SK(Secret Key)発行ガイド
エージェントやAPIが特定のプロジェクト(CSN)にアクセスする際に使用する秘密鍵 SK(Secret Key)を、サービス一覧画面で発行する手順を案内します。
📋 概要
SK(Secret Key) は、giipAgent、giip-fde-agent スケジューラ、各種 API が「このリクエストは対象プロジェクトのものである」ことを証明する際に使う秘密鍵です。プロジェクトを作成した直後、エージェントをインストールする前に、このキーを先に発行しておく必要があります。
- SK は プロジェクト(CSN)とそのプロジェクト内のグループの組み合わせ 単位で発行されます。
- 発行された SK はそのプロジェクトの範囲でのみ有効で、他のプロジェクトにはアクセスできません。
🛠️ 発行手順
- GIIP にログインし、上部で SK を発行する プロジェクトを選択 します。
- サービス一覧 画面へ移動します。現在のプロジェクトに属するグループの一覧が表示されます。
- SK を発行する グループ行の [SK生成] ボタン を押します。そのグループの SK が発行され、行に SKEY 値が表示されます。
- 発行された SK を使用先へ安全に渡します。たとえば giip-fde-agent スケジューラは、PC の
giipAgent.cnf(またはgiipAgent.cfg)ファイルからsk=の値としてこのキーを読み取ります。
⚠️ 注意事項
- 再発行すると既存の SK は即座に無効になります。 すでに SK があるグループでもう一度 [SK生成] を押すと新しい SK が発行され、以前の SK はその瞬間から認証に失敗します(401 Invalid session)。すでにエージェントが稼働しているグループで再発行する場合は、使用先のキーも合わせて交換してください。
- SK の値をチャット・ドキュメント・ログに残さないでください。 SK が漏れると、そのプロジェクトへのアクセス権限がそのまま渡ってしまいます。
- 発行権限がない場合は、そのプロジェクトの管理者に SK の発行を依頼してください。
➡️ 次のステップ
SK を発行したら、作業 PC に giip-fde-agent をインストールし、gissue スケジューラを登録 して、イシューが自動で処理されるようにします。
バージョン: 1.0
最終更新日: 2026-11-14
ソースファイル: giipv3/public/help/secret-key.ja.md