Delen via

Gebruikersverificatie configureren in Copilot Studio

Met verificatie kunnen gebruikers aanmelden, waardoor uw agent toegang krijgt tot een beperkte resource of informatie. Gebruikers kunnen zich aanmelden met een Microsoft Entra ID, of met een OAuth2-id-provider, zoals Google of Facebook.

Opmerking

U kunt in Microsoft Teams een Copilot Studio-agent configureren om verificatiemogelijkheden te bieden, zodat gebruikers zich met een Microsoft Entra ID of een willekeurige OAuth2-identiteitsprovider, zoals een Microsoft- of Facebook-account kunnen aanmelden.

U kunt gebruikersverificatie toevoegen aan onderwerpen wanneer u een onderwerp bewerkt.

Belangrijk

Wijzigingen in de verificatieconfiguratie worden pas van kracht nadat u uw agent publiceert. Zorg ervoor dat u vooruit plant voordat u verificatiewijzigingen aanbrengt in uw agent.

Een verificatieoptie kiezen

Copilot Studio ondersteunt verschillende verificatieopties. Selecteer en configureer de optie die aan uw behoeften voldoet.

  1. Ga naar Instellingen voor uw agent en selecteer Beveiliging.

  2. Selecteer Verificatie.

  3. Selecteer een verificatieoptie en configureer deze zo nodig. De volgende verificatieopties zijn beschikbaar:

  4. Selecteer Opslaan.

Geen verificatie

Geen verificatie betekent dat uw agent niet vereist dat uw gebruikers zich aanmelden bij interactie met de agent. Een niet-geverifieerde configuratie betekent dat uw agent alleen toegang heeft tot openbare informatie en bronnen. Klassieke chatbots zijn standaard zo geconfigureerd dat er geen verificatie vereist is.

Let op

Als u de optie Geen verificatie selecteert, kan iedereen met de koppeling chatten en communiceren met uw bot of agent.

Wij raden u aan om authenticatie toe te passen, vooral als u uw bot of agent binnen uw organisatie of voor specifieke gebruikers gebruikt, samen met andere beveiligings- en governancemaatregelen.

Notitie

Deze optie is niet beschikbaar wanneer gegevensbeleid in het Power Platform-beheercentrum is geconfigureerd om verificatie te vereisen. Zie het Voorbeeld van gegevensbeleid - Gebruikersverificatie in agenten vereisen voor meer informatie.

Verifiëren met Microsoft

Belangrijk

Wanneer de optie Verifiëren met Microsoft is geselecteerd, hebt u toegang tot het Teams + Microsoft 365-kanaal. U kunt ook systeemeigen app- en aangepaste app-kanalen gebruiken.

Bovendien is de optie Verifiëren met Microsoft niet beschikbaar voor agenten die zijn geïntegreerd met Dynamics 365 Customer Service.

Met deze configuratie wordt automatisch Microsoft Entra ID-verificatie ingesteld voor Teams, zonder dat u handmatig hoeft te configureren. Aangezien Teams-verificatie zelf de gebruiker identificeert, wordt gebruikers niet gevraagd zich aan te melden terwijl ze zich in Teams bevinden, tenzij uw agent een groter bereik nodig heeft.

Als u uw agent moet publiceren naar andere kanalen dan Teams + Microsoft 365, maar toch verificatie voor uw agent wilt, moet u de optie Handmatig verifiëren kiezen.

Als u Verifiëren met Microsoft selecteert, zijn de volgende variabelen beschikbaar op het ontwerpcanvas voor het onderwerp:

  • User.ID
  • User.DisplayName

Voor meer informatie over deze variabelen en hoe ze te gebruiken, zie Gebruikersverificatie toevoegen aan onderwerpen.

De variabelen User.AccessToken en User.IsLoggedIn zijn niet beschikbaar bij deze optie. Als u een verificatietoken nodig hebt, gebruikt u de optie Handmatig verifiëren.

Als u de verificatie wijzigt van Handmatig verifiëren in Verifiëren met Microsoft en uw onderwerpen de variabelen User.AccessToken of User.IsLoggedIn bevatten, worden ze na de wijziging weergegeven als onbekende variabelen. Zorg ervoor dat u eventuele fouten in uw onderwerpen corrigeert voordat u uw agent publiceert.

Handmatig verifiëren

