Điều kiện tiên quyết
- Một organization SonarQube Cloud, hoặc một instance SonarQube Server hay Community Build mà CloudThinker truy cập được qua HTTPS. Với instance nội bộ, xem Truy cập dịch vụ nội bộ.
- Một tài khoản SonarQube dành cho CloudThinker, có quyền Browse trên các project agent cần đọc (xem Quyền yêu cầu).
- Vai trò Admin trong workspace CloudThinker, vai trò cần có để thêm kết nối. Xem Vai trò.
Thiết lập
- SonarQube Cloud
- SonarQube Server
1
Tạo user token
Đăng nhập SonarQube Cloud bằng tài khoản CloudThinker sẽ dùng. Vào My Account → Security, nhập tên như
cloudthinker, đặt ngày hết hạn, rồi nhấn Generate Token.Sao chép token. SonarQube chỉ hiển thị token một lần.2
Tìm organization key
Mở organization của bạn. Key là phần cuối của URL:
https://sonarcloud.io/organizations/<org-key>.3
Cấp quyền Browse trên các project
Với mỗi project agent cần đọc, mở project, vào Administration → Permissions, và cấp quyền Browse cho tài khoản CloudThinker. Thiếu quyền này, prompt xác minh sẽ trả về kết quả rỗng.
4
Thêm kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn SonarQube. Điền:
- SONARQUBE_TOKEN: token bạn vừa sao chép
- SONARQUBE_DEPLOYMENT_TYPE: SonarQube Cloud
- SONARQUBE_ORG: organization key của bạn
Chi tiết kết nối
Form hiển thị SONARQUBE_ORG hoặc SONARQUBE_URL tùy theo loại triển khai bạn chọn. Tùy chọn SonarQube Cloud kết nối tớisonarcloud.io. Không có trường region.
Quyền yêu cầu
User token hoạt động với quyền của tài khoản đã tạo ra nó. Cấp quyền project cho tài khoản đó trong SonarQube, theo từng project hoặc qua permission template.Khả năng của agent
Tên mức độ nghiêm trọng tuân theo chế độ của instance. Chế độ Multi-Quality Rule báo BLOCKER, HIGH, MEDIUM, LOW và INFO. Chế độ Standard Experience báo BLOCKER, CRITICAL, MAJOR, MINOR và INFO.
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.
Yêu cầu bị từ chối sẽ không được thử lại. Để tự quyết định từng thay đổi trạng thái, chẳng hạn đánh dấu một issue là false positive, hãy chọn Manual để người duyệt phê duyệt mọi thay đổi. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Ask first có thể thu hẹp việc này về riêng kết nối SonarQube. Một số tool phụ thuộc vào phiên bản SonarQube: dependency risk cần giấy phép Advanced Security, còn các tool kiểm tra tình trạng hệ thống chỉ hoạt động trên SonarQube Server.
Agent báo cáo số liệu của từng project như hiện tại. SonarQube trả về measure hiện hành, nên agent sẽ không khẳng định xu hướng nào trừ khi bạn yêu cầu so sánh các branch hoặc pull request.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Request trả về 401
Request trả về 401
Token sai, đã hết hạn hoặc bị thu hồi. Tạo user token mới, sửa kết nối và dán token vào SONARQUBE_TOKEN.
Kết nối tới SonarQube Server thất bại
Kết nối tới SonarQube Server thất bại
CloudThinker không truy cập được SONARQUBE_URL. Kiểm tra địa chỉ dùng HTTPS và truy cập được từ internet, không phải
localhost hay hostname nội bộ, và service SonarQube đang chạy.Không có project nào được trả về (Cloud)
Không có project nào được trả về (Cloud)
SONARQUBE_ORG sai, hoặc tài khoản của token không phải thành viên của organization đó. Sao chép key từ URL của organization và xác nhận tư cách thành viên.
Thiếu một số project
Thiếu một số project
Tài khoản của token thiếu quyền Browse trên các project đó. Cấp quyền Browse trên các project này trong SonarQube. Không cần kết nối lại; quyền có hiệu lực từ request tiếp theo.
Đổi trạng thái trả về 403
Đổi trạng thái trả về 403
Tài khoản thiếu quyền Administer Issues hoặc Administer Security Hotspots trên project đó. Cấp quyền trong SonarQube, rồi yêu cầu lại.
Không có dependency risk hoặc tình trạng hệ thống
Không có dependency risk hoặc tình trạng hệ thống
Phiên bản của bạn không có các tool đó. Dependency risk cần giấy phép Advanced Security, còn các tool kiểm tra tình trạng hệ thống chỉ có trên SonarQube Server.
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.
- Dùng user token: trên SonarQube Server, chọn loại User Token, không chọn Global Analysis Token, để quyền truy cập tuân theo quyền project của một tài khoản.
- Đặt ngày hết hạn: đặt ngày hết hạn cho token và xoay vòng trước khi token hết hạn.
Liên quan
Review
Nhận bình luận AI review trên mọi merge request và pull request.
Kết nối Semgrep
Cho agent phân loại các phát hiện phân tích tĩnh từ Semgrep.