Skip to content

Commit ca89c1d

Browse files
author
gitName
committed
edits
1 parent 2bc3393 commit ca89c1d

File tree

1 file changed

+11
-7
lines changed

1 file changed

+11
-7
lines changed

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

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -37,20 +37,21 @@ After creating the API Center portal app registration, you can customize setting
3737

3838
1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
3939
1. In the left menu, under **API Center portal**, select **Settings**.
40+
4041
:::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. 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. 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, and you can continue to settings on other tabs.
4243
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**.
44+
1. Confirm that the **Redirect URI** is the value you configured in the app registration.
45+
1. Select **Save + publish**.
4546
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**.
4647
1. On the **API visibility** tab, optionally configure filters for APIs that you want to make discoverable in the portal. Select **Save + publish**. [Learn more about API visibility](#api-visibility)
4748
1. On the **Semantic search**, optionally enable [semantic search](#search-with-ai) to enhance API discovery in the portal. Select **Save + publish**.
48-
1. On the **Metadata** tab, optionally select custom metadata properties that you want to expose in API details and make searchable in the API Center portal. Select **Save**.
49+
1. On the **Metadata** tab, optionally select custom metadata properties that you want to expose in API details and make available for semantic search. Select **Save**.
4950
1. Select **Save + publish**.
5051

5152
## Access the portal
5253

53-
After publishing, you can now access the API Center portal:
54+
After publishing, you can now access the API Center portal in your browser.
5455

5556
* On the portal's **Settings** page, select **View API Center portal** to open the portal in a new tab.
5657
* 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/>
@@ -60,15 +61,18 @@ By default, the portal home page is reachable publicly but requires sign-in to a
6061

6162
## API visibility
6263

63-
API visibility settings control which APIs are discoverable (visible) to API Center portal users. The API Center portal uses the [Azure API Center data plane API](/rest/api/dataplane/apicenter/operation-groups) to retrieve and display APIs, and by default retrieves all APIs in your API center for signed-in users with Azure RBAC permissions. Visibility settings apply to all users of the API Center portal.
64+
API visibility settings control which APIs are discoverable (visible) to API Center portal users. The API Center portal uses the [Azure API Center data plane API](/rest/api/dataplane/apicenter/operation-groups) to retrieve and display APIs in your API center, and by default shows all APIs for signed-in users with Azure RBAC permissions. Visibility settings apply to all users of the API Center portal.
6465

6566
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 properties. For instance, choose to display APIs only of certain types (like REST or GraphQL) or based on certain specification formats (such as OpenAPI).
6667

6768
:::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.":::
6869

6970
### Anonymous access
7071

71-
Optionally enable anonymous read access to the API Center's APIs, allowing unauthenticated users to discover the API inventory by direct calls to the API Center data plane API. For example, enable this setting to make APIs and MCP servers in your API center discoverable to unauthenticated users when you [self-host](self-host-api-center-portal.md) the API Center portal.
72+
Optionally enable anonymous read access to the API Center's APIs, which allows unauthenticated users to discover the API inventory by direct calls to the API Center data plane API. For example, enable this setting to make APIs discoverable to unauthenticated users when you [self-host](self-host-api-center-portal.md) the API Center portal.
73+
74+
> [!CAUTION]
75+
> When enabling anonymous access, take care not to expose sensitive information in API definitions or settings.
7276
7377
## Enable sign-in to portal by Microsoft Entra users and groups
7478

0 commit comments

Comments
 (0)