Skip to content

Commit 9b954f6

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into nw-toc
2 parents 6736eb1 + aa4d3e3 commit 9b954f6

File tree

134 files changed

+1125
-1451
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

134 files changed

+1125
-1451
lines changed

.openpublishing.redirection.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6978,6 +6978,26 @@
69786978
"source_path": "articles/defender-for-iot/organizations/eiot-sensor.md",
69796979
"redirect_url": "/azure/defender-for-iot/organizations/concept-enterprise",
69806980
"redirect_document_id": false
6981+
},
6982+
{
6983+
"source_path": "articles/cyclecloud/release-notes/ccws/2024.09.18.md",
6984+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2024-09-18",
6985+
"redirect_document_id": false
6986+
},
6987+
{
6988+
"source_path": "articles/cyclecloud/release-notes/ccws/2024.11.08.md",
6989+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2024-11-08",
6990+
"redirect_document_id": false
6991+
},
6992+
{
6993+
"source_path": "articles/cyclecloud/release-notes/ccws/2024.12.18.md",
6994+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2024-12-18",
6995+
"redirect_document_id": false
6996+
},
6997+
{
6998+
"source_path": "articles/cyclecloud/release-notes/ccws/2025.02.06.md",
6999+
"redirect_url": "/azure/cyclecloud/release-notes/ccws/2025-02-06",
7000+
"redirect_document_id": false
69817001
}
69827002
]
69837003
}

articles/api-management/configure-custom-domain.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: dlepow
77

88
ms.service: azure-api-management
99
ms.topic: how-to
10-
ms.date: 05/09/2025
10+
ms.date: 05/30/2025
1111
ms.author: danlep
1212
ms.custom:
1313
- engagement-fy23
@@ -50,10 +50,10 @@ There are several API Management endpoints to which you can assign a custom doma
5050
| Endpoint | Default |
5151
| -------- | ----------- |
5252
| **Gateway** | Default is: `<apim-service-name>.azure-api.net`. Gateway is the only endpoint available for configuration in the Consumption tier.<br/><br/>The default Gateway endpoint configuration remains available after a custom Gateway domain is added. |
53-
| **Developer portal** | Default is: `<apim-service-name>.developer.azure-api.net` |
54-
| **Management** | Default is: `<apim-service-name>.management.azure-api.net` |
55-
| **Configuration API (v2)** | Default is: `<apim-service-name>.configuration.azure-api.net` |
56-
| **SCM** | Default is: `<apim-service-name>.scm.azure-api.net` |
53+
| **Developer portal** (all tiers except Consumption) | Default is: `<apim-service-name>.developer.azure-api.net` |
54+
| **Management** (classic tiers only) | Default is: `<apim-service-name>.management.azure-api.net` |
55+
| **Self-hosted gateway configuration API (v2)** | Default is: `<apim-service-name>.configuration.azure-api.net` |
56+
| **SCM** (classic tiers only) | Default is: `<apim-service-name>.scm.azure-api.net` |
5757

5858
### Considerations
5959

@@ -62,6 +62,7 @@ There are several API Management endpoints to which you can assign a custom doma
6262
* Only API Management instance owners can use **Management** and **SCM** endpoints internally. These endpoints are less frequently assigned a custom domain name.
6363
* The **Premium** and **Developer** tiers support setting multiple hostnames for the **Gateway** endpoint.
6464
* Wildcard domain names, like `*.contoso.com`, are supported in all tiers except the Consumption tier. A specific subdomain certificate (for example, api.contoso.com) would take precedence over a wildcard certificate (*.contoso.com) for requests to api.contoso.com.
65+
* When configuing a custom domain for the **Developer portal**, you can [enable CORS](enable-cors-developer-portal.md) for the new domain name. This is needed for developer portal visitors to use the interactive console in the API reference pages.
6566

6667
## Domain certificate options
6768

articles/api-management/enable-cors-developer-portal.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,20 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: how-to
9-
ms.date: 12/22/2023
9+
ms.date: 05/30/2025
1010
ms.author: danlep
1111
---
1212

1313
# Enable CORS for interactive console in the API Management developer portal
14+
15+
[!INCLUDE [premium-dev-standard-basic-premiumv2-standarv2-basicv2.md](../../includes/api-management-availability-premium-dev-standard-basic-premiumv2-standardv2-basicv2.md)]
16+
1417
Cross-origin resource sharing (CORS) is an HTTP-header based mechanism that allows a server to indicate any origins (domain, scheme, or port) other than its own from which a browser should permit loading resources.
1518

