Support for multitenant apps

Use this guide, if you want to configure support for the multi-tenancy capability of Azure Active Directory applications and enable it for the WordPress + Office 365 plugin. You can use the multi-tenancy capability of Azure AD to allow accounts from one, some or all Microsoft Azure AD tenants to access your WordPress website.

Before you start

You are fully aware of the risks involved and that misconfiguration can lead to full account take-over.
You have purchased the premium extension WPO365 | LOGIN+ to be able to support the Azure AD multitenancy feature (or any of the bundles WPO365 | CUSTOMERS, WPO365 | SYNC or WPO365 | INTRANET).
You are fully aware of the consequences of allowing users in any Azure AD tenant to sign in to your application after consenting to use their account with your application.
You have understand the difference between Azure Active Directory Guest users and users from another organizational directory (see https://www.wpo365.com/guest-users-or-multi-tenant/ for details).
You must already have configured the single sign-on capability of the WordPress + Office 365 plugin.
You are a Global Administrator for your company’s Office 365 tenant / Azure AD directory (or have at least the ability to edit the Azure Active Directory App registration that was created previously when the single sign-on capability was configured).
You are an Administrator for your WordPress website.

App registration

In Azure Portal click the 'hamburger' (icon with three horizontal lines in the upper corner) to open the menu.
Navigate to Azure Active Directory > App registrations.
Select the App registration that you created when you configured the single sign-on capability of the plugin.

Authentication

Click Authentication from the 'App registration' menu on the left.
Scroll down to Supported account types.
Check Accounts in any organizational directory (Any Azure AD directory - Multitenant).
Click Save.

Please note If you'd like to add users with personal Microsoft accounts e.g. Outlook, Skype, Xbox you need to manually update the manifest as explained on the page..

Plugin configuration

Perform the following steps to configure WPO365 to allow users from other tenants to sign into your WordPress website with their Microsoft account.

Single Sign-on

Navigate to WP Admin > WPO365 > Single Sign-on.
Select the option Hybrid flow from the dropdown list Select OpenID Connect flow.
Check the option Allow users from other tenants.
Optionally, if you would like to synchronize user attributes e.g. companyName or the user's profile picture you should add Multi-tenant API Permissions. Perform the following steps to accomplish this:
- Add https://graph.microsoft.com/User.Read to the list of Multi-tenant API Permissions.
- Click + to add the permission to the list

Scroll down and click Save configuration.

Please note Adding permissions to the list here will require users from the other domain to grant their consent. Alternatively, a (global) administrator can grant consent on behalf of all users for the other domain, as shown in the example below.

User registration

You can restrict access to your website to users coming from selected tenants and / or domains.

Important Make sure that you have selected the Hybrid flow from the Select OpenID Connect flow dropdown list on the plugin's Single Sign-on page or else the following restrictions may fail to work as expected

Navigate to WP Admin > WPO365 > User registration.
Restrict access to users from specific domains only by adding domains those domains to the list of Allowed (login) domains (see https://docs.wpo365.com/article/43-domain-whitelist for details).
Restrict access to users from specific tenants only by adding those Tenant Directory IDs to the list of Allowed "other" tenants (see https://docs.wpo365.com/article/205-allowed-other-tenants for details).

Authorization for users from "other" tenants

Please note If an individual user (or an administrator on behalf of all users) already granted consent using the method explained before in the paragraph User registration then authorization is already given and you can skip this paragraph

For the plugin to be able to retrieve information about a user from another tenant e.g. the user's companyName or profile image, it must be able to request access tokens from that user's (Azure AD) tenant. By default, the plugin is capable of requesting information from another tenant if multi-tenancy is configured according to the steps outlined in this article. However, before the plugin successfully can request data, an administrator of the other tenant must have granted permissions to the Enterprise Application that will be automatically created in the other tenant's Azure AD as soon as a first user of that other tenant successfully signs in with your multi-tenanted App registration.

Perform the following steps to find the Enterprise Application in another tenant's Azure AD.

As an administrator of another tenant with sufficient privileges first navigate to Azure Portal Azure Active Directory Enterprise applications.
From the drop down list Application type be sure to select All applications and then search for the Application (client) ID that was assigned to the App registration for the WordPress website in the home tenant.
Click on the name to load the Overview page of the Enterprise application.
Continue to the Permissions page (in the Security section) and click Grant consent for ...

Only when an administrator of another tenant has granted consent will the plugin be able to request access tokens for users of another tenant.

Please note Bear in mind that many administrators have locked down their Azure AD and the ability for users to add third party applications. Therefore it is recommended that users from other tenants are made aware of the fact that they may not be able to sign into your application after all and if that is the case that they should get in contact with their global tenant administrator..

Synchronize user attributes

Please consult the following guide if you wish to synchronize user profile fields from Azure AD to WordPress.

Please note Ensure that you have added at least https://graph.microsoft.com/User.Read to the list of Multi-tenant API Permissions as explained in the paragraph Plugin configuration.

Test and Troubleshoot

To test your multitenant app you can log on with a (test) user that is a member of a different Azure AD tenant.

Enable the plugin's Debug log (see https://docs.wpo365.com/article/19-enable-debug-log).
Navigate to the plugin's wizard WP Admin > WPO365 > ... > Debug.
Check Log ID token.
Now try to sign in again with the (test) user that is a member of a different Azure AD tenant.
Navigate back to WP Admin > WPO365 > ... > Debug and click Show all.
Search for the ID token in the log and check to see if it is complete.