Merge pull request #297758 from dlepow/appreg

[APIC] Appreg headings and steps

Author: Stacyrch140

articles/api-center/enable-api-center-portal-vs-code-extension.md

@@ -46,7 +46,6 @@ Enterprise developers must sign in with a Microsoft account to see the API Cente
 
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
-### For API center administrators
 ## Steps for enterprise developers to access the API Center portal 
 
 Developers can follow these steps to connect and sign in to view an API Center portal using the Visual Studio Code extension. Settings to connect to the API center need to be provided by the API center administrator.

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

@@ -11,8 +11,6 @@ ms.author: danlep
 ms.custom: Include file
 ---
 
-## Create Microsoft Entra app registration
-
 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.
 
 1. In the [Azure portal](https://portal.azure.com), navigate to **Microsoft Entra ID** > **App registrations**.
@@ -24,5 +22,13 @@ First configure an app registration in your Microsoft Entra ID tenant. The app r
     1. In **Redirect URI**, select **Single-page application (SPA)** and set the URI. 
         Enter the URI of your API Center portal deployment, in the following form: `https://<service-name>.portal.<location>.azure-api-center.ms`. Replace `<service name>` and `<location>` with the name of your API center and the location where it's deployed, Example: `https://myapicenter.portal.eastus.azure-api-center.ms`.
     1. Select **Register**.
-    1. On the **Manage** > **Authentication** page, Select **Add a platform** and select **Mobile and desktop applications**. 
-    1. Configure the following three custom redirect URIs: `https://vscode.dev/redirect`, `http://localhost`, and `ms-appx-web://Microsoft.AAD.BrokerPlugin/<application-client-id>`. Replace `<application-client-id>` with the application (client) ID of this app. You can find this value on the **Overview** page. 
+
+When enabling the API Center portal in the Visual Studio Code extension for API Center, also configure the following redirect URIs. 
+
+1. On the **Manage** > **Authentication** page, Select **Add a platform** and select **Mobile and desktop applications**. 
+1. Configure the following three custom redirect URIs:<br/>
+    `https://vscode.dev/redirect`<br/>
+    `http://localhost`<br/>
+    `ms-appx-web://Microsoft.AAD.BrokerPlugin/<application-client-id>`<br/>
+    
+    Replace `<application-client-id>` with the application (client) ID of this app. You can find this value on the **Overview** page. 

articles/api-center/includes/api-center-portal-user-sign-in.md

@@ -11,9 +11,7 @@ ms.author: danlep
 ms.custom: Include file
 ---
 
-## Enable sign-in to portal by Microsoft Entra users and groups 
-
-Users must sign in to see the APIs in your API center. To enable sign-in, assign the **Azure API Center Data Reader** role to users or groups in your organization, scoped to your API center.
+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 don't have access to APIs in the API Center portal. Be sure to assign the **Azure API Center Data Reader** role to yourself and other administrators.  

articles/api-center/self-host-api-center-portal.md

@@ -39,6 +39,8 @@ The API Center portal reference implementation provides:
     * [Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
     * [Vite package](https://www.npmjs.com/package/vite)
 
+## Create Microsoft Entra app registration
+
 [!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
 
 > [!NOTE]
@@ -100,6 +102,9 @@ Follow these steps to build and test the API Center portal locally.
 
 For steps to deploy the portal to Azure Static Web Apps, see the [API Center portal starter](https://github.com/Azure/APICenter-Portal-Starter.git) repository.
 
+## Enable sign-in to portal by Microsoft Entra users and groups 
+
+
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
 ## Troubleshooting

articles/api-center/set-up-api-center-portal.md

@@ -22,8 +22,11 @@ This article shows you how to set up the *API Center portal* (preview), an Azure
 > [!TIP]
 > Both Azure API Management and Azure API Center provide API portal experiences for developers. [Compare the portals](#api-management-and-api-center-portals)
 
+
 [!INCLUDE [api-center-portal-prerequisites](includes/api-center-portal-prerequisites.md)]
 
+## Create Microsoft Entra app registration
+
 [!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
 
 ## Configure and publish the API Center portal
@@ -53,6 +56,8 @@ To make only specific APIs visible, go to the **API visibility** tab in the API
 
 :::image type="content" source="media/set-up-api-center-portal/add-visibility-condition.png" alt-text="Screenshot of adding API visibility conditions in the portal.":::
 
+## Enable sign-in to portal by Microsoft Entra users and groups 
+
 [!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
 
 [!INCLUDE [api-center-portal-compare-apim-dev-portal](includes/api-center-portal-compare-apim-dev-portal.md)]