Usare un'identità del carico di lavoro di Google Cloud con Microsoft Entra Agent ID

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 requests pacchetto 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:

  1. Apri il blueprint nel Interfaccia di amministrazione di Microsoft Entra.
  2. Selezionare Credenziali>Credenziali federate>Aggiungi credenziale.
  3. Selezionare Altro emittente.
  4. Immettere https://accounts.google.com come emittente.
  5. Immettere l'ID numerico univoco dell'account del servizio come oggetto.
  6. Inserisci api://AzureADTokenExchange come destinatario.
  7. 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.