Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into iotfrsh2-26

Author: sethmanheim

articles/api-center/TOC.yml

@@ -86,10 +86,8 @@
     href: set-up-notification-workflow.md
 - name: API discovery and consumption
   items:
-  - name: Enable API Center portal
+  - name: Enable and customize API Center portal
     href: set-up-api-center-portal.md
-  - name: Customize API Center portal
-    href: customize-api-center-portal.md
   - name: Enable API Center portal view - VS Code extension
     href: enable-api-center-portal-vs-code-extension.md
   - name: Self-host Azure API Center portal

articles/api-center/customize-api-center-portal.md

@@ -6,31 +6,34 @@ services: api-center
 
 ms.service: azure-api-center
 ms.topic: include
-ms.date: 08/08/2025
+ms.date: 02/25/2026
 
 ms.custom: Include file
 ---
 
-First configure an app registration in your Microsoft Entra ID tenant. The app registration enables the API Center portal to access data from your API center on behalf of a signed-in user.
+To configure Microsoft Entra ID as an identity provider, first configure an app registration in your Microsoft Entra ID tenant. The app registration enables the API Center portal to access data from your API center on behalf of a signed-in user.
 
 API Center can set up the app registration automatically, or you can create the app registration manually. 
 
-#### Set up the app registration automatically
+#### Set up the app registration automatically (recommended)
 
 To set up the app registration automatically, follow these steps:
 
-1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
-1. In the left-hand menu, select **API Center portal** > **Settings**.
-1. On the **Identity provider** tab, select **Start set up**.
-1. On the **Quick setup** tab, select **Save + publish**.
+1. In the [Azure portal](https://portal.azure.com), go to your API center.
+1. In the sidebar menu, select **API Center portal** > **Settings**.
+1. On the **Access** tab, select **Configure Entra ID**. 
+    :::image type="content" source="../media/set-up-api-center-portal/configure-access-entra-id.png" alt-text="Screenshot showing configuration of Entra ID in the portal.":::
+
+1. On the **Set up user sign-in with Microsoft Entra ID** page, select **Configure**.
+1. On the **Access** tab, select **Save + publish**.
 
 If you need to access the app registration later, you can find it in the portal under **App registrations**. The application is named with the following format: **\<api-center-name>-apic-aad**. 
 
 #### Set up the app registration manually
 
 If you want to create the app registration manually, follow these steps:
 
-1. In the [Azure portal](https://portal.azure.com), navigate to **Microsoft Entra ID** > **Manage** > **App registrations**.
+1. In the [Azure portal](https://portal.azure.com), go to **Microsoft Entra ID** > **Manage** > **App registrations**.
 1. Select **+ New registration**. 
 1. On the **Register an application** page, set the values as follows:
 

articles/api-center/includes/api-center-portal-app-registration.md

@@ -6,7 +6,7 @@ services: api-center
 
 ms.service: azure-api-center
 ms.topic: include
-ms.date: 03/04/2025
+ms.date: 02/25/2026
 
 ms.custom: Include file
 ---

articles/api-center/includes/api-center-portal-prerequisites.md

@@ -6,20 +6,21 @@ services: api-center
 
 ms.service: azure-api-center
 ms.topic: include
-ms.date: 08/05/2025
+ms.date: 02/25/2026
 
 ms.custom: Include file
 ---
 
-To enable sign-in to the API Center portal to access APIs, assign the **Azure API Center Data Reader** role to users or groups in your organization, scoped to your API center.
+When Microsoft Entra ID is configured for portal access, users must sign in to the API Center portal to access APIs. To enable sign-in, assign the **Azure API Center Data Reader** role to users or groups in your organization, scoped to your API center.
 
-> [!IMPORTANT]
-> By default, you and other administrators of the API center must sign-in to access APIs in the API Center portal. Be sure to assign the **Azure API Center Data Reader** role to yourself and other administrators.  
+> [!NOTE]
+> * When the Microsoft Entra ID app registration is set up automatically, the user who configures the portal is automatically assigned the **Azure API Center Data Reader** role. 
+> * Be sure to assign the **Azure API Center Data Reader** role to other administrators of the API center.  
 
 For detailed prerequisites and steps to assign a role to users and groups, see [Assign Azure roles using the Azure portal](/azure/role-based-access-control/role-assignments-portal). Brief steps follow:
 
-1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
-1. In the left menu, select **Access control (IAM)** > **+ Add role assignment**.
+1. In the [Azure portal](https://portal.azure.com), go to your API center.
+1. In the sidebar menu, select **Access control (IAM)** > **+ Add role assignment**.
 1. In the **Add role assignment** pane, set the values as follows:
     1. On the **Role** page, search for and select **Azure API Center Data Reader**. Select **Next**.
     1. On the **Members** page, In **Assign access to**, select **User, group, or service principal** > **+ Select members**.
@@ -29,7 +30,7 @@ For detailed prerequisites and steps to assign a role to users and groups, see [
 > [!NOTE]
 > To streamline access configuration for new users, we recommend that you assign the role to a Microsoft Entra group and configure a dynamic group membership rule. To learn more, see [Create or update a dynamic group in Microsoft Entra ID](/entra/identity/users/groups-create-rule).
 
-After you configure access to the portal, configured users can sign in to the portal and view the APIs in your API center.
+After you configure access to the portal, users can sign in to the portal and view the APIs in your API center.
 
 > [!NOTE]
 > The first user to sign in to the portal is prompted to consent to the permissions requested by the API Center portal app registration. Thereafter, other configured users aren't prompted to consent.