Skip to content

Commit 8b98347

Browse files
authored
docs: Adopt the script docs to create certs (#9)
* docs: Adapt the cert documentation * docs: Add more generic information about certificates
1 parent 76818c4 commit 8b98347

10 files changed

+16
-20
lines changed

scripts/ssl/EXAMPLE-CERT-CREATION.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44

55
Please execute the following script `bash create-tls-certs.sh` to create all necessary certificates for the complete setup of all related components.
66

7+
## Adaptation
8+
9+
Please adjust the configuration files inside the [config](./config) folder and adapt the corresponding values for the req_distinguished_names and subjectAltNames based on your organisation and configuration. You can find [here](https://support.dnsimple.com/articles/what-is-common-name/) and [here](https://learn.microsoft.com/en-us/azure/application-gateway/self-signed-certificates) more information about the corresponding values and CA certificates in general.
10+
711
## Ca Certificates
812

913
### Loki

scripts/ssl/config/ca_loki.conf

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,7 @@ O = TheIOTStudio
1212
CN = TIS Promtail CA
1313
emailAddress = [email protected]
1414

15-
16-
[ ext ]
15+
[ext]
1716
subjectKeyIdentifier=hash
1817
authorityKeyIdentifier=keyid:always,issuer
1918
basicConstraints = critical, CA:TRUE, pathlen:3

scripts/ssl/config/ca_promtail.conf

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ O = TheIOTStudio
1212
CN = TIS Promtail CA
1313
emailAddress = [email protected]
1414

15-
[ ext ]
15+
[ext]
1616
subjectKeyIdentifier=hash
1717
authorityKeyIdentifier=keyid:always,issuer
1818
basicConstraints = critical, CA:TRUE, pathlen:3

scripts/ssl/config/ca_syslog.conf

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,7 @@ O = TheIOTStudio
1212
CN = TIS Promtail CA
1313
emailAddress = [email protected]
1414

15-
16-
[ ext ]
15+
[ext]
1716
subjectKeyIdentifier=hash
1817
authorityKeyIdentifier=keyid:always,issuer
1918
basicConstraints = critical, CA:TRUE, pathlen:3

scripts/ssl/config/client_loki.conf

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ O = TheIOTStudio
1313
CN = TIS Promtail CA
1414
emailAddress = [email protected]
1515

16-
17-
[ v3_req ]
16+
[v3_req]
1817
keyUsage = keyEncipherment, dataEncipherment, digitalSignature
1918
extendedKeyUsage = serverAuth, clientAuth

scripts/ssl/config/client_promtail.conf

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ O = TheIOTStudio
1313
CN = TIS Promtail CA
1414
emailAddress = [email protected]
1515

16-
17-
[ v3_req ]
16+
[v3_req]
1817
keyUsage = keyEncipherment, dataEncipherment, digitalSignature
1918
extendedKeyUsage = serverAuth, clientAuth

scripts/ssl/config/client_syslog.conf

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ O = TheIOTStudio
1313
CN = TIS Promtail CA
1414
emailAddress = [email protected]
1515

16-
17-
[ v3_req ]
16+
[v3_req]
1817
keyUsage = keyEncipherment, dataEncipherment, digitalSignature
1918
extendedKeyUsage = serverAuth, clientAuth

scripts/ssl/config/server_loki.conf

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,7 @@ O = TheIOTStudio
1313
CN = TIS Promtail CA
1414
emailAddress = [email protected]
1515

16-
17-
[ v3_req ]
16+
[v3_req]
1817
keyUsage = keyEncipherment, dataEncipherment, digitalSignature
1918
extendedKeyUsage = serverAuth, clientAuth
20-
subjectAltName=IP:<IP address of the Loki server> DNS:<DNS address of the Loki server>
19+
subjectAltName=IP:<IP address of the Loki server> or DNS:<DNS address of the Loki server>

scripts/ssl/config/server_promtail.conf

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,7 @@ O = TheIOTStudio
1313
CN = TIS Promtail CA
1414
emailAddress = [email protected]
1515

16-
17-
[ v3_req ]
16+
[v3_req]
1817
keyUsage = keyEncipherment, dataEncipherment, digitalSignature
1918
extendedKeyUsage = serverAuth, clientAuth
20-
subjectAltName=IP:0.0.0.0, DNS:<DNS address of the Promtail server>
19+
subjectAltName=IP:0.0.0.0, DNS:<DNS address of the Promtail server> or IP1:<IP address of the Promtail server>

scripts/ssl/config/server_syslog.conf

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,7 @@ O = TheIOTStudio
1313
CN = TIS Promtail CA
1414
emailAddress = [email protected]
1515

16-
17-
[ v3_req ]
16+
[v3_req]
1817
keyUsage = keyEncipherment, dataEncipherment, digitalSignature
1918
extendedKeyUsage = serverAuth, clientAuth
20-
subjectAltName=DNS:<DNS address of the Promtail Syslog server>
19+
subjectAltName=DNS:<DNS address of the Promtail Syslog server> or IP:<IP address of the Promtail Syslog server>

0 commit comments

Comments
 (0)