Konfigurer enkeltlogon med Microsoft Entra ID til agenter i Microsoft Teams

Copilot Studio understøtter enkeltlogon (SSO) for agenter, der er publiceret i Microsoft Teams 1:1-chats. Ved hjælp af denne support kan agenter automatisk logge på brugere med deres Microsoft Teams legitimationsoplysninger. SSO understøttes kun, når du bruger Microsoft Entra ID.

Vigtig

Du kan bruge SSO i Microsoft Teams-chats uden at kræve manuel godkendelse. Hvis du vil bruge denne metode til en tidligere publiceret agent, skal du omkonfigurere agenten til at bruge Authenticate med Microsoft og derefter publicere den igen for at Microsoft Teams. Det kan tage et par timer, før denne ændring træder i kraft. Hvis en bruger er midt i en samtale, og ændringen endnu ikke er sket, kan brugeren skrive "start forfra" i chatten for at tvinge samtalen til at genstarte med den nyeste version af agenten. Disse ændringer er nu tilgængelige for Teams 1:1-chat mellem brugeren og agenten. De er endnu ikke tilgængelige for gruppechat eller kanalbeskeder.

SSO understøttes ikke, når agenter er integreret med Dynamics 365 Customer Service.

Fortsæt ikke med følgende dokument, medmindre det er nødvendigt. Hvis du skal bruge manuel godkendelse til din agent, skal du se Konfigurer brugergodkendelse med Microsoft Entra ID.

Bemærkning

Hvis du bruger Teams SSO-godkendelse med indstillingen for manuel godkendelse og samtidig bruger agenten på brugerdefinerede websteder, skal du installere Teams-appen ved hjælp af appmanifestet.

Du kan finde flere oplysninger under Downloade Teams-appmanifestet for en agent.

Andre konfigurationer, f.eks. godkendelsesindstillinger ud over manuel eller via Teams-udrulning ved hjælp af Copilot Studio ét klik, fungerer ikke.

Forudsætninger

Konfigurere en appregistrering

Før du konfigurerer SSO til Teams, skala du konfigurere brugergodkendelse med Microsoft Entra ID. Denne proces opretter en appregistrering, som du skal bruge for at konfigurere SSO.

  1. Oprette en appregistrering. Følg instruktionerne i Konfiguration af brugergodkendelse med Microsoft Entra ID.

  2. Tilføj URL-adressen til omdirigering.

  3. Opret en klienthemmelighed.

  4. Konfigurer manuel godkendelse.

Lokaliser ID for din Teams-kanalapp

  1. Åbn den agent, du vil konfigurere SSO for i Copilot Studio.

  2. Gå til siden Kanaler for din agent, og vælg feltet Teams og Microsoft 365 Copilot .

  3. I konfigurationspanelet Teams og Microsoft 365 Copilot skal du vælge Rediger detaljer, udvide Flere og derefter vælge Kopiér ud for feltet App-id.

Tilføj app-id for Teams-kanal til din -appregistrering

  1. Gå til Azure-portalen. Åbn app-registreringsforekomsten for den app-registrering, du oprettede, da du konfigurerede brugergodkendelse for din agent.

  2. Vælg Vis en API i sideruden. For URI til program-id, skal du vælge Angiv.

    Skærmbillede af placeringen af knappen Angiv for URI'en til program-id'et.

  3. Angiv api://botid-{teamsbotid}, og erstat {teamsbotid} med dit Teams-kanalapp-id, du har fundet tidligere.

    Skærmbillede af en korrekt formateret URI, der er angivet i feltet URI for program-id.

  4. Vælg Save.

Programmer har tilladelse til at kalde API'er, når brugere eller administratorer giver tilladelser under samtykkeprocessen. Hvis du vil vide mere om samtykke, skal du se Tilladelser og samtykke i Microsoft-identitetsplatformen.

Hvis muligheden for administratorsamtykke er tilgængelig, skal du give samtykke:

  1. Gå til API-tilladelser på Azure-portalen.

  2. Vælg Tildel administratorsamtykke til <dit lejer navn>, og vælg derefter Ja.

Vigtig

Hvis du vil undgå, at brugere skal give samtykke til de enkelte applikationer, kan en person med mindst rollen som programadministrator eller Cloud-programadministrator give samtykke for hele lejeren til dine appregistreringer.

