Acrobat の Analyzer の代理アクセスを設定する

代理アクセスが有効になると、中央のアプリケーションは個別のユーザー認証トークンを必要とせずに、ユーザー所有の Analyzer 文書やデータを操作できます。

代理アクセスを有効にした場合

テクニカルアカウントは承認されたユーザーの代理として次のことを実行できます。

• ユーザーの文書にアクセスする。
• ユーザーの文書から抽出された値を取得する。
• ユーザーのデータを検索する。
• ユーザーに文書をアップロードする。
• ユーザーが設定した属性を抽出する。

アクセスはテクニカルアカウントに明示的に承認されたユーザーにのみ適用されます。

要件

代理アクセスを要求する前に実行すること：

• Analyzer API アクセス権にテクニカルアカウントを設定します。
• テクニカルアカウントを使用して 1 回以上有効な Analyzer API 呼び出しを実行します。
• 各ユーザーがテクニカルアカウントと同じ組織に属していることを確認します。
• 代理アクセスが必要な各ユーザーの正確なメールアドレスを収集します。

アドビは、別の組織のユーザーまたは提供されたメールアドレスがユーザーのアカウントと正確に一致しない場合、代理アクセスのリクエストを却下します。

テクニカルアカウントを特定する

OAuth アクセストークンを生成し、API リクエストを行うテクニカルアカウントを特定します。

テクニカルアカウント ID を確認するには：

1. Adobe Developer Console でプロジェクトを開きます。
2. Analyzer に使用される OAuth Server-to-Server 資格情報を開きます。
3. アクセストークンの生成に使用されるページを開きます。
4. テクニカルアカウント ID を特定します。

テクニカルアカウント ID の末尾は @techacct.adobe.com です。

許可リストのリクエストを送信する前に、その ID が統合で使用しているテクニカルアカウントに属していることを確認してください。

ユーザーを特定する

テクニカルアカウントが代理でアクションするユーザーのリストを作成します。

各ユーザーに対して、次のことを実行します。

1. ユーザーの正確なアドビアカウントのメールアドレスを収集します。
2. ユーザーがテクニカルアカウントと同じ組織に属していることを確認します。

承認済み許可リストに含まれているユーザーのみが、代理リクエストを通じてアクセスできます。

代理アクセスをリクエストする

アドビサポートが各テクニカルアカウントの許可リストを管理します。

組織のシステム管理者は、以下を含むサポートリクエストを提出する必要があります。

• @techacct.adobe.com で終わるテクニカルアカウント ID。
• 許可リストに加えるユーザーのメールアドレスの完全なリスト。
• 組織のシステム管理者による承認の確認。

アドビはリクエストをレビューし、テクニカルアカウントに承認されたユーザーを設定します。

アドビが設定を更新する前に、テクニカルアカウントは 1 回以上の有効な Analyzer API 呼び出しを完了している必要があります。

ユーザーの代わりに API リクエストを実行する

アドビが許可リストを承認した後、承認されたユーザーに代わって実行するリクエストに x-on-behalf-user ヘッダーを含めてください。

次のようにヘッダーの値をユーザーの承認されたメールアドレスに設定してくだい。

x-on-behalf-user: user@example.com

テクニカルアカウントの OAuth Server-to-Server ベアラートークンを使用してリクエストの認証を続けます。

リクエストは x-on-behalf-user ヘッダーで識別されたユーザーのコンテキストで実行されます。ユーザーはテクニカルアカウントの承認済み許可リストに含まれている必要があります。