Configurare l'autenticazione utente in Copilot Studio

L'autenticazione utente permette agli utenti di accedere così che l'agente possa accedere a risorse o informazioni ad accesso limitato per loro conto. Gli utenti possono accedere utilizzando Microsoft Entra ID o un provider di identità OAuth 2.0, come Google o Facebook.

Note

Per le distribuzioni di Microsoft Teams che utilizzano l'autenticazione manuale, consulta i requisiti di distribuzione in Configurare SSO (single sign-on) con Microsoft Entra ID per gli agenti in Teams.

Puoi aggiungere l'autenticazione dell'utente agli argomenti durante la modifica di un argomento.

Importante

Le modifiche apportate alla configurazione di autenticazione diventano effettive solo dopo la pubblicazione dell'agente. Pianificare in anticipo prima di apportare modifiche di autenticazione all'agente.

Scegliere un'opzione di autenticazione

Note

Prima di scegliere un'opzione di autenticazione, esaminare le limitazioni di integrazione Power BI seguenti. Gli agenti di Copilot Studio che utilizzano l'autenticazione Microsoft (Entra ID) non possono essere incorporati nei report di Power BI tramite oggetti visivi basati su iframe.

Copilot Studio supporta diverse opzioni di autenticazione. Seleziona e configura l'opzione che soddisfa le tue esigenze.

  1. Vai su Impostazioni per l'agente e seleziona Sicurezza.

  2. Seleziona Autenticazione.

  3. Selezionare un'opzione di autenticazione e configurarla in base alle esigenze. Di seguito vengono illustrate le opzioni di autenticazione disponibili:

  4. Selezionare Salva.

Nessuna autenticazione

Nessuna autenticazione significa che il tuo agente non richiede ai tuoi utenti di accedere quando interagiscono con l'agente. Se la configurazione non ha autenticazione, l'agente può accedere solo a informazioni e risorse pubbliche. I chatbot classici sono configurati per impostazione predefinita per non richiedere l'autenticazione.

Questa opzione non è disponibile quando una policy dati viene configurata nel centro di amministrazione Power Platform per richiedere l'autenticazione.

Caution

Selezionando l'opzione Nessuna autenticazione chiunque abbia il collegamento potrà chattare e interagire con il bot o l'agente.

È consigliabile applicare l'autenticazione, soprattutto se si usa il bot o l'agente all'interno dell'organizzazione o per utenti specifici, insieme ad altri controlli di sicurezza e governance.

Esegui l'autenticazione con Microsoft

Importante

Per pubblicare tramite il canale integrato di Teams + Microsoft 365, usa Authenticate with Microsoft. Se la configurazione dell'autenticazione blocca il canale, controlla agent status. Per le implementazioni di autenticazione manuale in Teams, segui i requisiti per SSO di Teams e per il manifesto dell'app.

Inoltre, l'opzione Authenticate con Microsoft non è disponibile per gli agenti che si integrano con Dynamics 365 Customer Insights - Journeys.

Questa configurazione configura automaticamente l'autenticazione Microsoft Entra ID per Teams, SharePoint, Power Apps e Microsoft Copilot senza configurazione manuale. In Teams, agli utenti non viene chiesto di accedere a meno che il tuo agente non richieda un ambito ampliato.

Se hai bisogno di autenticazione su altri canali, scegli Autentica manualmente.

Se selezioni Autenticati con Microsoft, le seguenti variabili sono disponibili nell'area di creazione dell'argomento sia nell'app web che nell'app di Teams:

  • User.Id
  • User.DisplayName

Nell'app Web User.IsLoggedIn sono disponibili variabili di profilo aggiuntive. Nel piano Teams, User.IsLoggedIn non è disponibile con questa opzione. Scopri di più in Variabili di autenticazione.

User.AccessToken non è disponibile con questa opzione. Se hai bisogno di un token di autenticazione, utilizza Esegui autenticazione manualmente.

Se passi da Autentica manualmente a Autentica con Microsoft, i riferimenti a User.AccessToken diventano variabili Sconosciute. Nel piano Teams, anche i riferimenti a User.IsLoggedIn diventano variabili sconosciute. Correggi eventuali errori di argomento prima di pubblicare il tuo agente.

