{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21432,"path":"integrate-applications/integration-hub/set-up-msteams.md","title":"Set up the Microsoft Teams Graph spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Set up the Microsoft Teams Graph spoke\n\nIntegrate the ServiceNow instance and Microsoft Teams account by creating a custom OAuth application in Microsoft Azure portal to authenticate ServiceNow requests.\n\n## Before you begin\n\n- Request an Integration Hub subscription.\n- Activate the Microsoft Teams Graph spoke.\n- Role required: admin.\n\n## Register an application using the Microsoft Azure portal\n\nProvide authorization to the ServiceNow instance by registering an application in Microsoft Entra ID \\(formerly Microsoft Azure Active Directory\\).\n\n### Before you begin\n\nRole required: Microsoft Entra ID admin\n\n### About this task\n\nComplete these steps from the Microsoft Azure portal.\n\n### Procedure\n\n1. In the Microsoft Azure portal, copy and record the **Directory ID** for later use.\n\n For more information, see [Get tenant and app ID values for signing in](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal#get-tenant-and-app-id-values-for-signing-in) in [Microsoft Entra ID documentation](https://docs.microsoft.com/en-gb/).\n\n2. Register your application in Azure portal. For instructions on registering an application, see [Tutorial: Register an app with Microsoft Entra ID](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/walkthrough-register-app-azure-active-directory) in the [Microsoft Docs](https://docs.microsoft.com/en-us/).\n\n3. Copy and record the **Application ID** for later use.\n\n4. Add the **Redirect URL** in this format: `https://.service-now.com/oauth_redirect.do`.\n\n For more information, see [Authentication and authorization for Azure Time Series Insights API](https://docs.microsoft.com/en-us/azure/time-series-insights/time-series-insights-authentication-and-authorization) in [Microsoft Docs](https://docs.microsoft.com/en-us/).\n\n5. For the **Required Permissions**, select **Microsoft Graph**.\n\n For more information, see [Permissions and consent in the Microsoft identity platform](https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-permissions-and-consent) in [Microsoft Docs](https://docs.microsoft.com/en-us/).\n\n For information about the permissions required to use the spoke actions, see the Spoke actions section in [Microsoft Teams Graph Spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/msteams-spoke.md). Provide permissions as per your requirement. For more information about the permissions, see [Microsoft Graph REST API v1.0 reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0) in [Microsoft Docs](https://docs.microsoft.com/en-us/).\n\n6. Record the **Client Secret** for use in later configurations.\n\n\n### Result\n\nThe ServiceNow application is created with Microsoft Entra ID.\n\n## Configure connections for the Microsoft Teams Graph spoke\n\nAdd and configure the Microsoft Teams connections to authenticate ServiceNow requests in the Microsoft Teams Graph spoke.\n\n### Before you begin\n\nRole required: admin\n\n### Procedure\n\n1. Navigate to **All** > **Process Automation** > **Workflow Studio**.\n\n2. Select the **Integrations** tab.\n\n3. Under **Connections**, toggle and enable the **Outbound** connections.\n\n4. Configure the **Microsoft Teams Spoke** connection.\n\n 1. Locate the **Microsoft Teams Spoke** connection alias and select **View Details**.\n\n - To configure the default connection and credential alias record that is shipped along with the Microsoft Teams spoke, select **View Details**.\n\n \\[Omitted image \"ms-teams-spoke-tile.jpg\"\\] Alt text: Connection for the Microsoft Teams Spoke\n\n - To manage more than one Microsoft Teams spoke connection records, you should create a child alias record by clicking **Add Connection**. For more information about using multiple connections, see [Supporting multiple connections](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/support-multiple-connections.md).\n If you're configuring the spoke for the first time, select **Configure**. Otherwise, select **Edit**.\n\n \\[Omitted image \"ms-teams-spoke-configure.jpg\"\\] Alt text: Initial connection configuration\n\n 2. On the form, fill in these fields:\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nName to identify the alias record associated with this connection.\n\n
\n\nConnection URL\n\n\n\nConnection URL. Enter `https://graph.microsoft.com`.\n\n
\n\nAPI Version\n\n\n\nThe value is set to **v1.0** by default.If you're using any other API version, update the version number here.\n\n
\n\nAuthorization URL\n\n\n\nOAuth authorization code endpoint. Enter `https://login.microsoftonline.com//oauth2/v2.0/authorize`.\n\n
\n\nToken URL\n\n\n\nOAuth server token endpoint. Enter `https://login.microsoftonline.com//oauth2/v2.0/token`.\n\n
\n\nToken Revocation URL\n\n\n\nOAuth server token revocation endpoint.\n\n
\n\nOAuth Client ID\n\n\n\nApplication ID created during application registration.\n\n
\n\nOAuth Client Secret\n\n\n\nClient secret created during application registration.\n\n
\n\nOAuth Redirect URL\n\n\n\nOAuth callback endpoint. Enter `https://.service-now.com/oauth_redirect.do`.\n\n
\\[Omitted image \"ms-teams-spoke-conf-connection.jpg\"\\] Alt text: Configure a connection for the Microsoft Teams spoke\n\n 3. Select **Save and Get OAuth Token**.\n\n5. Configure the **Microsoft Teams Graph Client Credentials** connection.\n\n Except the Look up Schedules action, all the other calendar and webhook management spoke actions use this connection record.\n\n 1. Locate the **Microsoft Teams Graph Client Credentials** connection alias and select **View Details**.\n\n - To configure the default connection and credential alias record that is shipped along with the Microsoft Teams Graph Client Credentials, select **View Details**.\n\n \\[Omitted image \"ms-teams-gphcc-tile.jpg\"\\] Alt text: Connection for the Microsoft Teams Graph Client Connection\n\n - To manage more than one Microsoft Teams Graph Client Credentials connection records, you should create a child alias record by clicking **Add Connection**. For more information about using multiple connections, see [Supporting multiple connections](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/support-multiple-connections.md).\n If you're configuring the spoke for the first time, select **Configure**. Otherwise, select **Edit**.\n\n \\[Omitted image \"ms-teams-gphcc-configure.jpg\"\\] Alt text: Initial connection configuration\n\n 2. On the form, fill in these fields:\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nName to identify the alias record associated with this connection.\n\n
\n\nConnection URL\n\n\n\nConnection URL. Enter `https://graph.microsoft.com`.\n\n
\n\nAPI Version\n\n\n\nThe value is set to **v1.0** by default.If you're using any other API version, update the version number here.\n\n
\n\nToken URL\n\n\n\nOAuth server token endpoint. Enter `https://login.microsoftonline.com//oauth2/v2.0/token`.\n\n
\n\nOAuth Client ID\n\n\n\nApplication ID created during application registration.\n\n
\n\nOAuth Client Secret\n\n\n\nClient secret created during application registration.\n\n
\\[Omitted image \"ms-teams-gphcc-conf-connection.jpg\"\\] Alt text: Configure a connection for the Microsoft Teams Graph Client Credentials\n\n 3. Select **Save and Get OAuth Token**.\n\n\n### Result\n\nThe Microsoft Teams Graph spoke is set up and Microsoft Teams account is integrated with your ServiceNow instance.\n\n"}}