In this article
You can use this account type to connect all Snaps in this Snap Pack with the Business Central application that requires OAuth2 authorization.
A registered application in the Microsoft Azure Portal with required permissions to generate the Access token. Learn more about registering an application in the Azure Portal for OAuth2 Account.
None.
|
Field Name | Field Type | Description | ||
---|---|---|---|---|
Label* Default Value: N/A | String | Specify a unique name for the account. | ||
Instance URL* Default Value: N/A | String | Specify the host URL of the Business Central application in the following format:
| ||
Client ID*
Default Value: N/A | String | Specify the client ID associated with your OAuth2 application. You can create the client ID as advised by your application provider. Learn more about generating a Client ID: Application Configuration in Azure Portal for OAuth2 Account to use in Business Central | ||
Client secret
Default Value: N/A | String | Specify the client secret associated with your account. You can create the client secret as advised by your application provider. Learn more about generating a Client secret: Application Configuration in the Azure Portal for OAuth2 Account to use Business Central OAuth2 Account. | ||
Access token
Default Value: N/A | String | Auto-generated after authorization. | ||
Access token expiration Default Value: N/A | Integer | Auto-generated after authorization. The access token expiration value. | ||
OAuth2 Endpoint* Default Value: https://login.microsoftonline.com/<tenant-id>oauth2/v2.0/authorize | String | Specify the authorization endpoint to obtain the access token. Replace the tenant ID placeholder with the tenant ID generated when creating the OAuth2 application. | ||
OAuth2 Token* Default Value: https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token | String | Specify the token endpoint to obtain the access token. Replace the tenant ID placeholder with the tenant ID generated during OAuth2 account creation. | ||
Grant type
Default Value: authorization_code | String | Select one of the following grant types for authentication:
| ||
Token endpoint config | Use this field set to define custom properties for the OAuth2 token endpoint. This endpoint returns access tokens or refresh tokens based on the request parameters. | |||
Token endpoint parameter Default Value: N/A | String | Specify the name for the token endpoint parameter. | ||
Token endpoint parameter value Default Value: N/A | String | Specify the value for the parameter. | ||
Auth endpoint config | Use this field set to define custom properties for the OAuth2 authentication endpoint. | |||
| Authentication parameter Default Value: N/A | String | Specify the authentication parameter . | |
Authentication parameter Value Default Value: N/A | String | Specify the associated value for the authentication parameter. |
Error | Reason | Resolution |
---|---|---|
Authentication failed. | You entered an incorrect Client ID or Client secret. | Ensure that you have provided valid Client ID and Client secret values for the account and allowed the required access privileges to the application. Reauthorize the account and retry. |