In this article
Overview
Use this account type to connect Microsoft 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
- Auth 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 upon account 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 |
| Refresh token | String | Auto-generated upon account authorization. The token used to refresh the access token. | N/A | N/A |
Access token expiration | Integer | Auto-generated upon account authorization. The access token expiration value. | N/A | N/A |
| OAuth2 Endpoint | URL | Required. Enter the tenant ID in the designated position in the URL. | https://login.microsoftonline.com/ <tenant_id>/oauth2/v2.0/authorize | https://login.microsoftonline.com/123a456b-7c89-0d1e-234f-g5h678901ijk/oauth2/v2.0/authorize |
OAuth2 Token | URL | Required. Enter the tenant ID in the designated position in the URL. | https://login.microsoftonline.com/ <tenant_id>/oauth2/v2.0/token | https://login.microsoftonline.com/123a456b-7c89-0d1e-234f-g5h678901ijk/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 |
| Auth endpoint config | Use this field set to configure auth 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. | |||
| Auth endpoint parameter | String | Provide the name for the auth endpoint parameter. | N/A | scope |
| Auth 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 |
| Auto-refresh token | Checkbox | Select this to refresh the access token automatically. | Not selected | Selected |
| 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 |
| Refresh | Button | Click this button to refresh the access token using the refresh token. | N/A | N/A |
Troubleshooting
None.