Skip to content

Commit 3a1c3df

Browse files
author
gitName
committed
[APIC] Appreg headings and steps
1 parent 71d027d commit 3a1c3df

File tree

4 files changed

+21
-7
lines changed

4 files changed

+21
-7
lines changed

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

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,6 @@ ms.author: danlep
1111
ms.custom: Include file
1212
---
1313

14-
## Create Microsoft Entra app registration
15-
1614
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.
1715

1816
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
2422
1. In **Redirect URI**, select **Single-page application (SPA)** and set the URI.
2523
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`.
2624
1. Select **Register**.
27-
1. On the **Manage** > **Authentication** page, Select **Add a platform** and select **Mobile and desktop applications**.
28-
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.
25+
26+
When enabling the API Center portal in the Visual Studio Code extension for API Center, also configure the following redirect URIs.
27+
28+
1. On the **Manage** > **Authentication** page, Select **Add a platform** and select **Mobile and desktop applications**.
29+
1. Configure the following three custom redirect URIs:<br/>
30+
`https://vscode.dev/redirect`<br/>
31+
`http://localhost`<br/>
32+
`ms-appx-web://Microsoft.AAD.BrokerPlugin/<application-client-id>`<br/>
33+
34+
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

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,7 @@ ms.author: danlep
1111
ms.custom: Include file
1212
---
1313

14-
## Enable sign-in to portal by Microsoft Entra users and groups
15-
16-
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.
14+
To enable sign-in, assign the **Azure API Center Data Reader** role to users or groups in your organization, scoped to your API center.
1715

1816
> [!IMPORTANT]
1917
> 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

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,8 @@ The API Center portal reference implementation provides:
3939
* [Node.js and npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
4040
* [Vite package](https://www.npmjs.com/package/vite)
4141

42+
### Create Microsoft Entra app registration
43+
4244
[!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
4345

4446
> [!NOTE]
@@ -100,6 +102,9 @@ Follow these steps to build and test the API Center portal locally.
100102
101103
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.
102104
105+
## Enable sign-in to portal by Microsoft Entra users and groups
106+
107+
103108
[!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
104109
105110
## Troubleshooting

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

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,11 @@ This article shows you how to set up the *API Center portal* (preview), an Azure
2222
> [!TIP]
2323
> Both Azure API Management and Azure API Center provide API portal experiences for developers. [Compare the portals](#api-management-and-api-center-portals)
2424
25+
2526
[!INCLUDE [api-center-portal-prerequisites](includes/api-center-portal-prerequisites.md)]
2627

28+
## Create Microsoft Entra app registration
29+
2730
[!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
2831

2932
## 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
5356

5457
:::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.":::
5558

59+
## Enable sign-in to portal by Microsoft Entra users and groups
60+
5661
[!INCLUDE [api-center-portal-user-sign-in](includes/api-center-portal-user-sign-in.md)]
5762

5863
[!INCLUDE [api-center-portal-compare-apim-dev-portal](includes/api-center-portal-compare-apim-dev-portal.md)]

0 commit comments

Comments
 (0)