How can I provide a SSL certificate with create-react-app?

Question

I am trying to host a react app I created and tested locally using the facebook boilerplate.
The client app interacts with an API I made using node.js, and with which I had no issue setting up a secure connection (with a node.js client sending my SSL certificate, for testing).
However, I am encountering difficulties when it comes to using react to send my SSL certificate instead of a self-signed one which causes me to encounter this error using chrome and trying to access to https://example.net:3000 :

Your connection is not private (NET:ERR_CERT_AUTHORITY_INVALID)

The documentation did not quite help me:

Note that the server will use a self-signed certificate, so your web browser will almost definitely display a warning upon accessing the page. https://github.com/facebookincubator/create-react-app/blob/master/packages/react-scripts/template/README.md#using-https-in-development

How can I use my own SSL certificate (which I already use on another app on my domain and works like a charm) instead of this self-signed one ? Did I miss something ?

Andi · Accepted Answer · 2020-03-26T14:59:28.417

40

I was able to get a local certificate working without modifying the webpack-dev-server files using react-scripts 3.4.1 (technically added in 3.4.0 but I had some—probably unrelated—issues). I added these two environment variables to my .env.development:

SSL_CRT_FILE=.cert/server.crt
SSL_KEY_FILE=.cert/server.key

Notes:

.cert is a folder I created in the root of my project
My script that generates the SSL certificate
Official documentation on these two environment variables

edited Mar 26 '20 at 14:59

answered Mar 23 '20 at 20:40

Andi

2,731
1
19
12

Is the certificate generated by your script self signed or signed by a certificate authority? – Daly Jul 25 '20 at 18:26
It's self-signed. – Andi Jul 26 '20 at 04:34
1

The script doesn't work, it gets stucked on almost every openssl command (using windows 10) – SenTisso Aug 08 '20 at 10:44
if it gets stuck on openssl (generate rootCA.key), modify the script by add 'winpty' before any 'oppenssl' command. Found answer here https://stackoverflow.com/questions/34156938/openssl-hangs-during-pkcs12-export-with-loading-screen-into-random-state – viethieule Oct 31 '21 at 03:21
@viethieule is there any workaround for this for Ubuntu? – Imnotapotato Dec 27 '21 at 08:09

Elad · Answer 2 · 2020-05-21T14:30:58.060

35

Update: see Andi's answer below. In recent version you should set environment variable to configure the certificate

SSL_CRT_FILE=.cert/server.crt
SSL_KEY_FILE=.cert/server.key

Ejecting create-react-app is not recommended since you won't be able to seamlessly upgrade it. Moreover, you can easily have valid SSL certificate without ejecting.
You will need to copy your certificate to node_modules/webpack-dev-server/ssl/server.pem. The downside is that you need to manually copy the file. However, one way to make this seamless is to add a postinstall script that creates a symlink. Here is a script I created:

#!/bin/bash
# With create-react-app, a self signed (therefore invalid) certificate is generated.
# 1. Create some folder in the root of your project
# 2. Copy your valid development certificate to this folder
# 3. Copy this file to the same folder
# 4. In you package.json, under `scripts`, add `postinstall` script that runs this file.
# Every time a user runs npm install this script will make sure to copy the certificate to the 
# correct location

TARGET_LOCATION="./node_modules/webpack-dev-server/ssl/server.pem"
SOURCE_LOCATION=$(pwd)/$(dirname "./local-certificate/server.pem")/server.pem

echo Linking ${TARGET_LOCATION} TO ${SOURCE_LOCATION}
rm -f ${TARGET_LOCATION} || true
ln -s ${SOURCE_LOCATION} ${TARGET_LOCATION}
chmod 400 ${TARGET_LOCATION} # after 30 days create-react-app tries to generate a new certificate and overwrites the existing one. 
echo "Created server.pem symlink"

Your package.json should look something like:

"scripts": {
    ...
    "postinstall": "sh ./scripts/link-certificate.sh"
}

My solution is based on this thread

edited May 21 '20 at 14:30

answered Jun 17 '18 at 12:58

Elad

17,685
17
60
70

