Skip to main content
GitGuardian ワークスペースを接続して、CloudThinker エージェントがリポジトリ全体のシークレットインシデントの参照、漏洩した認証情報の調査、ハニートークンの監視を行えるようにします。GitGuardian は Personal Access Token（PAT） で認証します。CloudThinker はダッシュボード URL から適切なエンドポイントを自動的に判別するため、US、EU、セルフホストのいずれのインスタンスでも同じセットアップ手順で動作します。

​
対応プラットフォーム

​
前提条件

  • レビューしたいインシデントへのアクセス権を持つ GitGuardian ワークスペース。
  • CloudThinker がアクセスすべきデータのスコープを持つ Personal Access Token。
  • ハニートークンの作成には：ワークスペースの Manager ロール。
PAT は付与したスコープと、作成したワークスペースメンバーのロールを継承します。CloudThinker が必要とする範囲をカバーしつつも最小権限のメンバーから発行してください。

​
セットアップ

1

GitGuardian を開く

GitGuardian ダッシュボード（US、EU、またはセルフホスト URL）にサインインします。
2

Personal Access Token を作成する

サイドバーで Settings をクリックし、API → Personal Access Tokens に移動して Create token をクリックします：
  • Name: cloudthinker
  • Expiration: ローテーション期間を設定
  • Scopes: CloudThinker がアクセスすべきデータのスコープを選択（まずは incidents から始めることを推奨）
トークンを直ちにコピーします — 一度しか表示されません。
3

CloudThinker に接続を追加する

Connections → GitGuardian に移動し、以下を入力します：
  • GitGuardian URL: ダッシュボードまたはインスタンスの URL
  • Personal Access Token: 作成したトークン
Connect をクリックします。CloudThinker がトークンを検証し、Connected ステータスを表示します。
Personal Access Token は作成直後にコピーしてください。GitGuardian は一度しか表示しないため、紛失した場合は新しいものを発行する必要があります。

​
接続の詳細

CloudThinker は URL から API エンドポイントを自動的に判別するため、US、EU、セルフホストのいずれの形式でも追加設定なしに動作します。

​
必要な権限

GitGuardian のアクセスは スコープ駆動型 です。各 PAT スコープが対応する機能ファミリーを解放します。機能が欠けている場合、接続の問題ではなくトークンにそのスコープが不足していることがほとんどです。 CloudThinker がアクセスすべきデータのスコープを選択してください。インシデントのトリアージには incidents から始め、必要に応じて追加してください。
CloudThinker が必要なスコープのみ付与してください。多くのスコープは個別の 読み取り および 書き込み アクセスを提供しています — 書き込み機能が必要でなければ読み取り専用を選択してください。

​
エージェントの機能

接続後、エージェントは GitGuardian ワークスペースへのスコープ制御アクセスを持ちます。
ハニートークンの作成はワークスペースの状態を変更します。CloudThinker は書き込みを実行する前に明示的な承認と Manager ロールのトークンを必要とします。

​
接続を確認する

​
プロンプト例

​
トラブルシューティング

PAT に対応するスコープが不足しています。必要な GitGuardian スコープを追加して再発行または更新し、再接続してください。
PAT が無効、期限切れ、または失効しています。新しい Personal Access Token を作成して CloudThinker の接続を更新してください。
トークンのスコープまたはワークスペースのロールが不十分です。必要なスコープまたはワークスペースロールを付与してください。ハニートークンへの書き込みには Manager ロールが必要です。
インシデントが空になるか、エンドポイントに到達できません。GitGuardian URL がワークスペースのリージョン（US、EU）またはセルフホストインスタンスと一致していることを確認してください。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • スコープ駆動型アクセス — CloudThinker が必要なスコープのみ付与してください。スコープで読み取り専用アクセスが提供されている場合は読み取り専用を優先してください。
  • 書き込みには Manager ロール — ハニートークンを作成する必要があるセットアップのために Manager ロールのトークンを確保し、ハニートークンの作成を承認ゲート付きに維持してください。

​
関連

SonarQube 接続

コード品質とセキュリティスキャン

Atlassian 接続

インシデントを Jira 課題として追跡する