(レガシー) iOS/tvOS アプリケーションの登録 iostvos-application-registration
概要 Intro
IOS/tvOS AccessEnabler SDKのバージョン 3.0以降、Adobeのサーバーを使用して認証メカニズムを変更しています。 公開鍵と秘密鍵を使用して依頼者IDに署名する代わりに、SDKがサーバーに対して行うすべての呼び出しに後で使用されるアクセストークンを取得するために使用できるソフトウェアステートメント文字列の概念を導入します。 ソフトウェアステートメントに加えて、アプリケーションのカスタム URL スキームも必要になります。
詳しくは、動的クライアント登録の概要を参照してください。
ソフトウェアに関する声明とは? Soft_state
ソフトウェアステートメントは、アプリケーションに関する情報を含むJWT トークンです。 各アプリケーションには、Adobe システム内のアプリケーションを識別するためにサーバーが使用する一意のソフトウェアステートメントが必要です。 AccessEnabler SDKを初期化する際にソフトウェア ステートメントを渡す必要があり、それを使用してアプリケーションをAdobeに登録します。 登録時に、SDKはクライアント IDとアクセストークンの取得に使用されるクライアント秘密鍵を受け取ります。 SDKが当社のサーバーに対して行う呼び出しには、有効なアクセストークンが必要です。 SDKは、アプリケーションの登録、アクセストークンの取得と更新を担当します。
注: ソフトウェア ステートメントはアプリ固有であり、同じソフトウェア ステートメントを複数のアプリケーションで使用することはできません。 プログラマレベルのソフトウェアステートメントも同じである、つまり、単一チャネルでもマルチチャネルでも、単一のアプリケーションにのみ使用できます。 この制限は、カスタムスキームにも適用されます。
ソフトウェアステートメントを取得するには? obtain
AdobeのTVE ダッシュボードにアクセスできる場合:
- ブラウザーを開き、https://experience.adobe.com/#/pass/authenticationに移動します
Channelsセクションに移動し、チャネルを選択します。- 「
Registered Applications」タブに移動します。 Add new applicationをクリックします。- アプリケーションの名前とバージョンを入力し、使用可能なプラットフォームを選択します。 iOS/tvOSです。
- 変更をサーバーにプッシュし、チャネルの「登録済みアプリケーション」タブに戻ります。
- 登録されたすべてのアプリケーションのリストが表示されます。 作成したアプリケーションの
Downloadボタンをクリックします。 ソフトウェアステートメントをダウンロードする準備が整うまで、数分待つ必要がある場合があります。 - テキストファイルがダウンロードされます。 ソフトウェアステートメントとしてコンテンツを使用します。
詳しくは、動的クライアント登録管理を参照してください。
AdobeのTVE ダッシュボードにアクセスできない場合:
tve-support@adobe.comへのチケット送信。 チャネル、アプリケーション名、バージョン、プラットフォームなど、必要な情報をすべて含めてください。また、サポートチームの担当者がソフトウェアに関する声明を作成します。
ソフトウェアステートメントの使用方法 use
ソフトウェア ステートメントを取得したら、Access Enabler コンストラクターのパラメーターとして渡す必要があります。 ソフトウェアステートメントをリモートの場所でホストすることをお勧めします。 これにより、アプリケーションの新しいバージョンをリリースしなくても、ソフトウェアのステートメントを簡単に取り消して変更できます。
アプリケーションのカスタム URL スキームの生成 generating
AdobeのTVE ダッシュボードにアクセスできる場合:
- ブラウザーを開き、https://experience.adobe.com/#/pass/authenticationに移動します
Channelsセクションに移動し、チャネルを選択します。- 「
Custom Schemes」タブに移動します。 Generate a new custom schemeをクリックします。- アプリケーション用に新しいカスタムスキームが生成されます。 例:
adbe.1JqxQsYhQOCIrwPjaooY8w:// - 変更をサーバーにプッシュします。
AdobeのTVE ダッシュボードにアクセスできない場合:
tve-support@adobe.comへのチケット送信。 チャネル IDを含めてください。サポートチームからカスタムスキームを作成します。
カスタムスキームの使用方法 use_custom
アプリケーションのinfo.plist ファイルに次のコードを追加します。
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array>
<string>adbe.u-XFXJeTSDuJiIQs0HVRAg</string> // replace this with your custom scheme
</array>
</dict>
</array>