Del via

Aktiver brukergodkjenning i Copilot Studio Kit

Copilot Studio Kit støtter testing av egendefinerte agenter med brukergodkjenning når du bruker Entra ID v2 som tjenesteleverandør med SSO aktivert. Sammendrag oppretter og konfigurerer du de nødvendige programmene i Azure portalen, og deretter oppretter du agentkonfigurasjonen i Copilot Studio Kit.

Slik aktiverer du brukergodkjenning i Copilot Studio Kit:

  • Opprett appregistrering spesielt for Copilot Studio Kit-godkjenningsformål.
  • Opprett appregistrering for Copilot Studio godkjenning.
  • Aktiver godkjenning for Copilot Studio-agenten.
  • Opprett agentkonfigurasjonen i Copilot Studio Kit med sluttbrukergodkjenning aktivert.
  • Koble programmene slik at Copilot Studio Kit kan godkjennes til Direct Line ved hjelp av Copilot Studio godkjenning.

Forhåndskrav

  • Installer Copilot Studio Kit hvis du ikke allerede har gjort det.
  • Ha riktige tillatelser i leieren for å opprette appregistreringer.

Vi foreslår at du bruker følgende verdier i konfigurasjonstrinnene som følger:

  • Copilot Studio Kit-godkjenningsapp: KitAuthApp
  • Copilot Studio godkjenningsapp: CopilotStudioAuthApp
  • Copilot Studio omfang: copilot.studio.scope

Opprett godkjenningsprogram for Copilot Studio Kit

Hvis du vil opprette et godkjenningsprogram for Copilot Studio Kit, følger du fremgangsmåten i Opprett en appregistrering i Microsoft Entra ID for det egendefinerte lerretet.

Legg merke til de ekstra trinnene:

  1. Opprett appregistreringen i Microsoft Entra ID.

    (Anbefales) Gi navn til det nye programmet KitAuthApp.

    Under registreringsprosessen, legg merke til katalog (leietaker) ID-en og applikasjons (klient) ID-en. Du trenger disse verdiene senere når du oppretter en agentregistrering i Copilot Studio Kit og knytter Copilot Studio til Copilot Studio Kit-appen. Du kan alltid få disse ID-ene fra Oversikt-siden for appregistreringen.

  2. Legg til url-adressen for omadressering.

    Pass på at du peker til nettadressen for dataversmiljøet. for eksempel https://<hostname>.crm.dynamics.com

  3. Som et ekstra trinn kan du gå til Sertifikater og hemmeligheter og opprette en ny klienthemmelighet.

    (Anbefales) Gi navn til den hemmelige KitAuthApp-hemmeligheten.

    Lagre verdien for denne hemmeligheten i en sikker midlertidig fil. Du trenger den når du konfigurerer agentens godkjenning senere.

  4. Velg fra <, og velg deretter >. Hvis knappen ikke er tilgjengelig, må du kanskje be en leieradministrator om å angi den for deg.

Opprett godkjenningsprogram for Copilot Studio

Hvis du vil opprette et godkjenningsprogram for Copilot Studio, følger du fremgangsmåten i Konfigurer brukergodkjenning med Microsoft Entra ID.

Legg merke til de anbefalte ekstra trinnene .

Når du oppretter appregistreringen:

  • Gi navn til det nye programmet CopilotStudioAuthApp.

  • Under Støttede kontotyper velger du Konto i alle organisasjonsleierene (alle Microsoft Entra ID katalog - multitenant) og personlige Microsoft kontoer (for eksempel skype, Xbox).

  • Noter deg Katalog-ID-en (leier) og Applikasjons-ID-en (klient). Du trenger disse verdiene senere når du aktiverer sluttbrukergodkjenning i Copilot Studio. Du kan alltid få disse ID-ene fra Oversikt-siden for appregistreringen.

Når du konfigurerer manuell godkjenning:

  • Bruk klienthemmeligheter i stedet for legitimasjon i forbund. Noter deg klienthemmelighetsverdien . Lagre den i en sikker midlertidig fil. Du trenger det senere når du aktiverer sluttbrukergodkjenning i Copilot Studio.

Når du definerer et egendefinert omfang for agenten:

  • (Anbefales) For Scope name, bruk copilot.studio.scope.

  • Legg merke til det fullstendige omfangsnavnet under omfang (format som ligner api://xxx/copilot.studio.scope). Du trenger denne verdien senere når du aktiverer sluttbrukergodkjenning i Copilot Studio.

  • Fullfør disse ekstra trinnene:

    1. Velg Legg til et klientprogram.
    2. Angi klient-ID-en for KitAuthApp du opprettet tidligere, i klient-ID.
    3. Kontroller at omfanget i autoriserte omfang er det du opprettet tidligere (copilot.studio.scope). Aktiver kontroll av dette omfanget.
    4. Velg Legg til program.

Aktiver sluttbrukergodkjenning på den egendefinerte agenten

Følg disse trinnene for å aktivere sluttbrukergodkjenning for den egendefinerte agenten:

  1. I Copilot Studio, under Innstillinger, velg Sikkerhet > Godkjenning.
  2. Velg Godkjenn manuelt.
  3. La være å kreve at brukere logger på.
  4. Ikke endre URL-adressen for omadressering. Kontroller at Tjenesteleverandøren er Microsoft Entra ID V2 med klienthemmeligheter.
  5. For å angi klient-ID, skriver du inn klient-ID til CopilotStudioAuthApp.
  6. For klienthemmelighet, skriv inn klienthemmeligheten opprettet for CopilotStudioAuthApp.
  7. Skriv inn det fullstendige navnet på scope (formatet som ligner på ) som er opprettet for api://xxx/copilot.studio.scope i CopilotStudioAuthApp.
  8. (Valgfritt, obligatorisk for SharePoint kunnskapskilde) I Scopes legger du til Files.Read.All.
  9. (Valgfritt, obligatorisk for SharePoint kunnskapskilde) I Scopes legger du til Sites.Read.All.
  10. Velg Lagre, og velg deretter Lagre på nytt i dialogboksen.
  11. Lukk innstillinger.
  12. Velg Publiser, og velg deretter Publiser på nytt i dialogboksen.

Opprett agentkonfigurasjon med sluttbrukergodkjenning aktivert

Følg disse trinnene for å opprette en agentkonfigurasjon med sluttbrukergodkjenning aktivert:

  1. Gå til Copilot Studio Kit.
  2. Velg Agenter fra navigasjonen.
  3. Velg Ny.
  4. Angi et navn.
  5. Velg Test automatisering fra konfigurasjonstypen(e).
  6. Fyll ut Direct Line Innstillinger. Aktiver Channel Security og skriv inn Direct Line hemmeligheten.
  7. For Brukergodkjenning velger du Entra ID v2.
  8. Angi Client ID til KitAuthApp i feltet Client ID.
  9. For Leier-ID angir du katalog-ID-en for KitAuthApp.
  10. For Omfang angir du det fullstendige omfangsnavnet (format som ligner på api://xxx/copilot.studio.scope) som er opprettet for CopilotStudioAuthApp.
  11. Velg Lagre og lukk.

Du er nå klar til å teste agenten med sluttbrukergodkjenning aktivert.

  • Last updated on