當託管於 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 身份新增至藍圖
將聯合憑證新增至代理程式身份藍圖:
- 打開Microsoft Entra 系統管理中心中的藍圖。
- 選取 「憑證」>「聯合憑證」>「新增憑證」。
- 選擇 「其他發行機構」。
- 輸入 AWS 帳戶專屬的發行機構網址。
- 將 IAM 角色 ARN 作為主體輸入,例如
arn:aws:iam::<account-id>:role/<role-name>。 - 輸入
api://AzureADTokenExchange作為受眾。 - 新增憑證。
發行者、主體與受眾必須與 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 或藍圖。