Esegui l'autenticazione manuale

Copilot Studio supporta i provider di servizi di autenticazione seguenti nell'opzione Authenticate manualmente:

  • Microsoft Entra ID V2 con credenziali federate
  • Microsoft Entra ID V2 con certificati
  • Microsoft Entra ID V2 con segreti client
  • Microsoft Entra ID
  • OAuth 2 generico: Qualsiasi fornitore di identità che rispetti lo standard OAuth 2.0

Se selezioni l'opzione Esegui l'autenticazione manuale le seguenti variabili sono disponibili nell'area del contenuto dell'argomento:

  • User.Id
  • User.DisplayName
  • User.AccessToken
  • User.IsLoggedIn

Scopri di più su queste variabili in Aggiungi autenticazione utente agli argomenti.

Note

  • Le modifiche all'autenticazione entrano in vigore solo dopo aver pubblicato l'agente.
  • Controlla questa impostazione con il corrispondente controllo di amministrazione in Power Platform. Quando attivi il controllo, impedisce che l'opzione Authenticate manually venga attivata o disattivata all'interno di Copilot Studio. Il controllo è sempre attivato e l'opzione Authenticate manualmente non può essere modificata in Copilot Studio.

Accesso utente richiesto e condivisione agente

L'impostazione Richiedi agli utenti di accedere determina se un utente deve accedere prima di parlare con l'agente. Attivare questa impostazione per gli agenti che devono accedere a informazioni riservate o limitate.

Questa opzione non è disponibile per le opzioni Nessuna autenticazione ed Esegui autenticazione con Microsoft .

Note

Non è possibile disattivare questa opzione quando i criteri dati nell'interfaccia di amministrazione di Power Platform sono impostati per richiedere l'autenticazione. Per altre informazioni, vedere Configurare i criteri dati per gli agenti.

Se disattivi questa opzione, l'agente non chiederà agli utenti di accedere finché non incontra un argomento che richiede loro di farlo.

Quando attivi questa opzione, crea un argomento di sistema chiamato Richiedi agli utenti di accedere. Questo argomento è rilevante solo per l'impostazione Autentica manualmente. Per l'accesso automatico nelle chat supportate da Teams, usa Authenticate with Microsoft.

L'argomento Richiedi agli utenti di accedere viene attivato automaticamente per qualsiasi utente che comunica con l'agente senza essere autenticato. Se l'utente non riesce ad effettuare l'accesso, l'argomento reindirizza al tema di sistema Escalate.

L'argomento è di sola lettura e non può essere personalizzato. Per vederlo, seleziona Vai al pannello di modifica.

Controllare chi può chattare con l'agente nell'organizzazione

La combinazione del tipo di autenticazione del tuo agente e dell'impostazione Richiedi l'accesso agli utenti determina se puoi condividere l'agente per controllare chi nella tua organizzazione può chattare con esso. L'impostazione di autenticazione non influisce sulla condivisione di un agente per la collaborazione.

  • Nessuna autenticazione: qualsiasi utente che ha un collegamento all'agente (o può trovarlo, ad esempio, nel sito Web) può chattare con esso. Non puoi controllare quali utenti dell'organizzazione possono chattare con l'agente.

  • Autentica con Microsoft: L'agente utilizza l'autenticazione Microsoft Entra ID in Teams, SharePoint, Power Apps e Microsoft Copilot. Gli utenti hanno già effettuato l'accesso, quindi non devi configurare separatamente l'opzione Richiedere l'accesso agli utenti. Puoi utilizzare la condivisione dell'agente per controllare chi nella tua organizzazione può chattare con l'agente.

  • Autenticazione manuale:

    • Se il provider di servizi è Microsoft Entra ID, è possibile attivare Richiedi agli utenti di accedere per controllare chi nell'organizzazione può chattare con l'agente mediante la condivisione dell'agente.

    • Se il provider del servizio è Generic OAuth 2, puoi attivare o disattivare Richiedere l'accesso agli utenti. Quando è attivato, un utente che effettua l'accesso può chattare con l'agente. Non puoi controllare quali utenti specifici dell'organizzazione possono chattare con l'agente usando la condivisione dell'agente.

