Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
Brugerautentificering giver brugerne mulighed for at logge ind, så din agent kan få adgang til begrænsede ressourcer eller information på brugernes vegne. Brugere kan logge ind ved at bruge Microsoft Entra ID eller en OAuth 2.0-identitetsudbyder, såsom Google eller Facebook.
Notat
For Microsoft Teams-implementeringer, der bruger manuel godkendelse, skal du gennemgå implementeringskravene i Konfigurer SSO (enkeltlogon) med Microsoft Entra-id for agenter i Teams.
Du kan føje slutbrugergodkendelse til emner, når du redigerer et emne.
Vigtig
Ændringer af godkendelseskonfigurationen træder først i kraft, når du har publiceret din agent. Planlæg, før du foretager ændringer af din agents godkendelse.
Vælg en godkendelsesindstilling
Notat
Før du vælger en godkendelsesindstilling, skal du gennemse følgende Power BI integrationsbegrænsning. Copilot Studio agenter, der bruger Microsoft godkendelse (Entra ID), kan ikke integreres i Power BI rapporter ved hjælp af iframe-baserede visualiseringer.
Copilot Studio understøtter flere godkendelsesindstillinger. Vælg og konfigurer den indstilling, der opfylder dine behov.
Gå til Indstillinger for din agent, og vælg Sikkerhed.
Vælg Godkendelse.
Vælg en godkendelsesindstilling, og konfigurer den efter behov. Der findes følgende godkendelsesindstillinger:
Vælg Gem.
Ingen godkendelse
Ingen godkendelse betyder, at din agent ikke kræver, at dine brugere logger på, når de interagerer med agenten. En ikke-godkendt konfiguration betyder, at din agent kun kan få adgang til offentlige oplysninger og ressourcer. Klassiske chatrobotter er som standard konfigureret til ikke at kræve godkendelse.
Denne mulighed er ikke tilgængelig, når en datapolitik er konfigureret i Power Platform-administrationscentret til at kræve autentificering.
Advarsel
Hvis du vælger indstillingen Ingen godkendelse, kan alle, der har linket, chatte og interagere med din robot eller agent.
Det anbefales, at du anvender godkendelse, især hvis du bruger din robot eller agent i din organisation eller for bestemte brugere, sammen med andre sikkerheds- og styringskontroller.
Godkend med Microsoft
Vigtig
Ved publicering via den indbyggede kanal Teams + Microsoft 365 skal du bruge Godkend med Microsoft. Hvis din autentificeringskonfiguration blokerer kanalen, så gennemgå agent status. Ved implementeringer med manuel godkendelse i Teams skal du følge de separate krav til Teams SSO og appmanifest.
Desuden er indstillingen Authenticate med Microsoft ikke tilgængelig for agenter, der kan integreres med Dynamics 365 Customer Service.
Denne konfiguration opsætter automatisk Microsoft Entra ID-autentificering for Teams, SharePoint, Power Apps og Microsoft Copilot uden manuel konfiguration. I Teams bliver brugerne ikke bedt om at logge ind, medmindre din agent kræver et udvidet tilladelsesområde.
Hvis du har brug for autentificering på andre kanaler, vælg Autentificér manuelt.
Hvis du vælger Log på med Microsoft, er følgende variabler tilgængelige i emneforfatter-canvasen både i webappen og i Teams-planen:
User.IdUser.DisplayName
I webappen User.IsLoggedIn er der også tilgængelige yderligere profilvariabler. I Teams-planen er User.IsLoggedIn ikke tilgængelig med denne indstilling. Lær mere i Autentificeringsvariabler.
User.AccessToken er ikke tilgængelig med denne indstilling. Hvis du har brug for et godkendelsestoken, skal du bruge Godkend manuelt.
Hvis du skifter fra Godkend manuelt til Godkend med Microsoft, bliver referencer User.AccessToken til Ukendte variabler. I Teams-planen bliver referencer til User.IsLoggedIn også til ukendte variable. Ret eventuelle emnefejl, før du udgiver din agent.
Godkend manuelt
Copilot Studio understøtter følgende godkendelsestjenesteudbydere under indstillingen Authenticate manuelt indstilling:
- Microsoft Entra ID V2 med legitimationsoplysninger i organisationsnetværket
- Microsoft Entra ID V2 med certifikater
- Microsoft Entra ID V2 med klienthemmeligheder
- Microsoft Entra ID
- Generisk OAuth 2: Enhver identitetsudbyder, der overholder OAuth 2.0-standarden
Hvis du vælger indstillingen Godkend manuelt, er følgende variabler tilgængelige på emnets oprettelseslærred:
User.IdUser.DisplayNameUser.AccessTokenUser.IsLoggedIn
Lær mere om disse variable i Tilføj brugerautentificering til emner.
Notat
- Autentificeringsændringer træder først i kraft, efter du har offentliggjort agenten.
- Kontrollér denne indstilling med det tilsvarende administratorkontrolelement i Power Platform. Når kontrolelementet er aktiveres, forhindrer det, at indstillingen Godkend manuelt slås til eller fra i Copilot Studio. Kontrolelementet er altid slået til, og indstillingen Authenticate manuelt kan ikke ændres i Copilot Studio.
Krævet brugerlogon og deling af agent
Indstillingen 'Kræve, at brugere logger ind', afgør, om en bruger skal logge ind, før de taler med agenten. Slå denne indstilling til for agenter, der har brug for at få adgang til følsomme eller begrænsede oplysninger.
Denne indstilling er ikke tilgængelig for Ingen godkendelse og Godkend med Microsoft.
Notat
Du kan ikke slå denne indstilling fra, når datapolitikken i Power Platform Administration er angivet til at kræve godkendelse. Få mere at vide under Konfigurer datapolitikker for agenter.
Hvis du slår denne indstilling fra, beder din agent først brugerne om at logge på, når den møder et emne, der kræver, at de logger på.
Når du slår denne indstilling til, oprettes der et systememne, der hedder Kræv, at brugere logger på. Dette emne er kun relevant for indstillingen Godkend manuelt. Til automatisk logon i understøttede Teams-chats skal du bruge Godkend med Microsoft.
Emnet Kræv, at brugerne logger på udløses automatisk for alle brugere, der taler med agenten uden at blive godkendt. Hvis brugeren ikke kan logge på, omdirigeres emnet til systememnet Eskaler.
Emnet er skrivebeskyttet og kan ikke tilpasses. Vælg Gå til oprettelseslærredet for at se det.
Kontrollere, hvem der kan chatte med agenten i organisationen
Kombinationen af din agents autentificeringstype og indstillingen 'Kræver at brugere logger ind' afgør, om du kan dele agenten for at styre, hvem i din organisation der kan chatte med den. Godkendelsesindstillingen påvirker ikke deling af en agent til samarbejde.
Ingen godkendelse: Alle brugere, der har et link til agenten (eller kan finde det, f.eks. på dit websted), kan chatte med den. Du kan ikke styre, hvilke brugere i organisationen der kan chatte med agenten.
Log på med Microsoft: Agenten bruger Microsoft Entra ID-autentifikation i Teams, SharePoint, Power Apps og Microsoft Copilot. Brugerne er allerede logget på, så du konfigurerer ikke Kræv, at brugerne logger på separat. Du kan bruge agentdeling til at styre, hvem i din organisation der kan chatte med agenten.
Godkend manuelt:
Hvis tjenesteudbyderen er Microsoft Entra ID, kan du slå Kræk brugerne at logge på for at styre, hvem i organisationen der kan chatte med agenten ved hjælp af agentdeling.
Hvis tjenesteudbyderen er Generic OAuth 2, kan du slå Kræver at brugere logger ind til eller fra. Når den er slået til, kan en bruger, der logger på, chatte med agenten. Du kan ikke styre, hvilke specifikke brugere i organisationen der kan chatte med agenten ved hjælp af agentdeling.
Når agentens godkendelsesindstilling ikke tillader kontrol med, hvem der kan chatte med den, og du kan vælge Del på agentens oversigtsside, får du en meddelelse om, at alle kan chatte med agenten.
Felter til manuel godkendelse
I følgende tabel beskrives de felter, der kan opstå, når du konfigurerer manuel godkendelse. De specifikke felter, du ser, afhænger af dit valg til tjenesteudbyderen.
| Feltnavn | Beskrivende tekst |
|---|---|
| Skabelon til URL-adresse til godkendelse | URL-skabelonen til godkendelse, som defineret af din identitetsudbyder. For eksempel, https://login.microsoftonline.com/common/oauth2/v2.0/authorize |
| Skabelon til forespørgselsstreng til URL-adresse til autorisation | Forespørgselsskabelonen til godkendelse som leveret af identitetsudbyderen. Nøglerne i skabelonen for forespørgselsstrengen varierer afhængigt af identitetsudbyderen (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State}). |
| Klient-id | Dit klient-it, der er hentet fra identitetsudbyderen. |
| Klienthemmelighed | Din klienthemmelighed, der blev indhentet, da du oprettede appregistrering for identitetsudbyderen. |
| URL-adresse til klientcertifikatnøgle | URL-adressen til KeyVault, hvor klientcertifikatet er gemt. Påkrævet til Microsoft Entra ID med godkendelse af certifikater. |
| Bevillingstype | Den OAuth 2.0-granttype, du vil bruge. |
| Er x5c-krav påkrævet | Angiv, om x5c-kravet er påkrævet i token-anmodningen. Påkrævet til Microsoft Entra ID med godkendelse af certifikater. |
| URL-adresse til logon | Den URL-adresse, hvor brugerne bliver bedt om at logge på. |
| Skabelon til opdatering af brødtekst | Skabelonen til opdatering af brødteksten (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}). |
| Skabelon til opdatering af forespørgselsstreng til URL-adresse | Forespørgselsstrengseparatoren til opdatering af URL-adressen for token-URL'en, som regel et spørgsmålstegn (?). |
| Skabelon til opdatering af URL-adresse | URL-skabelonen til opdatering, for eksempel https://login.microsoftonline.com/common/oauth2/v2.0/token. |
| Ressourcens URL-adresse | Ressourcens web-adresse , som token kræves til. |
| Separator til områdeliste | Separatortegnet for områdelisten. Tomme mellemrum understøttes ikke i dette felt.1 |
| Områder | Den liste over områder, som brugerne skal have, når de logger på. Brug Separator til områdeliste til at adskille flere omfang.1 Angiv kun de nødvendige omfang, og følg princippet om færrest mulige adgangsrettigheder. |
| Tjenesteudbyder | Den tjenesteudbyder, du vil bruge til godkendelse. Lær mere om OAuth generiske udbydere. |
| Lejer-ID | Dit Microsoft Entra-ID lejeridentifikator. Lær mere i Sådan finder du dit Microsoft Entra-tenant-id. |
| Skabelon for brødtekst i token | Skabelonen til kerneteksten i tokenet. (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret}) |
| URL-adresse til udveksling af token (kræves ved enkeltlogon (SSO)) | Påkrævet, når du konfigurerer single sign-on; ellers valgfrit. |
| Skabelon til URL-adresse for token | URL-skabelonen til tokens som defineret af identitetsudbyderen, for eksempel https://login.microsoftonline.com/common/oauth2/v2.0/token |
| Token URL skabelon til forespørgselskæde | Forespørgselsstrengseparatoren for token-URL'en, som regel et spørgsmålstegn (?). |
1 Du kan bruge mellemrum i feltet Områder, hvis identitetsudbyderen kræver det. I det tilfælde skal du skrive et komma (,) i Separator til områdeliste og angive mellemrum i feltet Omfang.
Slå godkendelse fra
Når din agent er åben, skal du vælge Indstillinger på den øverste menulinje.
Vælg Sikkerhed, og vælg derefter Godkendelse.
Vælg Ingen godkendelse.
Hvis et emne bruger godkendelsesvariabler, bliver de ukendte variabler. Gå til siden med Emner for at se, hvilke emner der indeholder fejl, og ret dem inden udgivelsen.
Vælg Gem, og udgiv derefter agenten.
Vigtig
Hvis din agent har værktøjer konfigureret til at kræve brugerlegitimationsoplysninger, så slå ikke autentificering fra på agentniveau. Denne handling forhindrer disse værktøjer i at fungere.