Skip to content

Commit cb1eec0

Browse files
authored
[Part 2] Update docs for Cloud UI navigation redesign (#2004)
Adding only the updates related to trust management since that is being merged now. Will wait to merge this PR until those changes are in. Will create a subsequent PR for Security tab changes once we have more info from dev. Closes: #1769
1 parent 22a051a commit cb1eec0

File tree

5 files changed

+24
-40
lines changed

5 files changed

+24
-40
lines changed
Binary file not shown.

deploy-manage/remote-clusters/ec-remote-cluster-ece.md

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -139,14 +139,16 @@ A deployment can be configured to trust all or specific deployments in a remote
139139
5. Upload the Certificate Authority of the ECE environment. You can download it from Platform > Trust Management in your ECE administration UI.
140140
6. Choose one of following options to configure the level of trust with the ECE environment:
141141

142-
* All deployments - This deployment trusts all deployments in the ECE environment, including new deployments when they are created.
143-
* Specific deployments - Specify which of the existing deployments you want to trust in the ECE environment. The full {{es}} cluster ID must be entered for each remote cluster. The {{es}} `Cluster ID` can be found in the deployment overview page under **Applications**.
142+
* **All deployments** - This deployment trusts all deployments in the ECE environment, including new deployments when they are created.
143+
* **Specific deployments** - Specify which of the existing deployments you want to trust in the ECE environment. The full {{es}} cluster ID must be entered for each remote cluster. The {{es}} `Cluster ID` can be found in the deployment overview page under **Applications**.
144144

145145
7. Provide a name for the trusted environment. That name will appear in the trust summary of your deployment’s **Security** page.
146146
8. Select **Create trust** to complete the configuration.
147-
9. Configure the corresponding deployments of the ECE environment to [trust this deployment](/deploy-manage/remote-clusters/ece-enable-ccs.md). You will only be able to connect 2 deployments successfully when both of them trust each other.
147+
9. Configure the corresponding deployments of the ECE environment to [trust this deployment](/deploy-manage/remote-clusters/ece-enable-ccs.md). You will only be able to connect two deployments successfully when both of them trust each other.
148148

149-
Note that the environment ID and cluster IDs must be entered fully and correctly. For security reasons, no verification of the IDs is possible. If cross-environment trust does not appear to be working, double-checking the IDs is a good place to start.
149+
::::{note}
150+
The environment ID and cluster IDs must be entered fully and correctly. For security reasons, verification of the IDs is not possible. If cross-environment trust does not appear to be working, double-checking the IDs is a good place to start.
151+
::::
150152

151153
::::{dropdown} Using the API
152154
You can update a deployment using the appropriate trust settings for the {{es}} payload.
@@ -209,11 +211,6 @@ On the local cluster, add the remote cluster using {{kib}} or the {{es}} API.
209211

210212
* **Server name**: This value can be found on the **Security** page of the {{ech}} deployment you want to use as a remote.
211213

212-
:::{image} /deploy-manage/images/cloud-ce-copy-remote-cluster-parameters.png
213-
:alt: Remote Cluster Parameters in Deployment
214-
:screenshot:
215-
:::
216-
217214
::::{note}
218215
If you’re having issues establishing the connection and the remote cluster is part of an {{ece}} environment with a private certificate, make sure that the proxy address and server name match with the the certificate information. For more information, refer to [Administering endpoints in {{ece}}](/deploy-manage/deploy/cloud-enterprise/change-endpoint-urls.md).
219216
::::

deploy-manage/remote-clusters/ec-remote-cluster-other-ess.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -86,19 +86,21 @@ If you later need to update the remote connection with different permissions, yo
8686

8787
A deployment can be configured to trust all or specific deployments in another {{ech}} [organization](../users-roles/cloud-organization.md). To add cross-organization trust:
8888

89-
1. From the **Security** menu, select **Remote Connections > Add trusted environment** and select **{{ecloud}}**. Then click **Next**.
89+
1. From the **Security** page, select **Remote Connections > Add trusted environment** and select **{{ecloud}}**. Then click **Next**.
9090
2. Select **Certificates** as authentication mechanism and click **Next**.
91-
3. Enter the ID of the deployment’s organization which you want to establish trust with. You can find that ID on the Organization page. It is usually made of 10 digits.
91+
3. Enter the ID of the deployment’s organization which you want to establish trust with. You can find that ID on the **Organization** page. It is usually made of 10 digits.
9292
4. Choose one of following options to configure the level of trust with the other organization:
9393

94-
* All deployments - This deployment trusts all deployments in the other organization, including new deployments when they are created.
95-
* Specific deployments - Specify which of the existing deployments you want to trust in the other organization. The full {{es}} cluster ID must be entered for each remote cluster. The {{es}} `Cluster ID` can be found in the deployment overview page under **Applications**.
94+
* **All deployments** - This deployment trusts all deployments in the other organization, including new deployments when they are created.
95+
* **Specific deployments** - Specify which of the existing deployments you want to trust in the other organization. The full {{es}} cluster ID must be entered for each remote cluster. The {{es}} `Cluster ID` can be found in the deployment overview page under **Applications**.
9696

9797
5. Provide a name for the trusted environment. That name will appear in the trust summary of your deployment’s **Security** page.
9898
6. Select **Create trust** to complete the configuration.
99-
7. Repeat these steps from each of the deployments you want to use for CCS or CCR in both organizations. You will only be able to connect 2 deployments successfully when both of them trust each other.
99+
7. Repeat these steps from each of the deployments you want to use for CCS or CCR in both organizations. You will only be able to connect two deployments successfully when both of them trust each other.
100100

101-
Note that the organization ID and cluster IDs must be entered fully and correctly. For security reasons, no verification of the IDs is possible. If cross-organization trust does not appear to be working, double-checking the IDs is a good place to start.
101+
::::{note}
102+
The organization ID and cluster IDs must be entered fully and correctly. For security reasons, verification of the IDs is not possible. If cross-organization trust does not appear to be working, double-checking the IDs is a good place to start.
103+
::::
102104

103105
::::{dropdown} Using the API
104106
You can update a deployment using the appropriate trust settings for the {{es}} payload.
@@ -151,11 +153,6 @@ On the local cluster, add the remote cluster using {{kib}} or the {{es}} API.
151153

152154
* **Server name**: This value can be found on the **Security** page of the {{ech}} deployment you want to use as a remote.
153155

154-
:::{image} /deploy-manage/images/cloud-ce-copy-remote-cluster-parameters.png
155-
:alt: Remote Cluster Parameters in Deployment
156-
:screenshot:
157-
:::
158-
159156
::::{note}
160157
If you’re having issues establishing the connection and the remote cluster is part of an {{ece}} environment with a private certificate, make sure that the proxy address and server name match with the the certificate information. For more information, refer to [Administering endpoints in {{ece}}](/deploy-manage/deploy/cloud-enterprise/change-endpoint-urls.md).
161158
::::

deploy-manage/remote-clusters/ec-remote-cluster-same-ess.md

Lines changed: 9 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -84,13 +84,13 @@ If you later need to update the remote connection with different permissions, yo
8484
::::::{tab-item} TLS certificate (deprecated)
8585
### Set the default trust with other clusters in the same {{ecloud}} organization [ec_set_the_default_trust_with_other_clusters_in_the_same_elasticsearch_service_organization]
8686

87-
By default, any deployment that you create trusts all other deployments in the same organization. To manage this behavior in the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body), go to **Trust management** from the lower navigation menu. You can choose one of the following options:
87+
To configure this behavior in the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body), go to **Trust management** from the lower navigation menu. The **Trust all deployments** option is switched on by default. You can keep it switched on or switch it off.
8888

