Skip to content

Commit 28ab242

Browse files
committed
cert rotation section and acrolinx fixes
1 parent 1f28523 commit 28ab242

File tree

1 file changed

+16
-8
lines changed

1 file changed

+16
-8
lines changed

articles/spring-apps/how-to-configure-enterprise-spring-cloud-gateway.md

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ To assign an endpoint in the Azure portal, use the following steps:
5656

5757
After a few minutes, **URL** shows the configured endpoint URL. Save the URL to use later.
5858

59-
:::image type="content" source="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-overview.png" alt-text="Screenshot of Azure portal showing the Spring Cloud Gateway overview page for an Azure Spring Apps instance with the Assign endpoint buttons highlighted and the configured endpoint URL displayed." lightbox="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-overview.png":::
59+
:::image type="content" source="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-overview.png" alt-text="Screenshot of Azure portal showing the Spring Cloud Gateway overview page for an Azure Spring Apps instance. The Assign endpoint buttons are highlighted and the configured endpoint URL is displayed." lightbox="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-overview.png":::
6060

6161
#### [Azure CLI](#tab/Azure-CLI)
6262

@@ -96,7 +96,7 @@ To edit metadata in the Azure portal, do these steps:
9696
1. Specify values for the properties listed for **API**.
9797
1. Select **Save**.
9898

99-
:::image type="content" source="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-configuration.png" alt-text="Screenshot of Azure portal showing the Spring Cloud Gateway configuration page for an Azure Spring Apps instance with the API section highlighted." lightbox="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-configuration.png":::
99+
:::image type="content" source="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-configuration.png" alt-text="Screenshot of Azure portal showing the Spring Cloud Gateway configuration page for an Azure Spring Apps instance, with the API section highlighted." lightbox="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-configuration.png":::
100100

101101
#### [Azure CLI](#tab/Azure-CLI)
102102

@@ -182,7 +182,7 @@ The following steps describe an example of how to implement the function in your
182182
183183
### Log out just the SSO session
184184

185-
If you send the `GET` request to the `/scg-logout` endpoint using a `XMLHttpRequest` (XHR), then the `302` redirect could be swallowed and not handled in the response handler. In this case, the user would only be logged out of the SSO session on the gateway service instance and would still have a valid IdP session. The behavior typically seen in this case is that if the user attempts to log in again, they're automatically sent back to the gateway as authenticated from IdP.
185+
If you send the `GET` request to the `/scg-logout` endpoint using a `XMLHttpRequest` (XHR), then the `302` redirect could be swallowed and not handled in the response handler. In this case, the user would only be logged out of the SSO session on the gateway service instance and would still have a valid IdP session. The behavior typically seen is that if the user attempts to log in again, they're automatically sent back to the gateway as authenticated from IdP.
186186

187187
You need to have a route configuration to route the logout request to your application, as shown in the following example. This code makes a gateway-only logout SSO session.
188188

@@ -356,26 +356,34 @@ You can now test whether the application is TLS enabled with the endpoint of the
356356

357357
### Rotate certificates
358358

359-
As certificates expire, new ones need to be generated and synchronized (rotation). You can use the Azure portal or Azure CLI to synchronize certificates.
359+
As certificates expire, you need to rotate certificates in Spring Cloud Gateway using the following procedure:
360+
361+
- Generate new certificates from a trusted CA.
362+
- Import the certificates into Azure Spring Apps. For more information, see the [Import a certificate](how-to-use-tls-certificate.md#import-a-certificate) section of [Use TLS/SSL certificates in your application in Azure Spring Apps](how-to-use-tls-certificate.md).
363+
- Synchronize the certificates, using the Azure portal or the Azure CLI.
364+
365+
The gateway automatically restarts to ensure that the gateway uses the new certificate for all connections.
360366

361367
#### [Azure portal](#tab/Azure-portal)
362368

363-
Use the following steps to rotate and synchronize certificates.
369+
Use the following steps to synchronize certificates.
364370

365371
1. In your Azure Spring Apps instance, select **Spring Cloud Gateway** in the navigation pane.
366372
1. On the **Spring Cloud Gateway** page, select **Certificate management**.
367-
1. Select the new certificate in **Certificates**.
373+
1. Select the certificate you imported in **Certificates**.
368374
1. Select **sync certificate**.
369375
1. Select **Save**.
370376

371-
:::image type="content" source="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-sync-certificate.png" alt-text="Screenshot of the Azure portal showing the Spring Cloud Gateway page for an Azure Spring Apps instance with Certificate Management selected and the prompt to sync the certificate highlighted." lightbox="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-sync-certificate.png":::
377+
:::image type="content" source="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-sync-certificate.png" alt-text="Screenshot of the Azure portal showing the Spring Cloud Gateway page for an Azure Spring Apps instance, with Certificate Management selected and the prompt to sync the certificate highlighted." lightbox="media/how-to-configure-enterprise-spring-cloud-gateway/gateway-sync-certificate.png":::
372378

373379
#### [Azure CLI](#tab/Azure-CLI)
374380

375-
Use the following command to synchronize a certificate.
381+
Use the following command to synchronize a certificate for Spring Cloud Gateway.
376382

377383
```azurecli
378384
az spring gateway sync-cert
385+
--resrouce-group <resource-group-name>
386+
--service <Azure-Spring-Apps-instance-name>
379387
```
380388

381389
---

0 commit comments

Comments
 (0)