APIキーの管理と生成
この記事では、Tealium APIで認証に使用されるAPIキーの管理と生成方法について説明します。
要件
- 自分のAPIキーを生成または無効化するには、同じプライマリアカウント内の別のユーザーによってユーザー管理者ロールまたはManage Usersレガシーパーミッションで認証されている必要があります。
- 同じプライマリアカウント内のユーザーに対してAPIキーを認証するには:
- Manage Usersレガシーパーミッションまたはユーザー管理者ロールを持っている必要があります。
- 同じプライマリアカウントにいる必要があります。
- ユーザーは少なくとも一度はプラットフォームにログインしている必要があります。
仕組み
APIキーは、Tealium APIで認証するために使用され、個々のユーザーアカウントにリンクされています。
APIキーは以下のように生成されます:
- Manage Usersレガシーパーミッションまたはユーザー管理者ロールを持つ管理者が、1人以上のユーザーに対してAPIキーを認証します。
- 認証アクションは、影響を受けるユーザーにメールをトリガーし、APIキーを生成するための認証が行われたことを通知します。これらのユーザーはその後、自分のAPIキーを生成することができます。
APIキーは認証、無効化、生成することができます。APIキーが生成され、ユーザーに表示された後は、再度取得することはできません。紛失または忘れたキーは、Manage Usersパーミッションを持つユーザーによってリセットまたは無効化する必要があります。
Manage Usersパーミッションについて
Manage Usersパーミッションを持つユーザーは以下のことができます:
- 自分のプライマリアカウント内の他のユーザーのAPIキーを認証(またはリセット)します。
- 自分のプライマリアカウント内の他のユーザーのAPIキーを無効化します。
APIキーの生成を認証された任意のユーザーは以下のことができます:
- 自分のAPIキーを生成またはリセットします。
- 自分のAPIキーを無効化します。
APIキーの管理
このセクションでは、以下の方法について説明します:
- ユーザーが自分のAPIキーを生成するための認証を行います。
- 自分のAPIキーを生成します。
- 1人以上のユーザーのAPIキー(認証、リセット、または無効化)を管理します。
ユーザーがAPIキーを生成するための認証
ユーザーがAPIキーを生成するために認証を行うには、Manage Usersレガシーパーミッションまたはユーザー管理者ロールを持つ管理者である必要があります。このステップでは、ユーザーのためにキーを生成するのではなく、ユーザーが自分のAPIキーを生成するための認証を行います。
ユーザーが自分のAPIキーを生成するための認証を行うには、以下の手順を使用します:
- 管理メニューで、Manage Usersをクリックします。User Managerダイアログが表示されます。
- チェックボックスを使用して、管理するユーザーを1人以上選択します。
- Edit/View User Settingsをクリックします。
- 左側のパネルでAPI Keyをクリックします。
- Authorize Generationをクリックします。
APIキーの認証メールが送信されたことを示すメッセージが表示されます。 - Closeをクリックしてウィンドウを閉じます。
APIキーの生成
ユーザーは自分のAPIキーを生成するために事前に認証を受ける必要があります。認証されると、ユーザーはAPIキーを生成するよう指示するメール通知を受け取ります。
メールが受信された後、ユーザーは以下の手順を使用して自分のAPIキーを生成することができます:
-
管理メニューで、Edit/View User Settingsをクリックします。
-
左側のパネルでAPI Keyをクリックします。
-
Generate Keyをクリックします。
APIキーが生成され、ポップアップウィンドウに表示されます。APIキーは一度だけ表示され、後で表示することはできません。このウィンドウを閉じると、APIキーは再表示できません。
-
進む前に、APIキーを安全な場所にコピーします。
-
Closeをクリックしてウィンドウを閉じます。
単一ユーザーのAPIキーを管理する
以下の手順を使用して、単一のユーザーのAPIキーを管理します:
- 管理メニューで、ドロップダウンリストからManage Usersをクリックします。
User Managerダイアログが表示されます。 - APIキーを管理したいユーザーの隣にあるチェックボックスをクリックします。
- Edit/View User Settingsをクリックします。
- 左側のパネルでAPI Keyをクリックします。
- 次のアクションのいずれかを選択します:
- Authorize Generation
ユーザーが自分のキーを生成するための認証を行います。 - Reset Key
既存のキーをリセットし、新しいキーの生成を認証します。 - Revoke Key
既存のキーを無効化します。
- Authorize Generation
- Closeをクリックしてダイアログを閉じます。
複数ユーザーのAPIキーを管理する
APIキーは、一括で認証、リセット、または無効化することができます。
一括でAPIキーを管理するには、以下の手順を使用します:
- 管理メニューで、ドロップダウンリストからManage Usersをクリックします。User Managerダイアログが表示されます。
- APIキーを管理したい各ユーザーの隣にあるチェックボックスをクリックします。
- Moreドロップダウンリストをクリックし、Manage API Keysを選択します。
選択したユーザーが左パネルに表示されます。 - 以下のアクションを選択します:
- Authorize / Reset Keys
- 新しいユーザーにAPIキーの生成を認証し、既存のユーザーのAPIキーをリセットします。
- 既存のキーはすぐに無効となり、ユーザーは新しいAPIキーを生成する必要があります。
- Revoke Keys
- 選択したユーザーの既存のAPIキーを無効化します。
- 無効化されたキーは、選択したユーザーに対してすぐに非アクティブになります。
- Authorize / Reset Keys
- Saveをクリックします。
確認メッセージが表示され、影響を受けるユーザーに更新に関するメール通知が送信されます。 - Closeをクリックしてウィンドウを閉じ、前の画面に戻ります。
最終更新日 :: 2024年November月6日