API キー

API キーは、組織レベルでロールベースのアクセス制御(RBAC)を使用して管理されます。各キーは組織全体のロールと任意のアプリロールを割り当てることができ、各キーがアクセスできるものを細かく制御できます。

API キーはどこで管理されますか?

以下の手順に従ってください 設定 > 組織 > API キー コンソールの console.capgo.app/settings/organization/api-keys.

このページには2つのセクションがあります。

• RBAC キー — ロールが割り当てられているキーより推奨されます。これらのキーは、新しいロールベースの許可システムを使用します。
• レガシーキー — ロールの割り当てなしでシンプルモードベースのシステム (read, upload, write, all) を使用する古いキーより

新しいAPI キーを作成する方法

1. 新しい__CAPGO_KEEP_0__ キーを作成する方法 ”+” RBACキー表の先頭のボタン。

2. 入力してください。 キー情報:

   • キー名 (必須) — キーの説明ラベル (例: "CI/CD Deploy", "Monitoring Read-Only")
   • 安全なキーを作成 (任意) — チェックすると、キーはサーバー側でハッシュ化されます。平文のキーは、作成後一度だけ表示されます。後で取得することはできません。 __CAPGO_KEEP_0__ キー作成フォームの名前、安全なキーオプション、および有効期限 キー作成フォームの名前、安全なキーオプション、および有効期限を設定
   • 有効期限を設定 (任意) — 有効期限が設定された後、キーは機能を停止します。組織によっては、強制的な有効期限設定ポリシーが設定されています。

3. 組織役職を選択してください Organization role — この定義は、組織全体の基準的な権限をキーにします。利用可能な役割（あなたの役割レベルに応じて）：

   • None — 組織全体へのアクセスなし；キーは個別に割り当てられたアプリにのみアクセスします。
   • Member — 組織の基本的な読み取り権限。
   • Admin — 組織全体への完全な管理権限（すべてのアプリへのアクセスを継承）。

4. 選択した組織役職が Admin ではない場合、追加の per-app access:

   • Click ”+ アプリを追加” アプリを選択するためのアプリ ピッカーを開く。
   • 1 つ以上のアプリを選択し、それぞれに役割を割り当てる:
     • アプリ リーダー — アプリに読み取り専用のアクセス権限。
     • アプリ アップローダー — 新しいバンドルをアップロードできる。
     • アプリ デベロッパー — アプリの構成とデプロイメントを管理できる。
     • アプリ アドミン — アプリにフル アクセス権限。

5. Click 「作成」.

6. 「Create secure key」をチェックした場合、モーダルウィンドウが表示されます。 その時点で表示されるプレーンテキストのキーをすぐにコピーしてください。 モーダルウィンドウを閉じると復元できません。

API キーを管理（編集）する方法

「__CAPGO_KEEP_0__ キーの管理（編集）方法」セクション 「__CAPGO_KEEP_0__ キーの管理（編集）方法」セクションの「」アイコンをクリックしてください。 「(Manage)」ボタンをリスト内の任意のRBACキーにクリックしてください。

• (Manage)ボタンをクリックすると、キー詳細ページが開きます。ここでは、 name.
• Update the 組織ロール.
• Add, remove, or change アプリごとのロール.

Click “Save Changes” 完了したら。

API キーを再生成する方法

API キーのシークレット値を再生成するには、 更新アイコン (Regenerate) をリスト内の任意のキーで入力します。

__CAPGO_KEEP_0__ キーの再生成確認後、確認ダイアログが表示されます。

• 安全な(ハッシュ化された)キー用 : モーダル内で一度表示される新しいプレーンテキスト キーが生成され表示されます。すぐにコピーしてください。プレーンキーの場合
• : キー値はサーバー側で再生成されます。 古いキー値を使用しているすべての統合が即座に停止します。__CAPGO_KEEP_0__ キー削除方法

キー削除方法

API

リスト内の任意のキーに表示される ゴミ箱アイコン (削除) をクリックして、確認ダイアログで削除を確定してください。

キーは即時削除されます — これを使用したリクエストはすべて失敗します。

レガシーキー

セクション (役割割り当てなしのキー) を見つけた場合、これらは古いモードベースのパーミッションシステム ( ) を使用しています。まだ機能していますが、RBAC の細かいパーミッションの利点を受け取っていません。 レガシーキーread, upload, write, allレガシーキー

既存のキーはリストから再生成および削除できますが、RBACロールを追加するために編集することはできません。可能な場合、RBACキーを作成し、既存のキーを削除することをお勧めします。

必要に応じて、直接既存のキーを管理する必要がある場合は、 console.capgo.app/dashboard/apikeys このページは廃止予定であり、将来のアップデートで削除されます。

「API キー」から続けてください。

「__CAPGO_KEEP_0__ キー」を使用して、ダッシュボードと__CAPGO_KEEP_0__の実行を計画する場合、 API キー API キー 「API キー」 「API キー」 「__CAPGO_KEEP_0__ キー」の実装詳細については、「__CAPGO_KEEP_0__ キー」 for the implementation detail in Introduction、 API Keys for the implementation detail in API Keys、 Devices for the implementation detail in Devices、 Bundles for the implementation detail in Bundles。