In this article
Overview
Use this account type to connect Teams Snaps with data sources that use OAuth2 application accounts.
Prerequisites
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
- Access token
- OAuth 2.0 authorization endpoint
- OAuth 2.0 token endpoint
- Token endpoint configuration
Limitations
None.
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 user associated with the client ID. | N/A | N/A |
Access token expiration | Integer | The access token expiration value. | N/A | N/A |
OAuth2 Token | String | Required. Token endpoint to get the access token. | 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. Required Token endpoint parameters Provide values at least to the parameters scope and redirect_uri, in this field set. | |||
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 or a redirect_uri. See Scopes and permissions required for OneDrive API. | N/A | offline_access Files.ReadWrite.All Sites.ReadWrite.All |
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 |
Troubleshooting
None.