> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/manage-api-keys-in-the-dashboard.md).

# ダッシュボードで API キーを管理する

RoboflowダッシュボードからワークスペースAPIキーを作成、名前変更、ロール、保護、無効化、取り消しでき、キー一覧のバッジと警告を確認できます。

「設定」>「API Keys」には、ワークスペースのプライベートキーと、それぞれのキーに実行できる操作が表示されます。このページを表示するには「View Workspace API Keys」権限が必要です。この権限はデフォルトで管理者に付与されています。コードやエージェントからキーを管理する方法については、 [API Key Management API](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/manage-api-keys.md).

<figure><img src="https://1568109427-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmbAGf4KNeNPXGuUuKYv%2Fuploads%2Fgit-blob-12c5d1165945971573f6fcc7050e680d67e299a8%2Fapi-keys-settings-table.png?alt=media" alt="Settings, API Keys, with three workspace keys, their badges and row actions"><figcaption><p>「設定」>「API Keys」：各行には、キーのバッジ、マスクされた値と表示・コピーのボタン、ローテーションの状態、行の操作が表示されます。</p></figcaption></figure>

## キーの一覧

各行には、キーの名前、バッジ、作成日時と作成者、マスクされた値と表示・コピーのボタン、行の操作（「編集」、「保護」、「ロール」、「無効化」、「取り消し」）が表示されます。

<table data-search="false"><thead><tr><th width="180">バッジ</th><th>意味</th></tr></thead><tbody><tr><td>デフォルト</td><td>コードスニペットやバックグラウンド処理でアプリが使用するキーです。詳しくは、 <a href="#default-and-in-use-keys">デフォルトキーと使用中のキー</a>.</td></tr><tr><td>使用中</td><td>有効なデフォルトキーがない場合、アプリはこのキーを使用します。該当するものがあればフルアクセスのワークスペースキー、なければ必要な権限を持つ有効なワークスペースキーのうち、最も古いものが使われます。</td></tr><tr><td>保護済み</td><td>保護を解除するまで、キーを無効化、取り消し、ロールできません。詳しくは、 <a href="#protect-a-key">キーを保護する</a>.</td></tr><tr><td>無効</td><td>再度有効にするまで、このキーは拒否されます。バッジにカーソルを合わせると、無効になった理由が表示されます。</td></tr><tr><td>フルアクセスまたはスコープ設定済み</td><td>キーでワークスペースが許可するすべての操作を実行できるか、キーに選択した操作のみを実行できるかを示します。詳しくは、 <a href="https://docs.roboflow.com/reference/ja/ren-zheng/authentication/scoped-api-keys.md#scoped-keys">スコープ設定済みキー</a>.</td></tr><tr><td>ローテーション期限、期限までの日数、本日期限、期限超過、ローテーション日未設定</td><td>キーのローテーション期限がどれくらい近いか、または期限が設定されていないことを示します。詳しくは、 <a href="https://docs.roboflow.com/reference/ja/ren-zheng/authentication/rotate-api-keys.md#rotation-reminders">ローテーションのリマインダー</a>.</td></tr><tr><td>新規</td><td>キーがロールによって作成された直後であることを示します。</td></tr></tbody></table>

デバイス用に Deployment Manager が作成したキーでは、行の操作の代わりに「View Device」ボタンが表示されます。デバイスから管理してください。

## キーを作成する

「Generate New Key」をクリックし、「Key Name」を入力して、「Create API Key」をクリックします。「API Key Created」ダイアログに値が表示されます。シークレットマネージャー、またはコミット対象外の環境ファイルに保存してください。「Use and Copy API Keys」権限を持つメンバーは、一覧から値を再度コピーできます。APIとCLIでは、値は再表示されません。

キーを使う対象にちなんだ名前を付けてください（例：「ci-pipeline」、「line-3-camera-gateway」）。キーのローテーション時に、名前から影響を受ける対象がわかります。

「Create Api Key」権限を持つメンバーは誰でもキーを作成できます。フォルダーを対象範囲とするキー、またはすべてのフォルダーを参照できるキーを作成するには、それらのフォルダーへのアクセス権が必要です。

## キーの名前を変更する

「Edit」アイコンをクリックし、「Key Name」を変更して、「Save API Key」をクリックします。名前を変更しても、キーの値は変わりません。

## キーをロールする

「ロール」すると、キーが取り消され、置き換えのキーが一度の操作で作成されます。Dedicated Deployments は新しいキーに自動で切り替わります。それ以外の利用先は、新しい値に更新してください。詳しくは、 [APIキーをローテーションする](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/rotate-api-keys.md) を参照して、ロールするタイミングと事前に確認する項目を確認してください。

## キーを保護する

盾のアイコンをクリックして、確認します。保護されたキーは、保護を解除するまで無効化、取り消し、ロールできず、権限も変更できません。この制限はダッシュボード、API、CLI、MCP Server で適用されます。

キー管理スコープを持つ自動エージェントやスクリプトによって本番環境のキーが無効化されないよう、保護してください。保護を解除できるのはダッシュボードのみです。盾のアイコンをもう一度クリックして、確認します。

## キーを無効化・有効化する

一時停止アイコンをクリックして、確認します。このキーを使用するアプリケーションでは、すぐに認証エラーが発生します。再度有効にするには、再生アイコンをクリックします。値は変わらないため、利用先を更新しなくても再び動作します。

無効化には [Advanced API Keys](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/scoped-api-keys.md)が必要です。保護されたキーは無効化できません。Dedicated Deployment が使用するキーは、依存関係に関する警告を確認すれば無効化できます。その場合、デプロイは数分以内に一時停止します。

