Konfigurere brukergodkjenning i Copilot Studio

Brukerautentisering lar brukere logge inn slik at agenten kan få tilgang til begrensede ressurser eller informasjon på deres vegne. Brukere kan logge inn ved å bruke Microsoft Entra ID eller en OAuth 2.0-identitetsleverandør, som Google eller Facebook.

Note

For Microsoft Teams-utrullinger som bruker manuell autentisering, bør du gjennomgå distribusjonskravene i Konfigurer enkel pålogging med Microsoft Entra ID for agenter i Teams.

Du kan legge til brukergodkjenning i emner når du redigerer et emne.

Important

Endringer i godkjenningskonfigurasjonen trer bare i kraft etter at du har publisert agenten. Planlegg på forhånd før du gjør godkjenningsendringer til agenten.

Velg et godkjenningsalternativ

Note

Før du velger et godkjenningsalternativ, kan du se gjennom følgende Power BI integreringsbegrensning. Copilot Studio agenter som bruker Microsoft godkjenning (Entra ID), kan ikke bygges inn i Power BI rapporter ved hjelp av iframe-baserte visualobjekter.

Copilot Studio støtter flere godkjenningsalternativer. Velg og konfigurer alternativet som passer dine behov.

  1. Gå til Innstillinger for agenten, og velg Sikkerhet.

  2. Velg Godkjenning.

  3. Velg et godkjenningsalternativ, og konfigurer det etter behov. Følgende godkjenningsalternativer er tilgjengelige:

  4. Velg Lagre.

Ingen godkjenning

Ingen godkjenning betyr at agenten ikke krever at brukerne logger seg på når de kommuniserer med agenten. En ikke-godkjent konfigurasjon betyr at agenten bare har tilgang til offentlig informasjon og ressurser. Klassiske chatroboter er som standard konfigurert til å ikke kreve godkjenning.

Dette alternativet er ikke tilgjengelig når en datapolicy er konfigurert i Power Platform-administrasjonssenteret til å kreve autentisering.

Forsiktig! 

Hvis du velger alternativet Ingen godkjenning, kan alle som har koblingen, chatte og kommunisere med roboten eller agenten.

Vi anbefaler at du bruker godkjenning, spesielt hvis du bruker roboten eller agent i organisasjonen eller for bestemte brukere, sammen med andre sikkerhets- og styringskontroller.

Godkjenn med Microsoft

Important

For å publisere gjennom den innebygde Teams + Microsoft 365-kanalen bruker du Godkjenn med Microsoft. Hvis autentiseringskonfigurasjonen din blokkerer kanalen, sjekk agent status. For utrullinger med manuell autentisering i Teams, følg de separate kravene til Teams SSO og appmanifest.

I tillegg er ikke alternativet Authenticate med Microsoft tilgjengelig for agenter som integreres med Dynamics 365 Customer Service.

Denne konfigurasjonen setter automatisk opp Microsoft Entra ID-autentisering for Teams, SharePoint, Power Apps og Microsoft Copilot uten manuell konfigurasjon. I Teams blir ikke brukerne bedt om å logge på med mindre agenten din krever et utvidet scope.

Hvis du trenger autentisering på andre kanaler, velg Autentiser manuelt.

Hvis du velger Autentiser med Microsoft, er følgende variabler tilgjengelige i emneforfatterfeltet både i nettappen og i Teams-planen:

  • User.Id
  • User.DisplayName

I nettappen User.IsLoggedIn er også ytterligere profilvariabler tilgjengelige. I Teams-planen User.IsLoggedIn er ikke tilgjengelig med dette alternativet. Finn ut mer i Godkjenningsvariabler.

User.AccessToken er ikke tilgjengelig med dette alternativet. Hvis du trenger en autentiseringstoken, bruk Autentiser manuelt.

Hvis du bytter fra Autentiser manuelt til Autentiser med Microsoft, blir referanser til User.AccessTokenUkjente-variabler. I Teams-planen blir referanser til User.IsLoggedIn også ukjente variabler. Rett eventuelle emnefeil før du publiserer agenten din.

