Skip to content

Commit 7b1195e

Browse files
author
gitName
committed
Merge branch 'apimgem' of https://github.com/dlepow/azure-docs-pr; branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into apimgem
2 parents a3de74a + 7a6ed10 commit 7b1195e

File tree

81 files changed

+839
-346
lines changed

Some content is hidden

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

81 files changed

+839
-346
lines changed

articles/active-directory-b2c/best-practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Manage your Azure AD B2C environment.
8484
| Use the Microsoft Graph API to automate the management of your B2C tenants | Microsoft Graph APIs:<br/>Manage [Identity Experience Framework](/graph/api/resources/trustframeworkpolicy?preserve-view=true&view=graph-rest-beta) (custom policies)<br/>[Keys](/graph/api/resources/trustframeworkkeyset?preserve-view=true&view=graph-rest-beta)<br/>[User Flows](/graph/api/resources/identityuserflow?preserve-view=true&view=graph-rest-beta) |
8585
| Integrate with Azure DevOps | A [CI/CD pipeline](deploy-custom-policies-devops.md) makes moving code between different environments easy and ensures production readiness always. |
8686
| Deploy custom policy | Azure AD B2C relies on caching to deliver performance to your end users. When you deploy a custom policy using whatever method, expect a delay of up to **30 minutes** for your users to see the changes. As a result of this behavior, consider the following practices when you deploy your custom policies: <br> - If you're deploying to a development environment, set the `DeploymentMode` attribute in your custom policy file's `<TrustFrameworkPolicy>` element to `Production`. <br> - Deploy your updated policy files to a production environment when traffic in your app is low. <br> - When you deploy to a production environment to update existing policy files, upload the updated files with new names, which act as new versions of the policies. Then, update your app references to the new names/versions. You can remove the old policy files afterward or keep them as your last known good configuration for easy rollback.<br> - If you need to deploy to a production environment to update existing policy files without versioning, make the new policy backward compatible with the old policy by following some simple rules. If you need to change a technical profile, claim, or [SubJourney](subjourneys.md), create a new version of it, publish the policy, and wait for 30 minutes for Azure AD B2C caches to pick up the new version. Then, in a subsequent update, make changes to use the new version and perform another policy update. Wait for another 30 minutes, then you can delete the old version of the elements if needed. Ensure all of your business logic is inside SubJourneys.<br> - You can set the `DeploymentMode` to `Development` in a production environment to bypass the caching behavior. However, we don't recommend this practice. If you [Collect Azure AD B2C logs with Application Insights](troubleshoot-with-application-insights.md), all claims sent to and from identity providers are collected, which is a security and performance risk. |
87-
| Deploy app registration updates | When you modify your application registration in your Azure AD B2C tenant, such as updating the application's redirect URI, expect a delay of up to **2 hours (3600s)** for the changes to take effect in the production environment. We recommend that you modify your application registration in your production environment when traffic in your app is low.|
87+
| Deploy app registration updates | When you modify your application registration in your Azure AD B2C tenant, such as updating the application's redirect URI, expect a delay of up to **2 hours (7200s)** for the changes to take effect in the production environment. We recommend that you modify your application registration in your production environment when traffic in your app is low.|
8888
| Integrate with Azure Monitor | [Audit log events](view-audit-logs.md) are only retained for seven days. [Integrate with Azure Monitor](azure-monitor.md) to retain the logs for long-term use, or integrate with third-party security information and event management (SIEM) tools to gain insights into your environment. |
8989
| Setup active alerting and monitoring | [Track user behavior](./analytics-with-application-insights.md) in Azure AD B2C using Application Insights. |
9090

articles/api-management/api-management-get-started-publish-versions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.topic: tutorial
99
ms.date: 03/26/2025
1010
ms.author: danlep
1111

12-
#customer intent: As a developer, I want to publish mutliple versions of an API so that all callers to the API don't need to use the same version.
12+
#customer intent: As a developer, I want to publish multiple versions of an API so that all callers to the API don't need to use the same version.
1313
---
1414

1515
# Tutorial: Publish multiple versions of your API

