このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

APIキーとシークレットキーを管理する

マネージャーと管理者は、キー管理ページを使用して API キーを作成および無効化したり、プロジェクトのシークレットキーを作成および削除したりできます。 すべての変更は永続的です。

API キーを使用してプロジェクトを識別することで、Amplitude は取り込んだデータをそのプロジェクトにルーティングできます。シークレットキーを使用して、プロジェクトデータを読み取ったり変更したりするサーバー側の分析 API に対する認証を行います。

次のことが可能です。

  • 複数の API キーとシークレットキーを作成し、名前を付けます。
  • 作成者のログと、そのキーに対して最後に行われたアクションを表示します。
  • API アクセスを無効にします。

キーを管理する

キーを管理するには、次の手順に従ってください。

  1. 上部のナビゲーションで [組織設定] を選択します。
  2. サイドナビゲーションで_APIキー_を選択します。

APIキー

APIキーはプロジェクトを識別するため、これによりAmplitudeは取り込んだデータを該当するプロジェクトにルーティングできます。APIキーの詳細についてはこちらをご覧ください。

レガシー API キー

APIキー管理を初めて使用する場合、レガシーAPIキーが_APIキー_タブに表示されます。Amplitudeはプロジェクトを作成したときにこのキーを作成しました。このキーを無効にすることはできませんが、ローテーションをクリックしてキーを置き換えることはできます。

API キーを生成する

APIキーを生成するには、以下の手順に従ってください。

  1. 興味のあるプロジェクトを選択します。
  2. APIキーを生成をクリックします。
  3. APIキーの名前を指定します。

このAPIキーをコピーして保存したり、別の場所で使用したりできます。

API キーの取り消し

API キーを取り消すには、以下の手順に従ってください。

  1. API キーを選択します。
  2. キーを取り消したいことを確認します。

取り消しをクリックすると、キーは恒久的に使用できなくなります。記録用のAPIキーは引き続き保持されます。

秘密鍵(ベータ)

シークレットキーは、プロジェクトデータの読み取りや変更を行うサーバー側の分析APIに対してユーザーを認証します。詳細については、キーとトークンを参照してください。

秘密鍵を生成する

秘密鍵を生成するには、次の手順に従ってください。

  1. 適切なプロジェクトを選択します。
  2. シークレットキーを生成をクリックします。
  3. 秘密鍵に名前を付けて、それを自分の記録にコピーします。 Amplitudeは秘密鍵を保存しておらず、秘密鍵を取得する方法はありません。 キー ID は秘密鍵の一意の識別子ですが、キーそのものではありません。

秘密鍵を削除する

秘密鍵を削除するには、削除したい秘密鍵を選択し、「DELETE」と入力してその意図を確認してください。

秘密鍵を削除した後は、その秘密鍵を使用したり、表示したり、復元したりすることはできません。

制限事項

  • 最大 50 個のアクティブなキーを使用できます。
  • キーの作成は瞬時に行われますが、まれに、失効したキーが機能しなくなるまでに最大 6 時間かかることがあります。 これは、レガシー API キーとレガシー以外の API キーの両方に適用されます。

これは役に立ちましたか?