Konfigurowanie uwierzytelniania użytkownika w programie Copilot Studio

Uwierzytelnianie użytkownika pozwala użytkownikom się zalogować, aby Twój agent mógł uzyskać dostęp do ograniczonych zasobów lub informacji w ich imieniu. Użytkownicy mogą się zalogować, używając Microsoft Entra ID lub dostawcy tożsamości OAuth 2.0, takiego jak Google czy Facebook.

Note

W przypadku wdrożeń Microsoft Teams wykorzystujących ręczną autoryzację, przejrzyj wymagania wdrożenia w Configure SSO (pojedyncze logowanie) z Microsoft Entra ID dla agentów w Teams.

Możesz dodać uwierzytelnianie użytkownika do tematów podczas edytowania tematu.

Important

Zmiany konfiguracji uwierzytelniania obowiązują dopiero po opublikowaniu agenta. Zaplanuj z wyprzedzeniem przed wprowadzeniem zmian uwierzytelniania w agencie.

Wybierz opcję uwierzytelniania

Note

Przed wybraniem opcji uwierzytelniania przejrzyj następujące Power BI ograniczenia integracji. Agentów usługi Copilot Studio korzystających z uwierzytelniania firmy Microsoft (Entra ID) nie można osadzać w raportach usługi Power BI przy użyciu wizualizacji opartych na ramkach iframe.

program Copilot Studio obsługuje kilka opcji uwierzytelniania. Wybierz i skonfiguruj opcję spełniającą Twoje potrzeby.

  1. Przejdź do Ustawień dla swojego agent i wybierz Zabezpieczenia.

  2. Wybierz Uwierzytelnianie.

  3. Wybierz opcję uwierzytelniania i skonfiguruj ją zgodnie z potrzebami. Dostępne są następujące opcje uwierzytelnienia:

  4. Wybierz Zapisz.

Bez uwierzytelniania

Brak uwierzytelniania oznacza, że agent nie wymaga od użytkowników logowania się podczas interakcji z agentem. Niezautoryzowana konfiguracja oznacza, że agent może uzyskiwać dostęp jedynie do informacji i zasobów publicznych. Klasyczne czatboty są domyślnie skonfigurowane tak, aby nie wymagały uwierzytelniania.

Ta opcja nie jest dostępna, gdy w centrum administratora Power Platform skonfigurowana jest polityka danych wymagająca uwierzytelnienia.

Caution

Wybranie opcji Bez uwierzytelniania pozwala każdemu, kto ma link, na czatowanie i interakcję z botem lub agentem.

Zalecamy stosowanie uwierzytelniania, zwłaszcza w przypadku korzystania z bota lub agenta w organizacji lub dla określonych użytkowników, wraz z innymi kontrolami bezpieczeństwa i zarządzania.

Uwierzytelnij za pomocą usługi firmy Microsoft

Important

Do publikowania przez wbudowany kanał Teams + Microsoft 365 użyj Uwierzytelnij za pomocą konta Microsoft. Jeśli konfiguracja uwierzytelniania blokuje kanał, sprawdź status agenta. Przy ręcznym uwierzytelnianiu w Teams należy stosować się do oddzielnych wymagań SSO Teams i manifestu aplikacji.

Ponadto opcja Uwierzytelnianie z Microsoftem nie jest dostępna dla agentów łączących się z Dynamics 365 Customer Service.

Ta konfiguracja automatycznie konfiguruje uwierzytelnianie Microsoft Entra ID dla Teams, SharePoint, Power Apps i Microsoft Copilot bez konieczności ręcznej konfiguracji. W Teams użytkownicy nie są proszeni o zalogowanie, chyba że Twój agent wymaga rozszerzonego zakresu.

Jeśli potrzebujesz uwierzytelniania na innych kanałach, wybierz Uwierzytelnij ręcznie.

Jeśli wybierzesz Uwierzytelnij za pomocą Microsoft, następujące zmienne są dostępne w obszarze tworzenia tematów zarówno w aplikacji internetowej, jak i w środowisku Teams:

  • User.Id
  • User.DisplayName

W aplikacji webowej dostępne są również User.IsLoggedIn oraz dodatkowe zmienne profilowe. W planie Teams opcja User.IsLoggedIn nie jest dostępna z tą opcją. Dowiedz się więcej w sekcji Zmienne uwierzytelniania.

User.AccessToken nie jest dostępny z tą opcją. Jeśli potrzebujesz tokena uwierzytelniania, użyj Uwierzytelnij ręcznie.

Jeśli zmienisz opcję z Uwierzytelnianie ręcznie na Uwierzytelnianie z Microsoft, odniesienia do User.AccessToken stają się zmiennymi Nieznane. W planie Teams odniesienia do User.IsLoggedIn również stają się zmiennymi nieznanymi. Popraw wszelkie błędy dotyczące tematów przed publikacją agenta.

Uwierzytelnij ręcznie

