Cisco Webex Teams authentication

Prerequisites

Depending on the authentication type you select, you need one of the following credentials:

• OAuth 2.0 Authorization code: OAuth Scope, the email and password associated with your Cisco account.
• Bring your own OAuth 2.0 app: client ID, client secret, scope.

To learn how to create your own OAuth 2.0 application, see the Cisco documentation.

OAuth Scope

You must provide the OAuth scopes for the regular user operations. In case you want to add admin scopes, you can just type it in the field and then click Connect.

For example, let's assume you are an admin and want to work with the Invite User activity. While adding the connection, you must manually type the spark-admin:people_write scope in the OAuth Scope field.

Note: The scopes must be space separated.

Add the Cisco Webex Teams connection

To create a connection to your Cisco Webex Teams instance, you need to perform the following steps:

1. Select Integration Service from Automation Cloud.

2. From the Connectors list, select Cisco Webex Teams. You can also use the search bar to narrow down the connector.

3. Select the Connect to Cisco Webex Teams button.

4. You can choose between two authentication types: OAuth 2.0 Authorization code or Bring your own OAuth 2.0 app.

5. Enter the required credentials for your preferred authentication method and select Connect.

6. Your connection has been added.

Privileges and permissions

When creating a connection via Cisco WebEx Teams, you must allow the application to view and manage information in accordance with the following privileges and permissions:

analytics:read_all audit:events_read identity:placeonetimepassword_create meeting:admin_participants_read meeting:admin_preferences_read meeting:admin_preferences_write meeting:admin_recordings_read meeting:admin_recordings_write meeting:admin_schedule_read meeting:admin_schedule_write meeting:admin_transcripts_read meeting:controls_read meeting:controls_write meeting:participants_read meeting:participants_write meeting:preferences_read meeting:preferences_write meeting:recordings_read meeting:recordings_write meeting:schedules_read meeting:schedules_write meeting:transcripts_read spark-admin:broadworks_billing_reports_read spark-admin:broadworks_billing_reports_write spark-admin:broadworks_enterprises_read spark-admin:broadworks_enterprises_write spark-admin:broadworks_subscribers_read spark-admin:broadworks_subscribers_write spark-admin:call_qualities_read spark-admin:devices_read spark-admin:devices_write spark-admin:hybrid_clusters_read spark-admin:hybrid_connectors_read spark-admin:licenses_read spark-admin:organizations_read spark-admin:organizations_write spark-admin:people_read spark-admin:people_write spark-admin:places_read spark-admin:places_write spark-admin:resource_group_memberships_read spark-admin:resource_group_memberships_write spark-admin:resource_groups_read spark-admin:roles_read spark-admin:telephony_config_read spark-admin:telephony_config_write spark-admin:wholesale_billing_reports_read spark-admin:wholesale_billing_reports_write spark-admin:workspace_locations_read spark-admin:workspace_locations_write spark-admin:workspace_metrics_read spark-admin:workspaces_read spark-admin:workspaces_write spark-compliance:events_read spark-compliance:meetings_read spark-compliance:meetings_write spark-compliance:memberships_read spark-compliance:memberships_write spark-compliance:messages_read spark-compliance:messages_write spark-compliance:rooms_read spark-compliance:rooms_write spark-compliance:team_memberships_read spark-compliance:team_memberships_write spark-compliance:teams_read spark-compliance:webhooks_read spark-compliance:webhooks_write spark:calls_read spark:calls_write spark:devices_read spark:devices_write spark:kms spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:people_read spark:people_write spark:places_read spark:places_write spark:rooms_read spark:rooms_write spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write spark:xapi_commands spark:xapi_statuses"}, {"scopes": "Identity:one_time_password analytics:read_all audit:events_read identity:placeonetimepassword_create meeting:admin_participants_read meeting:admin_preferences_read meeting:admin_preferences_write meeting:admin_recordings_read meeting:admin_recordings_write meeting:admin_schedule_read meeting:admin_schedule_write meeting:admin_transcripts_read meeting:controls_read meeting:controls_write meeting:participants_read meeting:participants_write meeting:preferences_read meeting:preferences_write meeting:recordings_read meeting:recordings_write meeting:schedules_read meeting:schedules_write meeting:transcripts_read spark-admin:broadworks_billing_reports_read spark-admin:broadworks_billing_reports_write spark-admin:broadworks_enterprises_read spark-admin:broadworks_enterprises_write spark-admin:broadworks_subscribers_read spark-admin:broadworks_subscribers_write spark-admin:call_qualities_read spark-admin:devices_read spark-admin:devices_write spark-admin:hybrid_clusters_read spark-admin:hybrid_connectors_read spark-admin:licenses_read spark-admin:organizations_read spark-admin:organizations_write spark-admin:people_read spark-admin:people_write spark-admin:places_read spark-admin:places_write spark-admin:resource_group_memberships_read spark-admin:resource_group_memberships_write spark-admin:resource_groups_read spark-admin:roles_read spark-admin:telephony_config_read spark-admin:telephony_config_write spark-admin:wholesale_billing_reports_read spark-admin:wholesale_billing_reports_write spark-admin:workspace_locations_read spark-admin:workspace_locations_write spark-admin:workspace_metrics_read spark-admin:workspaces_read spark-admin:workspaces_write spark-compliance:events_read spark-compliance:meetings_read spark-compliance:meetings_write spark-compliance:memberships_read spark-compliance:memberships_write spark-compliance:messages_read spark-compliance:messages_write spark-compliance:rooms_read spark-compliance:rooms_write spark-compliance:team_memberships_read spark-compliance:team_memberships_write spark-compliance:teams_read spark-compliance:webhooks_read spark-compliance:webhooks_write spark:calls_read spark:calls_write spark:devices_read spark:devices_write spark:kms spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:people_read spark:people_write spark:places_read spark:places_write spark:rooms_read spark:rooms_write spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write spark:xapi_commands spark:xapi_statuses"}, {"scopes": "spark-admin:people_read spark-admin:people_write spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write"}, {"scopes": "spark-admin:people_read spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write"}, {"scopes": "spark-admin:people_write spark-admin:people_read spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write"}, {"scopes": "spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write"}, {"scopes": "spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write spark-admin:people_read"}, {"scopes": "spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write spark-admin:people_read spark-admin:people_write"}, {"scopes": "spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write spark-admin:people_write"}, {"scopes": "spark:memberships_read spark:memberships_write spark:messages_read spark:messages_write spark:organizations_read spark:rooms_read spark:rooms_write spark:people_read spark:team_memberships_read spark:team_memberships_write spark:teams_read spark:teams_write spark-admin:people_write spark-admin:people_read

More information regarding the OAuth 2.0 scopes are available in the Cisco WebEx Teams documentation: Admin - Authentication.