Connecter les utilisateurs à partir d’un agent local (préversion)

Un agent local s’exécute sur un appareil de point de terminaison et ne peut pas stocker en toute sécurité une clé secrète client ou un certificat. Configurez-le en tant que client public OAuth et utilisez le flux de code d’autorisation avec Proof Key for Code Exchange (PKCE).

L’utilisateur se connecte via un navigateur. L’agent reçoit un code d’autorisation à son URI de redirection enregistrée et échange le code sans informations d’identification du client.

Important

L’authentification de l’agent local est en préversion. Cette version préliminaire est fournie sans contrat de niveau de service et n’est pas recommandée pour les environnements de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités limitées. Pour plus d’informations, consultez Conditions du contrat de licence universel pour les services en ligne.

Prerequisites

Vous avez besoin d’un tenant Microsoft Entra dans lequel vous pouvez inscrire un Agent ID, ou d’un tenant qui prend en charge les documents CIMD (Client ID Metadata Documents).

Choisir un ID client

Option ID du client À utiliser quand
Inscrire un ID d’agent dans Microsoft Entra ID client attribué par Microsoft Entra Recommandé lorsque vous savez que l’agent se connecte à Microsoft Entra.
Utiliser un CIMD URL HTTPS publique du document de métadonnées du client Utiliser quand le même client distribué se connecte à des serveurs d’autorisation gérés indépendamment et que la préinscription n’est pas pratique.

Préférez un ID d’agent enregistré lorsque cela est possible. Pour plus d’informations sur CIMD, consultez documents de métadonnées d’ID client dans Microsoft Entra ID.

Enregistrer l’ID de l’agent

  1. Créez un blueprint à instance unique et provisionnez son ID d’agent. Choisissez le mode d’instance lorsque vous créez le blueprint ; vous ne pouvez pas le modifier par la suite.
  2. Ajoutez l’URI de redirection recommandée par votre bibliothèque d’authentification sous la plateforme publicClient du modèle.
  3. Enregistrez l’ID client et l’ID de locataire de l’agent.

Chaque installation utilise le même ID client. Ne créez pas d’Agent ID distinct pour chaque appareil et n’ajoutez pas de secret du client, de certificat ou d’informations d’identification fédérées pour ce flux.

Pour obtenir des options d’URI de redirection, consultez l’application de bureau qui appelle des API web : configuration du code.

Se connecter avec MSAL.NET

Installez MSAL.NET :

dotnet add package Microsoft.Identity.Client

Créez une application publique-cliente :

using Microsoft.Identity.Client;

var app = PublicClientApplicationBuilder
    .Create("<agent-client-id>")
    .WithAuthority("https://login.microsoftonline.com/<tenant-id>")
    .WithDefaultRedirectUri()
    .Build();

Connectez-vous à l’utilisateur sans demander d’autorisations déléguées pour une API :

var result = await app
    .AcquireTokenInteractive(Array.Empty<string>())
    .ExecuteAsync();

Console.WriteLine($"Signed in as {result.Account.Username}");

AcquireTokenInteractive n’a pas de surcharge sans paramètre. Transmettez une collection de scopes vide lorsque l’agent doit uniquement connecter l’utilisateur. MSAL ajoute les étendues OpenID Connect réservées requises pour la connexion, mais elle ne demande pas d’étendue déléguée pour une API.

MSAL ouvre le navigateur système, utilise PKCE, valide la réponse et met en cache le compte. Utilisez une autorité spécifique au locataire pour un Agent ID enregistré. N’utilisez pas le nom du compte ou le jeton d’ID pour autoriser l’accès à une API. Demandez les portées déléguées de l’API à l’étape suivante.

Utiliser un client CIMD pour l’accès délégué à l’API (préversion)

Utilisez l’URL CIMD comme identifiant client dans une bibliothèque OAuth qui prend en charge les identifiants client dont la valeur est une URL. La bibliothèque doit utiliser le flux de code d’autorisation avec PKCE et ne doit pas envoyer d’informations d’identification client lorsqu’elle échange le code.

CIMD ne prend pas en charge les jetons d’ID pour la connexion utilisateur. Cette branche utilise l’authentification du navigateur pour obtenir l’accès à l’API déléguée, et non le résultat de connexion uniquement MSAL.NET indiqué précédemment. Demandez les autorisations déléguées de la ressource en suivant la procédure de configuration CIMD.

Pour connaître les exigences relatives aux métadonnées et aux URI de redirection, consultez Configurer un client avec un document de métadonnées d’ID client.

Étape suivante

Appelez des API en tant qu’utilisateur connecté.