使用 AWS 工作負載身分識別搭配 Microsoft Entra Agent ID

當託管於 Amazon Web Services (AWS) 的代理程式以自身身份呼叫受 Microsoft Entra 保護的資源時,請使用工作負載身份聯合。 AWS 安全令牌服務(STS)會發行短期有效的 JSON Web 令牌(JWT)。 Microsoft Entra ID 將該權杖視為代理程式身分藍圖的聯合憑證。

此路徑支援僅應用程式存取。 它不會驗證使用者身份,也不會執行 On-Behalf-Of 流程。

Prerequisites

  • 代理身份藍圖與代理識別碼。
  • 為託管工作負載設定的 AWS IAM 角色。
  • 啟用 AWS IAM 對外身分同盟並更新 IAM 角色的權限。
  • 指派給代理程式 ID 的應用程式權限、應用程式角色或資源角色。
  • 範例需使用 Python 3 搭配目前的 boto3 和 requests 套件。
  • 一個以 AWS 工作負載角色身份驗證的執行環境。 在那裡執行該範例,讓 boto3 使用那個角色,而不是無關的開發者身分。

啟用 AWS 外寄身分同盟

為 AWS 帳戶啟用此功能:

aws iam enable-outbound-web-identity-federation

記錄 AWS 傳回的帳戶專屬簽發者 URL。 API GetWebIdentityToken 需要區域性的 STS 端點,且無法透過全域端點使用。

授予工作負載角色僅請求用於 Microsoft Entra ID 的權杖權限:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sts:GetWebIdentityToken",
      "Resource": "*",
      "Condition": {
        "ForAllValues:StringEquals": {
          "sts:IdentityTokenAudience": "api://AzureADTokenExchange"
        },
        "NumericLessThanEquals": {
          "sts:DurationSeconds": 300
        }
      }
    }
  ]
}

如需完整的 AWS 程序,請參閱「 外發身份聯盟入門」。

將 AWS 身份新增至藍圖

將聯合憑證新增至代理程式身份藍圖:

  1. 打開Microsoft Entra 系統管理中心中的藍圖。
  2. 選取 「憑證」>「聯合憑證」>「新增憑證」。
  3. 選擇 「其他發行機構」。
  4. 輸入 AWS 帳戶專屬的發行機構網址。
  5. 將 IAM 角色 ARN 作為主體輸入,例如 arn:aws:iam::<account-id>:role/<role-name>。
  6. 輸入 api://AzureADTokenExchange 作為受眾。
  7. 新增憑證。

發行者、主體與受眾必須與 AWS 權杖中的 iss、sub 和 aud 宣告完全相符。 不支援萬用字元。 如需更多資訊,請參閱 「為代理程式身份藍圖新增聯合憑證 」及 AWS 外寄令牌聲明。

授予代理程式 ID 存取權

將目標 API 所需的應用程式權限或資源角色授與代理程式 ID。 聯邦憑證僅認證藍圖本身;它並不授權存取下游資源。

對於自訂 API,請公開並指派應用程式角色。 對於 Azure 資源,請將 Agent ID 指派所需的 Azure 角色。

Exchange AWS 權杖

安裝範例相依項:

pip install --upgrade boto3 requests

以下範例取得 AWS 代幣,將其換成代理程式 ID 資源代幣,並呼叫受保護的 API:

import boto3
import requests

TENANT_ID = "<tenant-id>"
BLUEPRINT_CLIENT_ID = "<agent-identity-blueprint-client-id>"
AGENT_ID_CLIENT_ID = "<agent-identity-client-id>"
RESOURCE_SCOPE = "api://<resource-client-id>/.default"
RESOURCE_URL = "https://api.contoso.com/data"

token_endpoint = (
    f"https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/token"
)


def exchange_token(client_id, scope, assertion, fmi_path=None):
    data = {
        "client_id": client_id,
        "scope": scope,
        "grant_type": "client_credentials",
        "client_assertion_type":
            "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
        "client_assertion": assertion,
    }
    if fmi_path:
        data["fmi_path"] = fmi_path

    response = requests.post(token_endpoint, data=data, timeout=30)
    response.raise_for_status()
    return response.json()["access_token"]


sts = boto3.client("sts", region_name="<aws-region>")
aws_token = sts.get_web_identity_token(
    Audience=["api://AzureADTokenExchange"],
    SigningAlgorithm="RS256",
    DurationSeconds=300,
)["WebIdentityToken"]

blueprint_token = exchange_token(
    BLUEPRINT_CLIENT_ID,
    "api://AzureADTokenExchange/.default",
    aws_token,
    AGENT_ID_CLIENT_ID,
)

resource_token = exchange_token(
    AGENT_ID_CLIENT_ID,
    RESOURCE_SCOPE,
    blueprint_token,
)

resource_response = requests.get(
    RESOURCE_URL,
    headers={"Authorization": f"Bearer {resource_token}"},
    timeout=30,
)
resource_response.raise_for_status()

不要記錄 AWS 斷言、藍圖權杖或資源權杖。 為每個 Exchange 申請新的 AWS 令牌,而不是儲存它。

確認資源呼叫是否回傳 API 預期的成功回應。 如果 AWS 令牌請求失敗,請檢查工作負載角色、區域 STS 端點以及外寄聯盟權限。 如果 Microsoft Entra Exchange 失敗,請檢查藍圖的聯合認證憑證及所選代理程式 ID。 如果只有資源呼叫失敗,請檢查資源範圍以及分配給代理程式 ID 的權限;成功的聯盟不會授予 API 存取權。

關於代理程式 ID 交換,請參閱 代理程式自主應用程式 OAuth 流程。 關於 AWS 令牌 API,請參閱 GetWebIdentityToken。

清理測試存取權

當您不再需要此整合時,移除僅供測試使用的資源權限及聯邦憑證。 在移除角色權限或停用全帳戶外寄聯邦之前,請與 AWS 帳戶擁有者協調;其他工作量可能也會依賴它們。 僅在沒有剩餘代理程式使用這些資源時,刪除代理程式 ID 或藍圖。