Copilot Studio obsługuje następujących dostawców usług uwierzytelniania w opcji Uwierzytelnij ręcznie:

  • Microsoft Entra ID V2 z poświadczeniami federacyjnymi
  • Microsoft Entra ID v2 z certyfikatami
  • Microsoft Entra ID V2 z sekretami klienta
  • Microsoft Entra ID
  • Generic OAuth 2: Każdy dostawca tożsamości zgodny ze standardem OAuth 2.0

Jeśli wybierzesz opcję Uwierzytelnij ręcznie, następujące zmienne są dostępne w kanwie tworzenia tematu:

  • User.Id
  • User.DisplayName
  • User.AccessToken
  • User.IsLoggedIn

Dowiedz się więcej o tych zmiennych w Dodaj uwierzytelnianie użytkownika do topików.

Note

  • Zmiany w uwierzytelnianiu wchodzą w życie dopiero po opublikowaniu agenta.
  • Steruj tym ustawieniem za pomocą odpowiedniej kontrolki administratora na platformie Power Platform. Po włączeniu sterowania uniemożliwia ono włączanie lub wyłączanie opcji Uwierzytelnij ręcznie w Copilot Studio. Kontrolka jest zawsze włączona, a opcja Authenticate ręcznie nie można modyfikować w programie Copilot Studio.

Wymagane logowanie użytkownika i udostępnianie agentów

Ustawienie Wymagaj zalogowania użytkowników określa, czy użytkownik musi się zalogować przed rozmową z agentem. Włącz to ustawienie dla agentów, którzy muszą uzyskiwać dostęp do poufnych lub ograniczonych informacji.

Ta opcja nie jest dostępna dla opcji Brak uwierzytelniania i Uwierzytelnij za pomocą Microsoft.

Note

Nie można wyłączyć tej opcji, gdy zasady danych w centrum administracyjnym platformy Power Platform są ustawione tak, aby wymagać uwierzytelniania. Dowiedz się więcej w temacie Konfigurowanie zasad danych dla agentów.

Jeśli wyłączysz tę opcję, agent nie będzie prosić użytkowników o zalogowanie się, dopóki nie napotka tematu, który tego wymaga.

Po włączeniu tej opcji tworzony jest temat systemowy o nazwie Wymagaj logowania użytkownika. To temat ma znaczenie tylko w przypadku ustawienia Uwierzytelniania ręcznego. Aby automatycznie logować się w obsługiwanych czatach Teams, użyj opcji Uwierzytelnij za pomocą konta Microsoft.

Temat Wymagaj od użytkowników logowania jest automatycznie wyzwalany dla każdego użytkownika, który rozmawia z agentem bez uwierzytelniania. Jeśli użytkownik się nie zaloguje, temat przekieruje do tematu systemowego Eskalacja.

Temat jest tylko do odczytu i nie można go dostosować. Aby go wyświetlić, wybierz Przejdź do płótna autorskiego.

Kontroluj, kto może czatować z agentem w organizacji

Połączenie typu uwierzytelniania agenta i ustawienia "Wymagaj logowania użytkowników " decyduje o tym, czy możesz udostępniać agenta , aby kontrolować, kto w organizacji może z nim rozmawiać. Ustawienie uwierzytelniania nie ma wpływu na udostępnianie agenta do współpracy.

  • Brak uwierzytelniania: każdy użytkownik, który ma link do agenta (lub może go znaleźć, na przykład w witrynie internetowej), może rozmawiać z nim. Nie można kontrolować, którzy użytkownicy w organizacji mogą czatować z agentem.

  • Uwierzytelnij się za pomocą konta Microsoft: Agent wykorzystuje uwierzytelnianie Microsoft Entra ID w Teams, SharePoint, Power Apps i Microsoft Copilot. Użytkownicy są już zalogowani, więc nie konfigurujesz osobno opcji Wymagaj od użytkowników logowania. Możesz używać udostępniania agenta do kontrolowania, kto w organizacji może z agentem czatować.

  • Uwierzytelnij ręcznie:

    • Jeśli dostawcą usług jest Microsoft Entra ID, możesz włączyć opcję Wymagaj logowania użytkowników, aby kontrolować, kto w Twojej organizacji może rozmawiać z agentem przy użyciu udostępniania agenta.

    • Jeśli dostawca usług to Generic OAuth 2, możesz włączyć lub wyłączyć opcję Wymagaj logowania użytkowników . Po włączeniu tej aplikacji użytkownik, który się loguje, może czatować z agentem. Nie można kontrolować, którzy konkretni użytkownicy w organizacji mogą czatować z agentem poprzez funkcję współdzielenia agenta.

Gdy ustawienie uwierzytelniania agenta nie dozwala kontrolowania, kto może czatować z nim, po wybraniu opcji Udostępnij na stronie głównej agenta pojawi się informacja, że dowolna osoba może czatować z agentem.

