API keys

API keys は workspace の Cogno CLI workers を認証するために使います。key は app で作成し、raw key を1回だけコピーし、workspace settings から revoke します。

API keyの用途

現在の workspace API keys は worker scope です。CLI と worker daemon の認証に使います。

Keyを作成する

1. Cogno app を開きます。
2. workspace を選択します。
3. Settings > API Keys を開きます。
4. Create を選択します。
5. MacBook worker や CI worker のような name を入力します。
6. Create を選択します。
7. raw key をすぐにコピーします。

raw key は1回だけ表示されます。dialog を閉じた後、Cogno は key metadata と prefix だけを表示します。

CLIで使う

次を実行します。

cogno login --token <key>
cogno

その後 Settings > Workers を開きます。worker が register され、heartbeat を送り始めると表示されます。

Key formatと制限

Key名を付ける

revoke 判断がすぐできる name にします。

workspace を複数人で運用する場合、test、key、worker のような名前は避けます。

Keyを保存する

raw key は password と同じ扱いにします。

• local secret manager、CI secret store、environment variable に保存します。
• task comments、docs、chat、tickets、screenshots に貼らないでください。
• repository に commit しないでください。
• machine や service ごとに別 key を作成します。
• temporary key は作業完了後に revoke します。

Keyをrevokeする

1. Settings > API Keys を開きます。
2. name または prefix で key を見つけます。
3. revoke icon を選択します。
4. Revoke を確認します。

revoke は即時で、取り消しできません。その key を使っている workers はすぐ access を失います。継続稼働が必要な場合は、先に replacement key を作成します。

Keyをrotateする

1. 新しい key を作成します。
2. worker machine または service に新しい key を設定します。
3. worker を restart します。
4. Settings > Workers に worker が表示されることを確認します。
5. 古い key を revoke します。

Troubleshooting

LLM handoff

assistant に API key setup を手伝わせる場合は、次を渡します。

1. workspace name または ID
2. key name と visible prefix。raw key は渡さない
3. 実行した command
4. worker output または visible error text
5. key が created、rotated、revoked のどれか

Copy for LLM は workflow 共有に使います。terminal output を共有する前に secrets を削除してください。