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-management/developer-portal-wordpress-plugin.md
+11-9Lines changed: 11 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ author: dlepow
6
6
ms.service: api-management
7
7
ms.custom:
8
8
ms.topic: how-to
9
-
ms.date: 07/09/2024
9
+
ms.date: 07/15/2024
10
10
ms.author: danlep
11
11
---
12
12
@@ -20,12 +20,14 @@ In this article, you create a WordPress site on Azure App Service and configure
20
20
21
21
## Prerequisites
22
22
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.
24
26
* Enable and publish the developer portal. For steps, see [Tutorial: Access and customize the developer portal](api-management-howto-developer-portal-customize.md).
25
27
* Permissions to create an app registration in a Microsoft Entra tenant associated with your Azure subscription.
26
28
* 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:
27
29
*`apim-devportal.zip` - Plugin file
28
-
*`twentytwentyfour.1.1.zip` - Theme file
30
+
*`twentytwentyfour.zip` - Theme file
29
31
30
32
## Step 1: Create WordPress on App Service
31
33
@@ -98,7 +100,7 @@ In this step, create a new Microsoft Entra app. In later steps, you configure th
98
100
1. Enter the **Application (client) Id** and **Client secret** from the app registration that you created in the previous step.
99
101
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.
100
102
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:
102
104
1. In **Client application requirement**, select **Allow requests from specific client applications**.
103
105
1. In **Tenant requirement**, select **Use default restrictions based on issuer**.
104
106
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
112
114
1. In the [portal](https://portal.azure.com), navigate to your API Management instance.
113
115
1. In the left menu, under **Developer portal**, select **Identities** > **+ Add**.
114
116
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.
116
118
1. In **Client library**, select **MSAL**.
117
119
1. Accept default values for the remaining settings and select **Add**.
118
120
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.
120
122
121
123
When you open it for the first time, you're prompted to consent to specific permissions.
122
124
@@ -127,10 +129,11 @@ Configure the same Microsoft Entra app registration as an identity provider for
127
129
128
130
When you open it for the first time, you're prompted to consent to specific permissions.
129
131
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.
131
133
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**.
133
135
1. In the next screen, select **Replace active with uploaded**.
136
+
1. Select **Activate**.
134
137
135
138
## Step 6: Install the developer portal plugin
136
139
@@ -289,6 +292,5 @@ The following screenshot shows a sample page of the API Management developer por
289
292
## Related content
290
293
291
294
- [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)
293
295
- [Customize the developer portal](api-management-howto-developer-portal-customize.md)
294
296
- [Authorize developer accounts by using Microsoft Entra ID in Azure API Management](api-management-howto-aad.md).
0 commit comments