From 940d97e73240576310d2ff31df9b7ab61189c4a5 Mon Sep 17 00:00:00 2001 From: Nitin Kumar Date: Fri, 10 Sep 2021 14:40:38 +0530 Subject: [PATCH 1/5] docs: update `devServer.https` --- src/content/configuration/dev-server.mdx | 25 +++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/src/content/configuration/dev-server.mdx b/src/content/configuration/dev-server.mdx index 158f0d4b1d12..fa130896751b 100644 --- a/src/content/configuration/dev-server.mdx +++ b/src/content/configuration/dev-server.mdx @@ -588,7 +588,7 @@ With the above setting, a self-signed certificate is used, but you can provide y module.exports = { devServer: { https: { - cacert: './server.pem', + ca: './server.pem', pfx: './server.pfx', key: './server.key', cert: './server.crt', @@ -607,6 +607,29 @@ To pass your own certificate via the CLI use the following options: npx webpack serve --https-key ./path/to/server.key --https-cert ./path/to/server.crt --https-cacert ./path/to/ca.pem ``` +`webpack-dev-server >= v4.2.0` allows you to set additional [TSL options](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options) like `minVersion`. Also, you can directly pass the contents of respective files: + +**webpack.config.js** + +```javascript +const fs = require('fs'); +const path = require('path'); + +module.exports = { + devServer: { + https: { + minVersion: 'TLSv1.1', + key: fs.readFileSync(path.join(__dirname, './server.key')), + pfx: fs.readFileSync(path.join(__dirname, './server.pfx')), + cert: fs.readFileSync(path.join(__dirname, './server.crt')), + ca: fs.readFileSync(path.join(__dirname, './ca.pem')), + passphrase: 'webpack-dev-server', + requestCert: true, + }, + }, +}; +``` + ## devServer.headers `function` `object` From ad1e11338003375bde1e72d13aae84996c7e0c08 Mon Sep 17 00:00:00 2001 From: Nitin Kumar Date: Fri, 10 Sep 2021 14:41:08 +0530 Subject: [PATCH 2/5] docs: update `devServer.https` --- src/content/configuration/dev-server.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/content/configuration/dev-server.mdx b/src/content/configuration/dev-server.mdx index fa130896751b..64077e4916f4 100644 --- a/src/content/configuration/dev-server.mdx +++ b/src/content/configuration/dev-server.mdx @@ -630,6 +630,8 @@ module.exports = { }; ``` +W> Don't specify `https.ca` and `https.cacert` option together, if specified `https.ca` will be used. `https.cacert` is deprecated and will be removed in next major release. + ## devServer.headers `function` `object` From 9e855025677612364bd7b87319de93a77d7cbf4a Mon Sep 17 00:00:00 2001 From: Nitin Kumar Date: Fri, 10 Sep 2021 14:43:21 +0530 Subject: [PATCH 3/5] docs: update `devServer.https` --- src/content/configuration/dev-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/configuration/dev-server.mdx b/src/content/configuration/dev-server.mdx index 64077e4916f4..9db261693dee 100644 --- a/src/content/configuration/dev-server.mdx +++ b/src/content/configuration/dev-server.mdx @@ -588,7 +588,7 @@ With the above setting, a self-signed certificate is used, but you can provide y module.exports = { devServer: { https: { - ca: './server.pem', + cacert: './server.pem', pfx: './server.pfx', key: './server.key', cert: './server.crt', From 2b9d0261b6c4bd0ea9560b34e3a9f82bac5d0497 Mon Sep 17 00:00:00 2001 From: Nitin Kumar Date: Fri, 10 Sep 2021 14:49:30 +0530 Subject: [PATCH 4/5] docs: update `devServer.https` --- src/content/configuration/dev-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/configuration/dev-server.mdx b/src/content/configuration/dev-server.mdx index 9db261693dee..c5a696ab923e 100644 --- a/src/content/configuration/dev-server.mdx +++ b/src/content/configuration/dev-server.mdx @@ -630,7 +630,7 @@ module.exports = { }; ``` -W> Don't specify `https.ca` and `https.cacert` option together, if specified `https.ca` will be used. `https.cacert` is deprecated and will be removed in next major release. +W> Don't specify `https.ca` and `https.cacert` options together, if specified `https.ca` will be used. `https.cacert` is deprecated and will be removed in next major release. ## devServer.headers From 80aa4cf74f142fb1b8fe24b37a08017171e11ece Mon Sep 17 00:00:00 2001 From: Nitin Kumar Date: Fri, 10 Sep 2021 17:14:17 +0530 Subject: [PATCH 5/5] fix typo --- src/content/configuration/dev-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/configuration/dev-server.mdx b/src/content/configuration/dev-server.mdx index c5a696ab923e..a08359e27928 100644 --- a/src/content/configuration/dev-server.mdx +++ b/src/content/configuration/dev-server.mdx @@ -607,7 +607,7 @@ To pass your own certificate via the CLI use the following options: npx webpack serve --https-key ./path/to/server.key --https-cert ./path/to/server.crt --https-cacert ./path/to/ca.pem ``` -`webpack-dev-server >= v4.2.0` allows you to set additional [TSL options](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options) like `minVersion`. Also, you can directly pass the contents of respective files: +`webpack-dev-server >= v4.2.0` allows you to set additional [TLS options](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options) like `minVersion`. Also, you can directly pass the contents of respective files: **webpack.config.js**