Skip to content

Commit 1436a66

Browse files
committed
v2 tiers not supported
1 parent f3bfc43 commit 1436a66

File tree

1 file changed

+11
-9
lines changed

1 file changed

+11
-9
lines changed

articles/api-management/developer-portal-wordpress-plugin.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66
ms.service: api-management
77
ms.custom:
88
ms.topic: how-to
9-
ms.date: 07/09/2024
9+
ms.date: 07/15/2024
1010
ms.author: danlep
1111
---
1212

@@ -20,12 +20,14 @@ In this article, you create a WordPress site on Azure App Service and configure
2020

2121
## Prerequisites
2222

23-
* An API Management instance. If needed, [create an instance](get-started-create-service-instance.md). The developer portal is available in all tiers except the Consumption tier.
23+
* An API Management instance. If needed, [create an instance](get-started-create-service-instance.md).
24+
> [!NOTE]
25+
> Currently, the plugin isn't supported in the API Management v2 tiers.
2426
* Enable and publish the developer portal. For steps, see [Tutorial: Access and customize the developer portal](api-management-howto-developer-portal-customize.md).
2527
* Permissions to create an app registration in a Microsoft Entra tenant associated with your Azure subscription.
2628
* Installation files for the developer portal WordPress plugin and customized WordPress theme from the [plugin repo](https://aka.ms/apim/wpplugin). Download the following zip files from the [dist](https://github.com/Azure/AzureAPIM-Wordpress-plugin/tree/main/dist) folder in the repo:
2729
* `apim-devportal.zip` - Plugin file
28-
* `twentytwentyfour.1.1.zip` - Theme file
30+
* `twentytwentyfour.zip` - Theme file
2931

3032
## Step 1: Create WordPress on App Service
3133

@@ -98,7 +100,7 @@ In this step, create a new Microsoft Entra app. In later steps, you configure th
98100
1. Enter the **Application (client) Id** and **Client secret** from the app registration that you created in the previous step.
99101
1. In **Issuer URL**, enter a value appropriate for the authentication endpoint of your Azure environment, such as `https://login.microsoftonline.com/<tenant-id>/v2.0` for global Azure. Replace `<tenant-id>` with the **Directory (tenant) Id** from the app registration.
100102
1. In **Allowed token audiences**, enter the **Application ID URI** from the app registration. Example: `api://<app-id>`.
101-
1. Under **Additional checks**:
103+
1. Under **Additional checks**, select values appropriate for your environment, for example:
102104
1. In **Client application requirement**, select **Allow requests from specific client applications**.
103105
1. In **Tenant requirement**, select **Use default restrictions based on issuer**.
104106
1. Accept the default values for the remaining settings and select **Add**.
@@ -112,11 +114,11 @@ Configure the same Microsoft Entra app registration as an identity provider for
112114
1. In the [portal](https://portal.azure.com), navigate to your API Management instance.
113115
1. In the left menu, under **Developer portal**, select **Identities** > **+ Add**.
114116
1. On the **Add identity provider** page, select **Azure Active Directory** (Microsoft Entra ID).
115-
1. Enter the **Client Id**, **Client secret**, and **Signin tenant** values from the app registration you created in a previous step.
117+
1. Enter the **Client Id**, **Client secret**, and **Signin tenant** values from the app registration that you created in a previous step.
116118
1. In **Client library**, select **MSAL**.
117119
1. Accept default values for the remaining settings and select **Add**.
118120
1. [Republish the developer portal](developer-portal-overview.md#publish-the-portal) to apply the changes.
119-
1. Test the authentication by signing into the developer portal at the following URL, substituting the name of your API Management instance: `https://<apim-instance-name>.developer.azure-api.net/signin`. Select the **Azure Active Directory** (Microsoft Entra ID) button to sign in.
121+
1. Test the authentication by signing into the developer portal at the following URL, substituting the name of your API Management instance: `https://<apim-instance-name>.developer.azure-api.net/signin`. Select the **Azure Active Directory** (Microsoft Entra ID) button at the bottom to sign in.
120122

121123
When you open it for the first time, you're prompted to consent to specific permissions.
122124

@@ -127,10 +129,11 @@ Configure the same Microsoft Entra app registration as an identity provider for
127129

128130
When you open it for the first time, you're prompted to consent to specific permissions.
129131

130-
1. Sign into the WordPress admin site using the username and password you entered while creating WordPress on App Service.
132+
1. Sign into the WordPress admin site using the username and password that you entered while creating WordPress on App Service.
131133
1. In the left menu, select **Appearance** > **Themes** and then **Add New Theme**.
132-
1. Select **Upload Theme**. Select **Choose File** to upload the API Management developer portal theme zip file (`twentytwentyfour.1.1.zip`) that you downloaded previously. Select **Install Now**.
134+
1. Select **Upload Theme**. Select **Choose File** to upload the API Management developer portal theme zip file that you downloaded previously. Select **Install Now**.
133135
1. In the next screen, select **Replace active with uploaded**.
136+
1. Select **Activate**.
134137

135138
## Step 6: Install the developer portal plugin
136139

@@ -289,6 +292,5 @@ The following screenshot shows a sample page of the API Management developer por
289292
## Related content
290293

291294
- [Create a WordPress site on Azure App Service](../app-service/quickstart-wordpress.md)
292-
- [WordPress on Linux App Service repo](https://github.com/Azure/wordpress-linux-appservice)
293295
- [Customize the developer portal](api-management-howto-developer-portal-customize.md)
294296
- [Authorize developer accounts by using Microsoft Entra ID in Azure API Management](api-management-howto-aad.md).

0 commit comments

Comments
 (0)