You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/enterprise/embedded-tls-certs.mdx
+30-3Lines changed: 30 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,15 +4,42 @@ This topic describes how to update custom TLS certificates in Replicated Embedde
4
4
5
5
## Update Custom TLS Certificates
6
6
7
-
Users can provide custom TLS certificates with Embedded Cluster installations and can update TLS certificates through the Admin Console.
7
+
Users can provide custom TLS certificates with Embedded Cluster installations and can update TLS certificates using the CLI or through the Admin Console.
8
+
9
+
### Update Using the CLI (Recommended)
10
+
11
+
:::note
12
+
The `admin-console update-tls` command is available in Embedded Cluster v2.14.0 and later.
13
+
:::
14
+
15
+
The `admin-console update-tls` command provides a secure way to update TLS certificates for the Admin Console. This method updates the `kotsadm-tls` Kubernetes secret directly. Pods watching this secret automatically reload the TLS configuration, so no restart is required.
16
+
17
+
To update TLS certificates using the CLI:
18
+
19
+
1. SSH onto a controller node where Embedded Cluster is installed. Ensure the TLS certificate and key files are present on the node.
20
+
21
+
1. Run the following command to update the TLS certificate and key:
-`APP_SLUG` with the unique slug of the installed application.
29
+
-`PATH_TO_CERT` with the path to the TLS certificate file.
30
+
-`PATH_TO_KEY` with the path to the TLS key file.
31
+
32
+
### Update Using the Admin Console
33
+
34
+
You can also update TLS certificates through the Admin Console. This method requires temporarily enabling anonymous uploads.
8
35
9
36
:::important
10
37
Adding the `acceptAnonymousUploads` annotation temporarily creates a vulnerability for an attacker to maliciously upload TLS certificates. After TLS certificates have been uploaded, the vulnerability is closed again.
11
38
12
-
Replicated recommends that you complete this upload process quickly to minimize the vulnerability risk.
39
+
Replicated recommends using the CLI method above when possible. If you use this method, complete the upload process quickly to minimize the vulnerability risk.
13
40
:::
14
41
15
-
To upload a new custom TLS certificate in Embedded Cluster installations:
42
+
To upload a new custom TLS certificate through the Admin Console:
16
43
17
44
1. SSH onto a controller node where Embedded Cluster is installed. Then, run the following command to start a shell so that you can access the cluster with kubectl:
0 commit comments