Skip to content

Commit 6fe0e2c

Browse files
committed
edit pass: end-to-end-ssl-portal
1 parent f00c8d9 commit 6fe0e2c

File tree

1 file changed

+32
-31
lines changed

1 file changed

+32
-31
lines changed

articles/application-gateway/end-to-end-ssl-portal.md

Lines changed: 32 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.custom: mvc
1111
---
1212
# Configure end-to-end SSL by using Application Gateway with the portal
1313

14-
This article shows you how to use the Azure portal to configure end-to-end SSL encryption with an application gateway v1 SKU.
14+
This article describes how to use the Azure portal to configure end-to-end Secure Sockets Layer (SSL) encryption through Azure Application Gateway v1 SKU.
1515

1616
> [!NOTE]
1717
> Application Gateway v2 SKU requires trusted root certificates for enabling end-to-end configuration.
@@ -20,94 +20,95 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
2020

2121
## Before you begin
2222

23-
To configure end-to-end SSL with an Application Gateway, a certificate is required for the gateway and certificates are required for the back-end servers. The gateway certificate is used to derive a symmetric key as per SSL protocol specification. The symmetric key is then used to encrypt and decrypt the traffic sent to the gateway. For end-to-end SSL encryption, the right back-end servers must be allowed in the application gateway. To do this, upload the public certificate of the back-end servers, also known as Authentication Certificates (v1) or Trusted Root Certificates (v2), to the Application Gateway. Adding the certificate ensures that the Application Gateway only communicates with known back-end instances. This further secures the end-to-end communication.
23+
To configure end-to-end SSL with an application gateway, a certificate is required for the gateway. Certificates are also required for the back-end servers. The gateway certificate is used to derive a symmetric key in compliance with the SSL protocol specification. The symmetric key is then used to encrypt and decrypt the traffic sent to the gateway. For end-to-end SSL encryption, the right back-end servers must be allowed in the application gateway. To allow this access, upload the public certificate of the back-end servers, also known as Authentication Certificates (v1) or Trusted Root Certificates (v2), to the application gateway. Adding the certificate ensures that the application gateway communicates only with known back-end instances. This configuration further secures end-to-end communication.
2424