Quando l'impostazione di autenticazione dell'agente non consente di controllare chi può chattare con esso, selezionando Condividi nella pagina della panoramica dell'agente viene visualizzato un messaggio che ti informa che chiunque può chattare con l'agente.

Campi di autenticazione manuale

La tabella seguente descrive i campi che possono verificarsi durante la configurazione dell'autenticazione manuale. I campi specifici che vedi dipendono dalla tua selezione per il fornitore di servizi.

Nome campo Description
Modello URL di autorizzazione Il modello URL per l'autorizzazione, definito dal provider di identità. Ad esempio, https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Modello stringa di query dell'URL di autorizzazione Il modello di query per l'autorizzazione, come fornito dal provider di identità. Le chiavi nel modello di stringa delle query variano in base al provider di identità (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State}).
ID del cliente L'ID client ottenuto dal provider di identità.
Segreto del cliente Il tuo segreto client, ottenuto quando hai creato la registrazione dell'app del provider di identità.
URL del KeyVault del certificato client URL del KeyVault in cui è archiviato il certificato client. Obbligatorio per Microsoft Entra ID con l'autenticazione dei certificati.
Tipo di concessione Il tipo di grant OAuth 2.0 che vuoi usare.
Richiesta x5c obbligatoria? Specifica se l'attestazione x5c è obbligatoria nella richiesta di token. Obbligatorio per Microsoft Entra ID con l'autenticazione dei certificati.
URL di accesso L'URL a cui gli utenti vengono indirizzati per effettuare l'accesso.
Aggiorna modello corpo Il modello per il corpo di aggiornamento (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}).
Aggiorna modello stringa di query dell'URL Il separatore della stringa di query dell'URL di aggiornamento per l'URL del token, in genere un punto interrogativo (?).
Aggiorna modello URL Il modello di URL per l'aggiornamento; per esempio, https://login.microsoftonline.com/common/oauth2/v2.0/token.
URL della risorsa URL della risorsa per cui il token è richiesto.
Delimitatore elenco ambiti Il carattere separatore per l'elenco degli ambiti. Gli spazi vuoti non sono supportati in questo campo.1
Ambiti L'elenco degli ambiti che vuoi che gli utenti abbiano dopo che hanno effettuato l'accesso. Utilizza il Delimitatore elenco ambiti per separare più ambiti.1 Imposta solo gli ambiti necessari e segui il lPrincipio di controllo dell'accesso con privilegi minimi.
Provider di servizi Il provider di servizi che vuoi utilizzare per l'autenticazione. Scopri di più sui fornitori generici OAuth.
ID del locatario Il tuo ID tenant Microsoft Entra ID. Scopri di più nell'articolo "Come trovare il tuo ID tenant Microsoft Entra".
Modello corpo del token Il modello per il corpo del token. (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret})
URL di scambio token (richiesto per Single Sign-On (SSO)) Richiesto quando si configura il single sign-on; altrimenti opzionale.
Modello URL del token Il modello di URL per i token, come definito dal provider di identità; per esempio, https://login.microsoftonline.com/common/oauth2/v2.0/token
Modello stringa di query dell'URL del token Il separatore della stringa di query per l'URL del token, in genere un punto interrogativo (?).

1 È possibile utilizzare spazi nel campo Scopes se il provider di identità lo richiede. In tal caso, inserisci una virgola (,) in Delimitatore elenco ambiti, e inserisci gli spazi nel campo Ambiti.

Disattiva autenticazione

  1. Con l'agente aperto, seleziona Impostazioni dalla barra dei menu in alto.

  2. Selezionare Sicurezza e quindi Autenticazione.

  3. Seleziona Nessuna autenticazione.

    Se un argomento usa variabili di autenticazione, diventano variabili sconosciute . Vai alla pagina Argomenti per vedere quali argomenti contengono errori e correggili prima della pubblicazione.

  4. Seleziona Salva, poi pubblica l'agente.

Importante

Se il tuo agente ha strumenti configurati per richiedere credenziali utente, non disattivare l'autenticazione a livello di agente. Questa azione impedisce il funzionamento di questi strumenti.