1619
To let visitors to the API Management [developer portal](developer-portal-overview.md) use the interactive test console in the API reference pages, enable a [CORS policy](cors-policy.md) for APIs in your API Management instance. If the developer portal's domain name isn't an allowed origin for cross-domain API requests, test console users will see a CORS error.
1720

1821
For certain scenarios, you can configure the developer portal as a CORS proxy instead of enabling a CORS policy for APIs.
1922

20-
[!INCLUDE [premium-dev-standard-basic.md](../../includes/api-management-availability-premium-dev-standard-basic.md)]
21-
2223
## Prerequisites
2324

2425
+ Complete the following quickstart: [Create an Azure API Management instance](get-started-create-service-instance.md)
@@ -41,7 +42,6 @@ You can enable a setting to configure a CORS policy automatically for all APIs i
4142

4243
![Screenshot that shows where to check status of your CORS policy in the developer portal.](media/enable-cors-developer-portal/cors-azure-portal.png)
4344

44-
4545
### Enable CORS policy manually
4646

4747
1. Select the **Manually apply it on the global level** link to see the generated policy code.
@@ -57,6 +57,12 @@ You can enable a setting to configure a CORS policy automatically for all APIs i
5757
>
5858
> As a workaround, you can pass the subscription key in a query parameter.
5959
60+
## CORS configuration for custom domain name
61+
62+
If you configure a [custom domain](configure-custom-domain.md) for the developer portal and want visitors to use the test console on API reference pages, ensure that you enable CORS for the custom developer portal domain name.
63+
64+
When configuring the custom domain, you can enable a setting to add an origin for your custom developer portal domain in the CORS policy. If CORS was already enabled for the default domain, both origins will be included in the CORS policy. You can change the CORS policy settings anytime.
65+
6066
## CORS proxy option
6167

6268
For some scenarios (for example, if the API Management gateway is network isolated), you can choose to configure the developer portal as a CORS proxy itself, instead of enabling a CORS policy for your APIs. The CORS proxy routes the interactive console's API calls through the portal's backend in your API Management instance.
@@ -84,4 +90,4 @@ If you [self-host](developer-portal-self-host.md) the developer portal, the foll
8490
## Related content
8591

8692
* For more information about configuring a policy, see [Set or edit policies](set-edit-policies.md).
87-
* For details about the CORS policy, see the [cors](cors-policy.md) policy reference.
93+
* For details about the CORS policy, see the [cors](cors-policy.md) policy reference.

articles/app-service/app-service-ip-restrictions.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@ ms.assetid: 3be1f4bd-8a81-4565-8a56-528c037b24bd
1313
---
1414
# Set up Azure App Service access restrictions
1515

16-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
17-
1816
When you set up access restrictions, you can define a priority-ordered allow/deny list that controls network access to your app. The list can include IP addresses or Azure Virtual Network subnets. When there are one or more entries, an implicit *deny all* exists at the end of the list. For more information, see [Azure App Service access restrictions](./overview-access-restrictions.md).
1917

2018
The access restriction capability works with all Azure App Service-hosted workloads. The workloads can include web apps, API apps, Linux apps, Linux custom containers, and Azure Functions apps.

articles/app-service/app-service-key-vault-references.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,6 @@ ms.custom: AppServiceConnectivity
1414