89-
* Trust all my deployments - All of your organization’s deployments created while this option is selected already trust each other. If you keep this option, that includes any deployments you’ll create in the future. You can directly jump to [Connect to the remote cluster](/deploy-manage/remote-clusters/ec-remote-cluster-same-ess.md#ec_connect_to_the_remote_cluster) to finalize the CCS or CCR configuration.
90-
* Trust no deployment - New deployments won’t trust any other deployment when they are created. You can instead configure trust individually for each of them in their security settings, as described in the next section.
89+
* When **Trust all deployments** is switched on - All deployments trust all other deployments in the same organization, including new deployments when they are created. If you keep this setting switched on, you can jump to [Connect to the remote cluster](/deploy-manage/remote-clusters/ec-remote-cluster-same-ess.md#ec_connect_to_the_remote_cluster) to finalize the CCS or CCR configuration.
90+
* When **Trust all deployments** is switched off - New deployments won’t trust any other deployments. Instead, you can configure trust for each of them in their security settings, as described in the next section.
9191

9292
::::{note}
93-
* The level of trust of existing deployments is not modified when you change this setting. You must instead update the trust settings individually for each deployment you wish to change.
93+
* The level of trust of existing deployments is not modified when you change this setting. Instead, you must update the individual trust settings for each deployment you wish to change.
9494
* Deployments created before the {{ecloud}} February 2021 release trust only themselves. You have to update the trust setting for each deployment that you want to either use as a remote cluster or configure to work with a remote cluster.
9595

9696
::::
@@ -99,22 +99,22 @@ By default, any deployment that you create trusts all other deployments in the s
9999

100100
### Specify the deployments trusted to be used as remote clusters [ec_specify_the_deployments_trusted_to_be_used_as_remote_clusters]
101101

102-
If your organization’s deployments already trust each other by default, you can skip this section. If that’s not the case, follow these steps to configure which are the specific deployments that should be trusted.
102+
If your organization’s deployments already trust each other by default, you can skip this section. If that’s not the case, follow these steps to configure which specific deployments should be trusted.
103103

104104
1. Go to the **Security** page of your deployment.
105105
2. From the list of existing trust configurations, edit the one labeled as your organization.
106106
3. Choose one of following options to configure the level of trust on each of your deployments:
107107

108-
* Trust all deployments - This deployment trusts all other deployments in this environment, including new deployments when they are created.
109-
* Trust specific deployments - Choose which of the existing deployments from your environment you want to trust.
110-
* Trust no deployment - No deployment in this {{ech}} environment is trusted.
108+
* **All deployments** - This deployment trusts all other deployments in this environment, including new deployments when they are created.
109+
* **Specific deployments** - Choose which of the existing deployments from your environment you want to trust.
110+
* **None** - No deployment in this environment is trusted.
111111

112112
::::{note}
113113
When trusting specific deployments, the more restrictive [CCS](/deploy-manage/remote-clusters/remote-clusters-self-managed.md#sniff-mode) version policy is used (even if you only want to use [CCR](/deploy-manage/tools/cross-cluster-replication.md)). To work around this restriction for CCR-only trust, it is necessary to use the API as described below.
114114
::::
115115

116116

117-
1. Repeat these steps from each of the deployments you want to use for CCS or CCR. You will only be able to connect 2 deployments successfully when both of them trust each other.
117+
1. Repeat these steps from each of the deployments you want to use for CCS or CCR. You will only be able to connect two deployments successfully when both of them trust each other.
118118

119119
::::{dropdown} Using the API
120120
You can update a deployment using the appropriate trust settings for the {{es}} payload.
@@ -182,11 +182,6 @@ On the local cluster, add the remote cluster using {{kib}} or the {{es}} API.
182182

183183
* **Server name**: This value can be found on the **Security** page of the {{ech}} deployment you want to use as a remote.
184184

185-
:::{image} /deploy-manage/images/cloud-ce-copy-remote-cluster-parameters.png
186-
:alt: Remote Cluster Parameters in Deployment
187-
:screenshot:
188-
:::
189-
190185
::::{note}
191186
If you’re having issues establishing the connection and the remote cluster is part of an {{ece}} environment with a private certificate, make sure that the proxy address and server name match with the the certificate information. For more information, refer to [Administering endpoints in {{ece}}](/deploy-manage/deploy/cloud-enterprise/change-endpoint-urls.md).
192187
::::

deploy-manage/remote-clusters/ec-remote-cluster-self-managed.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ If you later need to update the remote connection with different permissions, yo
122122

123123
A deployment can be configured to trust all or specific deployments in any environment:
124124

125-
1. From the **Security** menu, select **Remote Connections > Add trusted environment** and choose **Self-managed**, then click **Next**.
125+
1. From the **Security** page, select **Remote Connections > Add trusted environment** and choose **Self-managed**. Then click **Next**.
126126
2. Select **Certificates** as authentication mechanism and click **Next**.
127127
3. Upload the public certificate for the Certificate Authority of the self-managed environment (the one used to sign all the cluster certificates). The certificate needs to be in PEM format and should not contain the private key. If you only have the key in p12 format, then you can create the necessary file like this: `openssl pkcs12 -in elastic-stack-ca.p12 -out newfile.crt.pem -clcerts -nokeys`
128128
4. Select the clusters to trust. There are two options here depending on the subject name of the certificates presented by the nodes in your self managed cluster:
@@ -235,11 +235,6 @@ On the local cluster, add the remote cluster using {{kib}} or the {{es}} API.
235235

236236
* **Server name**: This value can be found on the **Security** page of the {{ech}} deployment you want to use as a remote.
237237

238-
:::{image} /deploy-manage/images/cloud-ce-copy-remote-cluster-parameters.png
239-
:alt: Remote Cluster Parameters in Deployment
240-
:screenshot:
241-
:::
242-
243238
::::{note}
244239
If you’re having issues establishing the connection and the remote cluster is part of an {{ece}} environment with a private certificate, make sure that the proxy address and server name match with the the certificate information. For more information, refer to [Administering endpoints in {{ece}}](/deploy-manage/deploy/cloud-enterprise/change-endpoint-urls.md).
245240
::::

0 commit comments

Comments
 (0)