Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usare la federazione delle identità del carico di lavoro quando un agente ospitato in Google Cloud chiama una risorsa protetta da Microsoft Entra come se stesso. Google rilascia un token ID OpenID Connect di breve durata per l'account del servizio del carico di lavoro. Microsoft Entra ID considera attendibile tale token come credenziale federata per il modello di identità dell'agente.
Questo percorso supporta l'accesso per sole app. Questo percorso non autentica gli utenti né esegue un flusso On-Behalf-Of.
Prerequisites
- Un blueprint di identità dell'agente e ID agente.
- Un account del servizio Google Cloud collegato al carico di lavoro.
- ID numerico univoco dell'account del servizio.
- Un'autorizzazione dell'applicazione, un ruolo dell'app o un ruolo della risorsa assegnato all'ID agente.
- Python 3 con il
requestspacchetto per l'esempio. - Carico di lavoro di Google Cloud supportato in cui è disponibile il server di metadati. Eseguire l'esempio su tale carico di lavoro con l'account del servizio previsto collegato, non in una workstation locale non configurata.
Aggiungere l'identità Google al blueprint
Aggiungere una credenziale federata al blueprint di identità dell'agente:
- Apri il blueprint nel Interfaccia di amministrazione di Microsoft Entra.
- Selezionare Credenziali>Credenziali federate>Aggiungi credenziale.
- Selezionare Altro emittente.
- Immettere
https://accounts.google.comcome emittente. - Immettere l'ID numerico univoco dell'account del servizio come oggetto.
- Inserisci
api://AzureADTokenExchangecome destinatario. - Aggiungere la credenziale.
I valori devono corrispondere esattamente al token Google:
| Credenziale federata | Attestazione del token di Google | Value |
|---|---|---|
| Issuer | iss |
https://accounts.google.com |
| Subject | sub |
ID univoco dell'account del servizio |
| Partecipanti | aud |
api://AzureADTokenExchange |
Per la procedura completa di Microsoft, vedere Federare un'identità del carico di lavoro di Google Cloud con Microsoft Entra ID. Per i passaggi del blueprint, vedere Aggiungere credenziali federate a un blueprint di identità dell'agente.
Concedi l'accesso all'Agent ID
Concedere all'ID agente l'autorizzazione dell'applicazione o il ruolo di risorsa richiesto dall'API di destinazione. L'account del servizio Google e l'ID agente rimangono identità separate. Le credenziali federate consentono all'identità Google di autenticare il blueprint; la risorsa di destinazione autorizza l'ID agente.
Exchange il token di Google
Installare la dipendenza di esempio:
pip install requests
L'esempio seguente richiede un token ID Google dal server di metadati, lo scambia per un token di risorsa ID agente e chiama l'API protetta:
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()
Il server di metadati è disponibile solo per i carichi di lavoro di Google Cloud supportati con un account del servizio collegato. Non registrare l'asserzione Google, il token blueprint o il token della risorsa.
Verificare che la chiamata di risorsa restituisca la risposta di esito positivo prevista dall'API. Se il recupero dei metadati non riesce, controllare l'ambiente di hosting e l'account del servizio collegato. Se lo scambio di Microsoft Entra ha esito negativo, confrontare l'autorità emittente configurata, il subject numerico dell'account di servizio e l'audience con i valori di attendibilità richiesti. Se solo la chiamata alla risorsa ha esito negativo, controllarne l'ambito e le autorizzazioni concesse all'ID agente anziché modificare le autorizzazioni dell'account del servizio Google.
Per la procedura del token Google, vedere Ottenere un token ID dal server di metadati. Per gli scambi di ID agente, vedere Flusso OAuth dell'app autonoma dell'agente.
Rimuovere l'accesso di test
Rimuovere le autorizzazioni delle risorse solo per test e la credenziale federata del blueprint al termine del test. Eliminare l'ID agente o il blueprint solo se non è necessario ad alcun agente rimanente. Non eliminare un account del servizio Google condiviso o scollegarlo da altri carichi di lavoro come parte di questa pulizia.