Điều kiện tiên quyết
- Một server chấp nhận kết nối SSH từ CloudThinker trên port SSH. CloudThinker kết nối thẳng tới Host: không có trường jump host hay bastion. Với server nằm sau tường lửa hoặc không có địa chỉ công khai, xem lựa chọn Environment trong Truy cập dịch vụ private. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ CloudThinker của bạn, hoặc liên hệ với chúng tôi.
- Một user đăng nhập có quyền shell, và
sshdđã bật xác thực bằng public key. - Một cặp key có public key nằm trong
~/.ssh/authorized_keyscủa user đó. - Vai trò Admin trong workspace CloudThinker, cần thiết để thêm kết nối. Xem Vai trò.
Thiết lập
1
Tạo cặp key riêng
Tạo một key chỉ CloudThinker dùng, để bạn thu hồi được mà không ảnh hưởng tới thứ khác:Lệnh này tạo
cloudthinker_key (private) và cloudthinker_key.pub (public). Key RSA hoặc ECDSA sẵn có ở định dạng OpenSSH hoặc PEM cũng dùng được.2
Cấp quyền cho public key trên server
cloudthinker_key.pub vào cuối ~/.ssh/authorized_keys của user.3
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, chọn SSH, nhấn Connect, rồi điền Host, User, Port và Private key. Chỉ điền Passphrase nếu key có passphrase. Nhấn Connect.CloudThinker kết nối, ghi lại host key của server và chạy kiểm tra. Lượt kiểm tra thường xong trong 30 giây và hết thời gian chờ sau 45 giây.Trạng thái thành công: hộp thoại hiển thị Connected kèm thông báo “SSH connection verified and saved.”
# trong ô nhập prompt.
Chi tiết kết nối
Quyền yêu cầu
Lệnh chạy dưới user đăng nhập, với đúng quyền của user đó. Quyền của user này chính là ranh giới thực sự cho những gì CloudThinker làm được trên server. Lệnh chạy không có terminal, nên không thể trả lời prompt hỏi password củasudo. Nếu muốn CloudThinker chạy một lệnh cần đặc quyền, hãy cho phép riêng lệnh đó chạy không cần password trong /etc/sudoers.d/:
Khả năng của agent
Xác minh kết nối
Ví dụ prompt
Quyền ghi
Lệnh đọc chạy mà không cần hỏi. Lệnh làm thay đổi server đi qua Approvals, và CloudThinker hiển thị lệnh đó trong yêu cầu phê duyệt. 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. Lệnh shell có dạng tự do, và CloudThinker tự quyết định lệnh nào được tính là thay đổi. Hãy coi bước phê duyệt là lớp kiểm tra thứ hai, và dựa vào quyền của user đăng nhập để chặn những gì CloudThinker tuyệt đối không được làm.Xác minh host key
Ở lần kết nối đầu tiên, CloudThinker tin cậy và ghi lại host key của server. Mọi lần kết nối sau đều kiểm tra key còn khớp hay không. CloudThinker không hiển thị fingerprint, nên hãy đảm bảo lần kết nối đầu tiên tới đúng server. Nếu key thay đổi, kết nối dừng lại và hiển thị Host key changed. Điều này là bình thường sau khi dựng lại server hoặc xoay vòng host key. Để chấp nhận key mới, nhấn biểu tượng khiên (Trust new host key) cạnh server và xác nhận bằng Trust.Khắc phục sự cố
Authentication failed
Authentication failed
- Kiểm tra public key đã nằm trong
~/.ssh/authorized_keyscủa user đăng nhập. - Kiểm tra User đúng là tài khoản đã được cấp quyền cho key.
- Dán toàn bộ private key, gồm cả dòng
BEGINvàEND. - Nhập Passphrase nếu key có passphrase.
Could not reach the host
Could not reach the host
- Kiểm tra Host và Port.
- Cho phép kết nối SSH từ CloudThinker trong tường lửa, security group hoặc allowlist.
- Xác nhận
sshdđang chạy và lắng nghe trên port đó. - Lượt kiểm tra chạy quá 45 giây sẽ hết thời gian chờ và hiển thị cùng lời khuyên này.
Host key changed
Host key changed
Bình thường sau khi dựng lại server hoặc xoay vòng key: hãy kiểm tra fingerprint trên server, rồi chọn Trust new host key. Nếu bạn không chờ đợi thay đổi này, hãy điều tra trước khi tin cậy.
The remote command exited with a non-zero code
The remote command exited with a non-zero code
SSH hoạt động, nhưng lệnh thất bại trên server. Kiểm tra lệnh, đường dẫn, và user đăng nhập có quyền chạy lệnh đó hay không.
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 key riêng. Key chỉ CloudThinker dùng có thể gỡ khỏi
authorized_keysmà không ảnh hưởng tới ai khác. - Xoay vòng key. Tạo cặp key mới và thêm public key mới vào
authorized_keys. Mở More → Workspace settings → Connections, chọn SSH, nhấn biểu tượng bút chì (Edit) cạnh server, dán Private key mới và nhấn Save. Chạy prompt xác minh, và khi đã hoạt động, gỡ public key cũ khỏi server. - Xác nhận trước khi tin cậy lại. Coi mọi thay đổi host key là đáng ngờ cho tới khi bạn đã kiểm tra fingerprint.
Liên quan
Approvals
Kiểm soát cách CloudThinker hỏi trước khi thay đổi một server.
Kết nối Kubernetes
Kết nối cluster để kiểm tra workload.