Apple SSOの概要 apple-sso-overview
Appleを使用すると、デバイスのシステムレベルでTV プロバイダーアカウントにログインできるので、アプリごとの認証が不要になります。
Adobe Pass Authenticationは、Appleと提携し、iPhone、iPad、Apple TV オーナー向けに、TV Everywhere エコシステムにおけるパートナーシングルサインオン(SSO)ユーザーエクスペリエンスを構築しました。
Apple デバイスでシングルサインオン(SSO)ユーザーエクスペリエンスを利用するには、次の前提条件のリストを満たす必要があります。
最終的な結果は、次のユーザーフローに沿ったエクスペリエンスを作成する必要があります。アプリケーションの開発を開始する前に参照することをお勧めします。
前提条件 apple-sso-prerequisites
オンボーディングの前提条件は、プログラマー、MVPD、Adobe Pass認証、Appleなど、TVE事業に関わる1つまたは複数のエンティティに適用されます。
プログラマー apple-sso-prerequisites-programmer
シングルサインオン(SSO)ユーザーエクスペリエンスを利用するには、1人のプログラマーが次の条件を満たす必要があります。
-
Apple チーム IDの一部としてVideo Subscriber Account Frameworkを有効にし、Apple デベロッパーアカウントの一部としてVideo Subscriber Single Sign-On Entitlementを設定するには、Appleにお問い合わせください。
- Xcode バージョン 8以上およびiOS/tvOS バージョン 10以上を使用してください。
-
Enable Single Sign OnプロパティをYesに設定して、Adobe Pass TVE ダッシュボード を介して、目的の統合およびプラットフォーム(iOS/tvOS)ごとにシングルサインオン(SSO)を有効にします。
-
IOS、iPadOS、またはtvOSで動作するクライアントアプリケーションのエンドユーザーに対して、Adobe Pass Authenticationが提供する次のいずれかのソリューションを使用して、シングルサインオン(SSO)ユーザーフローを統合します。
-
Adobe Pass Authentication REST API V2は、パートナーシングルサインオン(SSO)をサポートしています。
Apple SSO クックブック (REST API V2) のドキュメントを参照してください。
-
従来のAdobe Pass Authentication REST API V1は、パートナーシングルサインオン(SSO)をサポートしています。
(Legacy) Apple SSO Cookbook (REST API V1) のドキュメントを参照してください。
-
従来のAdobe Pass Authentication AccessEnabler iOS/tvOS SDKは、パートナーシングルサインオン(SSO)をサポートしています。
(Legacy) Apple SSO Cookbook (iOS/tvOS SDK) のドキュメントを参照してください。
-
MVPD apple-sso-prerequisites-mvpd
シングルサインオン(SSO)のユーザーエクスペリエンスを利用するには、MVPDで次の操作を行う必要があります。
-
Appleに連絡して、Apple側でオンボーディングプロセスを開始してください。
- ユーザーのログインフォームを処理できるJavaScript TVML アプリケーションの統合および開発方法に関する技術ドキュメントをリクエストします。
-
Adobe Pass Authenticationに連絡して、Adobe側でオンボーディングプロセスを開始します。
- オンボーディングプロセス中にAppleによって割り当てられたTV プロバイダー識別子を表す文字列値を指定します。
FAQ FAQ
-
Apple SSO ワークフローに問題が発生した場合、Adobe Pass Authentication AccessEnabler iOS/tvOS SDKを使用しているアプリケーションは、通常の認証フローにフォールバックできますか?
これは可能ですが、目的の統合とプラットフォーム(iOS/tvOS)の NO で シングルサインオンを有効にする を設定するには、Adobe Pass TVE ダッシュボード を通じて設定を変更する必要があります。 クライアントアプリケーションは、setRequestor APIを呼び出した後にのみ設定変更を承認することに注意してください。
-
Apple SSOを介したログインの結果、認証がいつ行われたのかをアプリケーションに知らせますか?
この情報は、ユーザーメタデータキー tokenSource の一部として利用できます。この場合、文字列値である「Apple」を返す必要があります。
-
別のアプリケーションでApple SSOを使用してログインした結果、認証がいつ発生したかをアプリケーションに知らせますか?
この情報は利用できません。
-
IOS/iPadOSの
Settings -> TV ProviderまたはtvOSのSettings -> Accounts -> TV Providerのセクションに、アプリケーションと統合されていないMVPDを使用してログインした場合はどうなりますか?ユーザーがアプリケーションを起動すると、Apple SSO ワークフローを介してユーザーが認証されることはありません。 したがって、アプリケーションは通常の認証フローにフォールバックして、独自のMVPD ピッカーを表示する必要があります。
-
IOS/iPadOSの
Settings -> TV ProviderまたはtvOSのSettings -> Accounts -> TV Providerセクションにログインし、NOにAdobe Pass TVE Dashboardを通じて シングル サインオンを有効にする が設定されているMVPDを使用してiOS/tvOS プラットフォームにログインした場合はどうなりますか?ユーザーがアプリケーションを起動すると、Apple SSO ワークフローを介してユーザーが認証されることはありません。 したがって、アプリケーションは通常の認証フローにフォールバックして、独自のMVPD ピッカーを表示する必要があります。
-
Appleでオンボーディングされていない(サポートされていない)MVPDがApple ピッカーに表示されている場合、どうなりますか?
ユーザーがアプリケーションを起動すると、認証フローを完了することなく、Apple SSO ワークフロー経由でのみMVPDを選択します。 したがって、アプリケーションは通常の認証フローにフォールバックする必要がありますが、既に選択されているMVPDを使用できます。
-
ユーザーがAppleでオンボーディングされていない(サポートされていない)MVPDを持っている場合はどうなりますか?
ユーザーがアプリケーションを起動すると、Apple SSO ワークフローを介して「その他のTV プロバイダー」ピッカーオプションが選択されます。 したがって、アプリケーションは通常の認証フローにフォールバックして、独自のMVPD ピッカーを表示する必要があります。
-
ユーザーがAdobe Pass TVE ダッシュボード の中で劣化したMVPDを持っている場合はどうなりますか?
ユーザーがアプリケーションを起動すると、Apple SSO ワークフローではなく、劣化メカニズムを使用してユーザーが認証されます。 エクスペリエンスはユーザーにとってシームレスである必要がありますが、Adobe Pass Authentication AccessEnabler iOS/tvOS SDKを使用している場合は、N010の警告コードを通じてアプリケーションに通知されます。
-
Apple SSOとMVPD以外のSSO認証フローの間で、Apple ユーザーIDは変更されますか?
ユーザーIDは変更されませんが、選択した各プロバイダーについて確認する必要があります。
-
認証TTLに変更はありますか?
Adobe Pass Authenticationは、各MVPDとの統合に必要なプログラマが必要とするTTLを引き続き尊重します。 Apple SSOを介して別のプログラマーアプリケーションにプログラマーアプリケーションから移動する場合、2番目のアプリケーションには、対応するプログラマーx MVPD統合のTTLがあります(認証した最初のアプリケーションのTTLは共有されません)