SSO for Entra ID

The login button will not be displayed until the plugin has been fully configured.

Make sure that the following options are configured and valid inside the plugin’s settings (Settings -> SSO for Entra ID): 1. Application (client) ID 2. Client secret 3. Directory (tenant) ID

The plugin will look for a user whose email address is the same as their email address on Entra ID. If the user does not have an email address, the plugin will attempt to match based on the User Principal Name (UPN) instead.

For example, when the user whose mailbox is user@example.com logs in to the site, the plugin will look for a user with the email address user@example.com .

The behavior for this case is configurable.

In the “Login options” section of the plugin’s settings (Settings -> SSO for Entra ID), there is an option named “Create new users if they don’t already exist”.

If it is enabled, when a user logs in and the plugin cannot find the corresponding site user, a new one will be created. By default, the user will be created with the same role as new site signups. This can be changed in the “Role for new profiles”.

The plugin can also automatically fill the user’s name on the new account by enabling the “Generate user profiles automatically” option.

The plugin will set the user’s username to be their email address. Alternatively, the email domain can be removed ( user@example.com -> user ) by enabling the “Create usernames without domain name” option. Warning : if multiple users have the same name but different domain names ( user@1.example.com and user@2.example.com ) enabling this option may cause conflicts.

If it is disabled, when a user logs in and the plugin cannot find the corresponding site user, the following error message will be displayed: “Your account has not been registered on this site. Please contact your administrator.”

To add the site administration panel to the Azure application list, copy the “Homepage/Login URL” displayed in the “Endpoints” section of the plugin’s settings (Settings -> SSO for Entra ID).

This URL must be pasted in the “Home page URL” field in the “Branding” section of your app registration on the Entra ID portal.

In some cases, Azure may reject the callback URL provided by the plugin with the error “URL may not contain a query string”.

In this case, URL rewrites are required. In the plugin settings page, enable “Use rewrites” and save.

The callback and login/homepage URLs listed in the plugin settings will change. These new URLs do not contain a query string and should therefore work.

Warning : if you had previously referenced the callback URL with a query string, those references must be changed to the new value displayed in the plugin settings.