Pola ręcznego uwierzytelniania

W poniższej tabeli opisano pola, które mogą wystąpić podczas konfigurowania uwierzytelniania ręcznego. To, jakie pola są widoczne, zależy od wybranego dostawcy usługi.

Nazwa pola Description
Szablon adresu URL autoryzacji Szablon adresu URL na potrzeby autoryzacji, który jest definiowany przez dostawcę tożsamości. Na przykład https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Szablon ciągu zapytania dotyczącego adresu URL autoryzacji Szablon zapytania dotyczącego autoryzacji, podany przez dostawcę tożsamości. Klucze w szablonie ciągu zapytania różnią się w zależności od dostawcy tożsamości (?client_id={ClientId}&response_type=code&redirect_uri={RedirectUrl}&scope={Scopes}&state={State}).
identyfikator klienta Identyfikator klienta, uzyskany od dostawcy tożsamości.
Tajemnica klienta Tajny klucz klienta uzyskany podczas rejestrowania aplikacji dostawcy tożsamości.
Adres URL KeyVault dla certyfikatu klienta Adres URL usługi KeyVault, pod którym jest przechowywany certyfikat klienta. Wymagane dla Microsoft Entra ID z uwierzytelnianiem certyfikatami.
Typ udzielenia Typ grantu OAuth 2.0, którego chcesz wykorzystać.
Czy wymagane jest oświadczenie x5c Określ, czy atrybut x5c jest wymagany w żądaniu tokenu. Wymagane dla Microsoft Entra ID z uwierzytelnianiem certyfikatami.
Adres URL logowania Adres URL, pod którym użytkownicy są kierowani do logowania.
Szablon odświeżania treści Szablon treści odświeżenia (refresh_token={RefreshToken}&redirect_uri={RedirectUrl}&grant_type=refresh_token&client_id={ClientId}&client_secret={ClientSecret}).
Szablon URL ciągu zapytania do odświeżania Separator ciągów zapytania odświeżenia adresu URL dla adresu URL tokenu, zwykle znak zapytania (?).
Szablon URL do odświeżania Szablon adresu URL do odświeżenia; na przykład https://login.microsoftonline.com/common/oauth2/v2.0/token.
Adres URL zasobu Adres URL zasobu, dla którego żądany jest token.
Ogranicznik listy zakresów Znak separatora listy zakresów. W tym polu nie są obsługiwane puste spacje.1
Scopes Lista zakresów, które użytkownicy mają mieć po zalogowaniu. Użyj ogranicznika listy zakresów do oddzielenia wielu zakresów.1 Ustaw tylko niezbędne zakresy i postępuj zgodnie z zasadą kontroli dostępu z najmniejszymi uprawnieniami.
Dostawca usług Dostawca usługi, którego chcesz użyć do uwierzytelniania. Dowiedz się więcej o dostawcach ogólnych OAuth.
Identyfikator najemcy Identyfikator dzierżawy Microsoft Entra ID. Dowiedz się więcej w artykule Jak znaleźć identyfikator dzierżawy Microsoft Entra.
Szablon treści tokenu Szablon treści tokenu. (code={Code}&grant_type=authorization_code&redirect_uri={RedirectUrl}&client_id={ClientId}&client_secret={ClientSecret})
Adres URL wymiany tokenu (wymagany podczas logowania jednokrotnego (SSO)) Wymagane przy konfiguracji logowania jednokrotnego (SSO); opcjonalne w przeciwnym razie.
Szablon adresu URL tokenu Szablon adresu URL dla tokenów, podany przez dostawcę tożsamości; na przykład https://login.microsoftonline.com/common/oauth2/v2.0/token.
Szablon ciągu zapytania dotyczącego adresu URL tokenu Separator ciągów zapytania dla adresu URL tokenu, zwykle znak zapytania (?).

1 Możesz użyć spacji w polu Zakresy, jeśli wymaga tego dostawca tożsamości. W tym przypadku wprowadź przecinek (,) w Ograniczniku listy zakresów i wprowadź spacje w polu Zakresy.

Wyłącz uwierzytelnianie

  1. Po otwarciu Agenta wybierz Ustawienia w górnym pasku menu.

  2. Wybierz pozycję Zabezpieczenia, a następnie wybierz pozycję Uwierzytelnianie.

  3. Wybierz Brak uwierzytelnienia.

    Jeśli temat używa zmiennych uwierzytelniania, stają się nieznanymi zmiennymi. Przejdź na stronę Tematy, aby sprawdzić, które tematy zawierają błędy, i poprawić je przed opublikowaniem.

  4. Wybierz Zapisz i następnie opublikuj agenta.

Important

Jeśli Twój agent ma narzędzia skonfigurowane tak, by wymagały danych logowania użytkownika, nie wyłączaj uwierzytelniania na poziomie agenta. Ta akcja uniemożliwia działanie tych narzędzi.

  • Ostatnia aktualizacja o