You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/api-center/set-up-api-center-portal.md
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,20 +37,21 @@ After creating the API Center portal app registration, you can customize setting
37
37
38
38
1. In the [Azure portal](https://portal.azure.com), navigate to your API center.
39
39
1. In the left menu, under **API Center portal**, select **Settings**.
40
+
40
41
:::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.
42
43
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**.
45
46
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
47
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)
47
48
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**.
49
50
1. Select **Save + publish**.
50
51
51
52
## Access the portal
52
53
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.
54
55
55
56
* On the portal's **Settings** page, select **View API Center portal** to open the portal in a new tab.
56
57
* 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
60
61
61
62
## API visibility
62
63
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.
64
65
65
66
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).
66
67
67
68
:::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.":::
68
69
69
70
### Anonymous access
70
71
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.
72
76
73
77
## Enable sign-in to portal by Microsoft Entra users and groups
0 commit comments