Godkjenn manuelt

Copilot Studio støtter følgende leverandører av godkjenningstjenester under alternativet Authenticate manuelt alternativet:

  • Microsoft Entra ID V2 med federerte legitimasjoner
  • Microsoft Entra ID V2 med sertifikater
  • Microsoft Entra ID V2 med klienthemmeligheter
  • Microsoft Entra ID
  • Generisk OAuth 2: Enhver identitetsleverandør som overholder OAuth 2.0-standarden

Hvis du velger Autentiser manuelt, følgende variabler er tilgjengelige i emneredigeringslerretet:

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

Lær mer om disse variablene i Legg til brukerautentisering i artikler.

Note

  • Autentiseringsendringer trer først i kraft etter at du har publisert agenten.
  • Kontroller denne innstillingen med den tilhørende administratorkontrollen i Power Platform. Når du aktiverer kontrollen, forhindrer den at alternativet Godkjenn manuelt deaktiveres eller aktiveres i Copilot Studio. Kontrollen er alltid aktivert, og alternativet Authenticate manuelt kan ikke endres i Copilot Studio.

Krever brukerinnlogging og deling av agent

Innstillingen Krev at brukere logger på avgjør om en bruker må logge seg på før brukeren kan snakke med agenten. Aktiver denne innstillingen for agenter som trenger tilgang til sensitiv eller begrenset informasjon.

Dette alternativet er ikke tilgjengelig for alternativene Ingen godkjenning og Godkjenn med Microsoft.

Note

Du kan ikke deaktivere dette alternativet når datapolicyen i administrasjonssenteret for Power Platform er satt til å kreve godkjenning. Finn ut mer i Konfigurer datapolicyer for agenter.

Hvis du deaktiverer dette alternativet, ber ikke agenten brukere om å logge seg på før den kommer til et emne som krever at de gjør det.

Når du aktiverer dette alternativet, opprettes et systememne kalt Krever at brukere logger på. Dette emnet er bare relevant for innstillingen Godkjenn manuelt godkjenning. For automatisk pålogging i støttede Teams-chatter bruker du Godkjenn med Microsoft.

Krev at brukere logger på emnet utløser automatisk for alle brukere som snakker med agenten uten å bli godkjent. Hvis brukeren ikke kan logge seg på, omdirigeres emnet til systememnet Eskaler.

Emnet er skrivebeskyttet og kan ikke tilpasses. Du kan vise det ved å velge Gå til redigeringslerretet.

Styre hvem som kan chatte med agenten i organisasjonen

Kombinasjonen av agentens autentiseringstype og innstillingen Krever at brukere logger inn avgjør om du kan dele agenten for å kontrollere hvem i organisasjonen som kan chatte med den. Godkjenningsinnstillingen påvirker ikke deling av en agent for samarbeid.

  • Ingen godkjenning: Alle brukere som har en kobling til agenten (eller finner den, for eksempel på nettstedet), kan chatte med den. Du kan ikke styre hvilke brukere i organisasjonen som kan chatte med agenten.

  • Autentiser deg hos Microsoft: Agenten bruker Microsoft Entra ID-autentisering i Teams, SharePoint, Power Apps og Microsoft Copilot. Brukere er allerede logget inn, så du konfigurerer ikke Krev at brukere logger på separat. Du kan bruke agentdeling til å styre hvem i organisasjonen som kan chatte med agenten.

  • Autentiser manuelt:

    • Hvis tjenesteleverandøren er Microsoft Entra ID, kan du aktivere Rekvise brukere til å logge på for å kontrollere hvem i organisasjonen som kan chatte med agenten ved hjelp av agentdeling.

    • Hvis tjenesteleverandøren er Generic OAuth 2, kan du slå på eller av Må brukere logge inn . Når den er aktivert, kan en bruker som logger seg på, chatte med agenten. Du kan ikke styre hvilke bestemte brukere i organisasjonen som kan chatte med agenten, ved å bruke agentdeling.

Når agentens autentiseringsinnstilling ikke lar deg kontrollere hvem som kan chatte med den, og du velger Dele På agentens oversiktsside informerer en melding deg om at hvem som helst kan chatte med agenten din.

