Skip to content

Commit 3b8b8e0

Browse files
committed
Create _certificate-management.mdx
1 parent 6fa1e1b commit 3b8b8e0

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
You have several options for certificate management:
2+
3+
1. Management of private key and certificate files
4+
1. Manage your private key and certificate files automatically by using [cert-manager](https://cert-manager.io/docs/).
5+
- This method can reduce maintenance or operation costs. For example, cert-manager automatically renews certificates before they expire and Scalar Helm Chart automatically mounts private key and certificate files on the Scalar product pods.
6+
- You cannot use a CA that cert-manager does not support. You can see the supported issuers in the [cert-manager documentation](https://cert-manager.io/docs/configuration/issuers/).
7+
1. Manage your private key and certificate files manually.
8+
- You can issue and manage your private key and certificate files on your own by using your preferred method.
9+
- You can use any certificate even if cert-manager does not support it.
10+
- You must update secret resources when certificates expire.
11+
1. Kinds of certificates
12+
1. Use a trusted CA (signed certificate by third party).
13+
- You can use trusted certificates from a third-party certificate issuer.
14+
- You can encrypt packets.
15+
- You must pay costs to issue trusted certificates.
16+
1. Use self-signed certificates.
17+
- You can reduce costs to issue certificates.
18+
- Reliability of certificates is lower than a trusted CA, but you can encrypt packets.
19+
20+
In other words, you have the following four options:
21+
22+
1. Use a self-signed CA with automatic management.
23+
1. Use a trusted CA with automatic management.
24+
1. Use a self-signed CA with manual management.
25+
1. Use a trusted CA with manual management.
26+
27+
You should consider which method to use based on your security requirements. For guidance and related documentation for each method, refer to the following decision tree:
28+
29+
```mermaid
30+
flowchart TD
31+
A[Do you want to use <br /><a href='https://cert-manager.io/docs/'>cert-manager</a> to manage your <br />private key and certificate <br />files automatically?]
32+
A -->|Yes, I want to manage my <br />certificates automatically.| B
33+
A -->|No, I want to manage my <br />certificates manually by myself.| C
34+
B[Do you want to use a <br />self-signed CA or a trusted CA?]
35+
C[Do you want to use a <br />self-signed CA or a trusted CA?]
36+
B -->|I want to use a <br />self-signed CA.| D
37+
B -->|I want to use a <br />trusted CA.| E
38+
C -->|I want to use a <br />self-signed CA.| F
39+
C -->|I want to use a <br />trusted CA.| G
40+
D[See the <a href='#use-a-self-signed-ca-with-cert-manager-to-manage-your-private-key-and-certificate-files'>Use a self-signed <br />CA with cert-manager to <br />manage your private key and <br />certificate files</a> section.]
41+
E[See the <a href='#use-a-trusted-ca-with-cert-manager-to-manage-your-private-key-and-certificate-files'>Use a trusted <br />CA with cert-manager to <br />manage private key and <br />certificate files</a> section.]
42+
F[See the <a href='#use-your-private-key-and-certificate-files'>Use your private <br />key and certificate files</a> <br />section, and use the self-signed <br />certificate you generated.]
43+
G[See the <a href='#use-your-private-key-and-certificate-files'>Use your private key <br />and certificate files</a> section, <br />and use the trusted certificate <br />generated by the third party.]
44+
```

0 commit comments

Comments
 (0)