Amazon Fire TVにおけるAdobe Primetime SSO（シングルサインオン）のヒントとコツ

SSOワークフローには、次の4つの重要な手順があります。

1. 初期化： Androidクライアントアプリが、Adobe Primetime認証のネイティブAmazon Fire OSライブラリ（AccessEnabler）を使用してAdobe Primetime認証を開始します。
2. 認証： 認証フローが開始されるか、ユーザーが既に認証されていることが確認されます。
3. 認可： 認可フローで、ユーザーが認証されており、リクエストしたメディアの視聴が許可されていることが確認されます。有効期間の短いメディアトークンが返されます。
4. メディアトークンの発行： 有効期間の短いメディアトークンが検証されます。有効であれば、そのトークンがAndroidクライアントアプリに発行され、メディアが再生されます。

以下は、SSOプロセスの各手順の概要です。

ユーザーは、このワークフローのエンタイトルメントの手順を行っています（図1： High-Level Single Sign-on Flowも参照）。

初めてユーザーを認証する呼び出しでは、有効な認証情報を使用して選択されたMVPDにユーザーを正常にログインさせ、返された認証トークンをバックエンドサーバーに保存する必要があります。その後の認証呼び出しでは、ユーザーが既に認証済みであることを確認してから、アプリへのシングルサインオンの権限をユーザーに付与することが理想です。しかし、これらの呼び出しでエラーが発生するとMVPDへのログイン要求が繰り返し表示されます。

このエラーは、単にFire TVプラットフォームでSSOを使用する権限がアプリにない、つまりSSOの許可リストにアプリが登録されていないことが原因である可能性があります。

図1のワークフローでは、認証が完了しているかをSSOコンパニオンアプリが確認する前に、アプリが許可リストに追加されているか（つまり、アプリがFire TVでSSOを使用する権限があるかどうか）を確認します。許可されていない場合、ユーザーは、MVPDリストが表示されるページ以降の手順に進むことができません。

これが、実際にログインの問題の原因であるかどうかを確認するには、デバイスログで次のエラーを探します。

このエラーは、Fire TVプラットフォームでSSOを使用するための権限をアプリに付与する必要があることを意味します。この作業は、AmazonのFire TVソリューションアーキテクトと共同で行ってください。

アプリパッケージ名がSSOに対して承認されたら、デバイスキャッシュが更新されるまで24時間ほど待つ必要があります。引き続き同じエラーが発生する場合は、パッケージ名を確認してください。デバッグパッケージ名と本番パッケージ名の両方を許可リストに追加する必要があります。

引き続き同じエラーが発生する場合は、次のコマンドを使用してコンパニオンアプリのキャッシュを手動でクリアする必要があります。

上記の例では、このデバイス上のSSOコンパニオンアプリの最終更新バージョン番号は4810です。ただし、最新バージョンのAdobe SDKでは、システムのSSOコンパニオンアプリのバージョン番号は5510以降である必要があります。SMPデバイスでSSOコンパニオンアプリを更新するには、デバイスの [設定] > [My Fire TV] > [バージョン情報] > [アップデートをチェック] の順にクリックします。Fire TV Editionデバイス（日本未対応）では、[Settings] > [Device & Software] > [About] > [Check for Updates] の順にクリックします。システムアップデートが表示されなくなるまで、このコマンドを繰り返し実行します。adbバージョンコマンドを再度実行すると、次のような結果が表示されるはずです。