Konfigurowanie logowania jednokrotnego przy użyciu Microsoft Entra ID dla agentów w usłudze Microsoft Teams

Aplikacja Copilot Studio obsługuje logowanie jednokrotne (SSO) dla agentów opublikowanych w czatach usługi Microsoft Teams 1:1. Dzięki tej obsłudze agenci mogą automatycznie logować użytkowników przy użyciu poświadczeń Microsoft Teams. Logowanie jednokrotne (SSO) jest obsługiwane tylko w przypadku korzystania z Microsoft Entra ID.

Important

Logowania jednokrotnego można używać w czatach usługi Microsoft Teams bez konieczności ręcznego uwierzytelniania. Aby użyć tej metody dla wcześniej opublikowanego agenta, skonfiguruj ponownie agenta do używania Authenticate z Microsoft, a następnie opublikuj go ponownie w Microsoft Teams. Może minąć kilka godzin, zanim ta zmiana zacznie obowiązywać. Jeśli użytkownik jest w trakcie konwersacji, a zmiana jeszcze nie nastąpiła, może wpisać "zacznij od nowa" na czacie, aby wymusić ponowne uruchomienie konwersacji przy użyciu najnowszej wersji agenta. Zmiany te są teraz dostępne dla czatów Teams 1:1 pomiędzy użytkownikiem a agentem. Nie są one jeszcze dostępne dla czatów grupowych ani wiadomości na kanałach.

Logowanie jednokrotne nie jest obsługiwane w przypadku agentów zintegrowanych z usługą Dynamics 365 Customer Service.

Nie kontynuuj pracy z poniższym dokumentem, chyba że jest to konieczne. Jeśli chcesz użyć ręcznego uwierzytelniania dla agenta, zobacz Konfigurowanie uwierzytelniania użytkownika za pomocą Microsoft Entra ID.

Note

Jeśli korzystasz z uwierzytelniania SSO w Teams z opcją manualnej autoryzacji oraz używasz agenta na niestandardowych stronach internetowych jednocześnie, musisz wdrożyć aplikację Teams za pomocą manifestu aplikacji.

Aby uzyskać więcej informacji, zobacz Pobierz manifest aplikacji Teams dla agenta.

Inne konfiguracje, takie jak metody uwierzytelniania oprócz ręcznej czy za pośrednictwem wdrożenia usługi Teams przy użyciu jednego kliknięcia w Copilot Studio, nie działają.

Prerequisites

Konfigurowanie rejestracji aplikacji

Przed skonfigurowaniem logowania jednokrotnego dla aplikacji Teams skonfiguruj uwierzytelnianie użytkownika za pomocą Microsoft Entra ID. Proces ten powoduje utworzenie rejestracji aplikacji, która jest potrzebna do skonfigurowania SSO (logowania jednokrotnego).

  1. Utwórz rejestrację aplikacji. Zobacz instrukcje w temacie Konfigurowanie uwierzytelniania użytkownika przy użyciu Microsoft Entra ID.

  2. Dodaj URL przekierowania.

  3. Wygeneruj klucz tajny klienta.

  4. Konfiguruj ręczne uwierzytelnianie.

Znajdowanie identyfikatora aplikacji kanału Teams

  1. W programie Copilot Studio otwórz agenta, dla którego chcesz skonfigurować logowanie jednokrotne.

  2. Przejdź do strony Kanały dla swojego agenta i wybierz kafelek Microsoft 365 i Microsoft Teams.

  3. W panelu konfiguracyjnym Microsoft 365 i Microsoft Teams wybierz Edytuj szczegóły, rozwiń Więcej, a następnie Kopiuj obok pola App ID.

Dodaj identyfikator aplikacji kanału Teams do rejestracji aplikacji

  1. Przejdź do portalu Azure. Otwórz instancję rejestracji aplikacji, którą utworzyłeś podczas konfigurowania uwierzytelniania użytkownika dla swojego agenta.

  2. Wybierz opcję Uwidacznianie interfejsu API w okienku bocznym. W obszarze Adres URI identyfikatora aplikacji wybierz pozycję Ustaw.

    Zrzut ekranu przedstawiający lokalizację przycisku Ustaw dla identyfikatora aplikacji (URI).

  3. Wpisz api://botid-{teamsbotid} i zastąp {teamsbotid} swoim identyfikatorem aplikacji kanału Teams, który znalazłeś wcześniej .

    Zrzut ekranu z poprawnie sformatowanym URI Identyfikatora aplikacji wprowadzonym w polu.

  4. Wybierz Zapisz.

Aplikacje są autoryzowane do wywoływania interfejsów API, gdy użytkownicy lub administratorzy udzielają uprawnień podczas procesu wyrażania zgody. Aby dowiedzieć się więcej o zgodzie, zobacz Uprawnienia i zgoda na platformie tożsamości firmy Microsoft.

