Configurer l’authentification utilisateur avec Microsoft Entra ID

Lorsque vous ajoutez l’authentification à votre agent, les utilisateurs peuvent se connecter et donner à votre agent accès à une ressource ou à une information restreinte.

Cet article explique comment configurer Microsoft Entra ID en tant que fournisseur de services. Pour plus d’informations sur les autres fournisseurs de services et l’authentification utilisateur, consultez Configurer l’authentification utilisateur dans Copilot Studio.

Si vous disposez des droits d’administration des clients, vous pouvez configurer des autorisations d’API. Sinon, demandez à un administrateur locataire d’accorder ces autorisations.

Prérequis

Découvrez comment ajouter l’authentification utilisateur à une rubrique

Vous effectuez les premières étapes du portail Azure et effectuez les deux dernières étapes dans Copilot Studio.

Créer un enregistrement d’application

1. Connectez-vous au portail Azure à l’aide d’un compte d’administrateur dans le même locataire que votre agent.

2. Accédez à App registrations.

3. Sélectionnez Nouvelle inscription et tapez un nom pour l’inscription. Ne modifiez pas les inscriptions d’applications existantes.

   Il peut être utile ultérieurement d’utiliser le nom de votre agent. Par exemple, si votre agent est appelé « Aide aux ventes Contoso », vous pouvez nommer l’inscription de l’application « ContosoSalesReg ».

4. Sous Types de comptes pris en charge, sélectionnez Comptes dans cet annuaire organisationnel uniquement (Contoso uniquement - Locataire unique).

5. Laissez la section URI de redirection vide pour l’instant. Entrez ces informations dans les étapes suivantes.

6. Sélectionnez Inscription.

7. Après la fin de l’inscription, allez à Aperçu.

8. Copiez l’ID d’application (client) et collez-le dans un fichier temporaire. Vous en aurez besoin dans des étapes ultérieures.

Ajouter l’URL de redirection

1. Sous Gérer, sélectionnez Authentification.

2. Sous Configurations de plate-forme, sélectionnez Ajouter une plateforme, puis sélectionnez Web.

3. Sous URI de redirection, entrez https://token.botframework.com/.auth/web/redirect ou https://europe.token.botframework.com/.auth/web/redirect pour l’Europe. Vous pouvez également copier l’URI à partir de la zone de texte Redirect URL dans Copilot Studio, à la page des paramètres de Sécurité, sous Authentification manuelle.

   Cette action vous redirige vers la page Configurations de la plateforme.

   Pour obtenir la liste des services requis auxquels Copilot Studio se connecte, y compris token.botframework.com, consultez Required services.

4. Sélectionnez les jetons d’accès (utilisés pour les flux implicites) et les jetons d’ID (utilisés pour les flux implicites et hybrides) .

5. Sélectionnez Configurer.

Configurer l’authentification manuelle

Ensuite, configurez l’authentification manuelle. Vous pouvez choisir parmi plusieurs options pour votre fournisseur. Toutefois, utilisez Microsoft Entra ID V2 avec des informations d’identification fédérées. Vous pouvez également utiliser des clés secrètes client si vous ne parvenez pas à utiliser des informations d’identification fédérées.

Configurer les autorisations API

1. Accédez à Autorisations API.

2. Sélectionnez Accorder un consentement administrateur pour <votre nom de client>, puis cliquez sur Oui. Si le bouton n’est pas disponible, vous devrez peut-être demander à un administrateur client de l’entrer pour vous.

   

   Important

   Pour éviter aux utilisateurs d’avoir à accorder leur consentement à chaque application, une personne à laquelle au moins le rôle Administrateur d’application ou Administrateur d’application cloud est affectée peut accorder son consentement à l’échelle du locataire à vos inscriptions d’applications.

3. Sélectionnez Add une autorisation, puis sélectionnez Microsoft Graph.

   

4. Sélectionnez Autorisations déléguées.

   

5. Développez Autorisations OpenId et activez openid et profil.

   

6. Sélectionnez Ajouter des autorisations.

Définir une étendue personnalisée pour votre agent

Les périmètres déterminent les rôles des utilisateurs et des administrateurs ainsi que les droits d’accès. Créez un scope personnalisé pour l’inscription à l’application Canvas.

1. Accédez à Exposer une API et sélectionnez Ajouter une étendue.

   

2. Définissez les propriétés suivantes. Vous pouvez laisser les autres propriétés vides.

   Propriété	valeur
   Nom de l’étendue	Entrez un nom qui a du sens dans votre environnement, par exemple Test.Read
   Qui peut donner son consentement ?	Sélectionnez Administrateurs et utilisateurs
   Nom d’affichage du consentement de l’administrateur	Entrez un nom qui a du sens dans votre environnement, par exemple Test.Read
   Description du consentement de l'administrateur	Entrez Allows the app to sign the user in.
   État	Sélectionnez Activé

3. Sélectionnez Ajouter une étendue.

Configurer l’authentification dans Copilot Studio

1. Dans Copilot Studio, sous Settings, sélectionnez Security>Authentication.

2. Sélectionnez Authentifier manuellement.

3. Laissez l’option Demander aux utilisateurs de se connecter activée.

4. Sélectionnez un Fournisseur de services et fournissez les valeurs requises. Consultez Configurer l’authentification manuelle dans Copilot Studio.

5. Cliquez sur Enregistrer.

Tester votre assistant

1. Publiez votre agent.

2. Dans le volet Tester votre agent, envoyez un message à votre agent.

3. Lorsque l’agent répond, sélectionnez Connexion.

   Un nouvel onglet du navigateur s’ouvre, vous invitant à vous connecter.

4. Connectez-vous, puis copiez le code de validation affiché.

5. Pour terminer le processus de connexion, collez le code dans la conversation instantanée de l’assistant.