Copilot Studio ondersteunt de volgende providers van verificatieservices onder de optie Handmatig verifiëren:

  • Microsoft Entra ID V2 met federatieve referenties
  • Microsoft Entra ID V2 met certificaten
  • Microsoft Entra ID V2 met clientgeheimen
  • Microsoft Entra ID
  • Generieke OAuth 2 - Elke id-provider die voldoet aan de OAuth2-standaard

Als u Handmatig verifiëren selecteert, zijn de volgende variabelen beschikbaar op het ontwerpcanvas voor het onderwerp:

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

Voor meer informatie over deze variabelen en hoe ze te gebruiken, zie Gebruikersverificatie toevoegen aan onderwerpen.

Nadat de configuratie is opgeslagen, moet u uw agent publiceren, zodat de wijzigingen van kracht worden.

Notitie

  • Verificatiewijzigingen worden pas van kracht nadat de agent is gepubliceerd.
  • Regel deze instelling met het bijbehorende beheerdersbesturingselement in Power Platform. Wanneer het besturingselement is ingeschakeld, wordt voorkomen dat de optie Handmatig verifiëren in Copilot Studio wordt in- of uitgeschakeld. De optie is altijd ingeschakeld en de optie Handmatig verifiëren kan niet worden gewijzigd in Copilot Studio.

Vereiste gebruikersaanmelding en delen van agenten

Vereisen dat gebruikers zich aanmelden bepaalt of een gebruiker zich moet aanmelden voordat hij met de agent praat. We raden u ten zeerste aan deze instelling in te schakelen voor agenten die toegang nodig hebben tot gevoelige of beperkte informatie.

Deze optie is niet beschikbaar voor de opties Geen verificatie en Verifiëren met Microsoft.

Notitie

Deze optie kan niet worden uitgeschakeld wanneer het gegevensbeleid in het Power Platform-beheercentrum is ingesteld op verificatie. Zie het Voorbeeld van gegevensbeleid - Gebruikersverificatie in agenten vereisen voor meer informatie.

Als u deze optie uitschakelt, vraagt uw agent gebruikers niet om zich aan te melden, totdat hij een onderwerp tegenkomt dat dit vereist.

Wanneer u deze optie inschakelt, wordt een systeemonderwerp gemaakt met de naam Vereisen dat gebruikers zich moeten aanmelden. Dit onderwerp is alleen relevant voor de instelling Handmatig verifiëren. Gebruikers worden altijd geverifieerd in Teams.

Het onderwerp Vereisen dat gebruikers zich aanmelden wordt automatisch geactiveerd voor elke gebruiker die met de agent praat zonder te zijn geverifieerd. Als de gebruiker zich niet aanmeldt, wordt het onderwerp omgeleid naar het systeemonderwerp Escaleren.

Het onderwerp is alleen-lezen en kan niet worden aangepast. Om het te zien, selecteert u Ga naar het ontwerpcanvas.

Bepalen wie kan chatten met de agent in de organisatie

Op basis van de combinatie van het verificatietype van de agent en Vereisen dat gebruikers zich aanmelden wordt bepaald u of u de agent kunt delen om te bepalen wie in uw organisatie met de agent mag chatten. De verificatie-instelling heeft geen invloed op het delen van een agent voor samenwerking.

  • Geen verificatie: elke gebruiker die een koppeling naar de agent heeft (of kan vinden; bijvoorbeeld op uw website) kan ermee chatten. U kunt niet bepalen welke gebruikers in uw organisatie mogen chatten met de agent.

  • Verifiëren met Microsoft: de agent werkt alleen voor het Teams-kanaal. Aangezien de gebruiker altijd aangemeld is, is de instelling Vereisen dat gebruikers zich aanmelden ingeschakeld en kan niet worden uitgeschakeld. U kunt agent delen gebruiken om te bepalen wie in uw organisatie met de agent mag chatten.

  • Handmatig verifiëren:

    • Als de serviceprovider Microsoft Entra ID is, kunt u Vereisen dat gebruikers zich aanmelden inschakelen om te bepalen wie in uw organisatie met de agent kan chatten door de agent te delen.

    • Als de serviceprovider Generieke OAuth2 is, kunt u Vereisen dat gebruikers zich aanmelden in- of uitschakelen. Als het is ingeschakeld, kan een gebruiker die zich aanmeldt, chatten met de agent. U kunt niet bepalen welke specifieke gebruikers in uw organisatie mogen chatten met de agent via agent delen.

Wanneer u door de verificatie-instelling van een agent niet kunt bepalen wie met de agent mag chatten en als u Delen selecteert op de overzichtspagina van de agent, wordt een bericht weergegeven om aan te geven dat iedereen met uw agent mag chatten.