1515
This article shows you how to use secrets from Azure Key Vault as values of [app settings](configure-common.md#configure-app-settings) or [connection strings](configure-common.md#configure-connection-strings) in your Azure App Service or Azure Functions apps.
1616

17-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
18-
1917
[Key Vault](/azure/key-vault/general/overview) is a service that provides centralized secrets management, with full control over access policies and audit history. When an app setting or connection string is a Key Vault reference, your application code can use it like any other app setting or connection string. This way, you can maintain secrets apart from your app's configuration. App settings are securely encrypted at rest, but if you need capabilities for managing secrets, they should go into a key vault.
2018

2119
## Grant your app access to a key vault

articles/app-service/app-service-plan-manage.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,6 @@ ms.custom: "UpdateFrequency3"
1212
---
1313
# Manage an App Service plan in Azure
1414

15-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
16-
1715
An [Azure App Service plan](overview-hosting-plans.md) provides the resources that an App Service app needs to run. This guide shows how to manage an App Service plan.
1816

1917
## Create an App Service plan
@@ -38,7 +36,7 @@ You can create an empty App Service plan, or you can create a plan as part of ap
3836
6. Select **Review + create** to create the App Service plan.
3937

4038
> [!IMPORTANT]
41-
> When you create an new App Service plan in an existing resource group, certain conditions with existing apps can trigger these errors:
39+
> When you create a new App Service plan in an existing resource group, certain conditions with existing apps can trigger these errors:
4240
> - `The pricing tier is not allowed in this resource group`
4341
> - `<SKU_NAME> workers are not available in resource group <RESOURCE_GROUP_NAME>`
4442
>

articles/app-service/app-service-web-tutorial-custom-domain.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@ author: msangapu-msft
1313

1414
# Set up an existing custom domain in Azure App Service
1515

16-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
17-
1816
[Azure App Service](overview.md) provides a highly scalable, self-patching web hosting service. This guide shows you how to map an existing custom Domain Name System (DNS) name to App Service. To migrate a live site and its DNS domain name to App Service with no downtime, see [Migrate an active DNS name to Azure App Service](manage-custom-dns-migrate-domain.md).
1917

2018
The DNS record type you need to add with your domain provider depends on the domain you want to add to App Service.
@@ -110,7 +108,7 @@ Create two records, as described in the following table:
110108

111109
| Record type | Host | Value | Comments |
112110
| - | - | - |-|
113-
| CNAME | `<subdomain>` (for example, `www`) | `<app-name>.azurewebsites.net`. (See [the note at the start of this article](#dnl-note).) | The domain mapping itself. |
111+
| CNAME | `<subdomain>` (for example, `www`) | (See the value in the Azure portal **Overview** page for your app.) | The domain mapping itself. |
114112
| TXT | `asuid.<subdomain>` (for example, `asuid.www`) | The domain verification ID shown in the **Add custom domain** dialog. | App Service accesses the `asuid.<subdomain>` TXT record to verify your ownership of the custom domain. |
115113

116114
![Screenshot that shows the portal navigation to an Azure app.](./media/app-service-web-tutorial-custom-domain/cname-record.png)
@@ -121,7 +119,7 @@ For a wildcard name, like `*` in `*.contoso.com`, create two records, as describ
121119

122120
| Record type | Host | Value | Comments |
123121
| - | - | - | - |
124-
| CNAME | `*` | `<app-name>.azurewebsites.net`. (See [the note at the start of this article](#dnl-note).) | The domain mapping itself. |
122+
| CNAME | `*` | (See the value in the Azure portal **Overview** page for your app.) | The domain mapping itself. |
125123
| TXT | `asuid` | The domain verification ID shown in the **Add custom domain** dialog. | App Service accesses the `asuid` TXT record to verify your ownership of the custom domain. |
126124

127125
![Screenshot that shows the navigation to an Azure app.](./media/app-service-web-tutorial-custom-domain/cname-record-wildcard.png)

articles/app-service/configure-authentication-provider-aad.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,6 @@ ms.author: cephalin
1212

1313
# Configure your App Service or Azure Functions app to use Microsoft Entra sign-in
1414

15-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
16-
1715
Select another authentication provider to jump to it.
1816

1917
[!INCLUDE [app-service-mobile-selector-authentication](../../includes/app-service-mobile-selector-authentication.md)]
@@ -81,7 +79,7 @@ To use an existing registration, select either:
8179

8280
If you need to manually create an app registration in a workforce tenant, see [Register an application with the Microsoft identity platform](/entra/identity-platform/quickstart-register-app). As you go through the registration process, be sure to note the application (client) ID and client secret values.
8381

84-
During the registration process, in the **Redirect URIs** section, select **Web** for platform and enter `<app-url>/.auth/login/aad/callback`. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
82+
During the registration process, in the **Redirect URIs** section, select **Web** for platform, and enter a redirect URI. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
8583

8684
Now, modify the app registration:
8785

@@ -168,7 +166,7 @@ To use an existing registration, select **Provide the details of an existing app
168166

169167
If you need to manually create an app registration in an external tenant, see [Register an app in your external tenant](/entra/external-id/customers/how-to-register-ciam-app?tabs=webapp#register-your-web-app).
170168

171-
During the registration process, in the **Redirect URIs** section, select **Web** for platform and enter `<app-url>/.auth/login/aad/callback`. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
169+
During the registration process, in the **Redirect URIs** section, select **Web** for platform, and enter a redirect URI. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
172170

173171
Now, modify the app registration:
174172

@@ -364,7 +362,7 @@ You can register native clients to request access to your App Service app's APIs
364362

365363
1. On the **Register an application** pane, for **Name**, enter a name for your app registration.
366364

367-
1. In **Redirect URI**, select **Public client/native (mobile & desktop)** and enter the URL `<app-url>/.auth/login/aad/callback`. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
365+
1. In **Redirect URI**, select **Public client/native (mobile & desktop)** and enter the redirect URL. For example, enter `https://contoso.azurewebsites.net/.auth/login/aad/callback`.
368366

369367
1. Select **Register**.
370368

articles/app-service/configure-common.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,6 @@ ms.author: cephalin
1616

1717
This article explains how to configure common settings for web apps, a mobile back end, or an API app. For Azure Functions, see [App settings reference for Azure Functions](../azure-functions/functions-app-settings.md).
1818

19-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
20-
2119
## Configure app settings
2220

2321
In Azure App Service, app settings are variables passed as environment variables to the application code. The following conditions apply to app settings:
@@ -55,7 +53,7 @@ App settings are always encrypted when they're stored (encrypted at rest).
5553
By default, values for app settings are hidden in the portal for security. To see a hidden value of an app setting, under **Value**, select **Show value**. To see the hidden values of all app settings, select **Show values**.
5654

5755
> [!NOTE]
58-
> Read/Write user permimssions are required to view this section in the Azure portal. RBAC built-in roles with sufficient permissions are Owner, Contributor, and Website Contributor. The Reader role alone would not be allowed to access this page.
56+
> Read/Write user permissions are required to view this section in the Azure portal. RBAC built-in roles with sufficient permissions are Owner, Contributor, and Website Contributor. The Reader role alone would not be allowed to access this page.
5957
6058
1. To add a new app setting, select **Add**. To edit a setting, select the setting.
6159
1. In the dialog, you can [stick the setting to the current slot](deploy-staging-slots.md#which-settings-are-swapped).

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

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@ author: msangapu-msft
1313

1414
# Add and manage TLS/SSL certificates in Azure App Service
1515

16-
[!INCLUDE [regionalization-note](./includes/regionalization-note.md)]
17-
1816
You can add digital security certificates to [use in your application code](configure-ssl-certificate-in-code.md) or to [help secure custom DNS names](configure-ssl-bindings.md) in [Azure App Service](overview.md), which provides a highly scalable, self-patching web hosting service. Currently called Transport Layer Security (TLS) certificates, also previously known as Secure Socket Layer (SSL) certificates, these private or public certificates help you secure internet connections by encrypting data sent between your browser, websites that you visit, and the website server.
1917

2018
The following table lists the options for you to add certificates in App Service:
@@ -69,7 +67,7 @@ The free App Service managed certificate is a turn-key solution for helping to s
6967
>
7068
> Free certificates are issued by DigiCert. For some domains, you must explicitly allow DigiCert as a certificate issuer by creating a [CAA domain record](https://wikipedia.org/wiki/DNS_Certification_Authority_Authorization) with the value: `0 issue digicert.com`.
7169
>
72-
> Azure fully manages the certificates on your behalf, so any aspect of the managed certificate, including the root issuer, can change at anytime. Certificate renewals change both public and private key parts. All of these certificate changes are outside your control. Make sure to avoid hard dependencies and "pinning" practice certificates to the managed certificate or any part of the certificate hierarchy. If you need the certificate pinning behavior, add a certificate to your custom domain using any other available method in this article.
70+
> Azure fully manages the certificates on your behalf, so any aspect of the managed certificate, including the root issuer, can change at any time. Certificate renewals change both public and private key parts. All of these certificate changes are outside your control. Make sure to avoid hard dependencies and "pinning" practice certificates to the managed certificate or any part of the certificate hierarchy. If you need the certificate pinning behavior, add a certificate to your custom domain using any other available method in this article.
7371
7472
The free certificate comes with the following limitations:
7573

@@ -148,7 +146,7 @@ The service principal app ID or assignee value is the ID for the App Service res
148146

149147
| Resource provider | Service principal app ID | Key vault secret permissions | Key vault certificate permissions |
150148
|--|--|--|--|
151-
| **Microsoft Azure App Service** or **Microsoft.Azure.WebSites** | - `abfa0a7c-a6b6-4736-8310-5855508787cd` for public Azure cloud environment <br><br>- `6a02c803-dafd-4136-b4c3-5a6f318b4714` for Azure Government cloud environment | Get | Get |
149+
| **Microsoft Azure App Service** or **Microsoft.Azure.WebSites** | - `abfa0a7c-a6b6-4736-8310-5855508787cd` for global Azure cloud environment <br><br>- `6a02c803-dafd-4136-b4c3-5a6f318b4714` for Azure Government cloud environment | Get | Get |
152150

153151
The service principal app ID or assignee value is the ID for the App Service resource provider. To learn how to authorize key vault permissions for the App Service resource provider using an access policy, see the [assign a Key Vault access policy documentation](/azure/key-vault/general/assign-access-policy?tabs=azure-portal).
154152

0 commit comments

Comments
 (0)