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 アクセスを無効にします。
キーを管理する
キーを管理するには、次の手順に従ってください。
- 上部のナビゲーションで [組織設定] を選択します。
- サイドナビゲーションで_APIキー_を選択します。
APIキー
APIキーはプロジェクトを識別するため、これによりAmplitudeは取り込んだデータを該当するプロジェクトにルーティングできます。APIキーの詳細についてはこちらをご覧ください。
レガシー API キー
APIキー管理を初めて使用する場合、レガシーAPIキーが_APIキー_タブに表示されます。Amplitudeはプロジェクトを作成したときにこのキーを作成しました。このキーを無効にすることはできませんが、ローテーションをクリックしてキーを置き換えることはできます。
API キーを生成する
APIキーを生成するには、以下の手順に従ってください。
- 興味のあるプロジェクトを選択します。
- APIキーを生成をクリックします。
- APIキーの名前を指定します。
このAPIキーをコピーして保存したり、別の場所で使用したりできます。
API キーの取り消し
API キーを取り消すには、以下の手順に従ってください。
- API キーを選択します。
- キーを取り消したいことを確認します。
取り消しをクリックすると、キーは恒久的に使用できなくなります。記録用のAPIキーは引き続き保持されます。
秘密鍵(ベータ)
シークレットキーは、プロジェクトデータの読み取りや変更を行うサーバー側の分析APIに対してユーザーを認証します。詳細については、キーとトークンを参照してください。
秘密鍵を生成する
秘密鍵を生成するには、次の手順に従ってください。
- 適切なプロジェクトを選択します。
- シークレットキーを生成をクリックします。
- 秘密鍵に名前を付けて、それを自分の記録にコピーします。 Amplitudeは秘密鍵を保存しておらず、秘密鍵を取得する方法はありません。 キー ID は秘密鍵の一意の識別子ですが、キーそのものではありません。
秘密鍵を削除する
秘密鍵を削除するには、削除したい秘密鍵を選択し、「DELETE」と入力してその意図を確認してください。
秘密鍵を削除した後は、その秘密鍵を使用したり、表示したり、復元したりすることはできません。
制限事項
- 最大 50 個のアクティブなキーを使用できます。
- キーの作成は瞬時に行われますが、まれに、失効したキーが機能しなくなるまでに最大 6 時間かかることがあります。 これは、レガシー API キーとレガシー以外の API キーの両方に適用されます。
これは役に立ちましたか?