Skip to content

Commit 387c04e

Browse files
committed
[APIC] Updated APIC portal config
1 parent b70da12 commit 387c04e

16 files changed

Lines changed: 93 additions & 120 deletions

articles/api-center/TOC.yml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -86,10 +86,8 @@
8686
href: set-up-notification-workflow.md
8787
- name: API discovery and consumption
8888
items:
89-
- name: Enable API Center portal
89+
- name: Enable and customize API Center portal
9090
href: set-up-api-center-portal.md
91-
- name: Customize API Center portal
92-
href: customize-api-center-portal.md
9391
- name: Enable API Center portal view - VS Code extension
9492
href: enable-api-center-portal-vs-code-extension.md
9593
- name: Self-host Azure API Center portal

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

Lines changed: 0 additions & 89 deletions
This file was deleted.

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

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,31 +6,34 @@ services: api-center
66

77
ms.service: azure-api-center
88
ms.topic: include
9-
ms.date: 08/08/2025
9+
ms.date: 02/25/2026
1010

1111
ms.custom: Include file
1212
---
1313

14-
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.
14+
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.
1515

1616
API Center can set up the app registration automatically, or you can create the app registration manually.
1717

18-
#### Set up the app registration automatically
18+
#### Set up the app registration automatically (recommended)
1919

2020
To set up the app registration automatically, follow these steps:
2121

22-
1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
23-
1. In the left-hand menu, select **API Center portal** > **Settings**.
24-
1. On the **Identity provider** tab, select **Start set up**.
25-
1. On the **Quick setup** tab, select **Save + publish**.
22+
1. In the [Azure portal](https://portal.azure.com), go to your API center.
23+
1. In the sidebar menu, select **API Center portal** > **Settings**.
24+
1. On the **Access** tab, select **Configure Entra ID**.
25+
:::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.":::
26+
27+
1. On the **Set up user sign-in with Microsoft Entra ID** page, select **Configure**.
28+
1. On the **Access** tab, select **Save + publish**.
2629

2730
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**.
2831

2932
#### Set up the app registration manually
3033

3134
If you want to create the app registration manually, follow these steps:
3235

33-
1. In the [Azure portal](https://portal.azure.com), navigate to **Microsoft Entra ID** > **Manage** > **App registrations**.
36+
1. In the [Azure portal](https://portal.azure.com), go to **Microsoft Entra ID** > **Manage** > **App registrations**.
3437
1. Select **+ New registration**.
3538
1. On the **Register an application** page, set the values as follows:
3639

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: api-center
66

77
ms.service: azure-api-center
88
ms.topic: include
9-
ms.date: 03/04/2025
9+
ms.date: 02/25/2026
1010

1111
ms.custom: Include file
1212
---

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,16 @@ services: api-center
66

77
ms.service: azure-api-center
88
ms.topic: include
9-
ms.date: 08/05/2025
9+
ms.date: 02/25/2026
1010

1111
ms.custom: Include file
1212
---
1313

1414
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.
1515

1616
> [!IMPORTANT]
17-
> 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.
17+
> * The API center owner is automatically assigned the **Azure API Center Data Reader** role when Microsoft Entra ID is configured for the portal.
18+
> * Be sure to assign the **Azure API Center Data Reader** role to other administrators.
1819
1920
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:
2021

Binary file not shown.
Binary file not shown.
60.4 KB
Loading
58.2 KB
Loading
58.2 KB
Loading

0 commit comments

Comments
 (0)