Client Credentials Flow

この認証方式では、アプリケーションはクライアント ID やクライアントシークレットといったアプリケーションの資格情報を用いてアクセストークンを取得します。このフローは、ユーザーではなくアプリケーション自体を認証・認可するため、あなたのアプリケーションやバックエンドサービスを含む Machine-to-Machine (M2M) アプリケーションに特に適しています。

このフローは、API クライアントの Allow client credentials flow オプション (Configuration > 公開 API クライアント) が有効になっている場合にのみ使用できます。トークンの権限は、同じ画面で API クライアントに割り当てられたロールに基づきます。Reporting API エンドポイントを呼び出すには、テナント管理者または Processing Supervisor ロールが必要です。このオプションが有効になっていないクライアントは、トークンエンドポイントから {"error":"invalid_client"} を受け取ります。

アクセストークンを取得するには、次を使用します:

POST リクエスト

テナントリージョンの token リソース:

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

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

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

application/x-www-form-urlencoded を指定した Content-Type ヘッダー
次のパラメーターを含むリクエストボディ

Parameter	説明
client_id	アプリケーション識別子。
client_secret	アプリケーションの秘密キー。
grant_type=client_credentials	クライアントクレデンシャルグラントを使用することを指定します。
scope=openid permissions global.wildcard	権限スコープを指定します。

サンプルリクエスト: 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"

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'

サーバーからの応答には、アクセストークンが含まれます:

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

Client Credentials の詳細については、こちらをご参照ください。

概要

開発者ガイド