Client Credentials Flow

Este esquema de autenticación permite que una aplicación obtenga un token de acceso intercambiando sus credenciales de aplicación, como el client ID y el client secret. Este flujo es particularmente adecuado para aplicaciones Machine-to-Machine (M2M), incluidas su propia aplicación o los servicios de backend, ya que permite la autenticación y la autorización de la aplicación en sí, en lugar de la de un usuario.

Este flujo funciona solo si la opción Permitir Client Credentials Flow está habilitada para su cliente de API (Configuración > cliente de API pública). Los permisos del token provienen de los roles asignados al cliente de API en esa misma pantalla; la llamada a endpoints de Reporting API requiere el rol de Administrador del tenant o Supervisor de procesamiento. Un cliente sin la opción habilitada recibe {"error":"invalid_client"} del token endpoint.

Para obtener el token de acceso, use lo siguiente:

Una solicitud POST.

El recurso token de la región de su tenant:

https://vantage-us.abbyy.com/auth2/connect/token

https://vantage-eu.abbyy.com/auth2/connect/token

https://vantage-au.abbyy.com/auth2/connect/token

Un encabezado Content-Type con la codificación application/x-www-form-urlencoded.
Un cuerpo de la solicitud con los siguientes parámetros:

Parameter	Descripción
client_id	Identificador de la aplicación.
client_secret	Clave segura de la aplicación.
grant_type=client_credentials	Especifica que se utiliza el tipo de concesión de credenciales de cliente.
scope=openid permissions global.wildcard	Especifica el ámbito de permisos.

Solicitud de ejemplo: Para Windows:

curl --location --request POST "https://vantage-us.abbyy.com/auth2/connect/token" \
  --data-urlencode "client_id=client_id" \
  --data-urlencode "client_secret=client_secret" \
  --data-urlencode "grant_type=client_credentials" \
  --data-urlencode "scope=openid permissions global.wildcard"

curl --location --request POST "https://vantage-eu.abbyy.com/auth2/connect/token" \
  --data-urlencode "client_id=client_id" \
  --data-urlencode "client_secret=client_secret" \
  --data-urlencode "grant_type=client_credentials" \
  --data-urlencode "scope=openid permissions global.wildcard"

curl --location --request POST "https://vantage-au.abbyy.com/auth2/connect/token" \
  --data-urlencode "client_id=client_id" \
  --data-urlencode "client_secret=client_secret" \
  --data-urlencode "grant_type=client_credentials" \
  --data-urlencode "scope=openid permissions global.wildcard"

Para Linux:

curl --location --request POST 'https://vantage-us.abbyy.com/auth2/connect/token' \
  --data-urlencode 'client_id=client_id' \
  --data-urlencode 'client_secret=client_secret' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=openid permissions global.wildcard'

curl --location --request POST 'https://vantage-eu.abbyy.com/auth2/connect/token' \
  --data-urlencode 'client_id=client_id' \
  --data-urlencode 'client_secret=client_secret' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=openid permissions global.wildcard'

curl --location --request POST 'https://vantage-au.abbyy.com/auth2/connect/token' \
  --data-urlencode 'client_id=client_id' \
  --data-urlencode 'client_secret=client_secret' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=openid permissions global.wildcard'

La respuesta del servidor a tu solicitud incluirá el token de acceso:

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

Para obtener más información sobre Client Credentials, consulte este enlace.

Descripción general

Guía para desarrolladores