Skip to content

Commit 84400f1

Browse files
committed
DOC-5494 RS: Added crdb-cli and REST API examples to enable TLS after Active-Active database creation
1 parent ae5a456 commit 84400f1

File tree

1 file changed

+45
-2
lines changed

1 file changed

+45
-2
lines changed

content/operate/rs/security/encryption/tls/enable-tls.md

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,9 +81,14 @@ rladmin tune db < db:id | name > mtls_allow_outdated_certs enabled
8181

8282
## Enable TLS for Active-Active cluster connections
8383

84-
You cannot enable or turn off TLS after the Active-Active database is created, but you can change the TLS configuration.
8584

86-
To enable TLS for Active-Active cluster connections:
85+
You can enable TLS for Active-Active cluster connections when you create a database using the Cluster Manager UI, [`crdb-cli`]({{<relref "/operate/rs/references/cli-utilities/crdb-cli">}}), or the [REST API]({{<relref "/operate/rs/references/rest-api">}}).
86+
87+
If you need to enable or turn off TLS after the Active-Active database is created, you must use [`crdb-cli`]({{<relref "/operate/rs/references/cli-utilities/crdb-cli">}}) or the [REST API]({{<relref "/operate/rs/references/rest-api">}}).
88+
89+
### Enable TLS during database creation
90+
91+
To enable TLS for Active-Active cluster connections using the Cluster Manager UI:
8792

8893
1. During [database creation]({{<relref "/operate/rs/databases/active-active/create">}}), expand the **TLS** configuration section.
8994

@@ -95,6 +100,44 @@ To enable TLS for Active-Active cluster connections:
95100

96101
If you also want to require TLS for client connections, you must edit the Active-Active database configuration after creation. See [Enable TLS for client connections](#client) for instructions.
97102

103+
### Enable TLS after database creation
104+
105+
You can enable TLS for an existing Active-Active database using either `crdb-cli` or the REST API.
106+
107+
{{< multitabs id="enable-tls-post-creation"
108+
tab1="CLI"
109+
tab2="REST API" >}}
110+
111+
Run the following [`crdb-cli crdb update`]({{<relref "/operate/rs/references/cli-utilities/crdb-cli/crdb/update">}}) command:
112+
113+
```sh
114+
crdb-cli crdb update --crdb-guid <guid> --encryption true
115+
```
116+
117+
Replace `<guid>` with your Active-Active database's globally unique identifier.
118+
119+
-tab-sep-
120+
121+
To enable TLS for Active-Active cluster communication only:
122+
123+
```sh
124+
curl -v -k -u <username>:<password> \
125+
-H "Content-type: application/json" \
126+
-d '{ "enforce_client_authentication": "disabled", "tls_mode": "replica_ssl" }' \
127+
-X PUT https://<cluster-fqdn>:9443/v1/bdbs/<bdb-id>
128+
```
129+
130+
To enable TLS for all communications (cluster and client):
131+
132+
```sh
133+
curl -v -k -u <username>:<password> \
134+
-H "Content-type: application/json" \
135+
-d '{ "enforce_client_authentication": "disabled", "tls_mode": "enabled" }' \
136+
-X PUT https://<cluster-fqdn>:9443/v1/bdbs/<bdb-id>
137+
```
138+
139+
{{< /multitabs >}}
140+
98141
## Enable TLS for Replica Of cluster connections
99142

100143
{{<embed-md "replica-of-tls-config.md">}}

0 commit comments

Comments
 (0)