Install the 8x8 for Microsoft Teams app

To install the 8x8 for Microsoft Teams app (8x8 Teams app) for your organization you need to use administrator credentials with Global Admin rights or Teams Service Administrator rights for managing app policies.

Prerequisite

Before installing the app, ensure you have configured Microsoft Azure AD for user Single Sign-On (SSO). This is required to authenticate and sign-in users in the 8x8 Teams app. Learn how to configure Microsoft Azure AD for SSO.

Install the app

To install the 8x8 Teams app:

  1. Open https://www.office.com and log in using your administrator credentials.
  2. Click all apps in the left-side navigation bar and click Admin.
  3. Click Teams.
  4. Select Teams apps > Manage apps and enter 8x8 in the search field. The 8x8 app displays.

  5. Select Teams Apps > Setup policies and select Global (Org-wide default) to roll out the app to all users in your organization or add a custom app setup policy and assign it to a selected group of users that you want to provide this app to. In this guide way forward we shall exemplify by selecting the Global (Org-wide default) policy.

    Note: An administrator can apply the 8x8 Teams app to any teams in the organization including those created by others.

    Note: For additional information about setting policies for Microsoft Teams,
    see Manage app setup policies.

  6. Click Add Apps. The Add installed apps dialog displays.
  7. Select Global, enter 8x8 in the search field, click Add to add 8x8 Teams app to the Apps to add section. Then, click Add to pin the app for users.
  8. The 8x8 Teams app is listed in the Pinned apps section and available to users in the team. Optionally, select the app icon and click Move up or Move down to move the app icon up or down in the list.
  9. Click Save.

Note: It may take up to 24 hours for the 8x8 Teams app to sync before a user can access it in Microsoft Teams.

Set consent permissions for automatic authentication

Starting with version 4.0, the 8x8 Teams app supports automatic authentication. Previously, users had to manually sign in to the 8x8 Teams app every seven days. With this release, Teams users with an active 8x8 account are automatically logged in when they log in to Microsoft Teams.

To ensure the improved authentication method works as expected, you must:

Configure the app access permissions

To ensure users can automatically log in the 8x8 Teams app starting version 4.0 and above, you must configure the app access permissions. You can set up user consent permissions in different ways, each with different levels of interaction and control:

You can allow users to consent to the 8x8 Teams app accessing your organization’s data.

When users first launch the updated app, they will see a prompt asking them to accept the app’s permission terms. Once accepted, they are automatically logged in when launching Microsoft Teams.

Note: Microsoft controls the behavior for these permissions.

To allow users to consent to the app’s requested permissions:

  1. Log in to Azure AD.
  2. Go to Enterprise applications > Consent and permissions > User consent settings.
  3. Select Allow user consent for apps from verified publishers, for selected permissions.
  4. Click Save.
  5. Click Select permissions to classify as low impact from below the selected consent option.
    -Or-
    Go to Permission classifications.
  6. Click the check boxes for the most used permissions.
  7. Click Yes, add selected permissions.

When users try to access the 8x8 Teams app for the first time, they will see the Permissions requested dialog. Clicking Accept enables them to allow the app to view their basic profile and maintain access to the data they are given access to. They are then automatically logged in to the 8x8 Teams app.

You can restrict app access by preventing users from consenting to apps on their own. When this setting is enabled, users must submit a request with a reason for access. Admins must then approve the request before users can log in.

To restrict app access consent to admins only:

  1. Log in to Azure AD.
  2. Go to Enterprise applications > Consent and permissions > User consent settings.
  3. Select Let Microsoft manage your consent settings (Recommended).
    -Or-
    Select Do not allow user consent.
  4. Click Save.
  5. Go to Admin consent settings.
  6. Under Users can request admin consent to apps that are unable to consent to, set the toggle to Yes.
  7. Define who can review the consent requests.
  8. Click Save.

When users try to access the 8x8 Teams app for the first time, they may see the one of the following dialogs:

Dialog A Dialog B

Note: Microsoft controls the behavior for these permissions.

In both cases, users must request admin approval before they can access the 8x8 Teams app. Users who receive Dialog A must add a reason for requesting app access, and click Request approval.

Users who receive Dialog B can click Return to the application without granting consent. When they try to access the 8x8 Teams app, they will be prompted with Dialog A.

Ensure the 8x8 username matches the Microsoft Teams username or the Federation ID

For automatic authentication to work, each user’s Microsoft Teams username must match their 8x8 username or Federation ID.

If the usernames do not match, you can map 8x8 Work users to their Federation ID to enable seamless login.

Note: You only need to add or update the Federation ID if the usernames differ. For more information, see how to define the Federation ID or Google ID in user records.

How to approve a user’s app access request in Azure AD

If you have not enabled users to accept applications permissions on behalf of your organization, when a user tries to log in, they will be prompted to request access from an admin. You can approve these requests in different ways, each with different levels of interaction and control:

  1. In Azure AD, click Review permissions.
    -Or-
    Open the link sent by the user.
  2. Sign in as a Global Admin or Cloud Application Admin.
  3. Accept the permissions. The user receives permission to access the app.
  4. (Optional) Select the check box for Consent on behalf of your organization to approve access for all users in the organization.
  1. Log in to the Azure AD admin portal.
  2. Go to Enterprise applications > Admin consent requests.
  3. Locate the app in the list.
  4. Open the request.
  5. Review the permission request, then click Approve.
  6. (Optional) Select the check box for Consent on behalf of your organization to approve access for all users in the organization.
  1. Log in to Azure AD.
  2. Go to Enterprise applications.
  3. Open the app (it displays after the first user-triggered attempt or manual add).
  4. Click Permissions.
  5. Click Grant admin consent for <tenant name>. This approves the app access without waiting for end-user requests.