Authentifier les utilisateurs avec le sidecar du SDK Auth

Un client amont authentifie l’utilisateur et envoie un jeton d’accès à l’agent. L’agent transmet ce jeton au side-car pour validation avant d’utiliser les revendications de l’utilisateur ou d’effectuer un échange On-Behalf-Of (OBO).

Le sidecar ne fournit pas l’interface utilisateur pour la connexion. Utilisez MSAL dans le client web, le client de bureau ou le client mobile côté amont.

Prerequisites

Configurer l’audience

Inscrivez un scope exposé par l’API de l’agent. Le client en amont demande cette portée afin que le jeton d’accès résultant soit destiné à l’agent.

N'envoyez pas de jeton émis pour Microsoft Graph ou une autre ressource à l'API de l'agent.

Configurez le side-car pour valider l’audience de l’API de l’agent et l’étendue déléguée :

Définissez AzureAd:ClientId sur l’ID client enregistré lors de l’installation, et non sur un ID d’objet d’annuaire. Réglez AzureAd:Scopes sur access_agent. Le client en amont demande api://<agent-client-id>/access_agent.

{
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "TenantId": "<tenant-id>",
    "ClientId": "<agent-client-id>",
    "Scopes": "access_agent"
  }
}

Utilisez la même AzureAd section pour configurer les informations d’identification du blueprint. Pour connaître la configuration complète du conteneur et des informations d’identification, consultez Configurer le side-car Auth SDK.

Valider le jeton

Transférez l’en-tête d’autorisation entrant complet vers le side-car :

GET /Validate
Authorization: ******

La réponse inclut le protocole, le jeton et les déclarations validés. Utilisez les déclarations pour identifier l’utilisateur et appliquer la stratégie d’autorisation de l’agent.

Ne faites pas confiance aux claims décodés par le client ou l’agent avant la validation.

Invoquer le sidecar

Validez l’en-tête d’autorisation entrant avec le sidecar avant d’utiliser les claims qu’il renvoie. Exiger que protocol soit Bearer, que les claims oid et tid ne soient pas vides, et que access_agent figure dans le claim scp dont les valeurs sont séparées par des espaces. Identifiez l’appelant par la combinaison de tid et oid. Refusez la demande si une vérification échoue et appliquez la stratégie d’autorisation de l’agent avant de la traiter.

import requests

SIDECAR_URL = "http://localhost:5000"

def validate_caller(inbound_auth_header: str) -> dict:
    """Validate an inbound access token with the sidecar and return the token claims."""
    response = requests.get(
        f"{SIDECAR_URL}/Validate",
        headers={"Authorization": inbound_auth_header},
        timeout=5,
    )

    if response.status_code in (401, 403):
        raise PermissionError("The sidecar rejected the caller's access token.")

    response.raise_for_status()
    result = response.json()

    if result.get("protocol", "").lower() != "bearer":
        raise PermissionError("The validated token used an unexpected protocol.")

    claims = result.get("claims", {})
    object_id = claims.get("oid")
    tenant_id = claims.get("tid")

    if not object_id or not tenant_id:
        raise PermissionError("The validated token doesn't identify a user and tenant.")

    if "access_agent" not in claims.get("scp", "").split():
        raise PermissionError("The caller doesn't have the required delegated scope.")

    return claims


# Call before processing each request:
claims = validate_caller(request.headers.get("Authorization"))
# Use claims["oid"] and claims["tid"] as the stable caller identity.
# Apply the agent's authorization policy before processing the request.

Conservez SIDECAR_URL sur l’interface de bouclage dans l’espace de noms réseau partagé. Remplacez l’espace réservé « authorization-header » par l’en-tête complet Authorization reçu par l’agent. Si vous utilisez une étendue autre que access_agent, mettez à jour à la fois la configuration side-car et la vérification de l’étendue de l’assistant.

La réponse contient également le jeton validé, mais l’exemple ne le désérialise pas. Ne retournez pas ou ne consignez pas le jeton. Si le sidecar rejette le jeton, rejetez la demande de l’agent au lieu de décoder le jeton localement ou de continuer sans utilisateur authentifié.

Retourne 401 Unauthorized un jeton manquant ou non valide et 403 Forbidden lorsqu’un appelant authentifié ne dispose pas de l’étendue ou de l’accès requis. Ne passez pas à l’API en aval après l’un ou l’autre de ces rejets.

L’exemple rejette également les informations d’identification que le sidecar a validées avec un autre protocole, comme un jeton de preuve de possession d’application uniquement. Utilisez l’ID de locataire validé et l’ID d’objet comme clé utilisateur stable. Appliquez la stratégie d’autorisation de l’agent avant de traiter la demande.

Étapes suivantes

  1. Contrôler les utilisateurs qui peuvent accéder à l’agent.
  2. Demandez le consentement pour les autorisations déléguées.
  3. Appelez une API personnalisée en tant qu’utilisateur.