Configure Entra ID
Set up Microsoft Entra ID (formerly Azure AD) as your identity provider.
Before you start, find your callback URL on the Configure SSO page: {gatewayUrl}/api/auth/callback/azure-ad.
Register an app in Entra
- In the Microsoft Entra admin center (or the Azure Portal), go to App registrations → New registration
- Enter a name (e.g. "Willow Integration")
- Under Supported account types, select Accounts in this organizational directory only (Single tenant)
- Add a Redirect URI (web):
{gatewayUrl}/api/auth/callback/azure-ad - Select Register, then copy the Application (client) ID and Directory (tenant) ID
- Go to Certificates & secrets and create a Client secret and copy the value immediately
- Go to API permissions and add these Microsoft Graph delegated permissions:
openid,profile, andemail. Addoffline_accessas well if you turn on Enable passthrough refresh token in Willow. Then grant admin consent for them.
The Entra provider dialog in Willow lists the same permissions beneath the Callback URL.
Add the required API permissions
Willow signs users in with the openid, profile, and email scopes. Grant them on the app registration:
- Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions
- Select
openid,profile, andemail. KeepUser.Read, which Entra adds by default - If you plan to turn on Enable passthrough refresh token in Willow, also select
offline_access. Without consent for it, sign-in fails once the toggle is on - Select Grant admin consent for <your tenant>
Willow doesn't need a groups claim in the token. Users and groups sync through SCIM Provisioning.
For more details, see Microsoft's guide to registering an application in the Microsoft identity platform.
Finish in Willow
- Go to Admin → Settings → Authentication Settings
- On the SSO Provider card, select Edit
- Select Provider: Entra
- Enter the Client ID, Client Secret, and tenantId
- Select Save
