當託管在 Google Cloud 的代理程式以自身身份呼叫受 Microsoft Entra 保護的資源時,請使用工作負載身份聯盟。 Google 會為該工作負載的服務帳戶發放一個短暫的 OpenID Connect ID ID 令牌。 Microsoft Entra ID 信任該權杖,並將其視為代理程式身分藍圖的同盟憑證。
此路徑支援僅應用程式存取。 它不會驗證使用者身份,也不會執行 On-Behalf-Of 流程。
Prerequisites
- 代理身份藍圖與代理識別碼。
- 與工作負載相連的 Google Cloud 服務帳戶。
- 服務帳戶的唯一數字 ID。
- 指派給代理程式 ID 的應用程式權限、應用程式角色或資源角色。
- Python 3 搭配
requests範例的套件。 - 受支援且有中繼資料伺服器可用的 Google Cloud 工作負載。 請在已附加指定服務帳戶的該工作負載上執行範例,而非在未設定的本機工作站上執行。
將 Google 身份新增至藍圖
將聯合憑證新增至代理程式身份藍圖:
- 打開Microsoft Entra 系統管理中心中的藍圖。
- 選取 「憑證」>「聯合憑證」>「新增憑證」。
- 選擇 「其他發行機構」。
- 在發行機構欄位輸入
https://accounts.google.com。 - 請將服務帳戶的唯一數字 ID 輸入為主體。
- 輸入
api://AzureADTokenExchange作為受眾。 - 新增憑證。
這些值必須完全符合 Google 令牌:
| 聯合認證 | Google 代幣宣告 | Value |
|---|---|---|
| Issuer | iss |
https://accounts.google.com |
| 主旨 | sub |
服務帳戶唯一識別碼 |
| 觀眾 | aud |
api://AzureADTokenExchange |
如需完整的 Microsoft 程序,請參閱將 Google Cloud 工作負載識別與 Microsoft Entra ID 建立同盟。 有關藍圖步驟,請參閱「 將聯合憑證新增至代理程式身份藍圖」。
授予代理程式 ID 存取權
將目標 API 所需的應用程式權限或資源角色授予 Agent ID。 Google 服務帳號與 Agent ID 仍是不同的身份。 聯邦憑證讓 Google 身份能對藍圖進行驗證;目標資源授權代理程式 ID。
Exchange Google 代幣
安裝範例相依項目:
pip install requests
以下範例會從元資料伺服器請求 Google ID 權杖,將其交換成代理程式 ID 資源權杖,然後呼叫受保護的 API:
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"]
metadata_response = requests.get(
"http://metadata.google.internal/computeMetadata/v1/instance/"
"service-accounts/default/identity",
params={"audience": "api://AzureADTokenExchange"},
headers={"Metadata-Flavor": "Google"},
timeout=10,
)
metadata_response.raise_for_status()
google_token = metadata_response.text
blueprint_token = exchange_token(
BLUEPRINT_CLIENT_ID,
"api://AzureADTokenExchange/.default",
google_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()
此元資料伺服器僅適用於已連接服務帳戶且受支援的 Google Cloud 工作負載。 不要記錄 Google 斷言、藍圖權杖或資源權杖。
確認資源呼叫是否回傳 API 預期的成功回應。 如果擷取元資料失敗,請檢查主機環境及所連接的服務帳戶。 如果 Microsoft Entra Exchange 失敗,請將已設定的發行機構、數值服務帳戶主體及受眾與所需的信任值進行比較。 如果只有資源呼叫失敗,請檢查其範圍及授予代理程式 ID 的權限,而非更改 Google 服務帳戶的權限。
關於 Google 權杖程序,請參閱 從元資料伺服器取得 ID 權杖。 關於代理程式 ID 交換,請參閱 代理程式自主應用程式 OAuth 流程。
清理測試存取權
測試完成後,移除僅供測試使用的資源權限及藍圖的同盟認證。 僅在沒有任何剩餘代理程式需要這些項目時,才刪除代理程式 ID 或藍圖。 在這次清理過程中,不要刪除共用的 Google 服務帳戶,也不要將其從其他工作負載中分離出來。