Supported capabilities and licensing
- Protocol: OpenID Connect (OIDC) and OAuth 2.0 authorization code flow on the Microsoft identity platform v2.0 endpoint.
- Supported accounts: Multitenant Microsoft Entra ID work or school accounts and personal Microsoft accounts.
- Availability and licensing: Included in every ClearPolicy trial and standard subscription ($29/month per organization). No separate SSO add-on or enterprise plan is required.
- Not included in this integration: SAML 2.0 and SCIM user provisioning are not used by Microsoft sign-in. To sync people from your Microsoft directory into ClearPolicy, see Microsoft Entra directory sync.
Roles and permissions
Most team members can sign in with Microsoft without IT configuration. If your Microsoft Entra tenant restricts user consent for third-party applications, a Microsoft administrator—such as a Cloud Application Administrator, Application Administrator, or Global Administrator—must approve ClearPolicy for your tenant. ClearPolicy requests only the following delegated permissions for sign-in:
These permissions do not grant access to other users in your directory, OneDrive files, or mailboxes.
Set up and test with a pilot team member
Sign in or create a new ClearPolicy account
- Open app.clearpolicy.app/login (or app.clearpolicy.app/register to start a new trial).
- Click Microsoft.
- Sign in with your Microsoft Entra ID work or school account.
- Review and approve the requested permissions (or complete your organization’s Microsoft admin approval workflow if prompted).
- Confirm that you arrive in your ClearPolicy organization dashboard.
Connect Microsoft to an existing ClearPolicy account
- Sign in to ClearPolicy with your current sign-in method.
- Open Settings → Account → Profile.
- Under Sign-in providers, find Microsoft and click Connect.
- Complete the Microsoft sign-in prompt and return to ClearPolicy.
- Sign out, then return to app.clearpolicy.app/login and click Microsoft to verify your pilot sign-in works end to end.
Add ClearPolicy from the Microsoft Entra admin center
If your IT team prefers to pre-approve ClearPolicy for your organization before team members sign in:- Sign in to the Microsoft Entra admin center as an administrator.
- Add ClearPolicy to your tenant’s enterprise applications and grant tenant-wide admin consent for the delegated permissions listed above if your consent policy requires it.
- Have a pilot team member sign in at app.clearpolicy.app/login using Microsoft to verify access.
Microsoft sign-in, OneDrive, and directory sync
ClearPolicy keeps Microsoft connections separate so your organization only grants what it needs:- Microsoft sign-in (this page): Lets individual team members sign in to ClearPolicy.
- Microsoft OneDrive: Lets a team member import Word documents and PDFs from OneDrive (requests file access separately).
- Microsoft Entra directory sync: Organization-level connection approved by a Microsoft administrator to keep your ClearPolicy people list and groups aligned with your Microsoft directory.
Disconnect Microsoft sign-in
- Open Settings → Account → Profile.
- Under Sign-in providers, click Disconnect next to Microsoft.
Troubleshooting
Microsoft says “Need admin approval”
Microsoft says “Need admin approval”
Your Microsoft Entra tenant restricts users from approving new apps on their
own. Ask a Microsoft Global Administrator, Cloud Application
Administrator, or Application Administrator to approve ClearPolicy’s
sign-in permissions for your tenant, then retry signing in.
“Your login session expired. Please try again.”
“Your login session expired. Please try again.”
The sign-in state expired or was interrupted before returning from
Microsoft. Return to
app.clearpolicy.app/login, click
Microsoft, and complete sign-in in a single browser tab with cookies
enabled.
“Authentication with Microsoft failed.”
“Authentication with Microsoft failed.”
You may have canceled the Microsoft prompt, declined permissions, or been
blocked by a Microsoft Conditional Access policy. Retry from
app.clearpolicy.app/login, or ask your
Microsoft administrator to check Entra sign-in logs for Conditional Access
or consent blocks.
Signed in with the wrong Microsoft account
Signed in with the wrong Microsoft account
Sign out of ClearPolicy, then click Microsoft again on the login page
and choose your work or school account. If your browser automatically picks
another Microsoft session, use an InPrivate or incognito window or sign out
of the other Microsoft account first.
Your organization requires two-factor authentication
Your organization requires two-factor authentication
If an organization owner turned on Require two-factor authentication in
ClearPolicy, team members may also be prompted to set up an authenticator
app or passkey inside ClearPolicy. See Account and
security.