2525
To learn more, see [SSL termination and end-to-end SSL](https://docs.microsoft.com/azure/application-gateway/ssl-overview).
2626

2727
## Create a new application gateway with end-to-end SSL
2828

29-
To create a new application gateway with end-to-end SSL encryption, you'll need to first enable SSL termination while creating a new application gateway. This will enable SSL encryption for the communication between the client and application gateway. Then, you'll need to whitelist certificates for backend servers in the HTTP settings to enable SSL encryption for the communication between the application gateway and backend servers, accomplishing end-to-end SSL encryption.
29+
To create a new application gateway with end-to-end SSL encryption, you'll need to first enable SSL termination while creating a new application gateway. This action enables SSL encryption for communication between the client and application gateway. Then, you'll need to put on the Safe Recipients list the certificates for the back-end servers in the HTTP settings. This configuration enables SSL encryption for communication between the application gateway and the back-end servers. That accomplishes end-to-end SSL encryption.
3030

3131
### Enable SSL termination while creating a new application gateway
3232

33-
Refer to this article to understand how to [enable SSL termination while creating a new application gateway](https://docs.microsoft.com/azure/application-gateway/create-ssl-portal).
33+
To learn more, see [enable SSL termination while creating a new application gateway](https://docs.microsoft.com/azure/application-gateway/create-ssl-portal).
3434

3535
### Add authentication/root certificate of back-end servers
3636

3737
1. Select **All resources**, and then select **myAppGateway**.
3838

39-
2. Select **HTTP settings** from the left menu. Azure automatically created a default HTTP setting, **appGatewayBackendHttpSettings**, when you created the application gateway.
39+
2. Select **HTTP settings** from the left-side menu. Azure automatically created a default HTTP setting, **appGatewayBackendHttpSettings**, when you created the application gateway.
4040

4141
3. Select **appGatewayBackendHttpSettings**.
4242

43-
4. Under **Protocol**, select **HTTPS**. A pane for **Backend authentication certificates or Trusted root certificates** will appear.
43+
4. Under **Protocol**, select **HTTPS**. A pane for **Backend authentication certificates or Trusted root certificates** appears.
4444

45-
5. Choose **Create new**.
45+
5. Select **Create new**.
4646

47-
6. Enter a suitable **Name**.
47+
6. In the **Name** field, enter a suitable name.
4848

49-
7. Select the certificate file using the **Upload CER certificate** box.
49+
7. Select the certificate file in the **Upload CER certificate** box.
5050

51-
For Standard and WAF (v1) Application Gateways, you should upload the public key of your backend server certificate in .cer format.
51+
For Standard and WAF (v1) application gateways, you should upload the public key of your back-end server certificate in .cer format.
5252

53-
![addcert](./media/end-to-end-ssl-portal/addcert.png)
53+
![add_certificate](./media/end-to-end-ssl-portal/addcert.png)
5454

55-
For Standard_v2 and WAF_v2 Application Gateways, you should upload the **root certificate** of the backend server certificate in .cer format. If the backend certificate is issued by a well-known CA, you can check the "Use Well Known CA certificate" box and there is no need to upload a certificate.
55+
For Standard_v2 and WAF_v2 application gateways, you should upload the root certificate of the back-end server certificate in .cer format. If the back-end certificate is issued by a well-known certificate authority (CA), you can select the **Use Well Known CA Certificate** check box, and then you don't have to upload a certificate.
5656

57-
![addtrustedrootcert](./media/end-to-end-ssl-portal/trustedrootcert-portal.png)
57+
![add_trusted_root_certificate](./media/end-to-end-ssl-portal/trustedrootcert-portal.png)
5858

59-
![rootcert](./media/end-to-end-ssl-portal/trustedrootcert.png)
59+
![root_certificate](./media/end-to-end-ssl-portal/trustedrootcert.png)
6060

6161
8. Select **Save**.
6262

6363
## Enable end-to-end SSL for existing application gateway
6464

65-
To configure an existing application gateway with end-to-end SSL encryption, you'll need to first enable SSL termination in the listener. This will enable SSL encryption for the communication between the client and application gateway. Then, you'll need to whitelist certificates for backend servers in the HTTP settings to enable SSL encryption for the communication between the application gateway and backend servers, accomplishing end-to-end SSL encryption.
65+
To configure an existing application gateway with end-to-end SSL encryption, you must first enable SSL termination in the listener. This action enables SSL encryption for communication between the client and the application gateway. Then, put those certificates for back-end servers in the HTTP settings on the Safe Recipients list. This configuration enables SSL encryption for communication between the application gateway and the back-end servers. That accomplishes end-to-end SSL encryption.
6666

67-
You'll need to use a listener with HTTPS protocol and certificate for enabling SSL termination. So, you can either choose to use an existing listener with HTTPS protocol and certificate, or create a new listener. In case you choose the former, you can ignore the below mentioned steps to **Enable SSL termination in existing application gateway** and directly move to **Add authentication/trusted root certificates for back-end servers** section. If you choose the latter, use these steps.
67+
You'll need to use a listener with the HTTPS protocol and a certificate for enabling SSL termination. You can either use an existing listener that meets those conditions or create a new listener. If you choose the former option, you can ignore the following "Enable SSL termination in existing application gateway" section and move directly to the "Add authentication/trusted root certificates for backend servers" section.
6868

69+
If you choose the latter option, apply the steps in the following procedure.
6970
### Enable SSL termination in existing application gateway
7071

7172
1. Select **All resources**, and then select **myAppGateway**.
7273

73-
2. Select **Listeners** from the left menu.
74+
2. Select **Listeners** from the left-side menu.
7475

75-
3. Choose between **Basic** and **Multi-site** listener as per your requirement.
76+
3. Select either **Basic** or **Multi-site** listener depending on your requirements.
7677

77-
4. Under **Protocol**, select **HTTPS**. A pane for **Certificate** will appear.
78+
4. Under **Protocol**, select **HTTPS**. A pane for **Certificate** appears.
7879

79-
5. Upload the PFX certificate that you intend to use for SSL termination between the client and application gateway.
80+
5. Upload the PFX certificate you intend to use for SSL termination between the client and the application gateway.
8081

8182
> [!NOTE]
82-
> For testing purposes, you can use a self-signed certificate. but not advised for production workloads as they are harder to manage and not completely secure. Learn how to [create a self-signed certificate](https://docs.microsoft.com/azure/application-gateway/create-ssl-portal#create-a-self-signed-certificate).
83+
> For testing purposes, you can use a self-signed certificate. However, this is not advised for production workloads, because they're harder to manage and aren't completely secure. For more info, see [create a self-signed certificate](https://docs.microsoft.com/azure/application-gateway/create-ssl-portal#create-a-self-signed-certificate).
8384
84-
6. Add other required settings for the **Listener** as per your requirement.
85+
6. Add other required settings for the **Listener**, depending on your requirements.
8586

8687
7. Select **OK** to save.
8788

8889
### Add authentication/trusted root certificates of back-end servers
8990

9091
1. Select **All resources**, and then select **myAppGateway**.
9192

92-
2. Select **HTTP settings** from the left menu. You can either whitelist certificates in an existing backend HTTP setting or create a new HTTP setting. In the below step, we will whitelist certificate for the default HTTP setting, **appGatewayBackendHttpSettings**.
93+
2. Select **HTTP settings** from the left-side menu. You can either put certificates in an existing back-end HTTP setting on the Safe Recipients list or create a new HTTP setting. (In the next step, the certificate for the default HTTP setting, **appGatewayBackendHttpSettings**, is added to the Safe Recipients list.)
9394

9495
3. Select **appGatewayBackendHttpSettings**.
9596

96-
4. Under **Protocol**, select **HTTPS**. A pane for **Backend authentication certificates or Trusted root certificates** will appear.
97+
4. Under **Protocol**, select **HTTPS**. A pane for **Backend authentication certificates or Trusted root certificates** appears.
9798

98-
5. Choose **Create new**.
99+
5. Select **Create new**.
99100

100-
6. Enter suitable **Name**.
101+
6. In the **Name** field, enter a suitable name.
101102

102-
7. Select the certificate file using the **Upload CER certificate** box.
103+
7. Select the certificate file in the **Upload CER certificate** box.
103104

104-
For Standard and WAF (v1) Application Gateways, you should upload the public key of your backend server certificate in .cer format.
105+
For Standard and WAF (v1) application gateways, you should upload the public key of your back-end server certificate in .cer format.
105106

106-
![addcert](./media/end-to-end-ssl-portal/addcert.png)
107+
![add_certificate](./media/end-to-end-ssl-portal/addcert.png)
107108

108-
For Standard_v2 and WAF_v2 Application Gateways, you should upload the **root certificate** of the backend server certificate in .cer format. If the backend certificate is issued by a well-known CA, you can check the "Use Well Known CA certificate" box and there is no need to upload a certificate.
109+
For Standard_v2 and WAF_v2 application gateways, you should upload the root certificate of the back-end server certificate in .cer format. If the back-end certificate is issued by a well-known CA, you can select the **Use Well Known CA Certificate** check box, and then you don't have to upload a certificate.
109110

110-
![addtrustedrootcert](./media/end-to-end-ssl-portal/trustedrootcert-portal.png)
111+
![add_trusted_root_certificate](./media/end-to-end-ssl-portal/trustedrootcert-portal.png)
111112

112113
8. Select **Save**.
113114

0 commit comments

Comments
 (0)