動的クライアント登録(DCR)に関するFAQ rest-api-dcr-faqs
このドキュメントでは、Adobe Pass Authentication Dynamic Client Registration (DCR)の導入に関するよくある質問に対する概要を説明します。
動的クライアント登録(DCR)全体の詳細については、動的クライアント登録の概要のドキュメントを参照してください。
一般的なFAQ general-faqs
Dynamic Client Registration (DCR)を統合する必要があるアプリケーションを使用している場合は、新しいアプリケーションであるか、以前のメカニズムから移行する既存のアプリケーションであるかを問わず、この節から始めてください。
REST API V2 アクセスに関するFAQ rest-api-v2-access-faqs
1. 登録段階の目的は何か? rest-api-v2-access-faq1
登録フェーズの目的は、Dynamic Client Registration (DCR) プロセスを通じて、Adobe Pass Authenticationに対してクライアントアプリケーションを登録することです。
動的クライアント登録(DCR)プロセスでは、クライアントアプリケーションが登録フェーズの最終目標として、1組のクライアント資格情報を取得し、アクセストークンを取得する必要があります。
詳しくは、動的クライアント登録の概要のドキュメントを参照してください。
2. 登録フェーズは必須ですか? rest-api-v2-access-faq2
登録フェーズは必須ですが、クライアントアプリケーションがキャッシュされたクライアント資格情報のペアと有効なアクセストークンを持っている場合、このフェーズをスキップできます。
3. ソフトウェアステートメントとは何か?どれくらいの期間有効か? rest-api-v2-access-faq3
ソフトウェア文は、用語集のドキュメントで定義されている用語です。
ソフトウェアステートメントは、Adobe Pass TVE ダッシュボード から生成およびダウンロードできるJSON Web トークン(JWT)で構成されます。このトークンは、組織管理者またはAdobe Pass認証担当者が代わりに処理します。
ソフトウェアステートメントは無制限の期間で有効ですが、いつでもAdobe Pass認証担当者に取り消しを依頼することができます。
クライアントアプリケーションは、ソフトウェアステートメントを保存し、クライアント資格情報を取得する必要がある場合にそれを使用する必要があります。
詳しくは、動的クライアント登録の概要 ドキュメントを参照してください。
4. ソフトウェアステートメントを生成してダウンロードするには? rest-api-v2-access-faq4
この操作は、Adobe Pass TVE ダッシュボード を通じて、組織管理者の1人またはAdobe Pass認証担当者が代わりに実行します。
詳しくは、TVE ダッシュボード チャネル ユーザーガイド またはTVE ダッシュボード プログラマーユーザーガイド のドキュメントを参照してください。
5. ソフトウェアステートメントが失効した場合はどうなりますか? rest-api-v2-access-faq5
ソフトウェアステートメントが取り消された場合、考慮すべき重要な結果が1つあります。
- 失効したソフトウェアステートメントを使用するクライアントアプリケーションは、使用権限 フローを実行できなくなります。つまり、ユーザーはコンテンツの再生をブロックされます。
6. クライアントの資格情報とは何か?また、その有効期限はどれくらいか? rest-api-v2-access-faq6
クライアント資格情報は、用語集のドキュメントで定義されている用語です。
クライアント資格情報は、クライアント識別子とクライアント秘密鍵のペアで構成され、クライアント登録エンドポイントから取得できます。
クライアントの資格情報は、無制限の期間に有効です。
クライアントアプリケーションは、クライアントの資格情報を保存し、アクセストークンを取得する必要がある場合に無期限に使用する必要があります。
詳しくは、 クライアント資格情報の取得 ドキュメントを参照してください。
7. クライアント資格情報の管理方法 rest-api-v2-access-faq7
Adobe Pass Authenticationとクライアント間およびサーバー間の両方の統合が発生した場合に備えて、各ユーザーアプリケーションインスタンスの一意のクライアント資格情報のペアを管理することをお勧めします。
8. クライアントアプリケーションは、永続的なストレージにクライアントの資格情報をキャッシュしますか? rest-api-v2-access-faq8
クライアントアプリケーションは、クライアントの資格情報を保存し、アクセストークンを取得する必要がある場合に無期限に使用する必要があります。
9. キャッシュされたクライアント資格情報が失われた場合はどうなりますか? rest-api-v2-access-faq9
キャッシュされたクライアント資格情報が失われた場合、考慮すべき3つの重要な結果があります。
- クライアントアプリケーションは、新しいペアのクライアント資格情報を取得する必要があります。
- クライアントアプリケーションは、新しいペアのクライアント資格情報を使用して、新しいアクセストークンを取得する必要があります。
- クライアントアプリケーションは、以前に取得した認証済みプロファイルにアクセスできなくなります。そのため、ユーザーに再認証を依頼する必要があります。
10. アクセストークンとは何か、どのくらいの期間有効か? rest-api-v2-access-faq10
アクセストークンは、用語集のドキュメントで定義されている用語です。
アクセストークンは、クライアントトークンエンドポイントから取得できる ベアラートークン で構成されます。
アクセストークンは、発行の時点で指定された期間限定および短期間で有効です。
クライアントアプリケーションは、アクセストークンを保存し、REST API V2をターゲットする際に有効期限が切れるまで使用する必要があります。
クライアントアプリケーションは、不正な要求を防ぐために、現在のアクセストークンが期限切れになる前に新しいアクセストークンを取得する必要があります。
詳しくは、 アクセストークンの取得 ドキュメントを参照してください。
11. クライアントアプリケーションは、アクセストークンを永続的なストレージにキャッシュする必要がありますか? rest-api-v2-access-faq11
クライアントアプリケーションは、有効期限が切れるまでアクセストークンを保存して使用し、それを破棄して新しいトークンを取得する必要があります。
12. クライアントアプリケーションはどのようにアクセストークンを更新できますか? rest-api-v2-access-faq12
クライアントアプリケーションは、新しいアクセストークンの取得と同じ方法でアクセストークンを更新する必要がありますが、キャッシュされたクライアント資格情報を使用する必要があります。
クライアントアプリケーションは、アクセストークンを更新するために再登録しないでください。代わりに、保存されたクライアント資格情報を使用する必要があります。そうしないと、ユーザーは再認証する必要があります。
詳しくは、 アクセストークンの取得 ドキュメントを参照してください。
移行に関するFAQ migration-faqs
Dynamic Client Registration (DCR)を使用するために既存のアプリケーションを移行する必要があるアプリケーションを使用している場合は、この節を続行します。
REST API V2移行に関するFAQ rest-api-v2-migration-faqs
1. クライアントアプリケーションは、既存の登録アプリケーション(ソフトウェアステートメント)を再利用できますか? rest-api-v2-migration-faq1
クライアントアプリケーションは、既存の登録アプリケーション(ソフトウェアステートメント)を再利用できないため、REST API V2を使用するための新しい登録アプリケーション(ソフトウェアステートメント)を生成してダウンロードする必要があります。
この操作は、Adobe Pass TVE ダッシュボード を通じて、組織管理者の1人またはAdobe Pass認証担当者が代わりに実行します。
詳しくは、TVE ダッシュボード チャネル ユーザーガイド またはTVE ダッシュボード プログラマーユーザーガイド のドキュメントを参照してください。
現時点では、新しく登録されたアプリケーション(ソフトウェアステートメント)に対してREST API V2の使用を有効にするようにAdobe Pass認証担当者に依頼する必要があります。この操作を自動管理できるようにAdobe Pass TVE Dashboardが更新されます。
REST API V2を使用するクライアントアプリケーションで使用される登録アプリケーション(ソフトウェアステートメント)を区別するには、「RESTV2」など、登録アプリケーション名に特定のサフィックスを追加する必要があります。
2. クライアントアプリケーションは、既存のカスタムスキームを再利用できますか? rest-api-v2-migration-faq2
クライアントアプリケーションは、Adobe Pass TVE ダッシュボード を通じて生成された既存のカスタムスキームを再利用できます。
詳しくは、TVE ダッシュボード チャネル ユーザーガイド またはTVE ダッシュボード プログラマーユーザーガイド のドキュメントを参照してください。