In this article
Overview
Use this account type to connect Teams Snaps with data sources that use OAuth2 application accounts.
Prerequisites
- The user authorizing (as a User Account) must have access to either of the following:
- Teams application through the Office 365 portal
- Office365 (admin access) for the Application account.
- A registered application in the Microsoft Azure Portal with appropriate permissions that contains the following information.
- Client ID
- Tenant name or Tenant ID
- Client secret
- OAuth 2.0 token endpoint
- Token endpoint configuration
Limitations and Known Issues
None.
Account Settings
| Parameter | Data Type | Description | Default Value | Example |
|---|---|---|---|---|
Label | String | Required. Enter a unique label for the account. | N/A | MSTeams_Docs_App_Account |
Client ID | String | Required. Enter the client ID associated with your Azure application. You can create the client ID as advised by your application provider. | N/A | 1abcd23e-45fg-6789-hi01-23456jk789l0 |
Client secret | String | Enter the client secret associated with your account. You can create the client secret as advised by your application provider. | N/A | bec1f9242f9nsh67f2276b9ws4cadd14 |
Access token | String | Auto-generated after authorization. The access token associated with the Azure portal application is used to make API requests on behalf of the application associated with the client ID. | N/A | N/A |
Access token expiration | Integer | Auto-generated after authorization. The access token expiration value. | N/A | N/A |
OAuth2 Token | String | Required. Token endpoint to generate the access token. Replace <tenant-id*> in this field with your Directory (tenant) ID associated with your Azure application. | https://login.microsoftonline.com/ <tenant-id*>/oauth2/v2.0/token | https://login.microsoftonline.com/9ee09921-7b72-432d-b552-a21e8a1ab143/oauth2/v2.0/token |
Token endpoint config | Use this field set to configure token endpoint parameters as necessary for the account. This field set comprises the following fields:
Click the + or - icons to respectively add or remove configuration rows. | |||
Token endpoint parameter | String | Provide the name for the token endpoint parameter. | N/A | scope |
Token endpoint parameter value | String | Provide the value for the parameter, typically the default scope. | N/A | .default |
| Authorize | Button | Click this button to acquire the required permissions for this account from the Azure portal app, when creating an account. For existing accounts, you can click this button to re-acquire the permissions to ensure that the account works as expected. This action does not require or result in any changes to the Access Token that is already generated. | N/A | N/A |