Skip to content

Commit a310333

Browse files
committed
freshness update
1 parent 1b9fcc2 commit a310333

File tree

4 files changed

+27
-51
lines changed

4 files changed

+27
-51
lines changed

articles/app-service/configure-ssl-bindings.md

Lines changed: 25 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Secure HTTPS access to your custom domain by creating a TLS/SSL bin
44
tags: buy-ssl-certificates
55

66
ms.topic: article
7-
ms.date: 04/27/2022
7+
ms.date: 04/20/2023
88
ms.reviewer: yutlin
99
ms.custom: seodec18
1010
---
@@ -14,70 +14,52 @@ This article shows you how to secure the [custom domain](app-service-web-tutoria
1414

1515
![Web app with custom TLS/SSL certificate](./media/configure-ssl-bindings/app-with-custom-ssl.png)
1616

17-
Securing a [custom domain](app-service-web-tutorial-custom-domain.md) with a certificate involves two steps:
18-
19-
- [Add a private certificate to App Service](configure-ssl-certificate.md) that satisfies all the [private certificate requirements](configure-ssl-certificate.md#private-certificate-requirements).
20-
- Create a TLS binding to the corresponding custom domain. This second step is covered by this article.
21-
2217
## Prerequisites
2318

2419
To follow this how-to guide:
2520

26-
- [Create an App Service app](./index.yml)
27-
- [Map a domain name to your app](app-service-web-tutorial-custom-domain.md) or [buy and configure it in Azure](manage-custom-dns-buy-domain.md)
28-
- [Add a private certificate to your app](configure-ssl-certificate.md)
29-
30-
> [!NOTE]
31-
> The easiest way to add a private certificate is to [create a free App Service managed certificate with your custom domain](tutorial-secure-domain-certificate.md).
32-
33-
34-
[!INCLUDE [Prepare your web app](../../includes/app-service-ssl-prepare-app.md)]
21+
- [Scale up your App Service app](manage-scale-up.md) to one of the supported pricing tiers: **Basic**, **Standard**, **Premium**.
22+
- [Map a domain name to your app](app-service-web-tutorial-custom-domain.md) or [buy and configure it in Azure](manage-custom-dns-buy-domain.md).
3523

3624
<a name="upload"></a>
3725

38-
## Secure a custom domain
26+
## 1. Add the binding
3927

40-
Do the following steps:
28+
In the <a href="https://portal.azure.com" target="_blank">Azure portal</a>:
4129

42-
In the <a href="https://portal.azure.com" target="_blank">Azure portal</a>, from the left menu, select **App Services** > **\<app-name>**.
30+
1. From the left menu, select **App Services** > **\<app-name>**.
4331

44-
From the left navigation of your app, start the **TLS/SSL Binding** dialog by:
32+
1. From the left navigation of your app, select **Custom domains**
4533

46-
- Selecting **Custom domains** > **Add binding**
47-
- Selecting **TLS/SSL settings** > **Add TLS/SSL binding**
34+
1. Next to the custom domain, select **Add binding**
4835

49-
![Add binding to domain](./media/configure-ssl-bindings/secure-domain-launch.png)
36+
:::image type="content" source="media/configure-ssl-bindings/secure-domain-launch.png" alt-text="A screenshot showing how to launch the Add TLS/SSL Binding dialog.":::
5037

51-
In **Custom Domain**, select the custom domain you want to add a binding for.
52-
53-
If your app already has a certificate for the selected custom domain, go to [Create binding](#create-binding) directly. Otherwise, keep going.
54-
55-
### Add a certificate for custom domain
56-
57-
If your app has no certificate for the selected custom domain, then you have two options:
58-
59-
- **Upload PFX Certificate** - Follow the workflow at [Upload a private certificate](configure-ssl-certificate.md#upload-a-private-certificate), then select this option here.
60-
- **Import App Service Certificate** - Follow the workflow at [Import an App Service certificate](configure-ssl-certificate.md#buy-and-import-app-service-certificate), then select this option here.
61-
62-
> [!NOTE]
63-
> You can also [Create a free certificate](configure-ssl-certificate.md#create-a-free-managed-certificate) or [Import a Key Vault certificate](configure-ssl-certificate.md#import-a-certificate-from-key-vault), but you must do it separately and then return to the **TLS/SSL Binding** dialog.
38+
1. If your app already has a certificate for the selected custom domain, you can select it in **Certificate**. If not, you must add a certificate using one of the selections in **Source**.
6439

65-
### Create binding
40+
- **Create App Service Managed Certificate** - Let App Service create a managed certificate for your selected domain. This option is the simplest. For more information, see [Create a free managed certificate](configure-ssl-certificate.md#create-a-free-managed-certificate).
41+
- **Import App Service Certificate** - In **App Service Certificate**, choose an App Service certificate you've purchased for your selected domain. To purchase an App Service certificate, see [Import an App Service certificate](configure-ssl-certificate.md#buy-and-import-app-service-certificate).
42+
- **Upload certificate (.pfx)** - Follow the workflow at [Upload a private certificate](configure-ssl-certificate.md#upload-a-private-certificate) to upload a PFX certificate from your local machine and specify the cetificate password.
43+
- **Import from Key Vault** - Click **Select key vault certificate** and select the certificate in the dialog.
6644

67-
Use the following table to help you configure the TLS binding in the **TLS/SSL Binding** dialog, then click **Add Binding**.
45+
1. In **TLS/SSL type**, choose between **SNI SSL** and **IP based SSL**.
6846

69-
[!INCLUDE [Certificate binding types](../../includes/app-service-ssl-binding-types.md)]
47+
[!INCLUDE [Certificate binding types](../../includes/app-service-ssl-binding-types.md)]
7048

71-
Once the operation is complete, the custom domain's TLS/SSL state is changed to **Secure**.
49+
1. When adding a new certificate, validate the new certificate by selecting **Validate**.
7250

73-
![TLS/SSL binding successful](./media/configure-ssl-bindings/secure-domain-finished.png)
51+
1. Select **Add**.
7452

53+
Once the operation is complete, the custom domain's TLS/SSL state is changed to **Secure**.
54+
55+
![TLS/SSL binding successful](./media/configure-ssl-bindings/secure-domain-finished.png)
56+
7557
> [!NOTE]
7658
> A **Secure** state in the **Custom domains** means that it is secured with a certificate, but App Service doesn't check if the certificate is self-signed or expired, for example, which can also cause browsers to show an error or warning.
7759
78-
## Remap records for IP SSL
60+
## 2. Remap records for IP based SSL
7961

80-
If you don't use IP SSL in your app, skip to [Test HTTPS for your custom domain](#test-https).
62+
This step is needed only for IP based SSL. For an SNI SSL binding, skip to [Test HTTPS for your custom domain](#3-test-https).
8163

8264
There are two changes you need to make, potentially:
8365

@@ -87,7 +69,7 @@ There are two changes you need to make, potentially:
8769

8870
- If you have an SNI SSL binding to `<app-name>.azurewebsites.net`, [remap any CNAME mapping](app-service-web-tutorial-custom-domain.md#2-create-the-dns-records) to point to `sni.<app-name>.azurewebsites.net` instead (add the `sni` prefix).
8971

90-
## Test HTTPS
72+
## 3. Test HTTPS
9173

9274
In various browsers, browse to `https://<your.custom.domain>` to verify that it serves up your app.
9375

14.2 KB
Loading
85.6 KB
Loading

includes/app-service-ssl-prepare-app.md

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,19 +34,13 @@ To create custom TLS/SSL bindings or enable client certificates for your App Ser
3434

3535
1. Make sure that your web app isn't in the **F1** or **D1** tier, which doesn't support custom TLS/SSL.
3636

37-
Your web app's current tier is highlighted by a dark blue box.
38-
39-
![Screenshot of web app pricing tier information.](./media/app-service-ssl-prepare-app/check-pricing-tier.png)
40-
4137
1. If you need to scale up, follow the steps in the next section. Otherwise, close the **Scale up** page, and skip the [Scale up your App Service plan section](#scale-up-your-app-service-plan).
4238

4339
### Scale up your App Service plan
4440

45-
1. Select any non-free tier, such as **B1**, **B2**, **B3**, or any other tier in the **Production** category. For more options, select **See additional options**.
46-
47-
1. When you're done, select **Apply**.
41+
1. Select any non-free tier, such as **B1**, **B2**, **B3**, or any other tier in the **Production** category.
4842

49-
![Screenshot of pricing tier and "Apply" selected.](./media/app-service-ssl-prepare-app/choose-pricing-tier.png)
43+
1. When you're done, select **Select**.
5044

5145
When the following message appears, the scale operation has completed.
5246

0 commit comments

Comments
 (0)