Skip to content

Commit ecb79e3

Browse files
committed
edits
1 parent dfee925 commit ecb79e3

File tree

5 files changed

+19
-17
lines changed

5 files changed

+19
-17
lines changed

articles/spring-apps/enterprise/how-to-use-tls-certificate.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.custom: devx-track-java
1717
1818
**This article applies to:** ✔️ Basic/Standard ✔️ Enterprise
1919

20-
This article shows you how to use public certificates in Azure Spring Apps for your application. Your app might act as a client and access an external service that requires certificate authentication, or it might need to perform cryptographic tasks.
20+
This article shows you how to use public certificates in Azure Spring Apps for your application. Your app might act as a client and access an external service that requires certificate authentication, or it might need to perform cryptographic tasks.
2121

2222
When you let Azure Spring Apps manage your TLS/SSL certificates, you can maintain the certificates and your application code separately to safeguard your sensitive data. Your app code can access the public certificates you add to your Azure Spring Apps instance.
2323

@@ -32,20 +32,22 @@ You can choose to import your certificate into your Azure Spring Apps instance f
3232

3333
### Import a certificate from Key Vault
3434

35-
You need to grant Azure Spring Apps access to your key vault before you import your certificate using these steps:
35+
You need to grant Azure Spring Apps access to your key vault before you import your certificate.
3636

37-
Azure Key Vault offers two authorization systems: **[Azure role-based access control](../../role-based-access-control/overview.md)** (Azure RBAC), which operates on Azure's [control and data planes](../../azure-resource-manager/management/control-plane-and-data-plane.md), and the **access policy model**, which operates on the data plane alone.
37+
Azure Key Vault offers two authorization systems: [Azure role-based access control](../../role-based-access-control/overview.md) (Azure RBAC), which operates on Azure's [control and data planes](../../azure-resource-manager/management/control-plane-and-data-plane.md), and the *access policy model*, which operates on the data plane alone.
3838

39-
#### [Access Policies](#tab/accessPolicies)
39+
Use the following steps to grant access:
40+
41+
#### [Access policies](#tab/accessPolicies)
4042

