開発者ポータルアプリケーション

アプリケーションは、API呼び出しを行うシステムまたはサービスを表す資格情報のセットです。各アプリケーションにはクライアントIDとクライアントシークレットがあります。あなたの統合はこれらの資格情報を使用してAPIリクエストのためのアクセストークンを取得します。

アプリケーションを作成するとき、1つ以上のAPIに登録し、各APIに対して付与されるスコープ（アクセスレベル）を選択します。その後、アプリケーションは指定したAPIとTealiumアカウントにスコープされたトークンをリクエストする権限を持ちます。例えば、分析ダッシュボード用のアプリケーションとサードパーティ統合用の別のアプリケーションを作成することができます。

詳細については、スコープを参照してください。

アプリケーションの作成

アプリケーションを作成する際、同じワークフローの一部としてAPIサブスクリプションを構成します。

サイドバーのアプリケーションに移動し、アプリケーションを作成をクリックします。
名前とオプションの説明を入力し、作成をクリックします。
登録したいAPIを選択し、次へ: スコープの構成をクリックします。
スコープを選択します。各セクションを展開して利用可能なスコープを表示し、アプリケーションが必要とする各リソースとアクションのペアをチェックします。トークンには選択したスコープのみが含まれます。アプリケーションが必要とするもののみをリクエストしてください。詳細については、スコープを参照してください。
Tealiumユーザーとしてログインしている場合は、次へ: アカウントプロファイルをクリックします。このサブスクリプションがカバーするTealiumアカウントとプロファイルを選択します。
外部開発者は代わりに次へ: レビューを見て、アカウントプロファイルとエンジンのステップをスキップします。Tealiumの顧客リソースへのアクセスは、サードパーティアプリアクセスを通じてリソースオーナーによって付与されます。
選択したAPIがエンジンアクセスを必要とするかどうかに応じて、次へ: エンジンを選択または次へ: レビューをクリックします。
エンジンを選択します（該当する場合）。Context APIのようにエンジンレベルのアクセスを必要とするAPIの場合、エンジンを選択ステップが表示されます。エンジンはアカウントとプロファイルごとにグループ化されます。特定のエンジンを選択するか、後で追加されるエンジンを自動的に含めるために**すべてのエンジン（現在および将来）**を選択します。無効になっているエンジンも選択できます。警告チップが表示され、後で有効にすることができます。このステップをスキップして、後でエンジンアクセスを付与することもできます。
サブスクリプションを作成をクリックします。
アプリケーションを表示をクリックして、新しいアプリケーションの詳細ページに移動します。

既存のアプリケーションにサブスクリプションを追加する方法、スコープの編集、またはエンジンアクセスの管理については、サブスクリプションを参照してください。

作成後、確認画面からクライアントシークレットをコピーしてください。シークレットは一度だけ表示されます。作成直後またはシークレットを回転させた後にすぐにコピーしてください。シークレットマネージャーや環境変数に保存してください。クライアントシークレットをソースコントロールに保存しないでください。

アプリケーションの詳細を表示

アプリケーション画面で、アプリケーションをクリックしてその詳細を表示します。

クライアントID: OAuth2フローで使用されるアプリケーションの公開識別子です。
クライアントシークレット: クライアントIDと共に使用される秘密です。シークレットは作成直後またはシークレットを回転させた後にのみ表示されます。保存していない場合は、シークレットを回転を使用して新しいものを生成します。
アカウントアクセス: このアプリケーションがアクセスできるTealiumアカウントとプロファイルです。このセクションはTealiumユーザーのみ利用可能です。詳細については、アカウントアクセスの編集を参照してください。
外部グラント: 他のユーザーがこのアプリケーションに付与したTealiumアカウントとプロファイルです。このカードは外部グラントが存在する場合にのみ表示されます。
エンジンアクセス: アプリケーションがアクセスできるContext APIエンジンです。
サブスクリプション: アプリケーションが登録されているAPI、その状態、および付与されたスコープです。
APIバージョン: 各APIのサブスクリプションが対象とするバージョンです。

すべてのアカウントとプロファイルの関連付けとアクティブなスコープのクロスアプリケーションビューについては、サイドバーのTealiumアカウントに移動してください。このセクションはTealiumユーザーのみ利用可能です。

ベアラートークンの生成

アプリケーションの詳細ページからテスト用のベアラートークンを生成できます。トークンを生成をクリックし、オプションのスコープを入力して返されたトークンをコピーします。詳細については、認証を参照してください。

クライアントシークレットの回転

クライアントシークレットが侵害されたり失われたりした場合は、回転させます。

アプリケーションの詳細ページを開きます。
シークレットを回転をクリックします。プロンプトが表示されたら確認します。
新しいシークレットをコピーして、このアプリケーションの資格情報を使用するすべてのシステムを更新します。

シークレットを回転させると、古いものはすぐに無効になります。古いシークレットで発行された既存のアクセストークンは、有効期限が切れるまで動作を続けますが、新しいトークンリクエストには新しいシークレットが必要です。

アプリケーションの削除

削除する前に、アプリケーションのすべてのアクティブなサブスクリプションを終了します。

削除するには：

アプリケーションの詳細ページを開きます。
削除をクリックし、ダイアログで確認します。

アプリケーションの削除は永久的です。アプリケーションはもはやAPI呼び出しを行うことができず、その資格情報は無効になります。

アカウントアクセスの編集

アカウントアクセスは、アプリケーションのトークンがカバーするTealiumアカウントとプロファイルを制御します。アカウントアクセスの編集はスコープの編集とは別であり、サブスクリプションウィザード内ではなく、アプリケーションの詳細ページで直接管理されます。

アプリケーションの詳細ページを開きます。
アカウントアクセスの見出しの隣にある編集をクリックします。
アカウントアクセスの編集ダイアログで、アカウントとプロファイルを追加または削除します。
変更を保存します。

このオプションはTealiumユーザーのみ利用可能です。アプリケーションにアクティブなサブスクリプションがない場合、編集ボタンは無効になります。

エンジンアクセス管理

エンジン強制APIの場合、アプリケーションの詳細ページにはエンジンアクセスセクションが表示されます。このセクションでは、APIごとに付与されたエンジンがアカウントとプロファイルごとにグループ化されて表示されます。

付与されたエンジンは編集可能として表示されます。
他のユーザーによって付与されたエンジンは「他のユーザーによって付与された」というチップとともに表示され、変更することはできません。
すべてのエンジンチップは、そのプロファイルのすべてのエンジンをカバーするワイルドカード付与を示します。

エンジンの選択はいつでも編集できます。変更は即時に有効になります。新しいトークンは更新されたエンジンアクセスを反映します。