If I understand this correctly, one would move the three files to the `node_modules/webpack-dev-server/ssl/` dir and then execute `npm run build && serve -s build`. OR, `npm run postinstall && npm run build && serve -s build` ... is that correct? – player87 Jun 19 '18 at 19:10
Not exactly. You should create a folder in the root of your app (i.e. sibling of `node_modules`) that contains your `server.pem` and the script file. Then you add the `postinstall` script to your `package.json`. The script then runs automatically after each `npm install`, so no need to change your workflow. HTH. – Elad Jun 20 '18 at 19:45
Should I add `./local-certificate` to `.gitignore`? – InsOp Nov 18 '19 at 10:28
You usually don't want to commit certificates to Git, so yes. – Elad Nov 19 '19 at 08:25
Two things I had to work through. My server certificate is from Let's Encrypt and the private key is in a separate file. I had to add it to `fullchain.pem` and then rename it to `server.pem`. Also, because my dev user isn't root, I had to make sure my user is the owner/group of the new `server.pem`. – tim.rohrer Dec 10 '19 at 01:35
2

[As of `react-scripts@3.4.0`](https://github.com/facebook/create-react-app/blob/master/CHANGELOG.md#nail_care-enhancement-1) as stated in Andi's answer, the certificate can be provided via environment variable which is a modern, elegant and OS-independent approach as opposed to the proposed bash script workaround above. Because this is a highly upvoted and also the accepted answer, I believe it should be updated, at least stating that there is an out-of-the-box solution to the task for modern versions of React. – Snackoverflow May 12 '20 at 10:51

score 17 · Answer 3 · edited Sep 08 '19 at 16:44

17

To expand on Elad's answer:

1. Create a self-signed certificate following the instructions linked to from https://github.com/webpack/webpack-dev-server/tree/master/examples/cli/https
1. Save the pem file (containing both the certificate and private key) somewhere in your project (e.g. /cert/server.pem)

Modify your package.json scripts:

"start": "HTTPS=true react-scripts start",
"prestart": "rm ./node_modules/webpack-dev-server/ssl/server.pem && cp -f ./cert/server.pem ./node_modules/webpack-dev-server/ssl",

edited Sep 08 '19 at 16:44

Nicolás Alarcón Rapela

2,286
1
16
28

answered Oct 12 '18 at 06:57

senornestor

3,809
2
32
31

1

I ended up using devcert-cli (I just saw mkcert today which also looks good) to generate a signed certificate for localhost in `./cert`. I then add the following `prestart` script to my package.json: `cp -f ./cert/server.pem ./node_modules/webpack-dev-server/ssl`. The benefit of using devcert is that you get a signed certificate vs. self-signed and so you won't see any warning or errors in Chrome. – senornestor Jan 07 '19 at 20:54
1

What happens if we also need to add a key and a passphrase? – Filip Grebowski Jan 07 '19 at 21:39
1

Note the key to step #2 above is to concatenate the certificate and private key into a single file. In the case of a LetsEncrypt certificate we made, that's privkey.pem + fullchain.pem. – carl Mar 15 '19 at 21:51
2

If I have a cert.pem and key.pem, how do I create the server.pem? – Maverick May 23 '19 at 01:08

Alex K · Answer 4 · 2020-05-11T20:51:42.117

9

Your server that serves files from that port needs to be configured to use your SSL cert. I'm guessing you are using webpack-dev-server on that port (that's what npm start does in create-react-app), and maybe a different server (apache, nginx, etc) on port 80?

You can either serve your compiled files using your already configured server, or configure webpack-dev-server to use your SSL cert.

To do this, you can use webpack-dev-server's --cert option. See https://webpack.github.io/docs/webpack-dev-server.html

NOTE: you need an extra -- to pass arguments through npm run to the underlying command, e.g. npm start -- --cert ....

If you want to do this using npm start, which calls a custom start script, you'll have to edit that start script. You may need to use the eject command first, which dumps all the config code into your repo so you can change it.

Here is the source code of the start script: https://github.com/facebookincubator/create-react-app/blob/master/packages/react-scripts/scripts/start.js#L230

I should also note that webpack-dev-server isn't intended to be used in a production environment.

Have fun!

edited May 11 '20 at 20:51

answered Dec 16 '16 at 21:59

Alex K

13,447
4
29
30

