Đ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,secretsvà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.
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
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.
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
Ví dụ prompt
Khắc phục sự cố
Kết nối thất bại hoặc yêu cầu trả về 401
Kết nối thất bại hoặc yêu cầu trả về 401
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.
Yêu cầu trả về 403
Yêu cầu trả về 403
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.
Agent báo một khả năng không khả dụng
Agent báo một khả năng không khả dụng
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.
Không có sự cố nào, hoặc không truy cập được endpoint
Không có sự cố nào, hoặc không truy cập được endpoint
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:writehoặ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.