Velden voor handmatige verificatie

In de volgende tabel worden velden beschreven die u mogelijk tegenkomt wanneer u handmatige verificatie configureert. Welke specifieke velden u te zien krijgt, is afhankelijk van uw selectie voor serviceproviders.

Veldnaam Omschrijving
Sjabloon voor autorisatie-URL De URL-sjabloon voor autorisatie, zoals gedefinieerd door uw identiteitsprovider. Bijvoorbeeld https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Sjabloon voor querytekenreeks voor autorisatie-URL De querysjabloon voor autorisatie, zoals verstrekt door uw id-provider. Sleutels in de querytekenreekssjabloon variëren, afhankelijk van de identiteitsprovider (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State}).
Client-id De client-id die u van de id-provider hebt gekregen.
Clientgeheim Uw clientgeheim, verkregen toen u de app-registratie van de id-provider maakte.
KeyVault-URL voor clientcertificaat De URL van de KeyVault waar uw clientcertificaat is opgeslagen. Vereist voor Microsoft Entra ID met verificatie via certificaten.
Toekenningstype Het OAuth2-toekenningstype dat u wilt gebruiken.
Is x5c-claim vereist Geef op of de x5c-claim vereist is in de tokenaanvraag. Vereist voor Microsoft Entra ID met verificatie via certificaten.
URL voor aanmelding De URL waarnaar gebruikers worden omgeleid om zich aan te melden.
Sjabloon voor vernieuwen van hoofdtekst De sjabloon voor het vernieuwen van hoofdtekst (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}).
Sjabloon voor querytekenreeks voor vernieuwen van URL Het scheidingsteken voor de queryreeks voor de vernieuwings-URL voor de token-URL, meestal een vraagteken (?).
Sjabloon voor vernieuwen van URL De URL-sjabloon voor vernieuwen; bijvoorbeeld https://login.microsoftonline.com/common/oauth2/v2.0/token.
Resource-URL De resource-URL project waarvoor het token wordt aangevraagd.
Scheidingsteken voor bereiklijst Het scheidingsteken voor de lijst met bereiken. Lege ruimten worden niet ondersteund in dit veld.1
Bereiken De lijst van bereiken die u wilt dat gebruikers hebben nadat ze zijn aangemeld. Gebruik het scheidingsteken voor bereiklijst om meerdere bereiken te scheiden.1 Stel alleen noodzakelijke bereiken in en volg het principe van toegangscontrole met minimale bevoegdheden.
Serviceprovider De serviceprovider die u wilt gebruiken voor verificatie. Voor meer informatie, zie Generieke OAuth-providers.
Tenant-id Uw Microsoft Entra ID-tenant-id. Zie Een bestaande Microsoft Entra ID-tenant gebruiken voor meer informatie over het vinden van uw tenant-id.
Sjabloon voor token hoofdtekst De sjabloon voor de hoofdtekst van de token. (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret})
URL voor tokenuitwisseling (vereist voor eenmalige aanmelding (SSO)) Dit optionele veld wordt gebruikt wanneer u eenmalige aanmelding configureert.
Sjabloon voor URL van token De URL-sjabloon voor tokens, zoals verstrekt door uw id-provider; bijvoorbeeld https://login.microsoftonline.com/common/oauth2/v2.0/token.
Sjabloon voor querytekenreeks voor URL van token Het scheidingsteken voor de queryreeks voor de token-URL, meestal een vraagteken (?).

1 U kunt spaties gebruiken in het veld Bereiken als de id-provider het vereist. Typ in dat geval een komma (,) bij Scheidingsteken voor bereiklijst en voer spaties in het veld Bereiken in.

Verificatie uitschakelen

  1. Terwijl uw agent geopend is, selecteert u Instellingen op de bovenste menubalk.

  2. Selecteer Beveiliging en selecteer vervolgens Verificatie.

  3. Selecteer Geen verificatie.

    Als verificatievariabelen worden gebruikt in een onderwerp, worden ze onbekende variabelen. Ga naar de pagina Onderwerpen om te zien welke onderwerpen fouten bevatten en los ze op voordat u ze publiceert.

  4. Publiceer de agent.

Belangrijk

Als uw agent hulpmiddelen heeft geconfigureerd om gebruikersreferenties te vereisen, moet u verificatie niet uitschakelen op agentniveau omdat deze hulpmiddelen dan niet werken.

  • Last updated on