> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starfort.io/llms.txt
> Use this file to discover all available pages before exploring further.
# API キーの管理
> Guardian の Guard API 呼び出しを認可する API キーを作成・管理します。
API キーは [Guard API](/ja/v1.2/api/quickstart) の呼び出しを認可します。キーは **API** プロジェクト内の **Guardian** に属します。
## キーを作成する
Guardian を開き → **API Keys** → **Add API Key**、名前を付けて **Create** をクリックします。
キーは確認ダイアログに**一度だけ**表示され、`sf_` で始まります。後から取得することはできないため、今すぐコピーしてください。
キーはパスワードと同様に扱ってください。キーの**名前**はすべての[トレース](/ja/v1.2/admin/monitoring-opticon)にタグとして表示されるため、呼び出し元や環境ごとに名前を付けてください（例: `prod-backend`）。キー名は**プロジェクト内で一意**である必要があります — そのすべての Guardian のキーをまたいで — そのため、名前はトレース内で呼び出し元を明確に識別します。
## キーのライフサイクル
| 状態 | 意味 | 遷移 |
| ------------ | ----------------------------------- | -------------------- |
| **Active** | 通常どおり動作します。 | → Inactive、→ Revoked |
| **Inactive** | 管理者によって一時的に無効化されています — 呼び出しは拒否されます。 | → Active、→ Revoked |
| **Revoked** | 恒久的に無効化されています。 | **なし — 不可逆** |
Active と Inactive は自由に切り替えられます。**Revoke は恒久的**です: 失効したキーは再有効化できません — 代わりに新しいキーを発行してください。
キーが欠落・無効・失効している呼び出しは **HTTP 401** を受け取ります — [認証](/ja/v1.2/api/authentication)と[エラーと状態](/ja/v1.2/api/errors)を参照してください。
## キーの状態と Kill Switch
キーの状態と [Kill Switch](/ja/v1.2/admin/kill-switch) は**独立**しており、Starfort は**すべてのリクエスト**で両方をチェックします:
* Kill Switch（組織、プロジェクト、または Guardian 上）は、オンの間、**Active** なキーであってもトラフィックをブロックします。キーは状態を保持し、Kill Switch がクリアされた瞬間に通常どおり再開します。
* Guardian より上のいずれかの Kill Switch がオンの間は、そこで**新しいキーを作成することもできません**。