Effettuare il provisioning delle risorse dell'agente in Azure servizio Bot usando le credenziali federate

Questo articolo illustra come registrare un agente con Servizio di Azure AI Bot usando le credenziali federate.

Creare un'identità gestita assegnata dall'utente

Crea un'identità gestita assegnata dall'utente. Questa identità viene usata come identità per la risorsa bot Azure ed è associata alla registrazione dell'app usando credenziali federate. In questo modo il bot può eseguire l'autenticazione usando l'identità gestita quando viene distribuita in Azure, senza dover gestire i segreti.

1. Accedere al portale di Azure.

2. Creare un'identità gestita assegnata dall'utente:

   1. Nel riquadro destro trovare/selezionare Crea una risorsa e selezionare Identità gestita assegnata dall'utente.

      

   2. Selezionare Crea e specificare le informazioni necessarie.

      Schermata del modulo User Assigned Managed Identity (Dettagli identità gestita assegnata dall'utente) con i campi obbligatori.

   3. Completa la creazione selezionando Crea. Al termine, selezionare Vai alla risorsa.

   4. Annota il ClientId. Questa operazione verrà usata in un secondo momento durante la configurazione delle credenziali federate nella registrazione dell'app. Viene usato anche quando si configurano le impostazioni dell'agente ed è l'impostazione FederatedClientId.

Creare la risorsa di Azure Bot

1. Nel riquadro destro selezionare Crea una risorsa.

2. Trova e seleziona la scheda Bot di Azure.

   

3. Fare clic su Crea.

4. Immettere i valori nei campi obbligatori ed esaminare e aggiornare le impostazioni.

   1. Fornisci informazioni in Dettagli progetto. Seleziona se il tuo agente ha una residenza dei dati globale o locale. Attualmente, la funzionalità di residenza dei dati locali è disponibile per le risorse nell'area "westeurope" e "centralindia". Per ulteriori informazioni, vedere Regionalizzazione nel servizio Bot di Azure AI.

   

   1. Inserisci le informazioni nell'ID app Microsoft. Selezionare la modalità di gestione dell'identità dell'agente in Azure e se creare una nuova identità o usarne una esistente.

   

5. Seleziona Rivedi + Crea.

6. Se la convalida viene superata, selezionare Crea.

Configurare l'autenticazione per la risorsa di Azure Bot usando le credenziali federate

1. Al termine della distribuzione della risorsa Azure Bot, selezionare Vai alla risorsa. Verranno visualizzati l'agente e le risorse correlate elencate nel gruppo di risorse selezionato.

2. Se si tratta di un agente di Teams o Microsoft 365:

   1. Selezionare Impostazioni e quindi Canali.

   2. Seleziona Microsoft Teams dall'elenco e scegli le opzioni appropriate.

3. Selezionare Impostazioni e quindi Configurazione.

4. Seleziona Gestisci password accanto a Microsoft App ID.

   

5. Nel riquadro Panoramica, registra l'ID applicazione (client) e l'ID directory (tenant)

   • Si usa durante la configurazione delle impostazioni dell'agente e corrisponde alle impostazioni ClientId e TenantId.

6. Selezionare Certificati e segreti, quindi selezionare Segreti client. Se è presente un segreto elencato, è possibile eliminare il segreto in modo che non venga usato per l'autenticazione. Le credenziali federate configurate nei passaggi successivi vengono usate per l'autenticazione anziché per un segreto client.

7. Seleziona Credenziali federate.

8. Seleziona Aggiungi credenziali.

9. Impostare le proprietà delle credenziali.

   

   1. Scenario di credenziali federate: identità gestita.

   2. Selezionare Seleziona un'identità gestita e selezionare l'identità gestita assegnata dall'utente creata in precedenza.

   3. Impostare il nome, ad esempio "agent".

   4. Al termine, selezionare Aggiungi.

Operazioni successive

• Aggiungere l'autorizzazione utente usando la credenziale di identità federata
• Configurare l'autenticazione in un agente .NET
• Configurare l'autenticazione in un agente JavaScript