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

Usare la federazione dell'identità del carico di lavoro quando un agente ospitato in Amazon Web Services (AWS) chiama una risorsa protetta da Microsoft Entra come se stessa. AWS Security Token Service (STS) genera un token WEB JSON (JWT) di breve durata. Microsoft Entra ID considera attendibile tale token come credenziale federata per il progetto 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 progetto di identità dell'agente e un ID agente.
  • Ruolo AWS IAM per il carico di lavoro ospitato.
  • Autorizzazione per abilitare la federazione delle identità in uscita IAM di AWS e aggiornare il ruolo IAM.
  • Un'autorizzazione dell'applicazione, ruolo dell'app o ruolo della risorsa assegnato all'ID agente.
  • Python 3 con i pacchetti requests e boto3 correnti per l'esempio.
  • Un ambiente di esecuzione autenticato come ruolo del carico di lavoro AWS. Eseguire l'esempio in modo che boto3 usi tale ruolo, non un'identità dello sviluppatore non correlata.

Abilitare la federazione delle identità in uscita di AWS

Abilitare la funzionalità per l'account AWS:

aws iam enable-outbound-web-identity-federation

Registrare l'URL dell'emittente specifico dell'account restituito da AWS. L'API GetWebIdentityToken richiede un endpoint servizio token di sicurezza a livello di area e non è disponibile tramite l'endpoint globale.

Concedere al ruolo del carico di lavoro l'autorizzazione per richiedere solo i token destinati a 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
        }
      }
    }
  ]
}

Per la procedura di AWS completa, vedere Introduzione alla federazione delle identità in uscita.

Aggiungere l'identità AWS al progetto

Aggiungere una credenziale federata al blueprint dell'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 l'URL dell'autorità emittente specifica dell'account AWS.
  5. Immettere il ruolo IAM ARN come oggetto, ad esempio arn:aws:iam::<account-id>:role/<role-name>.
  6. Inserisci api://AzureADTokenExchange come destinatario.
  7. Aggiungere le credenziali.

L'emittente, il soggetto e il destinatario devono corrispondere esattamente ai claim iss, sub e aud nel token AWS. I caratteri jolly non sono supportati. Per altre informazioni, vedere Aggiungere credenziali federate a un blueprint di identità agente e attestazioni di token in uscita AWS.

Concedi l'accesso all'ID dell'agente

Concedi all'ID agente l'autorizzazione applicativa o il ruolo della risorsa richiesto dall'API di destinazione. La credenziale federata autentica solo il blueprint; non autorizza l'accesso a una risorsa downstream.

Per un'API personalizzata, esporre e assegnare un ruolo applicazione. Per una risorsa Azure, assegnare all'ID agente il ruolo Azure necessario.

Exchange del token AWS

Installare le dipendenze di esempio:

pip install --upgrade boto3 requests

L'esempio seguente ottiene un token AWS, lo scambia per un token di risorsa ID agente e chiama l'API protetta:

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()

Non registrare l'asserzione AWS, il token blueprint o il token della risorsa. Richiedere un nuovo token AWS per ogni Exchange anziché archiviarlo.

Verificare che la chiamata di risorsa restituisca la risposta prevista dell'API. Se la richiesta del token AWS ha esito negativo, controllare il ruolo del carico di lavoro, l'endpoint STS a livello di area e l'autorizzazione federativa in uscita. Se lo scambio di Microsoft Entra ha esito negativo, controllare le credenziali federate del blueprint e l'ID agente selezionato. Se solo la chiamata alla risorsa ha esito negativo, controllare l'ambito della risorsa e le autorizzazioni assegnate all'ID agente; la federazione con esito positivo non concede l'accesso all'API.

Per gli scambi di Agent ID, vedere Agent autonomous app OAuth flow. Per l'API del token AWS, vedere GetWebIdentityToken.

Rimuovere l'accesso di test

Rimuovere le autorizzazioni per risorse di solo test e la credenziale federata quando non è più necessaria questa integrazione. Coordinarsi con il proprietario dell'account AWS prima di rimuovere le autorizzazioni del ruolo o disabilitare la federazione in uscita a livello di account; altri carichi di lavoro possono dipendere da essi. Eliminare l'ID agente o il blueprint solo se nessun agente rimanente usa tali risorse.