Get Support
8x8 Status
My Services Express Jitsi as a Service 8x8 Connect 8x8 Work for Web
8x8 Community

Seamless Login for 8x8 for Microsoft Teams

Updated: 12/11/2025

Overview

Seamless Login automatically authenticates users into the 8x8 for Microsoft Teams app using their existing Microsoft Teams credentials. When users are already signed into Microsoft Teams and have an associated 8x8 account, they are automatically logged into the 8x8 integration app without additional credential entry or SSO pop-up windows.

Applies To

  • 8x8 Voice for Microsoft Teams version 4.0 or above

What's New

The Seamless Login feature replaces the previous authentication flow and provides the following improvements:
  • Automatic authentication: No manual credential entry required when already signed into Microsoft Teams
  • Eliminates SSO pop-up windows: Streamlined login experience
  • Resolves SSO session expiration issues: Previous sessions expired after 7 days requiring repeated manual re-authentication

Prerequisites

For Seamless Login to work automatically, one of the following conditions must be met:
  • Your 8x8 username matches your Microsoft Teams signed-in username
  • Your Federation ID matches your Microsoft Teams signed-in user

Setting the Federation ID

If your 8x8 username doesn't match your Microsoft Teams username, IT administrators can configure the Federation ID:
  1. Log in to the 8x8 Admin Console
  2. Navigate to Users
  3. Select the user
  4. Go to Single Sign-On (SSO)
  5. Set the Federation ID to match the Microsoft Teams username
NOTE: Setting the Federation ID is only necessary if the 8x8 and Microsoft usernames don't match.

First-Time Setup: Permissions Consent

When users first launch the updated 8x8 for Microsoft Teams app (version 4.0), they will see a one-time request for additional permissions:
After clicking Continue, a permission popup will appear, based on Azure AD > Enterprise Applications > Consent and permissions > User consent settings:
✖ Do not allow user consent (everything requires admin approval)
vs
✔ Allow user consent for apps from verified publishers
 
 
When Do not allow user consent is set, users are presented with the Approval required dialog (left).
When Allow user consent for apps from verified publishers is set (or allowed for low-risk permissions), users are presented with the Permissions requested dialog (right).
   
NOTE: Users can enter anything in the field: Enter justification for requesting this app. The request will be sent to their Microsoft administrator.

Enabling Admin Consent Requests

When user consent is globally disabled, users cannot request access to new enterprise applications. Instead, they see a Need admin approval dialog and are unable to submit a request on their own.
To enable the request flow for a specific user, an admin must temporarily allow admin consent requests and assign a reviewer:
  1. Go to Azure AD > Enterprise applications
  2. Select Consent and permissions > Admin consent settings
  3. Under Admin consent requests, configure:
    • Users can request admin consent to apps they are unable to consent to > set to Yes
    • Reviewers > assign the admin user who will grant the consent.
    
enable ursers to request admin consent.png
    

Granting Permissions by Admin

When a tenant is locked down so users cannot consent, the admin has to explicitly approve the permissions your app requires. The admin can do this in three ways:

1. Approve the app directly from the consent prompt (preferred)

When a user tries to install/use the app and hits the Approval required dialog the admin must:
  1. Click Review permissions (or open the link the user sends)
  2. Sign in as a Global Admin or Cloud Application Admin
  3. Accept the permissions
  4. Optionally check Consent on behalf of your organization.
  5. If they don’t check that box, only they receive the consent, not the org.
Result: Everyone in the org can now use the app without being blocked.

2. Approve via Azure AD > Enterprise Apps > Admin consent workflow

If they want the more bureaucratic path (or already have the request pending):
  1. Go to Azure AD admin portal
  2. Navigate to Enterprise applications > Admin consent requests
  3. They’ll see your app (“8x8 Work” or similar) in the list
  4. Open the request
  5. Review requested permissions
  6. Click Approve
  7. Again, they must choose Consent on behalf of your organization
This also unblocks all users.

3. Pre-grant the permissions from the Enterprise App blade

If the admin wants to approve without waiting for end-user requests:
  1. Go to Azure AD > Enterprise applications
  2. Find 8x8 app (shows up after first user-triggered attempt or manual add)
  3. Open it > Permissions
  4. Click Grant admin consent for <tenant name>

Granting permissions by User

  1. After the app updates to version 4.0, open the 8x8 for Microsoft Teams app
  2. A consent dialog appears with the message: "We need to ask for additional permissions. You should only need to do this once"
  3. Click Continue
  4. A Microsoft permissions dialog appears requesting:
    • View your basic profile
    • Maintain access to data you have given it access to
  5. Click Accept to grant permissions
Important: Users must grant these permissions to enable automatic token-based authentication. Without accepting permissions, Seamless Login will not function.

If Permissions Are Declined

If a user clicks Cancel or declines permissions, they will see an error screen.
Users can click the Retry button to be re-prompted for the required permissions.

Troubleshooting

Authentication Failed Error

If you see "Failed to authenticate. Please try again," this typically means:
  • Your Microsoft Teams username doesn't match your 8x8 username or Federation ID
  • You don't have an active 8x8 subscription
To resolve:
  1. Click Retry to attempt authentication again
  2. If the issue persists, verify:
    • You have an active 8x8 account and subscription
    • Your username matches the sign-in Microsoft credentials 
    • Your Federation ID is set correctly (if usernames don't match)
  3. Contact your IT administrator for assistance with account configuration

Permissions Not Granted

If you declined permissions during the initial setup:
  1. Close the 8x8 for Microsoft Teams app
  2. Reopen the app
  3. Click Retry when prompted
  4. Accept the permissions in the Microsoft consent dialog

Deployment Information

The Seamless Login feature is included in 8x8 for Microsoft Teams version 4.0. The update is deployed automatically through the Microsoft Teams app store.

Need Help?

If you continue experiencing issues with Seamless Login, contact your IT administrator or 8x8 Support.