4143
1. Sign in to the [Azure portal](https://portal.azure.com).
42-
1. Select **Key vaults**, then select the Key Vault you import your certificate from.
43-
1. In the left navigation pane, select **Access policies**, then select **Create**.
44+
1. Select **Key vaults**, then select the key vault you import your certificate from.
45+
1. In the navigation pane, select **Access policies**, then select **Create**.
4446
1. Select **Certificate permissions**, then select **Get** and **List**.
4547

4648
:::image type="content" source="media/how-to-use-tls-certificate/grant-key-vault-permission.png" alt-text="Screenshot of the Azure portal that shows the Create an access policy page with Permission pane showing and Get and List permissions highlighted." lightbox="media/how-to-use-tls-certificate/grant-key-vault-permission.png":::
4749

48-
1. Under **Principal**, select your **Azure Spring Cloud Resource Provider**.
50+
1. Under **Principal**, select **Azure Spring Cloud Resource Provider**.
4951

5052
:::image type="content" source="media/how-to-use-tls-certificate/select-service-principal.png" alt-text="Screenshot of the Azure portal that shows the Create an access policy page Principal tab with Azure Spring Cloud Resource Provider highlighted." lightbox="media/how-to-use-tls-certificate/select-service-principal.png":::
5153

@@ -54,21 +56,21 @@ Azure Key Vault offers two authorization systems: **[Azure role-based access con
5456
#### [RBAC](#tab/RBAC)
5557

5658
1. Sign in to the [Azure portal](https://portal.azure.com).
57-
1. Select **Key vaults**, then select the Key Vault you import your certificate from.
58-
1. In the left navigation pane, select **Access control (IAM)**, then select **Add role assignment**.
59-
1. Search **Certificate**, then select role named **Key Vault Certificate User**.
59+
1. Select **Key vaults**, then select the key vault you import your certificate from.
60+
1. In the navigation pane, select **Access control (IAM)**, then select **Add role assignment**.
61+
1. Search for *Certificate*, then select the role named **Key Vault Certificate User**.
6062

61-
:::image type="content" source="media/how-to-use-tls-certificate/grant-key-vault-permission-rbac.png" alt-text="Screenshot of the Azure portal that shows the Create role assignment page with Permission pane showing and Get and List permissions highlighted." lightbox="media/how-to-use-tls-certificate/grant-key-vault-permission-rbac.png":::
63+
:::image type="content" source="media/how-to-use-tls-certificate/grant-key-vault-permission-rbac.png" alt-text="Screenshot of the Azure portal that shows the Add role assignment page with Key Vault Certificate User highlighted." lightbox="media/how-to-use-tls-certificate/grant-key-vault-permission-rbac.png":::
6264

63-
1. Under **Members**, click **+Select members** link and search **Azure Spring Cloud Resource Provider** and then click **Select**.
65+
1. Under **Members**, select **Select members**. Search for *Azure Spring Cloud Resource Provider*, select the provider, and then select **Select**.
6466

65-
:::image type="content" source="media/how-to-use-tls-certificate/select-service-principal-rbac.png" alt-text="Screenshot of the Azure portal that shows the Create an role assignment page Principal tab with Azure Spring Cloud Resource Provider highlighted." lightbox="media/how-to-use-tls-certificate/select-service-principal-rbac.png":::
67+
:::image type="content" source="media/how-to-use-tls-certificate/select-service-principal-rbac.png" alt-text="Screenshot of the Azure portal that shows the Add role assignment page with the Select members pane showing." lightbox="media/how-to-use-tls-certificate/select-service-principal-rbac.png":::
6668

6769
1. Select **Review + assign**.
6870

6971
---
7072

71-
After you grant access to your key vault, you can import your certificate using these steps:
73+
After you grant access to your key vault, you can import your certificate using the following steps:
7274

7375
1. Go to your service instance.
7476

@@ -80,7 +82,7 @@ After you grant access to your key vault, you can import your certificate using
8082

8183
1. Provide a value for **Certificate name**, select **Enable auto sync** if needed, and then select **Apply**. For more information, see the [Auto sync certificate](./how-to-custom-domain.md#auto-sync-certificate) section of [Map an existing custom domain to Azure Spring Apps](./how-to-custom-domain.md).
8284

83-
After you've successfully imported your certificate, you see it in the list of Public Key Certificates.
85+
After you successfully import your certificate, you see it in the list of Public Key Certificates.
8486

8587
> [!NOTE]
8688
> The Azure Key Vault and Azure Spring Apps instances should be in the same tenant.
@@ -93,7 +95,7 @@ You can import a certificate file stored locally using these steps:
9395
1. From the left navigation pane of your instance, select **TLS/SSL settings**.
9496
1. Select **Upload public certificate** in the **Public Key Certificates** section.
9597

96-
After you've successfully imported your certificate, you see it in the list of Public Key Certificates.
98+
After you successfully import your certificate, you see it in the list of Public Key Certificates.
9799

98100
## Load a certificate
99101

@@ -119,7 +121,7 @@ X509Certificate cert = (X509Certificate) factory.generateCertificate(is);
119121

120122
### Load a certificate into the trust store
121123

122-
For a Java application, you can choose **Load into trust store** for the selected certificate. The certificate is automatically added to the Java default TrustStores to authenticate a server in SSL authentication.
124+
For a Java application, you can choose **Load into trust store** for the selected certificate. The certificate is automatically added to the Java default TrustStores to authenticate a server in TLS/SSL authentication.
123125

124126
The following log from your app shows that the certificate is successfully loaded.
125127

-169 KB
Loading
34.5 KB
Loading
7.92 KB
Loading
-96 KB
Loading

0 commit comments

Comments
 (0)