Skip to content

Commit 78a671b

Browse files
author
gitName
committed
[APIC] Anonymous access
1 parent 12b0fc8 commit 78a671b

File tree

2 files changed

+25
-15
lines changed

2 files changed

+25
-15
lines changed

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,18 +22,18 @@ To set up the app registration automatically, follow these steps:
2222
1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
2323
1. In the left-hand menu, select **API Center portal** > **Settings**.
2424
1. On the **Identity provider** tab, select **Start set up**.
25-
1. Select **Save + publish**.
25+
1. On the **Quick setup** tab, select **Save + publish**.
2626

2727
#### Set up the app registration manually
2828

2929
If you want to create the app registration manually, follow these steps:
3030

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

3535
1. Set **Name** to a meaningful name such as *api-center-portal*
36-
1. Under **Supported account types**, select **Accounts in this organizational directory (Single tenant)**.
36+
1. Under **Supported account types**, select **Accounts in this organizational directory only (\<Directory name> - Single tenant)**.
3737
1. In **Redirect URI**, select **Single-page application (SPA)** and set the URI.
3838
Enter the URI of your API Center portal deployment, in the following form: `https://<service-name>.portal.<location>.azure-apicenter.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-apicenter.ms`.
3939
1. Select **Register**.

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

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: How to set up the API Center portal, a managed website that enables
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 04/30/2025
7+
ms.date: 07/31/2025
88
ms.update-cycle: 180-days
99
ms.author: danlep
1010
ms.custom:
@@ -31,30 +31,40 @@ This article shows you how to set up the *API Center portal* (preview), an Azure
3131

3232
[!INCLUDE [api-center-portal-app-registration](includes/api-center-portal-app-registration.md)]
3333

34-
## Configure and publish the API Center portal
34+
## Customize and publish the API Center portal
3535

36-
After you create the API Center portal app registration, you need to configure and publish the API center portal. Complete the following steps in the Azure portal.
36+
After you create the API Center portal app registration, you need to configure and publish the API Center portal. Complete the following steps in the Azure portal.
3737

3838
1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
39-
1. In the left menu, under **API Center portal**, select **Portal settings**.
39+
1. In the left menu, under **API Center portal**, select **Settings**.
4040
:::image type="content" source="media/set-up-api-center-portal/configure-portal-settings.png" alt-text="Screenshot of API Center portal settings in the Azure portal." lightbox="media/set-up-api-center-portal/configure-portal-settings.png":::
41-
1. On the **Identity provider** tab, select **Start set up**. On the screen that appears, do the following:
42-
1. In **Client ID**, enter the **Application (client) ID** from the app registration you created in the previous section.
43-
1. Confirm that the **Redirect URI** is the value you configured in the app registration.
44-
1. Select **Save + publish**.
41+
1. If you set up an app registration manually, on the **Identity provider** tab, select **Start set up**. If you used the quick setup, this step is already complete.
42+
1. On the **Manual** tab, in **Client ID**, enter the **Application (client) ID** from the app registration you created in the previous section.
43+
3. Confirm that the **Redirect URI** is the value you configured in the app registration.
44+
4. Select **Save + publish**.
4545
1. On the **Site profile** tab, enter a website name that you want to appear in the top bar of the API Center portal. Select **Save + publish**.
46-
1. On the **API visibility** tab, optionally add filters for APIs that you want to make discoverable in the portal. Select **Save + publish**. [Learn more about API visibility](#api-visibility)
46+
1. On the **API visibility** tab, optionally enable anonymous read access to the portal and add filters for APIs that you want to make discoverable in the portal. Select **Save + publish**. [Learn more about API visibility](#api-visibility)
4747

4848
You can now access the API Center portal:
49-
* On the **Portal settings** page, select **View API Center portal** to open the portal in a new tab.
49+
* On the portal's **Settings** page, select **View API Center portal** to open the portal in a new tab.
5050
* Or, enter the following URL in your browser, replacing `<service-name>` and `<location>` with the name of your API center and the location where it's deployed:<br/>
5151
`https://<service-name>.portal.<location>.azure-apicenter.ms`
5252

5353
### API visibility
5454

55-
API visibility settings control which APIs are discoverable (visible) to API Center portal users. The API Center portal uses the data plane API to retrieve and display APIs, and by default retrieves all APIs in your API center. Visibility settings apply to all users of the API Center portal.
55+
Settings on the **API visibility** control which APIs are discoverable (visible) to API Center portal users. The API Center portal uses the data plane API to retrieve and display APIs, and by default retrieves all APIs in your API center for [signed-in users](#enable-sign-in-to-portal-by-microsoft-entra-users-and-groups). Visibility settings apply to all users of the API Center portal.
5656

57-
To make only specific APIs visible, go to the **API visibility** tab in the API Center portal settings. Here, add filter conditions for APIs based on built-in or custom API [metadata](metadata.md) properties. For instance, you can choose to display APIs only of certain types (like REST or GraphQL) or based on certain specification formats (such as OpenAPI). Additionally, you can select values of custom metadata properties that categorize your APIs.
57+
#### Anonymous access
58+
59+
Optionally enable anonymous read access to the API Center portal, allowing unauthenticated users to discover the APIs. This setting is useful for public APIs or MCP servers.
60+
61+
> [!CAUTION]
62+
> Enabling anonymous access makes your APIs visible to anyone on the internet. However, users must still sign in to the portal to try out APIs or view API details. If you enable anonymous access, consider adding filters to limit the APIs that are discoverable by unauthenticated users.
63+
64+
65+
#### Filter APIs by metadata
66+
67+
To make only specific APIs visible, add filter conditions for APIs based on built-in or custom API [metadata](metadata.md) properties. For instance, you can choose to display APIs only of certain types (like REST or GraphQL) or based on certain specification formats (such as OpenAPI). Additionally, you can select values of custom metadata properties that categorize your APIs.
5868

5969
:::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.":::.
6070

0 commit comments

Comments
 (0)