Skip to content

Commit 8c15287

Browse files
authored
adjust terms, indent images
1 parent 4c2fa69 commit 8c15287

File tree

1 file changed

+21
-18
lines changed

1 file changed

+21
-18
lines changed

articles/spring-cloud/spring-cloud-tutorial-custom-domain.md

Lines changed: 21 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Certificates encrypt web traffic. These TLS/SSL certificates can be stored in Az
1616
## Prerequisites
1717
* An application deployed to Azure Spring Cloud (see [Quickstart: Launch an existing Azure Spring Cloud application using the Azure portal](spring-cloud-quickstart-launch-app-portal.md), or use an existing app).
1818
* A domain name with access to the DNS registry for domain provider such as GoDaddy.
19-
* A private certificate (e.g. your self-signed certificate) from a third-party provider. The certificate must match the domain.
19+
* A private certificate (that is, your self-signed certificate) from a third-party provider. The certificate must match the domain.
2020
* A deployed instance of [Azure Key Vault](https://docs.microsoft.com/azure/key-vault/key-vault-overview)
2121

2222
## Import certificate
@@ -31,36 +31,39 @@ To upload your certificate to key vault:
3131
1. Under **Password**, enter the private key for your certificate.
3232
1. Click **Create**.
3333

34-
![Import certificate 1](./media/custom-dns-tutorial/import-certificate-a.png)
34+
![Import certificate 1](./media/custom-dns-tutorial/import-certificate-a.png)
3535

3636
To import certificate to Azure Spring Cloud:
3737
1. Go to your service instance.
3838
1. From the left navigation pane of your app, select **TLS/SSL settings**.
3939
1. Then click **Import Key Vault Certificate**.
4040

41-
![Import certificate](./media/custom-dns-tutorial/import-certificate.png)
41+
![Import certificate](./media/custom-dns-tutorial/import-certificate.png)
42+
43+
Or, you can use the Azure CLI to import the certificate:
4244

43-
Or using CLI to import certificate:
4445
```
4546
az spring-cloud certificate add --name <cert name> --vault-uri <key vault uri> --vault-certificate-name <key vault cert name>
4647
```
47-
>[!IMPORTANT]
48-
> Please ensure you grant Azure Spring Cloud to access your key vault before executing the above import certificate CLI. If you haven't, please execute the follow CLI to grant the access right.
48+
49+
> [!IMPORTANT]
50+
> Ensure you grant Azure Spring Cloud access to your key vault before you execute the previous import certificate command. If you haven't, you can execute the following command to grant the access rights.
4951
5052
```
5153
az keyvault set-policy -g <key vault resource group> -n <key vault name> --object-id 938df8e2-2b9d-40b1-940c-c75c33494239 --certificate-permissions get list
5254
```
5355

54-
When you have successfully imported your certificate, you'll see it on the list of **Private Key Certificates**.
56+
When you have successfully imported your certificate, you'll see it in the list of **Private Key Certificates**.
5557

5658
![Private key certificate](./media/custom-dns-tutorial/key-certificates.png)
5759

58-
Or using CLI to show a list of certificates:
60+
Or, you can use the Azure CLI to show a list of certificates:
61+
5962
```
6063
az spring-cloud certificate list
6164
```
6265

63-
>[!IMPORTANT]
66+
> [!IMPORTANT]
6467
> To secure a custom domain with this certificate, you still need to bind the certificate to a specific domain. Follow the steps in this document under the heading **Add SSL Binding**.
6568
6669
## Add Custom Domain
@@ -83,15 +86,15 @@ Go to application page.
8386
1. Select **Custom Domain**.
8487
2. Then **Add Custom Domain**.
8588

86-
![Custom domain](./media/custom-dns-tutorial/custom-domain.png)
89+
![Custom domain](./media/custom-dns-tutorial/custom-domain.png)
8790

8891
3. Type the fully qualified domain name for which you added a CNAME record, such as www.contoso.com. Make sure that Hostname record type is set to CNAME (<service_name>.azuremicroservices.io)
8992
4. Click **Validate** to enable the **Add** button.
9093
5. Click **Add**.
9194

92-
![Add custom domain](./media/custom-dns-tutorial/add-custom-domain.png)
95+
![Add custom domain](./media/custom-dns-tutorial/add-custom-domain.png)
9396

94-
Or using CLI to add a custom domain:
97+
Or, you can use the Azure CLI to add a custom domain:
9598
```
9699
az spring-cloud app custom-domain bind --domain-name <domain name> --app <app name>
97100
```
@@ -100,22 +103,22 @@ One app can have multiple domains, but one domain can only map to one app. When
100103

101104
![Custom domain table](./media/custom-dns-tutorial/custom-domain-table.png)
102105

103-
Or using CLI to show a list of custom domains:
106+
Or, you can use the Azure CLI to show a list of custom domains:
104107
```
105108
az spring-cloud app custom-domain list --app <app name>
106109
```
107110

108-
>[!NOTE]
111+
> [!NOTE]
109112
> A **Not Secure** label for your custom domain means that it's not yet bound to an SSL certificate. Any HTTPS request from a browser to your custom domain will receive an error or warning.
110113
111114
## Add SSL binding
112115
In the custom domain table, select **Add ssl binding** as shown in the previous figure.
113116
1. Select your **Certificate** or import it.
114117
1. Click **Save**.
115118

116-
![Add SSL binding](./media/custom-dns-tutorial/add-ssl-binding.png)
119+
![Add SSL binding](./media/custom-dns-tutorial/add-ssl-binding.png)
117120

118-
Or using CLI to **Add ssl binding**:
121+
Or, you can use the Azure CLI to **Add ssl binding**:
119122
```
120123
az spring-cloud app custom-domain update --domain-name <domain name> --certificate <cert name> --app <app name>
121124
```
@@ -131,7 +134,7 @@ In your app page, in the left navigation, select **Custom Domain**. Then, set **
131134

132135
![Add SSL binding](./media/custom-dns-tutorial/enforce-http.png)
133136

134-
Or using CLI to enforce HTTPS:
137+
Or, you can use the Azure CLI to enforce HTTPS:
135138
```
136139
az spring-cloud app update -name <app-name> --https-only <true|false> -g <resource group> --service <service-name>
137140
```
@@ -141,5 +144,5 @@ When the operation is complete, navigate to any of the HTTPS URLs that point to
141144
## See also
142145
* [What is Azure Key Vault?](https://docs.microsoft.com/azure/key-vault/key-vault-overview)
143146
* [Import a certificate](https://docs.microsoft.com/azure/key-vault/certificate-scenarios#import-a-certificate)
144-
* [Launch your Spring Cloud App using the Azure CLI](https://docs.microsoft.com/azure/spring-cloud/spring-cloud-quickstart-launch-app-cli)
147+
* [Launch your Spring Cloud App by using the Azure CLI](https://docs.microsoft.com/azure/spring-cloud/spring-cloud-quickstart-launch-app-cli)
145148

0 commit comments

Comments
 (0)