Share via

Eenmalige aanmelding configureren met Microsoft Entra ID voor Copilot Studio-copilots in Microsoft Teams

  • Artikel

Belangrijk

Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.

Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.

De Copilot Studio-app in Microsoft Teams ondersteunt eenmalige aanmelding (SSO), wat betekent dat copilots gebruikers automatisch kunnen aanmelden met hun Microsoft Teams-referenties.

SSO in de Microsoft Copilot Studio-app in Teams wordt alleen ondersteund bij gebruik van Microsoft Entra ID. Andere serviceproviders, zoals Azure AD v1, bieden geen ondersteuning voor SSO in de Microsoft Copilot Studio-app in Microsoft Teams.

Belangrijk

SSO wordt niet ondersteund wanneer uw copilot wordt geïntegreerd met Dynamics 365 Customer Service.

Notitie

Als u Teams SSO-verificatie gebruikt met de handmatige verificatieoptie en tegelijkertijd de copilot op aangepaste websites gebruikt, moet u de Teams-app implementeren met behulp van het app-manifest.

Zie Het manifest van de Teams-app voor een copilot downloaden voor meer informatie.

Andere configuraties, zoals authenticatieopties naast Handmatig, of via Teams-implementatie met behulp van Copilot Studio met één klik, werken niet.

Vereisten

Een app-registratie configureren

Voordat u SSO voor Teams configureert, moet u eerst gebruikersverificatie met Microsoft Entra ID configureren. Tijdens dit proces maakt u een app-registratie die u gebruikt om SSO in te stellen.

  1. Maak een app-registratie. Zie de instructies in Gebruikersverificatie configureren met Microsoft Entra ID.
  2. Voeg de omleidings-URL toe.
  3. Genereer een clientgeheim.
  4. Configureer handmatige verificatie.

Volg de instructies in Gebruikersverificatie configureren met Microsoft Entra ID en keer daarna terug naar dit artikel.

De app-id van uw Microsoft Teams-kanaal zoeken

  1. Open in Microsoft Copilot Studio de copilot waarvoor u SSO wilt configureren.

  2. Selecteer onder de instellingen voor de copilot de optie Kanalen. Selecteer de tegel Microsoft Teams.

  3. Selecteer Gegevens bewerken, vouw Meer uit en kopieer vervolgens de app-id door Kopiëren te selecteren.

Schermopname van het detailvenster voor Teams-kanalen met de knop voor het kopiëren van de app-id gemarkeerd.

Opmerking

Als u het Microsoft Teams-kanaal nog niet hebt ingeschakeld, krijgt u een melding dat het momenteel is uitgeschakeld. Selecteer Teams inschakelen en probeer stap 1 opnieuw om de app-id op te vragen.

Schermopname van het deelvenster Teams-kanaal waarin het kanaal is uitgeschakeld.

De app-id van uw Microsoft Teams-kanaal toevoegen aan uw app-registratie

  1. Ga naar de Azure-portal. Open blade voor app-registratie voor de app-registratie die u hebt gemaakt toen u gebruikersverificatie configureerde voor uw copilot.

  2. Selecteer Een API beschikbaar maken in het zijvenster. Selecteer Instellen voor URI van toepassings-id.

    Schermopname van de locatie van de knop Instellen voor de URI voor de toepassings-id.

  3. Voer api://botid-{teamsbotid} in en vervang {teamsbotid} door de app-id van uw Teams-kanaal die u eerder hebt gevonden.

    Schermopname van een correct opgemaakte URI die is ingevoerd in het vak URI van toepassings-id.

  4. Selecteer Save.

Toepassingen zijn geautoriseerd om API's aan te roepen wanneer ze toestemming hebben gekregen van gebruikers/beheerders als onderdeel van het toestemmingsproces. Zie Machtigingen en toestemming op het Microsoft-identiteitsplatform voor meer informatie over toestemming.

De optie voor toestemming van de beheerder kan grijs worden weergegeven als deze niet is ingeschakeld door uw tenantbeheerder. Als deze optie echter beschikbaar is, moet u toestemming verlenen:

  1. Ga bij in de Azure-portal op uw blade voor app-registratie naar API-machtigingen.

  2. Selecteer Beheerderstoestemming verlenen voor <uw tenantnaam> en Ja.

    Schermopname met de knop Beheerderstoestemming verlenen gemarkeerd.

Tip

Als u wilt voorkomen dat gebruikers voor elke toepassing toestemming moeten geven, kan een globale beheerder, toepassingsbeheerder of cloudtoepassingsbeheerder tenantbrede toestemming verlenen aan uw toepassingsregistraties.

API-machtigingen toevoegen

  1. Ga bij in de Azure-portal op uw blade voor app-registratie naar API-machtigingen.

  2. Selecteer Een toestemming toevoegen en kies vervolgens Microsoft Graph.

  3. Selecteer Gedelegeerde machtigingen. Hieronder verschijnt een lijst met machtigingen. Breid OpenId-machtigingen uit en schakel openid en profile in.

  4. Selecteer Machtigingen toevoegen.

