Skip to main content

Configuring Microsoft Entra for elvex Microsoft 365 Integration Actions

How to configure Microsoft Entra (Azure AD) so your users can connect Outlook, OneDrive, and SharePoint integration actions in elvex without hitting "Need admin approval" errors.

elvex connects to Outlook, OneDrive, and SharePoint through Paragon, which registers an enterprise application named elvex in your Microsoft Entra (Azure AD) tenant. Before your users can connect these integrations, an admin needs to configure a few settings in Entra. If any of these are missing, users will see a "Need admin approval" screen β€” even if consent has already been granted.

πŸ“˜ Looking for Microsoft Teams setup? See Installing the Microsoft Teams App.

Who this is for: Microsoft Entra administrators with a Global Administrator, Application Administrator, or Cloud Application Administrator role.

Before You Begin

  • A Global Administrator role is required for Steps 1 and 4.

  • Confirm your firewall or security tooling does not block passport.useparagon.com β€” this is the OAuth redirect host for elvex's Microsoft integrations.

Step 1 β€” Grant Tenant-Wide Admin Consent

  1. Sign in to the Microsoft Entra admin center as a Global Administrator.

  2. Navigate to Identity β†’ Applications β†’ Enterprise applications.

  3. Search for and select elvex. If it doesn't appear, have any user attempt to connect a Microsoft integration in elvex once to create the registration, then return here.

  4. In the left sidebar, click Permissions.

  5. Click Grant admin consent for [your organization].

  6. Sign in again when prompted and click Accept.

You should now see all delegated permissions listed under the Admin consent tab with your organization name in the "Granted by" column.

Step 2 β€” Configure User Assignment

  1. In the elvex enterprise app, click Properties in the left sidebar.

  2. Set Assignment required? based on your preference:

    • No (recommended) β€” any user in your tenant can connect elvex.

    • Yes β€” only users explicitly assigned can connect. Click Users and groups in the sidebar and add a security group containing all elvex users.

  3. Click Save.

Step 3 β€” Check Conditional Access Policies

Conditional Access can silently block elvex's OAuth flow even after admin consent is granted, and the user sees the same "Need admin approval" screen either way.

  1. Navigate to Microsoft Entra β†’ Protection β†’ Conditional Access β†’ Policies.

  2. Find any policy with Cloud apps set to Office 365, Microsoft Graph, or All cloud apps and State set to On.

  3. For each such policy, check the Assignments β†’ Users condition and confirm all elvex users are included β€” either directly or as direct members of an included group (nested group membership does not count).

Step 4 β€” Set User Consent Policy

  1. Navigate to Enterprise applications β†’ Consent and permissions β†’ User consent settings.

  2. Select Allow user consent for apps from verified publishers, for selected permissions.

  3. Click Save.

πŸ“˜ Note: This change can take a few minutes to propagate. If a user retries immediately and still fails, have them try in an incognito window before assuming the setting didn't take effect.

Step 5 β€” Optional: Enable Admin Consent Workflow

If you need a more restrictive consent policy, you can let users request admin approval rather than hitting a dead-end error screen.

  1. Navigate to Enterprise applications β†’ Consent and permissions β†’ Admin consent settings.

  2. Set Users can request admin consent to apps they are unable to consent to to Yes.

  3. Add reviewers and configure notifications as needed.

  4. Click Save.

Step 6 β€” Verify M365 License Assignment

Confirm each user has the license for the integration they want to connect:

Integration

Required license

Outlook

Exchange Online

OneDrive

OneDrive for Business / SharePoint Online

SharePoint

SharePoint Online

Onboarding New Users

Before a new user tries to connect, confirm:

  • They have an active Microsoft 365 account and the required license(s).

  • If "Assignment required" is Yes: they are a direct member of the assigned group.

  • They are included in any Conditional Access policy scoped to Microsoft Graph or Office 365.

  • They have access to elvex (they appear in your elvex company's user list).

Troubleshooting

The fastest way to diagnose a failed connection is Entra sign-in logs:

  1. Navigate to Microsoft Entra β†’ Monitoring β†’ Sign-in logs.

  2. Filter by the affected user and find the failed sign-in to the elvex application.

  3. Read the Failure reason field.

Error code

Cause

Fix

AADSTS50105

User not in assigned group

Add user to the group, or set "Assignment required" to No

AADSTS65001

Admin consent missing

Re-run Step 1

AADSTS90094

User consent policy too restrictive

Re-run Step 4

AADSTS53003 / AADSTS530...

Conditional Access blocked the sign-in

Add user to the group the CA policy requires (Step 3)

AADSTS500011

elvex enterprise app not yet created in tenant

Have a user attempt a connection in elvex, then re-run Step 1

AADSTS700016

App ID mismatch

Contact elvex support

When a single user can't connect but others can:

  • Check sign-in logs for the failure reason.

  • Compare the user's group membership side-by-side with a user who can connect. Add them to any group they're missing.

  • Have them retry in an incognito window to rule out cached consent state.

When the whole tenant can't connect:

  • Confirm admin consent has been granted and the date on elvex β†’ Permissions is recent.

  • Confirm user consent is set to at least "Allow user consent for apps from verified publishers."

  • Confirm passport.useparagon.com is not blocked by a firewall or security product.

Did this answer your question?