Chuyển đến nội dung chính
Kết nối workspace GitGuardian để agent CloudThinker liệt kê và phân loại sự cố lộ secret, truy từng thông tin xác thực bị lộ về nguồn và các lần xuất hiện của nó, và xem lại honeytoken. Kết nối đăng nhập bằng Personal Access Token (PAT) của GitGuardian cùng URL dashboard của bạn, nên cùng một cách thiết lập dùng được cho instance US, EU và self-hosted.

Điều kiện tiên quyết

  • Workspace GitGuardian chứa các sự cố bạn muốn agent đọc.
  • Quyền tạo Personal Access Token trong workspace đó.
  • Role Admin trong workspace CloudThinker, role có quyền thêm và sửa kết nối. Xem Roles.
  • URL dashboard của bạn. Dùng đúng địa chỉ bạn đăng nhập:

Thiết lập

1

Tạo Personal Access Token

Đăng nhập GitGuardian. Ở thanh bên, mở Settings → API → Personal Access Tokens và nhấn Create token:
  • Name: cloudthinker
  • Expiration: chọn ngày phù hợp với chính sách xoay vòng của bạn
  • Scopes: đánh dấu biến thể đọc của incidents, secrets và sources (ví dụ incidents:read). Bộ này đủ cho prompt xác minh và các ví dụ prompt. Chỉ thêm scope khác trong Quyền yêu cầu khi bạn cần.
Sao chép token ngay. GitGuardian chỉ hiển thị token một lần.
2

Thêm kết nối trong CloudThinker

Ở thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn GitGuardian. Điền:
  • GITGUARDIAN_URL: URL dashboard hoặc instance của bạn theo bảng trên
  • GITGUARDIAN_PERSONAL_ACCESS_TOKEN: token bạn vừa tạo
Nhấn Connect.Trạng thái thành công: GitGuardian hiển thị Connected trong danh sách Connections. Sau đó mở chat mới và gửi prompt xác minh để kiểm tra scope của token.
Nếu làm mất token, bạn không xem lại được. Tạo token mới trong GitGuardian rồi dán vào kết nối.

Chi tiết kết nối

Để kết nối workspace GitGuardian thứ hai, thêm workspace đó thành một kết nối riêng với token riêng.

Quyền yêu cầu

Mỗi scope của PAT mở một nhóm khả năng của agent. Khi GitGuardian có cả biến thể :read và :write, hãy chọn :read. Nếu agent báo không làm được việc gì đó, thường là token đang thiếu scope tương ứng.
PAT còn kế thừa role workspace của người tạo. Hãy tạo PAT từ thành viên có ít quyền nhất mà vẫn đủ quyền truy cập bạn cần, và chọn quyền đọc mỗi khi scope cho phép.

Khả năng của agent

Thao tác đọc chạy mà không cần hỏi. Tạo honeytoken cần honeytokens:write và token do một Manager tạo, và chỉ xảy ra khi bạn yêu cầu. Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi. Để được hỏi trước mỗi lần tạo honeytoken, chọn Manual. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Ask first có thể nhắm riêng vào thao tác tạo honeytoken.

Xác minh kết nối

Kết quả mong đợi gồm danh sách scope trên token và số sự cố đang mở, tức là sự cố ở trạng thái Triggered hoặc Assigned. Nếu thiếu một scope bạn mong đợi, token cần được cập nhật.

Ví dụ prompt

Khắc phục sự cố

Token sai, đã hết hạn hoặc bị thu hồi. Tạo Personal Access Token mới. Trong More → Workspace settings → Connections, mở GitGuardian, nhấn biểu tượng bút chì trên dòng của kết nối, nhấn Replace…, dán token vào GITGUARDIAN_PERSONAL_ACCESS_TOKEN và nhấn Save and test.
Token thiếu scope cho yêu cầu đó, hoặc role workspace của người tạo token quá thấp. Thêm scope trong GitGuardian (tạo honeytoken cần Manager), rồi cập nhật kết nối bằng token mới.
Token thiếu scope tương ứng. Đối chiếu yêu cầu với Quyền yêu cầu, tạo token có scope đó và cập nhật kết nối.
GITGUARDIAN_URL đang trỏ sai region hoặc instance. Token US không dùng được với dashboard EU. Dùng đúng địa chỉ bạn đăng nhập.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Ưu tiên scope đọc: chỉ thêm honeytokens:write hoặc dùng token của role Manager khi bạn muốn agent tạo honeytoken.
  • Token riêng: đặt tên cloudthinker để bạn thu hồi được trong GitGuardian mà không làm hỏng công cụ khác.

Liên quan

Kết nối Semgrep

Quét file và đọc các phát hiện về code từ Semgrep.

Approvals

Kiểm soát những thay đổi GitGuardian nào phải chờ người duyệt.