In this article
Overview
Use this account type to connect Teams Snaps with data sources that use OAuth2 application accounts.
The account authenticating the Teams OAuth2 Application Account must have administrator access to the Microsoft Teams Application through the Office 365 dashboard or owner access to specific Teams within the organization in order to use the Teams Snaps. Without either administrator access or ownership of a Team, there may be errors when performing many tasks, some may even be restricted by the Office 365 administrator.
Prerequisites
- The user authorizing as an Application account must have access to either of the following:
- Teams application through the Office 365 portal.
- Administrator access in Office365 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 |