Flux d’identifiants client

Utilisez le flux OAuth 2.0 Client Credentials pour les intégrations machine-to-machine ABBYY Vantage : échangez l’ID client et le secret client contre un jeton d’accès à l’API.

Ce mécanisme d’authentification permet à une application d’obtenir un jeton d’accès en échangeant ses identifiants d’application, tels que l’ID client et le secret client. Ce flux est particulièrement adapté aux applications Machine-to-Machine (M2M), y compris votre application ou vos services backend, car il permet d’authentifier et d’autoriser l’application elle-même plutôt qu’un utilisateur.

Ce flux fonctionne uniquement si l’option Autoriser le flux d’identifiants client est activée pour votre client d’API (Configuration > client d’API public). Les autorisations du jeton proviennent des rôles attribués au client d’API sur ce même écran ; l’appel des points de terminaison de l’API Reporting nécessite le rôle d’administrateur du tenant ou de superviseur du traitement. Un client pour lequel l’option n’est pas activée reçoit {"error":"invalid_client"} du point de terminaison du jeton.

Pour obtenir le jeton d’accès, utilisez les éléments suivants :

1. Une requête POST.
2. La ressource https://vantage-[region].abbyy.com/auth2/connect/token.
3. Un en-tête Content-Type avec l’encodage application/x-www-form-urlencoded.
4. Un corps de requête avec les paramètres suivants :

Parameter	Description
client_id	Identifiant de l’application.
client_secret	Clé sécurisée de l’application.
grant_type=client_credentials	Indique que le type d’octroi par identifiants client est utilisé.
scope=openid permissions global.wildcard	Indique le périmètre d’autorisation.

Exemple de requête :

Pour Windows :

Pour Linux :

La réponse du serveur à votre demande contiendra le jeton d’accès :

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

Pour plus d’informations sur le flux Client Credentials, consultez ce lien.