Chuyển đến nội dung chính
Kết nối Azure để CloudThinker kiểm kê máy ảo, cluster AKS, cơ sở dữ liệu, storage và mạng, rà soát danh tính và role assignment, đồng thời đọc chi phí từ Azure Cost Management. Azure xác thực bằng service principal (một danh tính ứng dụng trong Microsoft Entra ID, kèm client secret), và các role assignment của service principal quyết định CloudThinker xem được những gì.

Đ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

1

Chọn subscription

2

Tạo service principal với Reader

Nếu đã có app tên cloudthinker, create-for-rbac sẽ dùng lại app đó và đặt lại thông tin xác thực của nó, làm hỏng kết nối đang chạy dùng app này. Kiểm tra trước bằng az ad sp list --display-name cloudthinker. Nếu lệnh trả về kết quả, hãy chọn tên khác, hoặc thêm secret cho app hiện có bằng az ad sp credential reset --id <appId> --append.
Sao chép kết quả ngay. Azure chỉ hiển thị 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ỗi Given 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:
Để cho phép đọc ở cấp billing profile, vào Cost Management + Billing → billing account của bạn → Billing profiles → profile của bạn → Access control (IAM) → Add và gán Billing profile reader cho app 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.
Bắt đầu với Reader và Cost Management Reader. Khi cần thay đổi, hãy ưu tiên role dựng sẵn hẹp như Virtual Machine Contributor, giới hạn trong một resource group, thay vì Contributor trên toàn subscription.

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

Câu trả lời liệt kê tên và ID thật của các subscription.

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.
Để tạo secret mới, chạy 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ố

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.
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.
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.
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 đó.
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.
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.