Knowledge Base API への認証済みアクセスをサポートするテクニカルアカウントを作成します。
テクニカルアカウントは Knowledge Base での認証用のアプリケーション資格情報を提供します。テクニカルアカウントの作成では、Knowledge Base 固有のアクセス要件とアドビの標準デベロッパーおよび OAuth Server-to-Server 資格情報ワークフローが組み合わされます。
はじめる前に
テクニカルアカウントを設定する担当者には、次の条件が必要です:
- Acrobat Studio エンタープライズ版ライセンス。
- 該当する Acrobat Shared Credits 製品へのアクセス。
- Developer Console へのアクセス。
- 組織の Knowledge Base へのアクセス。
テクニカルアカウント自体には次のプロビジョニングが必要です。
- Acrobat Studio エンタープライズ版ライセンス。
- 該当する Acrobat Shared Credits 製品へのアクセス。
API 資格情報を作成するユーザーには、Adobe Admin Console 内の該当する製品プロファイルへのデベロッパーアクセスも必要です。デベロッパーアクセスにより、API 資格情報を作成し、製品プロファイルに関連付ける権限が付与されます。
テクニカルアカウント資格情報の作成
アドビの標準 OAuth Server-to-Server 資格情報ワークフローを使用して、テクニカルアカウントで使用する資格情報を作成します。
Adobe Developer Console で OAuth Server-to-Server 資格情報を作成し、統合に必要な製品プロファイルに関連付けます。
OAuth Server-to-Server 資格情報の設定。
OAuth Server-to-Server 資格情報は、認証された API リクエスト用のアクセストークンを生成するためにアプリケーションが使用するクライアント情報を提供します。
API 資格情報アクセスの管理
API 資格情報は 1 つ以上の製品プロファイルに関連付けられます。これらのプロファイル割り当てにより、資格情報を使用して行われる API リクエストで利用可能な権限が決まります。
管理者は Adobe Admin Console でこれらの関連付けを確認および変更できます。製品プロファイルの関連付けを変更または削除すると、関連する製品へのアプリケーションのアクセスが変更または終了される可能性があります。
テクニカルアカウントの資格情報を使用する
テクニカルアカウントが設定されると、アプリケーションはその OAuth Server-to-Server 資格情報を使用して、サポートされている Knowledge Base API リクエストを認証できます。
同じ統合に取り組んでいる他のデベロッパーは、組織用に別のテクニカルアカウントを作成する必要はありません。アプリケーションは、個人デベロッパーのインタラクティブユーザーセッションではなく、テクニカルアカウントの資格情報を使用して認証します。
API アクセスの設定を続行
テクニカルアカウントの資格情報の作成は、Knowledge Base API アクセスの設定の一部です。
資格情報が利用可能になったら、アプリケーションの Knowledge Base 固有の認証、権限、検証の要件を完了します。
テクニカルアカウントの検討事項
- 初期のテクニカルアカウント設定では、該当する Studio ライセンス、共有クレジットアクセス、および Knowledge Base アクセスが必要です。
- API 資格情報を作成するユーザーは、該当する製品プロファイルへのデベロッパーアクセス権を持っている必要があります。
- API 資格情報に関連付けられた製品プロファイルによって、API 呼び出しで利用可能な権限が決まります。
- OAuth Server-to-Server 資格情報により、個人開発者のインタラクティブセッションとは独立してアプリケーションリクエストが認証されます。
- 管理者は Adobe Admin Console で API 資格情報の製品プロファイル割り当てを管理できます。
- 現在のエンドポイント、リクエスト要件、およびスキーマについては、Knowledge Base API リファレンスを使用してください。