Konfigurowanie uwierzytelniania użytkownika przy użyciu Microsoft Entra ID

Po dodaniu uwierzytelniania do swojego agenta, użytkownicy mogą się zalogować i dać mu dostęp do ograniczonego zasobu lub informacji.

W tym artykule wyjaśniono, jak skonfigurować Microsoft Entra ID jako dostawcę usług. Aby uzyskać informacje na temat innych dostawców usług i uwierzytelniania użytkowników, zobacz Konfiguruj uwierzytelnianie użytkownika w programie Copilot Studio.

Jeśli masz uprawnienia administracyjne dzierżawcy, możesz skonfigurować uprawnienia interfejsu API. W przeciwnym razie poproś administratora najemcy o przyznanie tych uprawnień.

Wymagania wstępne

Dowiedz się, jak dodać uwierzytelnianie użytkownika do tematu

Pierwsze kroki należy wykonać w portalu Azure i wykonać dwa ostatnie kroki w programie Copilot Studio.

Tworzenie rejestracji aplikacji

1. Zaloguj się do Azure Portal przy użyciu konta administratora w tej samej dzierżawie, co agent.

2. Przejdź do Rejestracje aplikacji.

3. Wybierz pozycję Nazwa rejestracji i wprowadź nazwę rejestracji. Nie zmieniaj istniejących rejestracji aplikacji.

   W tym przypadku może być pomocne użycie nazwy agenta. Jeśli na przykład agent nazywa się „Pomoc sprzedażowa Contoso”, możesz nazwać rejestrację aplikacji "ContosoSalesReg."

4. Ustaw pole Obsługiwane typy kont na Konta tylko w tym katalogu organizacyjnym (tylko Contoso — jedna dzierżawa).

5. Na razie pozostaw sekcję Identyfikator URI przekierowywania pustą. Te informacje należy wprowadzić w następnych krokach.

6. Wybierz pozycję Zarejestruj.

7. Po zakończeniu rejestracji przejdź do Przeglądu.

8. Skopiuj identyfikator aplikacji (klienta) i wklej go w pliku tymczasowym. Będziesz tego potrzebować w kolejnych krokach.

Dodaj URL przekierowania

1. W obszarze Zarządzanie wybierz pozycję Uwierzytelnianie.

2. W obszarze Konfiguracje platformy wybierz pozycje Dodaj platformę i Internet.

3. W obszarze Identyfikatory URI przekierowania wprowadź https://token.botframework.com/.auth/web/redirect lub https://europe.token.botframework.com/.auth/web/redirect dla Europy. Możesz również skopiować identyfikator URI z pola tekstowego Redirect URL na stronie ustawień bezpieczeństwa w Copilot Studio pod Ręczna autoryzacja.

   Ta czynność powoduje powrót do strony Konfiguracje platformy.

   Aby uzyskać listę wymaganych usług, z którymi Copilot Studio nawiązuje połączenie, w tym token.botframework.com, zobacz Wymagane usługi.

4. Wybierz zarówno tokeny dostępu (używane dla przepływów niejawnych) jak i tokeny identyfikatorów (używane w przypadku przepływów niejawnych i hybrydowych).

5. Wybierz Konfiguruj.

Konfiguruj ręczne uwierzytelnianie

Następnie skonfiguruj ręczne uwierzytelnianie. Można wybierać spośród wielu opcji dostawców. Należy jednak użyć Microsoft Entra ID v2 z poświadczeniami federacyjnymi. Możesz również użyć tajemnic klienta, jeśli nie możesz użyć poświadczeń federacyjnych.

Konfiguracja uprawnień API

1. Przejdź do obszaru Uprawnienia interfejsu API.

2. Wybierz opcję Przyznawanie zgody administratora <Nazwa dzierżawy>, a następnie wybierz Tak. Jeśli przycisk jest niedostępny, może być konieczne zwrócenie się do administratora dzierżawy o wprowadzenie go za Ciebie.

   

   Ważne

   Aby użytkownicy nie musieli wyrażać zgody na każdą aplikację, administrator globalny, administrator aplikacji lub administrator aplikacji w chmurze może udzielić zgody całej dzierżawie na rejestracje aplikacji.

3. Wybierz pozycję Dodaj uprawnienie, a następnie wybierz pozycję Microsoft Graph.

   

4. Wybierz pozycję Uprawnienia delegowane.

   

5. Rozwiń uprawnienia OpenId i włącz openid i profile.

   

6. Wybierz opcję Dodaj uprawnienia.

Zdefiniuj zakres niestandardowy dla Twojego agenta

Zakresy definiują role użytkowników i administratorów oraz ich prawa dostępu. Stwórz niestandardowy zakres dla rejestracji aplikacji Canvas.

1. Wybierz opcję Uwidacznianie interfejsu API i następnie wybierz Dodaj zakres.

   

2. Określ następujące właściwości. Pozostałe właściwości można pozostawić puste.

   Majątek	Value
   Nazwa zakresu	Wprowadź nazwę, która ma sens w Twoim środowisku, na przykład Test.Read
   Kto może wyrazić zgodę?	Wybierz Administratorzy i użytkownicy
   Wyświetlana nazwa zgody administratora	Wprowadź nazwę, która ma sens w Twoim środowisku, na przykład Test.Read
   Opis zgody administratora	Wprowadź Allows the app to sign the user in.
   State	Wybierz opcję Włącz

3. Wybierz Dodaj zakres.

Konfigurowanie uwierzytelniania w programie Copilot Studio

1. W programie Copilot Studio w obszarze Settings wybierz pozycję Security>Authentication.

2. Wybierz Ręczne uwierzytelnianie.

3. Pozostaw opcję Wymagaj logowania użytkowników włączoną.

4. Wybierz Dostawcę usług i podaj wymagane wartości. Zobacz Konfiguruj ręczne uwierzytelnianie w programie Copilot Studio.

5. Wybierz Zapisz.

Przetestuj swojego agenta

1. Opublikuj swojego agenta.

2. W panelu Przetestuj agenta wyślij wiadomość do swojego agenta.

3. Gdy agent odpowie, wybierz pozycję Zaloguj.

   Otwiera się nowa zakładka przeglądarki, która prosi o zalogowanie.

4. Zaloguj się, a następnie skopiuj wyświetlany kod sprawdzania poprawności.

5. Aby dokończyć proces logowania, wklej kod na czacie z agentem.