Skip to content

Commit b890848

Browse files
author
Matthieu Fronton
committed
enhance README
1 parent 0dd8b50 commit b890848

File tree

3 files changed

+15
-8
lines changed

3 files changed

+15
-8
lines changed

README.md

+15-8
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,34 @@
11
# frntn/x509-san
22

3-
Generate a valid, self-signed, x509v3 certificate for multiple URLs / IPs
3+
Generate a self-signed x509v3 certificate for use with multiple URLs / IPs
44

55
## Generate
66

7-
The following command will generate (and overwrite if they already exists) two files:
8-
- pkcs#8 private key : `frntn-x509-san.key`
9-
- x509v3 certificate : `frntn-x509-san.crt`
7+
#### Default values
108

11-
**You can (or should) change the `CRT_CN` and `CRT_SAN` values to fit your needs**
129
```bash
1310
curl -sSL https://raw.githubusercontent.com/frntn/x509-san/master/gencert.sh | CRT_CN="client.com" CRT_SAN="DNS.1:www.client.com,DNS.2:admin.client.com,IP.1:192.168.1.10,IP.2:10.0.0.234" bash
1411
```
1512

16-
## Check
13+
The above command will generate (and overwrite if they already exists) two files:
14+
- pkcs#8 private key : `frntn-x509-san.key`
15+
- x509v3 certificate : `frntn-x509-san.crt`
16+
17+
And the certificate will look like *(screenshots from Chrome certificate viewer)*:
18+
![certificate-viewer-summary](cert-summary.png)
19+
![certificate-viewer-extensions-details](cert-details.png)
20+
21+
#### Custom values
22+
23+
You must **change the `CRT_CN` and `CRT_SAN` values** of the above command to fit your needs
1724

18-
You can check the certificate content by using the following standard `x509` command :
25+
You can then check the certificate content by using the following standard `x509` command :
1926

2027
```bash
2128
openssl x509 -in frntn-x509-san.crt -noout -text
2229
```
2330

24-
## Secure the private key
31+
## Secure
2532

2633
The generated private key is passwordless by default.
2734

cert-details.png

34 KB
Loading

cert-summary.png

43 KB
Loading

0 commit comments

Comments
 (0)