レッスン 2/7 · 8 分

チームの API キー

アプリと環境ごとに上限付きのキーを用意し、自動化には管理キーを使い、停止時間なしでキーをローテーションします。

オーナーと管理者は、設定 → APIキー で API キーを作成します。全員で 1 つのキーを共有するのではなく、アプリと環境ごとに 1 つのキー を使ってください。そうすれば、キーごとの使用量を確認し、上限を設け、ほかに影響を与えずに差し替えられます。シークレットは一度しか表示されないので、すぐにシークレットマネージャーに保存します。

どのキーにも、リクエストと支出について 1 日、1 週間、1 か月単位の上限を設定できます。上限はリクエストのたびに確認され、UTC の午前 0 時、月曜日、または毎月 1 日にリセットされます。上限に達すると、期間がリセットされるまで、そのキーを使ったリクエストは拒否されます。キーのセキュリティ には、漏えいした場合に被害が出るおそれのあるキーが一覧表示されます。支出上限がない、有効期限がない、90 日以上使われていない、どの IP アドレスからでも使える、といったキーです。

キーを作成したり使用量を読んだりするスクリプトなどの自動化には、設定 → 管理キー の 管理キー を使います。管理キーではモデルリクエストを送れません。テンプレートとして 読み取り、書き込み(削除なし)、すべて のいずれかを選ぶか、必要なケイパビリティだけを選びます。管理キーができることは、その背後にいる人のロールが許す範囲を超えることはありません。

キーを差し替えるには、ローテーション を選びます。Phaseo は同じ上限を持つ代わりのキーを作成し、現在のキーの有効期限を選ばせてくれます。すぐ、1 時間後、24 時間後、7 日後、指定した日時、または期限なしです。古いキーが期限切れになる前に、アプリを新しいキーに移してください。キーは一時停止して後で再開することも、完全に削除することもできます。無効にしたキーを再び有効にすることはできません。

理解度チェック

チームで、毎晩 API キーを作成・削除するスクリプトを動かしたいと考えています。どの認証情報を使うべきですか?

実践してみる

開発者から、本番の API キーが 1 時間前に公開リポジトリにプッシュされたと報告がありました。どうしますか?

答えを表示

すぐにキーをローテーションし、現在のキーをただちに期限切れにするよう選びます。新しいシークレットをシークレットマネージャーに保存し、アプリを更新します。そのうえで、設定 → ログ でそのキーのリクエストに見覚えのないものがないか確認します。まずローテーション、調査はその後です。

ポイント

アプリと環境ごとに 1 つのキーを使い、それぞれに支出上限を設ければ、漏えいの被害は小さく、ローテーションも簡単になります。

関連リンク

進捗はこのブラウザーに保存されます。

最終確認日:2026年11月17日