Life saver! Thank you so much. I configured webpack-dev-server after running eject and it works perfect. – mjarraya Dec 19 '16 at 14:48
Glad I was able to help! :) – Alex K Jan 04 '17 at 16:54
@MontasarJarraya maybe you can post your own solution step by step for beginners? – Mike.R Dec 08 '17 at 23:16
1

Please note that you do not absolutely need to eject in order to do this, if you use `react-app-rewired`—see https://github.com/timarney/react-app-rewired. I found that to get this to work I still needed to set the environment variable HTTPS to `true` – Nat Kuhn Dec 24 '17 at 22:41
1

That's awesome, @NatKuhn. I wasn't aware of that option. – Alex K Jan 21 '18 at 04:40
I can't get the `--cert` option working with `npm start`. Are the command-line arguments not passed through or something? – Snackoverflow Feb 20 '20 at 16:21
@anddero you need an extra -- to pass arguments through npm run to the underlying command. `npm start -- --cert` – Alex K May 11 '20 at 20:50

score 2 · Answer 5 · answered Oct 28 '20 at 07:58

2

Here is the webpack config of react-scripts when using HTTPS=true along side SSL_CRT_FILE & SSL_CRT_FILE. So you should just be able to add it to the env to set the paths to your cert.

answered Oct 28 '20 at 07:58

Paul van Dyk

659
8
7

score 2 · Answer 6 · edited Nov 17 '21 at 22:27

Are we looking for integration of SSL (HTTPS) to localhost for application? Or securely API call with any encryption (specific) algo.

If SSL enablement only,

Need to change at package.json file with HTTPS like –

"scripts": {
    "start": "HTTPS=true react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
},

Create your SSL certificate

In the project root folder, run:

openssl req -x509 -newkey rsa:2048 -keyout keytmp.pem -out cert.pem -days 365

run the

openssl rsa -in keytmp.pem -out key.pem
mkdir .cert
mv key.pem .cert/key.pem
mv cert.pem .cert/cert.pem

Enable your certificate (.perm) like –

"scripts": {
    "start": "HTTPS=true SSL_CRT_FILE='./.cert/cert.pem' SSL_KEY_FILE='./.cert/key.pem' react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
 },

now run with https://lochost:3000

w35l3y · Answer 7 · 2019-06-05T18:02:22.480

1

This is what I did:

bash <(wget -qO- https://gist.github.com/w35l3y/5bb7fe8508d576472136f35428019177/raw/local-cert-generator.sh)

Then I double clicked and imported: rootCA.pem and server.pem

Then I modified package.json:

"start": "HTTPS=true react-scripts start",
"prestart": "cp -f /path/to/server.pem ./node_modules/webpack-dev-server/ssl",

Very important sources:

edited Jun 05 '19 at 18:02

answered Jun 05 '19 at 17:31

w35l3y

8,086
3
37
50

Perfect! Thank you so much! – Nicolae Olariu Dec 17 '19 at 13:36

score 0 · Answer 8 · answered Jul 08 '21 at 19:11

Use mkcert to create the self-signed cert and install it. I tried other methods but they're error prone.

Example using macOS:

brew install mkcert
mkcert -install
mkcert localhost

Edit package.json:

"start": "HTTPS=true SSL_CRT_FILE=localhost.pem SSL_KEY_FILE=localhost-key.pem react-scripts start",

score 0 · Answer 9 · answered Jan 11 '22 at 14:54

Simplest way is to run reactjs with SSL on Ubuntu and windows is -

Create cert.pem and key.pem file and put it in ssl folder in app root folder

add below lines in scripts of package.json

"scripts": {
    "start": "...",
    "build": "...",
    "ssl-linux": "export HTTPS=true&&SSL_CRT_FILE=/ssl/cert.pem&&SSL_KEY_FILE=/ssl/key.pem craco start",
    "ssl-win": "set HTTPS=true&&npm start"
  },

Ubuntu - npm run ssl-linux on ubuntu

Windows - npm run ssl-win

To create pem file on ubuntu

Step 1.  openssl req -x509 -newkey rsa:2048 -keyout keytmp.pem -out cert.pem -days 365
Step 2.  openssl rsa -in keytmp.pem -out key.pem

Sample folder structure

How can I provide a SSL certificate with create-react-app?

9 Answers9

Linked