Cisco Catalyst Center Administrator Guide, Release 3.2.x

PDF

Catalyst Center and Microsoft Teams integration

Want to summarize with AI?

Log in

Overview

Introduces the topics that describe the Catalyst Center and Microsoft Teams integration.

Catalyst Center supports integration with Microsoft Teams. The topics in this section

  • explain what you need to know when Catalyst Center is integrated with Microsoft Teams

  • describe known limitations, and

  • guide you through the integration of these two products.


Considerations for a Microsoft Teams integration

Keep these points in mind for a Catalyst Center and Microsoft Teams integration.

Data handling and privacy considerations

  • Cisco Catalyst Cloud Portal obtains the following information from your Microsoft tenant and stores it locally in the cloud:

    • Microsoft Teams call records data

    • User profile data, such as ID, email address, first name, last name, display name, and office location

  • Catalyst Cloud Portal stores data for one hour before deleting it.

  • To view the privacy policy for Catalyst Center, refer to the Catalyst Center privacy data sheet.

  • Only the Cisco Cloud Ops team can access your cloud database information.

  • Catalyst Cloud Portal stores Microsoft Teams data in an encrypted file system using AWS EBS. It encrypts sensitive data, such as access tokens, and stores them in the database.

  • Catalyst Cloud Portal requires these API permissions from Microsoft to retrieve your data:

    • User.ReadBasic.All

    • CallRecords.Read.All

    • User.Read

Integration and connectivity considerations

  • An on-premises Catalyst Center instance polls Catalyst Cloud Portal every five minutes to retrieve data.

  • When Catalyst Center is integrated with Microsoft Teams, Catalyst Cloud Portal uses these FQDNs:

    • dna.cisco.com

    • dnaservices.cisco.com

    • *.ciscoconnectdna.com

    • neoffers.cisco.com

    • neoffers-de.cisco.com

    • app-experience-connect.cisco.com

    • app-experience-connect-de.cisco.com

  • The Catalyst Cloud Portal service does not use any static IP addresses. If you need to control traffic, use domain names instead.

  • You cannot integrate an air-gapped Catalyst Center deployment with Microsoft Teams because integration requires a connection to Catalyst Cloud Portal.

  • For Catalyst Center versions up to 2.3.7.5, register an on-premises Catalyst Center instance in Catalyst Cloud Portal using either the US-West or EU Central region. For Catalyst Center 2.3.7.6 and later, you can only register using the US-West region.

  • When connected, Catalyst Cloud Portal and Microsoft Teams use these APIs:

    • Authentication: {org tenant id}/adminconsent and {org tenant id}/oauth2/v2.0/token

    • Subscription: v1.0/subscriptions

    • Retrieving call records: v1.0/communications/callRecords/{call record id}?$expand=sessions($expand=segments) and v1.0/users/{user id}

Authentication and permissions considerations

  • If your Microsoft Teams account uses multifactor authentication (MFA), MFA is used when you enter account details during the consent flow.

  • Catalyst Center 2.3.7.6 and later use the OAuth2 standard device authentication flow. Earlier Catalyst Center versions used one-time password (OTP) authentication, where users generated a password in Catalyst Cloud Portal and used that password to complete the integration between Catalyst Center and Catalyst Cloud Portal.

  • After you grant Catalyst Cloud Portal permission, Microsoft Teams issues standard OAuth access and refresh tokens. Catalyst Cloud Portal refreshes the access token every hour using a refresh token. User credentials are never sent to Catalyst Cloud Portal.

  • Only Microsoft Teams users configured with these roles can initiate integration:

    • Global Administrator

    • Privileged Role Administrator

    • A custom role that has the permission to grant permissions to applications setting enabled

    Note

    For more information, refer to this article.

  • During the integration process, complete these steps to provide the consent necessary to authenticate Microsoft Teams:

    1. In the Authenticate your application page, click the Click here to start the consent flow link.

    2. In the resulting dialog box, enter your Microsoft Teams password and then click Sign in.

    3. In the Permissions requested dialog box, choose the first two check boxes and then click Accept.

    4. Do one of the following:

      • If you're configured with one of the three roles described in the previous FAQ entry (which means you have admin privileges), first click I am an Admin. Next, in the Permissions requested dialog box, click all three check boxes. And finally, click Accept.

      • If you don't have admin privileges, first click Copy URL. Next, send this URL to a user with admin privileges. And finally, have that user open the URL and provide the necessary consent.

  • The Application ID for the Catalyst Cloud Portal's OAuth application that is registered with Microsoft is 904c49f0-22c5-4a6f-a96c-613c2c319fc8. The name of the application is Cisco Catalyst Center Applications Experience.