Jeśli opcja zgody administratora jest dostępna, udziel zgody:

  1. W portalu Azure w obszarze rejestracji aplikacji przejdź do pozycji API Permissions(

  2. Wybierz opcję Przyznaj zgodę administratora dla <twojej dzierżawy>, a następnie wybierz Tak.

Important

Aby użytkownicy nie musieli wyrażać zgody na każdą aplikację, osoba przypisana co najmniej do roli Administratora aplikacji lub Administratora aplikacji w chmurze może udzielić zgody na poziomie całej dzierżawy na rejestracje aplikacji.

Dodawanie uprawnień API

  1. W portalu Azure w obszarze rejestracji aplikacji przejdź do pozycji API Permissions(

  2. Wybierz opcję Dodaj uprawnienie i wybierz opcję Microsoft Graph.

  3. Wybierz pozycję Uprawnienia delegowane. Zostanie wyświetlona lista uprawnień.

  4. Rozwiń uprawnienia OpenId.

  5. Wybierz openid i profil.

  6. Wybierz opcję Dodaj uprawnienia.

    Zrzut ekranu przedstawiający włączone uprawnienia openid i profil.

Zdefiniuj zakres niestandardowy dla Twojego agenta

  1. W portalu Azure w wystąpieniu rejestracji aplikacji przejdź do pozycji Wyświetl interfejs API.

  2. Wybierz Dodaj zakres.

    Wyróżniony zostanie zrzut ekranu przycisku Dodaj zakres.

  3. Określ następujące właściwości:

    Property Value
    Nazwa zakresu Wprowadź Test.Read
    Kto może wyrazić zgodę? Wybierz Administratorzy i użytkownicy
    Wyświetlana nazwa zgody administratora Wprowadź Test.Read
    Opis zgody administratora Wprowadź Allows the app to sign the user in.
    State Wybierz opcję Włącz

    Note

    Nazwa zakresu Test.Read jest wartością symbolu zastępczego. Zastąp ją nazwą, która ma sens w danym środowisku.

  4. Wybierz Dodaj zakres.

Dodaj identyfikatory klientów Microsoft Teams

Important

Użyj następujących wartości dla identyfikatorów klienta Microsoft Teams. Te identyfikatory klientów są takie same dla wszystkich tenantów.

  1. W portalu Azure w wystąpieniu rejestracji aplikacji przejdź do pozycji Expose an API i wybierz pozycję Dodaj aplikację kliencką.

    Zrzut ekranu podświetlonego przycisku Dodaj aplikację kliencką.

  2. W polu Identyfikator klienta wprowadź identyfikator klienta dla Microsoft Teams mobilny/na komputery, czyli 1fec8e78-bce4-4aaf-ab1b-5451cc387264. Zaznacz pole wyboru dla zakresu, który utworzyłeś wcześniej.

    Zrzut ekranu identyfikatora klienta wprowadzonego w okienku Dodaj aplikację kliencką.

  3. Wybierz Dodaj aplikację.

  4. Powtórz poprzednie kroki, ale w polu Identyfikator klienta wprowadź identyfikator klienta Microsoft Teams w Internecie, czyli 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.

  5. Potwierdź, że na stronie Udostępnij interfejs API znajdują się identyfikatory aplikacji klienckiej Microsoft Teams.

Podsumowując, dwa identyfikatory klienta Microsoft Teams, które dodajesz na stronie Ujawnij interfejs API, to:

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

Dodaj adres URL wymiany tokenów do ustawień uwierzytelniania swojego agenta

Aby zaktualizować ustawienia uwierzytelniania Microsoft Entra ID w Copilot Studio, dodaj adres URL wymiany tokenów, aby Microsoft Teams i Copilot Studio mogły udostępniać informacje.

  1. W portalu Azure w wystąpieniu rejestracji aplikacji przejdź do pozycji Wyświetl interfejs API.

  2. Pod Zakresy wybierz ikonę Kopiuj do schowka.

  3. W Copilot Studio, w ustawieniach dla agenta, wybierz Bezpieczeństwo, a następnie wybierz kafelek Uwierzytelnianie.

  4. W przypadku URL wymiany tokenów (wymagany przy logowaniu jednokrotnym) wklej skopiowany wcześniej zakres.

  5. Wybierz Zapisz.

    Zrzut ekranu przedstawiający miejsce, w którym należy wkleić adres URL wymiany tokenów w Copilot Studio.

Dodaj SSO do kanału Teams swojego agenta

  1. W Copilot Studio w ustawieniach agenta wybierz Kanały.

  2. Wybierz kafelek Microsoft 365 i Microsoft Teams.

  3. Wybierz Edytuj szczegóły i rozwiń Więcej.

  4. Dla Identyfikator klienta aplikacji usługi AAD dodaj wartość Identyfikator aplikacji (klienta) z rejestracji aplikacji.

    Aby uzyskać tę wartość, otwórz portal Azure. Następnie w rejestracji aplikacji przejdź do Przegląd. Kopiuj wartość z pola Identyfikator aplikacji (klienta).

  5. Dla identyfikatora URI zasobu wprowadź identyfikator URI aplikacji z rejestracji aplikacji.

    Aby uzyskać tę wartość, otwórz portal Azure. Następnie w rejestracji aplikacji przejdź do Uwidocznij interfejs API. Kopiuj wartość z pola Identyfikator aplikacji URI.

    Zrzut ekranu przedstawiający miejsce, w którym należy wkleić adres URI identyfikatora aplikacji w kanale Teams Copilot Studio.

  6. Wybierz kolejno pozycje Zapisz i Zamknij.

  7. Opublikuj ponownie agenta, aby udostępnić najnowsze zmiany swoim klientom.

  8. Wybierz opcję Zobacz agenta w Teams, aby rozpocząć nową rozmowę z agentem w Teams i sprawdzić, czy automatycznie się zalogujesz.

Znane problemy

Jeśli po raz pierwszy opublikowałeś agenta przy użyciu ręcznego uwierzytelniania bez SSO usługi Teams, agent w usłudze Teams nieustannie prosi użytkowników o zalogowanie się.

  • Ostatnia aktualizacja o