Far accedere gli utenti da un agente locale (anteprima)

Un agente locale viene eseguito su un dispositivo endpoint e non può conservare in modo sicuro un segreto del client o un certificato. Configurarlo come client pubblico OAuth e usare il flusso del codice di autorizzazione con Proof Key for Code Exchange (PKCE).

L'utente accede tramite un browser. L'agente riceve un codice di autorizzazione all'URI di reindirizzamento registrato e riscatta il codice senza credenziali client.

Importante

L'autenticazione dell'agente locale è in anteprima. Questa anteprima viene fornita senza un contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o avere funzionalità vincolate. Per altre informazioni, vedere Condizioni di licenza universali per i servizi online.

Prerequisites

È necessario un tenant Microsoft Entra in cui sia possibile registrare un Agent ID, oppure un tenant che supporti i documenti di metadati dell'ID client (CIMD).

Scegliere un ID client

Option ID del cliente Usa quando
Registrare un ID agente in Microsoft Entra ID del client assegnato da Microsoft Entra Consigliato quando si sa che l'agente si connette a Microsoft Entra.
Usare un CIMD URL HTTPS pubblico del documento di metadati del client Usare quando lo stesso client distribuito si connette a server di autorizzazione gestiti in modo indipendente e la preregistrazione non è praticabile.

Se possibile, preferire un ID agente registrato. Per altre informazioni su CIMD, vedere Documenti metadati ID client in Microsoft Entra ID.

Registrare l'ID dell'agente

  1. Creare un blueprint a istanza singola ed eseguirne il provisioning dell'ID agente. Scegliere la modalità istanza quando si crea il blueprint; non è possibile modificarla in seguito.
  2. Aggiungere l'URI di reindirizzamento consigliato dalla libreria di autenticazione nella piattaforma publicClient del blueprint.
  3. Registrare l'ID client e l'ID tenant dell'ID agente.

Ogni installazione usa lo stesso ID client. Non creare un ID agente separato per ogni dispositivo e non aggiungere un segreto client, un certificato o credenziali di identità federate per questo flusso.

Per le opzioni URI di reindirizzamento, vedere App desktop che chiama LE API Web: Configurazione del codice.

Accedere con MSAL.NET

Installare MSAL.NET:

dotnet add package Microsoft.Identity.Client

Creare un'applicazione client pubblica:

using Microsoft.Identity.Client;

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

Far accedere l'utente senza richiedere autorizzazioni delegate per un'API:

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

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

AcquireTokenInteractive non dispone di un overload senza parametri. Passare una raccolta di ambiti vuota quando l'agente deve solo effettuare l'accesso dell'utente. MSAL aggiunge gli ambiti OpenID Connect riservati necessari per l'accesso, ma non richiede un ambito delegato per un'API.

MSAL apre il browser di sistema, usa PKCE, convalida la risposta e memorizza nella cache l'account. Usare un'autorità specifica del tenant per un Agent ID registrato. Non usare il nome dell'account o il token ID per autorizzare l'accesso a un'API. Richiedere gli ambiti delegati dell'API nel passaggio successivo.

Usare un client CIMD per l'accesso alle API delegate (anteprima)

Usare l'URL CIMD come ID client in una libreria OAuth che supporta gli ID client con valori di URL. La libreria deve usare il flusso del codice di autorizzazione con PKCE e non deve inviare credenziali client quando riscatta il codice.

CIMD non supporta i token ID per l’accesso degli utenti. Questo ramo usa l'autenticazione del browser per ottenere l'accesso API delegato, non il risultato di MSAL.NET solo per l'accesso illustrato in precedenza. Richiedere gli scope delegati della risorsa seguendo la procedura di configurazione CIMD.

Per i metadati e i requisiti dell'URI di reindirizzamento, vedere Configurare un client con un documento metadati ID client.

Passaggio successivo

Chiamare le API come utente connesso.