Resource Owner Password Credentials

Use the OAuth 2.0 Resource Owner Password Credentials flow to authenticate to the ABBYY Vantage API directly with a username and password (no browser).

This authentication scheme is relatively simple and allows the application to log into the user’s system without using the browser by directly processing the username and password.

If an external Identity Provider is configured for a tenant, the Resource Owner Password Credentials authentication scheme will not work.

To obtain the access token, use the following:

1. A POST request.
2. The token endpoint. If your email address is connected to several accounts in different tenants and you use this authentication, use https://vantage-<region>.abbyy.com/auth2/{tenantId}/connect/token. The https://vantage-<region>.abbyy.com/auth resource is deprecated.
3. A Content-Type header with the application/x-www-form-urlencoded encoding.
4. A request body with the following parameters:

Parameter	Description
grant_type=password	Specifies that the password grant type is used.
scope=openid permissions global.wildcard	Specifies the permission scope.
username and password	Your credentials.
client_id	Application identifier.
client_secret	Secure application key.

Sample request:

For Windows:

For Linux:

The server’s response to your request will contain the access token:

{
  "access_token": "<redacted>",
  "expires_in": 2592000,
  "token_type": "Bearer",
  "scope": "openid permissions global.wildcard"
}

For more information about Resource Owner Password Credentials, visit this link.