## キーを取り消す

ゴミ箱アイコンをクリックして、確認します。取り消しは取り消せず、すぐに有効になります。一覧から最後のワークスペースキーを取り消すことはできません。また、保護されたキーは保護を解除するまで取り消せません。Dedicated Deployment が使用するキーは、依存関係に関する警告を確認すれば取り消せます。その場合、デプロイは数分以内に一時停止します。API、CLI、MCP Server からは、そのキーの取り消しは拒否されます。詳しくは、 [APIキーを取り消す](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/manage-api-keys.md#revoke-an-api-key).

## 依存関係に関する警告

ロール、取り消し、または無効化の前に、ダイアログには、Roboflow が把握しているキーへの依存先が一覧表示されます。項目が表示されている場合、または確認を完了できなかった場合は、続行する前に「このキーに依存するものを把握したうえで、続行します」（操作に応じて「ロール」「取り消し」「無効化」）にチェックを入れる必要があります。

<table data-search="false"><thead><tr><th width="200">依存関係</th><th>続行するとどうなるか</th></tr></thead><tbody><tr><td>専用デプロイ</td><td>キーのローテーション中は、デプロイは新しいキーに切り替わります。切り替えられないデプロイがある場合、ローテーションは失敗し、古いキーが引き続き有効です。キーを失効または無効化すると、数分以内にデプロイが一時停止します。それぞれの設定で有効なキーを割り当ててから、再開してください。</td></tr><tr><td>請求フォルダー</td><td>このキーによる使用量の帰属は停止し、別のキーに切り替わります。</td></tr><tr><td>エッジデバイス</td><td>これらのデバイスのストリーム認証情報は、このキーで暗号化されています。キーをローテーションまたは失効すると読み取れなくなり、デバイスを再度プロビジョニングする必要があります。キーを無効化すると、再び有効にするまでAPIアクセスが停止します。</td></tr><tr><td>ワークスペースのデフォルト</td><td>バックグラウンドジョブ（例：データセットのエクスポート、トレーニング、自動ラベル付け、Workflowのストリーミング）は別のキーに切り替わります。</td></tr><tr><td>最近の使用状況</td><td>このキーには過去30日間に請求対象の使用実績があります。現在は使用先が変わっている可能性があるため、ご自身で確認してください。</td></tr></tbody></table>

この警告の対象は、Roboflowが確認できる範囲です。お客様のシステムに保存されているキーは一覧に表示されません。詳しくは、 [キーの使用場所を確認する](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/rotate-api-keys.md#find-where-the-key-is-used).

## デフォルトキーと使用中のキー

ワークスペースに複数のキーがある場合でも、アプリはコードスニペットや、ユーザーに代わって実行する操作（例：モデル評価結果の表示）にそのうち1つのキーを使用します。使用するキーを選択するには、キーの作成時または「編集」で「このワークスペースのデフォルトAPIキーに設定」にチェックを入れます。このキーには「デフォルト」バッジが表示されます。デフォルトを選択するには、 [高度なAPIキー](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/scoped-api-keys.md).

デフォルトキーには、これらの操作に必要な権限が引き続き付与されている必要があります。 `workspace:read`, `project:read`, `version:read`, `image:read`, `model:infer` および `workflow:read`が必要です。キーがデフォルトである間、Roboflowがこれらの権限を追加し、変更できないようにします。フォルダーキーをデフォルトにすることはできません。

有効なデフォルトキーがない場合、アプリはフルアクセスのワークスペースキーがあればそれを使用し、なければ必要な権限を持つ最も古い有効なワークスペースキーに切り替わります。そのキーには「使用中」バッジが表示されます。キーを無効化または失効する前にこのバッジを確認し、ワークスペースの操作や請求対象の使用量にどのキーが使われているか把握してください。

必要な権限を持つキーがない場合、テーブルに警告が表示されます。ワークスペースキーを作成できるメンバーの場合、アプリがキーを必要とした次の機会に自動で作成します。作成できないメンバーの場合、誰かがフルアクセスキーを生成するかデフォルトを設定するまで、アプリが代わりに実行する操作は失敗します。対象となる操作には、モデルの実行、Workflowの実行とプレビュー、自動ラベル付け、モデル評価、データセットのエクスポートが含まれます。

## 権限

各操作には、 [ロールベースのアクセス制御](https://docs.roboflow.com/platform/enterprise-features/role-based-access-control)にある権限が対応します。管理者はすべての権限を持ちます。カスタムロールでは、権限を個別に付与できます。

<table data-search="false"><thead><tr><th width="240">操作</th><th>権限</th></tr></thead><tbody><tr><td>設定を開く、「APIキー」</td><td>ワークスペースのAPIキーを表示</td></tr><tr><td>キーの値をコピー</td><td>APIキーを使用・コピー</td></tr><tr><td>キーを作成</td><td>APIキーの作成</td></tr><tr><td>名前の変更、保護、無効化、デフォルトへの設定</td><td>APIキーの更新</td></tr><tr><td>キーを失効</td><td>APIキーの失効</td></tr><tr><td>キーをローテーション</td><td>APIキーの作成とAPIキーの失効</td></tr></tbody></table>

「ワークスペースのAPIキーを表示」権限がないメンバーも、書き込み可能なフォルダーのキーであれば、フォルダーカードのメニューから管理できます。詳しくは、 [フォルダーAPIキー](https://docs.roboflow.com/reference/ja/ren-zheng/authentication/scoped-api-keys.md#folder-api-keys).