Schermopname van de machtigingen openid en profile terwijl deze zijn ingeschakeld.

Een aangepast bereik voor uw copilot definiëren

  1. Ga bij in de Azure-portal op uw blade voor app-registratie naar Een API beschikbaar maken.

  2. Selecteer Een bereik toevoegen.

    Schermopname met de knop Een bereik toevoegen gemarkeerd.

  3. Stel de volgende eigenschappen in:

    Eigenschappen Weergegeven als
    Bereiknaam Test.Read invoeren
    Wie kan toestemming geven? Selecteer Beheerders en gebruikers
    Weergavenaam voor beheerderstoestemming Test.Read invoeren
    Beschrijving van beheerderstoestemming Allows the app to log in the user. invoeren
    Provincie Selecteer Ingeschakeld.

    Opmerking

    De bereiknaam Test.Read is een tijdelijke aanduiding en moet worden vervangen door een naam die logisch is in uw omgeving.

  4. Selecteer Bereik toevoegen.

Microsoft Teams-client-id's toevoegen

Belangrijk

In de volgende stappen moeten de waarden voor Microsoft Teams-client-id's letterlijk worden gebruikt omdat ze voor alle tenants hetzelfde zijn.

  1. Ga in de Azure-poretal op uw blade voor app-registratie naar Een API beschikbaar maken en selecteer Een clienttoepassing toevoegen.

    Schermopname met de knop Een clienttoepassing toevoegen gemarkeerd.

  2. Voer in het veld Client-id de client-id in voor Microsoft Teams mobiel/desktop. Dit is 1fec8e78-bce4-4aaf-ab1b-5451cc387264. Schakel het selectievakje in voor het bereik dat u eerder hebt gemaakt.

    Schermopname van de client-id die is ingevoerd in het deelvenster Een clienttoepassing toevoegen.

  3. Selecteer Toepassing toevoegen.

  4. Herhaal de bovenstaande stappen, maar voer voor Client-id de client-id in voor Microsoft Teams op het web. Dit is 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

  5. Controleer of op de pagina en API beschikbaar maken de Microsoft Teams-client-app-id's worden weergegeven.

    Schermopname van de pagina Een API beschikbaar maken die correct de Microsoft Teams-client-id's weergeeft.

URL voor uitwisselen van token toevoegen

Als u de Microsoft Entra ID-verificatie-instellingen in Copilot Studio wilt bijwerken, moet u de tokenuitwisselings-URL toevoegen om Microsoft Teams en Copilot Studio toe te staan informatie te delen.

  1. Ga bij in de Azure-portal op uw blade voor app-registratie naar Een API beschikbaar maken.

  2. Selecteer onder Bereiken de optie Kopiëren naar klembord.

    Schermopname van de knop Kopiëren naar klembord.

  3. Selecteer in Copilot Studio in het navigatiemenu onder instellingen Beveiliging en vervolgens de tegel Verificatie.

  4. Plak bij URL voor tokenuitwisseling (vereist voor SSO) het bereik dat u eerder hebt gekopieerd.

    Schermopname van de URI van de toepassings-id die is ingevoerd als de URL voor tokenuitwisseling in Copilot Studio.

  5. Selecteer Opslaan.

SSO toevoegen aan het Microsoft Teams-kanaal van uw copilot

  1. Selecteer in Copilot Studio onder de instellingen voor de copilot de optie Kanalen.

  2. Selecteer de tegel Microsoft Teams. Selecteer Details bewerken en breid Meer uit.

  3. Voer voor client-id van AAD-toepassing de Client-id van toepassing in vanuit uw app-registratie.

    Schermopname van de client-id van de toepassing die is ingevoerd als client-id van de vAAD-toepassing in Copilot Studio.

    Open de Azure-portal om deze waarde te verkrijgen. Ga vervolgens op uw blade voor app-registratie naar Overzicht. Kopieer de waarde in het vak Client-id van toepassing.

    Schermopname van waar u de toepassings-id (client) kunt vinden in Azure-portal.

  4. Voer bij Resource-URI de URI van de toepassings-id in vanuit uw app-registratie.

    Schermopname van de URI van de toepassings-id die is ingevoerd als de resource-URI in Copilot Studio.

    Open de Azure-portal om deze waarde te verkrijgen. Ga vervolgens op uw blade voor app-registratie naar Een API beschikbaar maken. Kopieer de waarde in het vak URI van de toepassings-id.

    Schermopname van waar u de URI van de toepassings-id kunt vinden in Azure-portal.

  5. Selecteer Opslaan en vervolgens Sluiten.

  6. Selecteer onder de instellingen voor de copilot de optie Publiceren.

  7. Selecteer Publiceren om de nieuwste copilot-inhoud beschikbaar te maken voor uw klanten.

  8. Selecteer in het navigatiemenu onder Instellingen de optie Kanalen.

  9. Selecteer Microsoft Teams en vervolgens Copilot openen.

  10. Start een nieuw gesprek met uw copilot in Microsoft Teams om te testen of u automatisch wordt aangemeld.