articles/api-management/api-management-region-availability.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ Information in the following table is updated regularly. Capacity availability i
3737
| East US 2 |||||
3838
| France Central ||| ||
3939
| Germany West Central |||||
40+
| Italy North ||| | |
4041
| Japan East ||| ||
4142
| Korea Central |||| |
4243
| North Central US ||| ||
@@ -45,7 +46,8 @@ Information in the following table is updated regularly. Capacity availability i
4546
| South Africa North ||| | |
4647
| South Central US ||| | |
4748
| South India ||| | |
48-
| Southeast Asia ||| ||
49+
| Sweden Central ||| | |
50+
| South India ||| | |
4951
| Switzerland North ||| | |
5052
| UK South |||||
5153
| UK West ||| | |

articles/api-management/mock-api-responses.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ The steps in this section show how to create an HTTP API with no backend.
6060
1. In the **Create an HTTP API** window, select **Full**.
6161
1. In **Display name**, enter *Test API*.
6262
1. In **Products**, select *Unlimited*, if that value is available. This value is available only in some tiers. You can leave the value blank for this tutorial, but you need to associate the API with a product to publish it. For more information, see [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api).
63-
1. In **Gateways**, select **Managed** if this option is available. (This option is avaiable only in certain service tiers.)
63+
1. In **Gateways**, select **Managed** if this option is available. (This option is available only in certain service tiers.)
6464
1. Select **Create**.
6565

6666
:::image type="content" source="media/mock-api-responses/create-http-api.png" alt-text="Screenshot that shows the Create an HTTP API window." lightbox="media/mock-api-responses/create-http-api.png":::

articles/app-service/app-service-hybrid-connections.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to create and use hybrid connections in Azure App Service
44
author: seligj95
55
ms.assetid: 66774bde-13f5-45d0-9a70-4e9536a4f619
66
ms.topic: article
7-
ms.date: 06/04/2025
7+
ms.date: 07/07/2025
88
ms.update-cycle: 1095-days
99
ms.author: jordanselig
1010
ms.custom:
@@ -170,6 +170,8 @@ To support the Hybrid Connections it's configured with, the Hybrid Connection Ma
170170

171171
- TCP access to Azure over port 443.
172172
- TCP access to the Hybrid Connection endpoint.
173+
- Windows clients must have ports 4999-5001 available.
174+
- Linux clients must have port 5001 available.
173175
- The ability to do DNS look-ups on the endpoint host and the Service Bus namespace. In other words, the hostname in the Azure relay connection should be resolvable from the machine that hosts the Hybrid Connection Manager.
174176

175177
### Getting started with the Hybrid Connection Manager GUI

articles/app-service/configure-language-dotnet-framework.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,19 +5,20 @@ description: Learn how to configure an ASP.NET app in Azure App Service. This ar
55
ms.devlang: csharp
66
ms.custom: devx-track-csharp, devx-track-azurecli, devx-track-dotnet
77
ms.topic: article
8-
ms.date: 06/02/2020
8+
ms.date: 07/07/2025
99
author: cephalin
1010
ms.author: cephalin
11+
#customer intent: As an ASP.NET developer, I want to configure an ASP.NET app using Azure App Service to take advantage the Azure features.
1112
---
1213

1314
# Configure an ASP.NET app for Azure App Service
1415

1516
> [!NOTE]
1617
> For ASP.NET Core, see [Configure an ASP.NET Core app for Azure App Service](configure-language-dotnetcore.md). If your ASP.NET app runs in a custom Windows or Linux container, see [Configure a custom container for Azure App Service](configure-custom-container.md).
1718
18-
ASP.NET apps must be deployed to Azure App Service as compiled binaries. The Visual Studio publishing tool builds the solution and then deploys the compiled binaries directly, whereas the App Service deployment engine deploys the code repository first and then compiles the binaries.
19+
ASP.NET apps must be deployed to Azure App Service as compiled binaries. The Visual Studio publishing tool builds the solution and then deploys the compiled binaries directly. The App Service deployment engine deploys the code repository first and then compiles the binaries.
1920

