# 如何讓 StackQL 向 Azure 進行驗證

> StackQL 透過 AZURE_TENANT_ID、AZURE_CLIENT_ID 與 AZURE_CLIENT_SECRET 環境變數，使用 Microsoft Entra ID 服務主體向 Azure 進行驗證。

Source: https://stackql.io/zh-hant/ai/how-tos/authenticate-stackql-to-azure

StackQL 使用 Microsoft Entra ID（前身為 Azure AD）服務主體向 Azure 進行驗證，並透過三個環境變數提供：`AZURE_TENANT_ID`、`AZURE_CLIENT_ID` 與 `AZURE_CLIENT_SECRET`。

## 步驟

1. 建立服務主體，並授予它目標訂用帳戶上的角色（唯讀查詢只需 `Reader` 角色即可）：

```bash
az ad sp create-for-rbac --name stackql-sp --role Reader \
  --scopes /subscriptions/<subscription-id>
```

2. 匯出它傳回的憑證：

```bash
export AZURE_TENANT_ID=your-tenant-id
export AZURE_CLIENT_ID=your-client-id
export AZURE_CLIENT_SECRET=your-client-secret
```

3. 提取 Azure Provider（僅首次使用時）：

```sql
REGISTRY PULL azure;
```

4. 以查詢確認：

```sql
SELECT name, location
FROM azure.compute.virtual_machines
WHERE subscriptionId = '00000000-1111-2222-3333-444444444444';
```

`subscriptionId` 述詞是 Azure API 的必要路由參數，不屬於驗證的一部分。以資源群組為範圍的方法另外需要 `resourceGroupName`；執行 `SHOW METHODS IN azure.compute.virtual_machines` 可查看每個存取方法的必要參數（`list_all` 只需要 `subscriptionId`；`list` 還需要 `resourceGroupName`；`get` 需要 `vmName`）。

## 變數的適用範圍

這些變數在 `stackql shell`、`stackql exec`、`stackql srv`（PostgreSQL 線路協定伺服器）與 `stackql mcp` 中的作用完全相同。對於 Claude Desktop 等 MCP 用戶端，請將它們放在 `claude_desktop_config.json` 中伺服器項目的 `env` 區塊。在 CI 中，請從管線的祕密存放區取得它們。

## 相關概念

- [如何讓 StackQL 向 AWS 進行驗證](/ai/how-tos/authenticate-stackql-to-aws)：AWS 的對應做法
- [如何讓 StackQL 向 Google Cloud 進行驗證](/ai/how-tos/authenticate-stackql-to-google-cloud)：GCP 的對應做法
- [如何搭配 Claude 使用 StackQL](/ai/how-tos/use-stackql-with-claude)：將 Azure 憑證傳遞給 MCP 工作階段
- [控制平面與資料平面](/ai/canonical-definitions/control-plane-vs-data-plane)：Resource Manager API 涵蓋的範圍
- [常見 StackQL 錯誤](/ai/troubleshooting/common-stackql-errors)：包括驗證失敗