Integration scope considerations

  • There are no differences in the limitations or restrictions you may encounter when Microsoft Teams has been integrated with a physical Catalyst Center appliance versus a virtual appliance.

  • You can map one Catalyst Center instance to one Microsoft Teams tenant. Integrate a Catalyst Center instance with the appropriate Microsoft Teams account.

  • You can register multiple Catalyst Center instances with a single Catalyst Cloud Portal account. Catalyst Cloud Portal collects data from your subscribed Microsoft Teams account. Each registered Catalyst Center instance retrieves data from its managed clients.

Logging and metrics considerations

  • If your network only has Catalyst 9000 Series switches, only Microsoft Teams scores and metrics are available. Catalyst 9000 Series switches do not provide qualitative metrics (like packet loss, latency, and jitter), so network application performance management (APM) metrics are not available.


Known limitations

You may encounter these limitations after integrating Catalyst Center with Microsoft Teams:

  • Health data may not be available for meetings that are shorter than 10 minutes.

  • After a call ends, Microsoft Teams may take a few hours to send a notification to Catalyst Cloud Portal.

  • The on-premises version of Catalyst Center stores call record data for 14 days.


Configure an AppX MS-Teams integration

When activated, Catalyst Center provides call quality metrics information for Application 360 and Client 360 dashboards.

Before you begin

You must have a Microsoft Teams account with admin privileges.

Procedure

1.

From the main menu, choose System > Settings > External Services > Cisco Catalyst - Cloud.

2.

From the Region drop-down list, select the Catalyst Cloud US region. For the integration to work, Microsoft Teams must be enabled in the same region (Catalyst Cloud US).

3.

Click the icon, search by name, and locate AppX MS-Teams.

4.

Click Activate.

You are redirected to the Cisco Catalyst - Cloud window.

5.

In the Cisco Catalyst - Cloud window:

  1. Log in to Cisco Catalyst - Cloud with your cisco.com credentials.

    If you do not have cisco.com credentials, you can create them.

  2. In the Activate application on your product window, click the consent flow link and do these tasks:

    • In the Sign in to your account window, enter the Microsoft admin username and password, and click Sign In.

    • Click Accept.

  3. In the Activate application on your product window, select Catalyst Center and click Next.

    To register a new Catalyst Center, click the here link and:

    • In the Host Name/IP field, enter the Catalyst Center IP address.

    • In the Product Name field, enter the Catalyst Center name.

    • In the Type field, enter the Catalyst Center type.

    • Click Register.

  4. Cisco Catalyst - Cloud synchronizes with Catalyst Center automatically; you are redirected to the Choose the Scope for your Cisco Catalyst Center window. Click Next.

  5. In the Summary window, review the configuration settings. To make any changes, click Edit.

  6. Click Activate.

    You are redirected back to Catalyst Center.
    Note
    If you want to deactivate the product or disconnect from AppX MS-Teams application, see Configure an AppX MS-Teams integration through Cisco Cloud Services.

Configure an AppX MS-Teams integration through Cisco Cloud Services

Use this procedure to activate, deactivate, or check the status of MS-Teams integration on the devices through Cisco Cloud Services.

Before you begin

You must have a Microsoft Teams account with admin privileges.

Procedure

1.

Log in to Cisco Cloud Services with your cisco.com credentials.

If you do not have cisco.com credentials, you can create them.

2.

From the main menu, choose Applications and Products.

3.

From the Region drop-down list, select the Catalyst Cloud US region. For the integration to work, Microsoft Teams must be enabled in the same region (Catalyst Cloud US).

4.

Click the icon, search by name, and locate AppX MS-Teams.

5.

In the AppX MS-Teams tile, click Activate. For details, see Configure an AppX MS-Teams integration.

6.

After the product is activated, click Exit.

7.

You are redirected to the Applications window.

8.

Click the AppX MS-Team tile to view the details in the App 360 window.

9.

(Optional) To activate products from the App 360 window:

  1. In the Product Activations table, click Add.

  2. Choose the product that you want to activate and click Next.

    Note

    You cannot select more than one product at a time.

  3. In the Summary window, review the configuration settings. To make any changes, click Edit. Otherwise, click Activate.

10.

(Optional) To deactivate the product:

  1. Click the AppX MS-Teams tile.

  2. In the Product Activations table, check the check box next to the product that you want to deactivate.

  3. From the More Action drop-down list, choose Deactivate.

  4. In the confirmation window, click Deactivate.

11.

(Optional) To disconnect the product from AppX MS-Teams application:

  1. Click the AppX MS-Teams tile to view the details in the App 360 window.

  2. In the top menu bar, click View all details.

    The Details slide-in pane is displayed.
  3. Click Disconnect now.