Tilføje API-tilladelser

  1. Gå til API-tilladelser på Azure-portalen.

  2. Vælg Tilføj en tilladelse, og vælg Microsoft Graph.

  3. Vælg Delegerede tilladelser. Der vises en liste over tilladelser.

  4. Udvid OpenId-tilladelser.

  5. Vælg openid og profil.

  6. Vælg Tilføj tilladelser.

    Skærmbillede af de openid- og profiltilladelser, der er slået til.

Definer et brugerdefineret omfang til din agent

  1. Gå til Eksponer en API på Azure-portalen.

  2. Vælg Tilføj et område.

    Skærmbillede af knappen Tilføj omfang fremhævet.

  3. Angiv følgende egenskaber:

    Egenskab Værdi
    Navn på omfang Angiv Test.Read
    Hvem kan give samtykke? Vælg Administratorer og brugere
    Vist navn for administratorsamtykke Angiv Test.Read
    Beskrivelse af administratorsamtykke Angiv Allows the app to sign the user in.
    Stat/område Vælg Aktiveret

    Bemærkning

    Områdenavnet Test.Read er en pladsholderværdi. Erstat det med et navn, der giver mening i miljøet.

  4. Vælg Tilføj område.

Tilføj Microsoft Teams-klient-id'er

Vigtig

Brug de værdier, der er angivet for Microsoft Teams klient-id'er, bogstaveligt talt i følgende trin, fordi disse klient-id'er er ens på tværs af alle lejere.

  1. Azure Gå til Tilføj en API i din appregistreringsportal, og vælg Tilføj et klientprogram.

    Skærmbillede af knappen Tilføj et klientprogram fremhævet.

  2. I feltet Klient-id skal du angive klient-id'et for Microsoft Teams mobil/desktop, som er 1fec8e78-bce4-4aaf-ab1b-5451cc387264. Markér afkrydsningsfeltet for det omfang, du har oprettet.

    Skærmbillede af det klient-id, der er angivet i ruden Tilføj et klientprogram.

  3. Vælg Tilføj program.

  4. Gentag de foregående trin, men angiv klient-id'et for Microsoft Teams på internettet for Klient-id, hvilket vil sige 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

  5. Bekræft, at siden Vis en API indeholder Microsoft Teams-klientapp-id'erne.

De to Microsoft Teams klient-id'er, du føjer til siden Expose a API er:

  • 1fec8e78-bce4-4aaf-ab1b-5451cc387264
  • 5e3ce6c0-2b1f-4285-8d4b-75ee78787346

Føj URL-adressen for udveksling af token til agentens godkendelsesindstillinger

Hvis du vil opdatere Microsoft Entra ID godkendelsesindstillinger i Copilot Studio, skal du tilføje URL-adressen til udveksling af tokens, så Microsoft Teams og Copilot Studio kan dele oplysninger.

  1. Gå til Eksponér en API på Azure-portalen.

  2. Under Omfang skal du vælge ikonet Kopiér til udklipsholder.

  3. I Copilot Studio indstillingerne for agenten skal du vælge Sikkerhed og derefter vælge feltet Godkendelse.

  4. Indsæt det omfang, du kopierede tidligere, i URL-adresse til tokenudveksling (kræves til SSO).

  5. Vælg Save.

    Skærmbillede af, hvor URL-adressen til udveksling af tokens skal indsættes i Copilot Studio.

Føj SSO til agentens Teams-kanal

  1. I Copilot Studio skal du under indstillinger for agenten vælge Kanaler.

  2. Vælg feltet Teams og Microsoft 365 Copilot.

  3. Vælg Rediger detaljer, og udvid Flere.

  4. Til Klient-id for AAD-applikation skal du angive Program-id (klient) fra appregistreringen.

    Du kan hente denne værdi ved at åbne Azure portalen. Derefter i app-registreringen skal du gå til Oversigt. Kopiér værdien fra feltet Program-id (klient).

  5. Til Ressource-URI skal du angive URI for program-id fra din appregistrering.

    Du kan hente denne værdi ved at åbne Azure portalen. Derefter i app-registreringen skal du gå til Vis en API. Kopiér værdien fra feltet URI for program-id.

    Skærmbillede af, hvor program-id-URI'en skal indsættes i Teams-kanalen for Copilot Studio.

  6. Vælg Gem, og derefter Luk.

  7. Publicer agenten igen for at gøre de seneste ændringer tilgængelige for dine kunder.

  8. Vælg Se agent i Teams for at starte en ny samtale med din agent i Teams og kontrollere, om den automatisk logger dig på.

Kendte problemer

Hvis du først publicerede din agent ved hjælp af manuel godkendelse uden Teams SSO, beder agenten i Teams løbende brugerne om at logge på.

  • Last updated on