Điều kiện tiên quyết
- Một subscription Azure mà bạn có vai trò Owner hoặc User Access Administrator, để có thể gán role.
- Quyền tạo app registration trong Microsoft Entra ID: vai trò Application Developer, hoặc thiết lập Users can register applications đặt là Yes trong user settings của Entra ID.
- Tài khoản của bạn đã đăng ký xác thực đa yếu tố. Security defaults chặn đăng ký ứng dụng nếu chưa có.
Giới hạn cần biết trước
- Chỉ dùng client secret. Hộp thoại nhận client secret. Không có trường cho certificate hay federated credential.
- Mỗi workspace một tenant. Mỗi workspace có một kết nối Azure, bao phủ mọi subscription mà service principal đọc được trong một tenant. Tenant thứ hai, ví dụ một tenant dev riêng, cần workspace riêng với Rules và cuộc trò chuyện riêng.
- Một bộ quy tắc. Azure là dịch vụ chỉ cho một kết nối, nên Environment của nó luôn là Not set. Dù sao Rules phê duyệt cũng không đọc environment. Để xử lý thao tác ghi trên Azure theo cách khác, hãy viết Rule nêu tên kết nối này.
Thiết lập
- Azure CLI
- Azure portal
1
Chọn subscription
2
Tạo service principal với Reader
password một lần. Mặc định secret hết hạn sau một năm. Thêm --years 2 (hoặc giá trị khác) để thay đổi, và đặt nhắc nhở để xoay vòng secret.3
Thêm quyền đọc chi phí
4
Tùy chọn: bao phủ thêm subscription
Để gán cả hai role cho service principal trên mọi subscription bạn thấy được, hãy lặp qua chúng. Đây là cách được khuyến nghị, vì bạn có danh sách tường minh:Gán ở cấp management group là phương án đánh đổi: tự động bao phủ subscription mới, nhưng cũng bao phủ cả những subscription bạn có thể không muốn CloudThinker đọc. Chỉ dùng khi đó đúng là điều bạn muốn:
5
Thêm kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections, chọn Microsoft Azure rồi nhấn Connect. Hộp thoại có bốn trường và không có Alias hay Description, vì Azure chỉ cho phép một kết nối mỗi workspace. Điền như sau, rồi nhấn Connect:
Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi chuyển sang trạng thái Connected. Discovery chạy một lần ở chế độ nền và tiêu tốn credit. Kiểm tra mục Discovery trên bảng chi tiết trước khi gửi prompt đầu tiên. Xem Điều gì xảy ra sau khi bạn kết nối.
Thanh toán theo Microsoft Customer Agreement
Chỉ cần cho Optimize trên subscription theo Microsoft Customer Agreement. Subscription pay-as-you-go mua trực tuyến thường thuộc Microsoft Customer Agreement (MCA). Cost Management từ chối truy vấn ở cấp subscription với các subscription này, kèm lỗiGiven subscription doesn't have valid WebDirect/AIRS offer type, nên Optimize đọc chi phí ở cấp billing profile.
Để kiểm tra bạn có dùng MCA không, chạy lệnh sau. MCA hiển thị MicrosoftCustomerAgreement:
cloudthinker. Role assignment ở cấp subscription không áp dụng cho phạm vi billing. Để xác nhận, mở Optimize và kiểm tra chi phí Azure đã tải lên.
Chi tiết kết nối
Không có trường subscription. CloudThinker làm việc với mọi subscription mà service principal đọc được. Nếu đọc được nhiều hơn một, Optimize sẽ yêu cầu bạn Choose an Azure billing scope ở lần mở đầu tiên.
Quyền yêu cầu
Chỉ có Reader thì không trả về dữ liệu chi phí. Reader cấp
*/read, còn truy vấn Cost Management là thao tác POST mà */read không bao gồm.
Khả năng của agent
CloudThinker chạy các lệnh Azure CLI chỉ đọc mà không cần hỏi. Thay đổi tuân theo mô hình Quyền ghi.Xác minh kết nối
Ví dụ prompt
Quyền ghi
Allow writes trên bảng chi tiết của kết nối quyết định agent có được thay đổi gì trong Azure hay không. Mặc định switch này bật, nhưng Reader và Cost Management Reader không thay đổi được gì, nên Azure từ chối mọi thao tác ghi cho đến khi bạn cấp thêm quyền.
Để khóa thao tác ghi cả ở phía CloudThinker, mở Microsoft Azure trong More → Workspace settings → Connections và tắt switch Allow writes trên bảng chi tiết.
Xoay vòng client secret
Azure là dịch vụ chỉ cho một kết nối, nên khi kết nối đang ổn định thì không có biểu tượng bút chì hay hộp thoại Edit Instance.
Xoay vòng sớm tốn công hơn thay một secret đã hết hạn, nhưng đừng để secret hết hạn chỉ để đỡ việc: secret hết hạn đồng nghĩa với gián đoạn cho đến khi bạn thay. Hãy xoay vòng sớm vào lúc ít hoạt động. Kết nối lại sẽ tạo một kết nối mới:
- Agent, automation và Optimize không dùng được Azure trong khoảng giữa lúc ngắt và lúc kết nối lại.
- Discovery chạy lại và tiêu tốn credit.
- Allow writes trở về trạng thái bật. Tắt lại nếu trước đó bạn đã tắt.
- Kiểm tra các Rules nêu tên kết nối Azure vẫn còn liệt kê kết nối.
az ad sp credential reset --id <appId> --append, hoặc dùng Microsoft Entra ID → App registrations → app của bạn → Certificates & secrets. Nếu thiếu --append, lệnh reset sẽ xóa các secret hiện có và làm hỏng kết nối ngay lập tức.
Khắc phục sự cố
Đăng nhập bị security defaults chặn
Đăng nhập bị security defaults chặn
az login hoặc portal trả về AADSTS530035: Access has been blocked by security defaults. Security defaults yêu cầu xác thực đa yếu tố trước khi bạn đăng ký ứng dụng. Đăng ký một phương thức tại aka.ms/mfasetup rồi đăng nhập lại. Các cờ --use-device-code và --allow-no-subscriptions không giúp vượt qua lỗi này.Xác thực thất bại
Xác thực thất bại
Nguyên nhân: APP_ID, CLIENT_SECRET hoặc TENANT_ID sai, secret đã hết hạn, hoặc bị conditional access policy chặn. Mã lỗi Microsoft Entra cho biết trường hợp nào:
Cách sửa: nếu các giá trị đều đúng, xác nhận không có conditional access policy nào chặn service principal đăng nhập.
Client secret đã hết hạn
Client secret đã hết hạn
Nguyên nhân: secret đã đến ngày hết hạn (mặc định một năm khi tạo từ CLI).Cách sửa: tạo secret mới, rồi nhấn Replace credentials trên bảng chi tiết Microsoft Azure và lưu lại. Xem Xoay vòng client secret.
Optimize báo Azure Cost Management is not readable
Optimize báo Azure Cost Management is not readable
Nguyên nhân: service principal thiếu quyền đọc chi phí.Cách sửa: gán Cost Management Reader trên subscription. Với subscription theo Microsoft Customer Agreement, gán thêm Billing profile reader trên billing profile. Role assignment mất vài phút để có hiệu lực, nên hãy thử lại sau đó.
Cost Management trả về 429
Cost Management trả về 429
Nguyên nhân: Cost Management giới hạn tần suất rất chặt với subscription mới, nên truy vấn trả về
429 Too many requests. Không có gì bị cấu hình sai.Cách sửa: đợi vài phút rồi tải lại Optimize.Thiếu tài nguyên hoặc subscription
Thiếu tài nguyên hoặc subscription
Nguyên nhân: service principal không đọc được subscription đó.Cách sửa: gán Reader trên mọi subscription bạn muốn thấy. Bước vòng lặp tùy chọn trong tab Azure CLI làm việc này một lần cho tất cả. Role assignment có thể mất khoảng 10 phút để áp dụng, nên hãy chờ trước khi hỏi lại.
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.
- Đặt hạn và xoay vòng secret: luôn đặt thời hạn cho client secret và xoay vòng secret trước khi hết hạn.
- Giới hạn phạm vi role: chỉ gán role trên các subscription CloudThinker cần. Xem phần đánh đổi ở bước bao phủ thêm subscription.
Liên quan
Bắt đầu nhanh với Optimize
Xem chi phí Azure và các phát hiện chi phí đầu tiên.
Tổng quan kết nối
Cách kết nối, kiểm thử và discovery hoạt động.