Autenticazione

Completato

L'impostazione di autenticazione in Microsoft Copilot Studio incide sulla modalità di gestione degli accessi al copilota. Consente di verificare l'identità di un utente durante una conversazione, il che permette:

  • Ulteriore personalizzazione della conversazione

  • La capacità del copilota di eseguire azioni per conto dell'utente

  • La possibilità di saltare le finestre di dialogo nella conversazione precompilando i dati dell'utente e andando dritti al punto

  • Variabili quali l'ID utente e il nome visualizzato disponibili per l'uso all'interno degli argomenti

Si tratta di un'esperienza flessibile. È possibile contrassegnare alcune parti della conversazione che richiedono l'accesso dell'utente, mentre altre parti non richiedono l'accesso dell'utente.

Le impostazioni di autenticazione sono disponibili in Microsoft Copilot Studio selezionando Impostazioni nel riquadro di spostamento laterale e accedendo successivamente a Sicurezza>Autenticazione.

Screenshot del menu delle impostazioni.

Le opzioni per l'autenticazione sono:

  • Nessuna autenticazione

  • Solo per Teams

  • Manuale (per qualsiasi canale, incluso Teams)

Screenshot della finestra di dialogo Autenticazione con Manuale selezionato e Provider di servizi compilato.

È necessario pubblicare il copilota per rendere effettive le modifiche nell'impostazione di autenticazione.

Nessuna autenticazione

Se si seleziona Nessuna autenticazione, chiunque può accedere al copilota potrà chattare con esso senza dover effettuare l'accesso. Viene incluso qualsiasi utente che abbia un collegamento al copilota o chiunque possa trovarlo, ad esempio, sul sito Web. Non sono disponibili variabili di autenticazione per l'uso negli argomenti.

Solo per Teams

Questa opzione imposta l'autenticazione solo per Microsoft Teams e disattiva eventuali altri canali, da cui disconnette il copilota. Solo gli utenti con cui è stato condiviso il copilota possono utilizzarlo.

Manuale (per qualsiasi canale, incluso Teams)

Microsoft Copilot Studio supporta i provider di identità conformi allo standard OAuth2 . Ciò significa che è possibile consentire agli utenti di effettuare l'accesso con qualsiasi provider di identità OAuth2. I provider di identità OAuth2 includono:

  • Microsoft Entra ID

  • Account Microsoft

  • Google

  • Facebook

  • Servizio di autenticazione personalizzato creato per la propria società.

È possibile chiamare l'azione di Autenticazione durante una conversazione, pertanto l'utente ha bisogno di una scheda di accesso. In alternativa, è possibile selezionare l'opzione Richiedi agli utenti di accedere, che crea un argomento di sistema per "Richiedi all'utente di accedere". Questo argomento richiederà all'utente di accedere all'avvio della conversazione con il copilota. Questo screenshot mostra l'argomento di sistema Richiedi all'utente di accedere e le variabili archiviate. Le variabili ottenute sono IsLoggedIn, AuthToken, UserDisplayName e UserID.

Screenshot di Microsoft Copilot Studio che mostra l'azione Autentica con condizioni.

Configurazione dell'autenticazione manuale

Per configurare un'autenticazione manuale in Microsoft Copilot Studio, registrare una nuova app presso il proprio provider di identità e ottenere un ID client e un Segreto client. I dettagli di seguito mostrano come è possibile effettuare questa operazione dal portale di Azure per Microsoft Entra ID.

Per registrare un'applicazione, è possibile passare a Registrazioni app dal portale di Azure e creare una nuova registrazione. È necessario fornire un nome per la registrazione, ad esempio il nome del copilota, quindi specificare quali account possono accedere al copilota. Ad esempio, l'opzione selezionata qui consente agli utenti di qualsiasi directory Microsoft Entra ID o account Microsoft personale di accedere e parlare con il copilota. Il valore di URI di reindirizzamento deve essere https://token.botframework.com/.auth/web/redirect con Web come piattaforma.

Screenshot di Microsoft Azure nella pagina Registra un'applicazione con il campo Nome compilato, l'opzione Account in qualsiasi directory dell'organizzazione selezionata e l'URI di reindirizzamento impostato.

Quindi, è necessario aggiungere un nuovo segreto client. È possibile passare all'area Certificati e segreti della registrazione dell'app e selezionare +Nuovo segreto client. Qui è possibile fornire una descrizione e selezionare un periodo di scadenza.

Screenshot della finestra di dialogo Aggiungi un segreto client in Microsoft Entra ID con la descrizione impostata su Microsoft Copilot Studio e la scadenza impostata su 12 mesi.

Il valore del segreto client mostrato qui dovrà essere annotato, poiché verrà usato per la configurazione.

Screenshot della pagina Certificati e segreti per Microsoft Copilot Studio di Microsoft Azure con il valore del segreto client Microsoft Copilot Studio evidenziato.

Sarà inoltre necessario l'ID (client) dell'applicazione, disponibile nell'area Panoramica della registrazione dell'app.

Screenshot di Microsoft Azure con l'opzione Panoramica per Microsoft Copilot Studio con il valore ID client applicazione evidenziato.

Ora che la configurazione di Azure è completata, è possibile popolare le impostazioni di autenticazione di Microsoft Copilot Studio. È possibile aprire il copilota in Microsoft Copilot Studio e andare a Impostazioni>Sicurezza>Autenticazione.

Opzione di autenticazione deve essere impostata su Manuale. Se si seleziona Richiedi agli utenti di accedere, verrà creato un argomento di sistema che richiede agli utenti di effettuare l'accesso all'inizio della conversazione. In caso contrario, se questa opzione è deselezionata, è possibile chiamare l'azione di autenticazione in qualsiasi momento della conversazione.

Provider di servizi deve essere Azure Active Directory v2. Nei campi ID client e Segreto client è possibile immettere l'ID dell'applicazione e il valore del segreto client ottenuto in precedenza. URL scambio token è un campo facoltativo usato per la configurazione Single Sign-On. L'ambito si riferisce all'accesso che si desidera concedere agli utenti autenticati una volta effettuato l'accesso. Per ulteriori informazioni, vedere Ambiti.

Screenshot della finestra di dialogo Autenticazione con le impostazioni manuali evidenziate.

Una volta salvate le impostazioni di autenticazione e pubblicato il copilota è possibile usare Chiama un'azione>Autenticazione negli argomenti. Se più argomenti richiedono l'autenticazione, all'utente verrà richiesto di accedere solo una volta durante la sessione.

Screenshot del flusso di frasi trigger che chiamano un'azione di autenticazione.

Questo imposta automaticamente la diramazione condizionale, con messaggi e variabili correlati all'autenticazione. Esiste una variabile che archivia il token di autenticazione quando l'utente effettua l'accesso. Si tratta una variabile booleana che memorizza se l'utente ha effettuato l'accesso, nonché le variabili per l'ID utente e il nome visualizzato.

Screenshot del flusso Richiedi conferma all'utente con scheda di accesso completato con le azioni e i messaggi per le condizioni di autenticazione.