Felter for manuell godkjenning

Tabellen nedenfor beskriver felt du kan støte på når du konfigurerer manuell godkjenning. De spesifikke feltene du ser avhenger av valget av tjenesteleverandør.

Feltnavn Description
Mal for nettadresse for godkjenning URL-malen for godkjenning, som definert av identitetsleverandøren. Eksempel: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Spørringsstrengmal for nettadresse for godkjenning Spørringsmalen for godkjenning, som levert av identitetsleverandøren. Nøkler i malen for spørringsstreng vil variere avhengig av identitetsleverandøren (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State}).
Klient-ID Klient-ID-en som er hentet fra identitetsleverandøren.
Klienthemmelighet Klienthemmeligheten, som du fikk da du opprettet appregistreringen for identitetsleverandøren.
URL for klientsertifikatets nøkkelhvelv URL-adressen til nøkkelhvelvet der klientsertifikatet ditt er lagret. Obligatorisk for Microsoft Entra ID med sertifikatgodkjenning.
Tilskuddstype OAuth 2.0-tildelingstypen du vil bruke.
Er x5c-krav påkrevd Angi om x5c-kravet er nødvendig i tokenforespørselen. Obligatorisk for Microsoft Entra ID med sertifikatgodkjenning.
Nettadresse for pålogging NETTADRESSEn der brukerne blir bedt om å logge på.
Mal for oppdateringsbrødtekst Malen for oppdateringsbrødteksten (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}).
Oppdater spørringsstrengmal for nettadresse Skilletegn for spørringsstrengen i oppdaterings-URL-en for token-URL-en, vanligvis et spørsmålstegn (?).
Mal for oppdatering av URL Malen for nettadressen for oppdatering, for eksempel https://login.microsoftonline.com/common/oauth2/v2.0/token.
URL-adresse til ressurs Ressurs-URL-en som tokenet forspørres for.
Skilletegn for områdeliste Skilletegnet for omfangslisten. Tomme mellomrom støttes ikke i dette feltet.1
Omfang Listen over omfang du vil at brukere skal ha, etter at de har logget seg på. Bruk Skilletegn for omfangsliste til å skille flere omfang.1 Bare angi nødvendige omfang, og følg tilgangskontrollprinsippet om minimale rettigheter.
Tjenesteleverandør Tjenesteleverandøren du vil bruke til godkjenning. Lær mer om OAuth generiske leverandører.
Leietaker-ID Din Microsoft Entra ID leier-ID. Finn ut mer i Slik finner du Microsoft Entra-leier-ID-en.
Mal for tokenbrødtekst Malen for tokenbrødteksten. (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret})
URL-adresse for tokenutveksling (kreves for enkel pålogging (SSO)) Påkrevd når du konfigurerer single sign-on; valgfritt ellers.
Mal for nettadresse for token Malen for nettadresse for tokener, som levert av identitetsleverandøren, for eksempel https://login.microsoftonline.com/common/oauth2/v2.0/token.
Mal for token-spørringsstreng i URL Skilletegn for spørringsstreng for tokennettadressen, vanligvis et spørsmålstegn (?).

1 Du kan bruke mellomrom i Omfang feltet hvis identitetsleverandøren krever det. I slike tilfeller angir du komma (,) i Skilletegn for omfangsliste og mellomrom i Omfang-feltet.

Deaktivere godkjenning

  1. Når agenten er åpen, velger du Innstillinger på den øverste menylinjen.

  2. Velg Sikkerhet, og velg deretter Godkjenning.

  3. Velg Ingen godkjenning.

    Hvis et emne bruker godkjenningsvariabler, blir de ukjente variabler. Gå til Emner-siden for å se hvilke emner som har feil, og rett dem før publisering.

  4. Velg Lagre, og publiser deretter agenten.

Important

Hvis agenten din har verktøy konfigurert til å kreve brukerlegitimasjon, ikke slå av autentisering på agentnivå. Denne handlingen hindrer disse verktøyene i å fungere.