20-
This guide provides key concepts and instructions for ASP.NET developers. If you've never used Azure App Service, follow the [ASP.NET quickstart](./quickstart-dotnetcore.md?tabs=netframework48) and [ASP.NET with SQL Database tutorial](app-service-web-tutorial-dotnet-sqldatabase.md) first.
21+
This guide provides key concepts and instructions for ASP.NET developers. If this article is your first experience with Azure App Service, follow [Deploy an ASP.NET web app](./quickstart-dotnetcore.md?tabs=netframework48) and [Deploy an ASP.NET app with Azure SQL database to Azure](app-service-web-tutorial-dotnet-sqldatabase.md) first.
2122

2223
## Show supported .NET Framework runtime versions
2324

@@ -29,7 +30,7 @@ For CLR 4 runtime versions (.NET Framework 4 and above):
2930
ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework"
3031
```
3132

32-
Latest .NET Framework version may not be immediately available.
33+
Latest .NET Framework version might not be immediately available.
3334

3435
For CLR 2 runtime versions (.NET Framework 3.5 and below):
3536

@@ -73,31 +74,31 @@ ConfigurationManager.ConnectionStrings["MyConnection"];
7374
}
7475
```
7576

76-
If you configure an app setting with the same name in App Service and in *web.config*, the App Service value takes precedence over the *web.config* value. The local *web.config* value lets you debug the app locally, but the App Service value lets your run the app in product with production settings. Connection strings work in the same way. This way, you can keep your application secrets outside of your code repository and access the appropriate values without changing your code.
77+
If you configure an app setting with the same name in App Service and in *web.config*, the App Service value takes precedence over the *web.config* value. The local *web.config* value lets you debug the app locally. The App Service value lets your run the app in product with production settings. Connection strings work in the same way. This way, you can keep your application secrets outside of your code repository and access the appropriate values without changing your code.
7778

7879
> [!NOTE]
7980
> Consider more secure connectivity options that don't require connection secrets at all. For more information, see [Secure connectivity to Azure services and databases from Azure App Service](tutorial-connect-overview.md).
8081
8182

8283
## Deploy multi-project solutions
8384

84-
When a Visual Studio solution includes multiple projects, the Visual Studio publish process already includes selecting the project to deploy. When you deploy to the App Service deployment engine, such as with Git, or with ZIP deploy [with build automation enabled](deploy-zip.md#enable-build-automation-for-zip-deploy), the App Service deployment engine picks the first Web Site or Web Application Project it finds as the App Service app. You can specify which project App Service should use by specifying the `PROJECT` app setting. For example, run the following in the [Cloud Shell](https://shell.azure.com):
85+
When a Visual Studio solution includes multiple projects, the Visual Studio publish process includes selecting the project to deploy. When you deploy to the App Service deployment engine, such as with Git, or with ZIP deploy [with build automation enabled](deploy-zip.md#enable-build-automation-for-zip-deploy), the App Service deployment engine picks the first Web Site or Web Application Project it finds as the App Service app. You can specify which project App Service should use by specifying the `PROJECT` app setting. For example, run the following command in the [Cloud Shell](https://shell.azure.com):
8586

8687
```azurecli-interactive
8788
az webapp config appsettings set --resource-group <resource-group-name> --name <app-name> --settings PROJECT="<project-name>/<project-name>.csproj"
8889
```
8990

9091
## Get detailed exceptions page
9192

92-
When your ASP.NET app generates an exception in the Visual Studio debugger, the browser displays a detailed exception page, but in App Service that page is replaced by a generic error message. To display the detailed exception page in App Service, open the *Web.config* file and add the `<customErrors mode="Off"/>` element under the `<system.web>` element. For example:
93+
When your ASP.NET app generates an exception in the Visual Studio debugger, the browser displays a detailed exception page. A generic error message replaces that page in App Service. To display the detailed exception page in App Service, open the *web.config* file and add the `<customErrors mode="Off"/>` element under the `<system.web>` element. For example:
9394

9495
```xml
9596
<system.web>
9697
<customErrors mode="Off"/>
9798
</system.web>
9899
```
99100

100-
Redeploy your app with the updated *Web.config*. You should now see the same detailed exception page.
101+
Redeploy your app with the updated *web.config*. You should now see the same detailed exception page.
101102

102103
## Access diagnostic logs
103104

0 commit comments

Comments
 (0)