Delegowanie użytkownika dla narzędzi w usłudze Microsoft Foundry

Delegowanie użytkownika przez klienta umożliwia agentowi dostęp do narzędzia docelowego lub zasobu w kontekście zalogowanego użytkownika reprezentowanego przez klienta, który wywołuje agenta. Usługa podrzędna może stosować uprawnienia użytkownika, dostęp do danych i inne zasady autoryzacji zamiast traktować każde wywołanie narzędzia jako dostęp tylko do aplikacji.

Ten artykuł koncentruje się na scenariuszach z udziałem agenta, w których zalogowany użytkownik wchodzi w interakcję z agentem, a agent uzyskuje dostęp do systemów podrzędnych w kontekście tego użytkownika. Usługa agenta Foundry obsługuje wiele delegowanych opcji uwierzytelniania dla tych scenariuszy. Właściwa opcja zależy od tego, jak wywołujący dociera do punktu końcowego agenta, jak usługa downstream akceptuje autoryzację użytkownika i czy tworzysz nową konfigurację, czy utrzymujesz zgodność z istniejącą konfiguracją.

Klienci, którzy łączą się bezpośrednio z toolboxem, a nie za pośrednictwem agenta usługi Foundry, mogą używać oddzielnego logowania OAuth dla każdego narzędzia na potrzeby delegowania uprawnień użytkownika. Bezpośredni dostęp do zestawu narzędzi nie obsługuje logowania do planu agenta ani tożsamości agenta działającej w imieniu użytkownika.

W czasie wykonywania połączenie narzędzia określa, w jaki sposób usługa agenta uzyskuje poświadczenie reprezentujące użytkownika w usłudze podrzędnej. Następnie usługa podrzędna autoryzuje żądanie zgodnie z uprawnieniami użytkownika i własnymi zasadami.

Delegowanie użytkownika w porównaniu z dostępem do aplikacji

Delegowanie uprawnień użytkownika jest odpowiednie, gdy usługa podrzędna musi podjąć decyzję o autoryzacji dla zalogowanego użytkownika. Użyj tożsamości aplikacji lub agenta, gdy operacja nie jest specyficzna dla użytkownika.

Model uwierzytelniania Tożsamość prezentowana w dalszym etapie Typowe użycie
Delegowanie uprawnień użytkownika Zalogowany użytkownik korzystający z Microsoft Entra, poprzez zachowanie działania w imieniu użytkownika lub oddzielne logowanie OAuth Odczytywanie komunikatów, plików, rekordów użytkownika lub innych danych autoryzowanych przez użytkownika.
Tożsamość agenta Agent jako niezależny podmiot Microsoft Entra Dostęp kontrolowany za pomocą ról lub uprawnień aplikacji przypisanych do agenta.
Tożsamość zarządzana Project Tożsamość zarządzana projektu Foundry Udostępniony dostęp na poziomie projektu do zasobu Azure.
Klucz API lub niestandardowe poświadczenie podmiot zabezpieczeń skojarzony z przechowywanym poświadczeniem Usługi, które nie obsługują dostępu Microsoft Entra ani delegowanego protokołu OAuth.
Bez uwierzytelniania Brak uwierzytelnionego podmiotu zabezpieczeń Narzędzia publiczne, które celowo zezwalają na dostęp anonimowy.

Nie używaj delegowania użytkownika, gdy każdy użytkownik powinien otrzymać te same uprawnienia na poziomie aplikacji. Natomiast nie używaj tożsamości aplikacji, gdy usługa podrzędna musi zachować autoryzację specyficzną dla użytkownika. Obsługa narzędzi i kanałów może zawęzić dostępne opcje. Przed utworzeniem połączenia potwierdź typy uwierzytelniania obsługiwane przez wybrane narzędzie.

Opcje delegowania uprawnień użytkownika

Delegowanie uprawnień użytkownika może ponownie używać kontekstu użytkownika Microsoft Entra z przychodzącego żądania agenta lub ustanowić oddzielną sesję protokołu OAuth podczas rozmowy.

Sposób delegowania Jak użytkownik jest reprezentowany
Dostęp w imieniu użytkownika Usługa agenta używa kontekstu użytkownika Microsoft Entra z przychodzącego żądania agenta w celu uzyskania poświadczenia dla zasobu docelowego.
Logowanie za pomocą protokołu OAuth podczas konwersacji Użytkownik ustanawia oddzielną sesję protokołu OAuth dla każdego połączenia podczas rozmowy z agentem.

Usługa Foundry IQ (Wyszukiwanie AI platformy Azure) używa dostępu w imieniu użytkownika z zachowaniem autoryzacji źródła specyficznego dla elementu docelowego. Aby uzyskać szczegółowe informacje, zobacz Autoryzacja źródła Foundry IQ.

Dostęp w imieniu użytkownika

W przypadku dostępu w imieniu użytkownika narzędzie chronione przez Microsoft Entra otrzymuje poświadczenia reprezentujące użytkownika, który wywołał agenta. Usługa agenta wykonuje wymianę tokenów w dalszym etapie przepływu. token podrzędny reprezentuje zarówno użytkownika, jak i aktora, który uczestniczy w wymianie.

Dostępne konfiguracje aktorów zależą od narzędzia. Niektóre narzędzia obsługują konfigurację, w której grupa odbiorców przychodzącego punktu końcowego określa aktora w czasie wykonywania:

  • Gdy przychodzący token jest przeznaczony dla usługi Foundry, usługa Foundry jest podmiotem.
  • Gdy token przychodzący jest przeznaczony dla schematu agenta, tożsamość agenta pełni rolę aktora.

Inne narzędzia obsługują lub wymagają konfiguracji, w której tożsamość agenta jest zawsze aktorem. W przypadku tego zachowania punkt końcowy musi używać schematu AgentBlueprint autoryzacji, a token przychodzący musi być przeznaczony dla planu agenta.

Note

W interfejsie API połączenia UserEntraToken reprezentuje wybór warunkowy między usługą Foundry i tożsamością agenta, AgentOnBehalfOfUser reprezentuje zachowanie tylko dla tożsamości agenta i OAuth2 reprezentuje logowanie OAuth w trakcie konwersacji. Aby uzyskać szczegółowe informacje o konfiguracji, zobacz wskazówki dotyczące wybranego narzędzia.

Foundry jako podmiot

Foundry może działać w imieniu użytkownika dla ograniczonego zestawu narzędzi należących do firmy Microsoft. Nie może tego zrobić w przypadku niestandardowych serwerów ani integracji innych firm. Zasób docelowy otrzymuje token uzyskany za pośrednictwem aplikacji, a nie agenta. Narzędzie Foundry nie wymaga dodatkowego uprawnienia do interakcji z obsługiwanymi narzędziami.

Ta sama konfiguracja aktora umożliwia również tożsamości agenta działanie w imieniu użytkownika, gdy przychodzący token jest przeznaczony dla schematu agenta. Funkcja Foundry działa tylko wtedy, gdy przychodzący token jest przeznaczony dla usługi Foundry. To zachowanie warunkowe obsługuje przejście z dostępu RBAC platformy Azure do dostępu do planu agenta, podczas gdy oba schematy autoryzacji punktu końcowego są skonfigurowane. Aby uzyskać więcej informacji, zobacz Autoryzacja punktu końcowego agenta.

Tożsamość agenta jako podmiot (wersja zapoznawcza)

Tożsamość agenta może działać w imieniu użytkownika, gdy przychodzące żądanie jest autoryzowane za pośrednictwem schematu AgentBlueprint, a jego token jest przeznaczony dla projektu agenta. To zachowanie jest w wersji zapoznawczej. Token podrzędny reprezentuje zarówno użytkownika, jak i agenta, co umożliwia zasobowi podejmowanie decyzji dotyczących autoryzacji dotyczących agenta. Zasady dostępu warunkowego Microsoft Entra mogą również regulować te wywołania narzędzi.

Tożsamość agenta musi być autoryzowana dla żądanych delegowanych uprawnień podrzędnych. W zależności od zasad zasobów i dzierżawy ta autoryzacja może wymagać zgody użytkownika, zgody administratora lub wstępnej autoryzacji. Ten artykuł zawiera zwięzłe omówienie Zachowanie zgody. Pełniejszy model zgody znajdziesz w artykule zgoda platformy Microsoft Entra na dostęp delegowany.

To zachowanie dotyczy obecnie klientów bezpośrednio korzystających ze środowiska uruchomieniowego. Klienci deweloperscy Foundry i integracje Azure Bot Service nadal korzystają z audience usługi Foundry i nie mogą używać konfiguracji aktora opartej wyłącznie na tożsamości agenta.

Tożsamość agenta może zostać wybrana przez Agent Service na jeden z następujących sposobów:

  • Użyj tożsamości agenta dla każdego żądania.
  • Wybierz aktora z grupy odbiorców tokenu przychodzącego. To warunkowe zachowanie umożliwia usłudze Foundry pozostać actor w celu zachowania zgodności z istniejącymi klientami.

Niektóre narzędzia pozwalają, aby tylko tożsamość agenta była aktorem.

Autoryzacja źródła Foundry IQ

Bazy wiedzy IQ usługi Foundry używają zachowania autoryzacji specyficznego dla obiektu docelowego. Usługa agenta dynamicznie ustawia x-ms-query-source-authorization za pomocą tokenu Foundry IQ zalogowanego użytkownika, aby baza wiedzy mogła egzekwować uprawnienia dostępu do źródła. To zachowanie ma zastosowanie, czy przychodzące żądanie dotyczy rozwiązania Foundry, czy planu agenta.

Gdy żądanie agenta jest przeznaczone dla odbiorców blueprintu, usługa agenta próbuje uzyskać token dostępu dla https://search.azure.com/user_impersonation w imieniu użytkownika. Jeśli wymagana autoryzacja nie została udzielona, wywołanie narzędzia może zwrócić element oauth_consent_request.

Logowanie za pomocą protokołu OAuth podczas konwersacji

Logowanie OAuth w trakcie konwersacji monituje użytkownika o ustanowienie oddzielnej sesji protokołu OAuth podczas konwersacji.

Klienci Direct Toolbox mogą również używać tego oddzielnego logowania OAuth dla poszczególnych narzędzi z OAuth2 połączeniem. Termin in-conversation opisuje środowisko agenta; interfejs udostępniany przez klienta MCP nie musi być konwersacyjny. To logowanie podrzędne nie zastępuje uwierzytelniania klienta do punktu końcowego Toolbox.

Aplikacja wywołująca musi obsługiwać autoryzację interaktywną: wyświetlanie użytkownikowi żądania logowania i kontynuowanie po jego zakończeniu. Samo skonfigurowanie OAuth2 nie zapewnia takiego działania po stronie klienta. Upewnij się, że Twój klient obsługuje ten przepływ przed użyciem narzędzi wymagających logowania użytkownika.

Konfiguracja połączenia określa autoryzację, token i punkty końcowe odświeżania wraz z zakresami żądanymi od dostawcy. Usługa agenta przechowuje i odświeża wynikowe poświadczenia. Dzieli stan autoryzacji według użytkownika i połączenia, więc poświadczenia usług podrzędnych każdego użytkownika pozostają izolowane. Aplikacje muszą zachować kontekst wywołującego wymagany do tego partycjonowania podczas interakcji z agentem lub bezpośredniego połączenia z przybornikiem.

Aby uzyskać informacje na temat konfiguracji połączenia toolbox i obsługi protokołu OAuth dla poszczególnych użytkowników, zobacz Jak działa uwierzytelnianie toolbox.

zgoda autoryzuje delegowane uprawnienia dla zasobu docelowego. Nie udziela on użytkownikowi dostępu do danych, do których zasób w przeciwnym razie odmówiłby dostępu. Zasób nadal ocenia uprawnienia użytkownika i własne zasady autoryzacji.

Dzięki zgodzie administratora można uniknąć interakcyjnego monitu dla użytkownika. Preautoryzacja może zrobić to samo, gdy zasób docelowy to obsługuje. Gdy wymagana jest interaktywna autoryzacja, usługa agenta może zwrócić oauth_consent_request element wyjściowy. Aplikacja wywołująca wyświetla link zgody należącej do produktu i kontynuuje interakcję po wyrażeniu zgody. Jeśli zasady dzierżawcy nie zezwalają na zgodę udzielaną przez użytkownika, próba zakończy się niepowodzeniem, gdy użytkownik spróbuje dokończyć ten proces. Aplikacja nie zbiera, sprawdza ani nie przekazuje tokenu dostępu usługi podrzędnej.

Zgoda dotyczy konkretnego zasobu docelowego. Każdy zasób ma własne uprawnienia i stan zgody. Aby uzyskać więcej informacji, zobacz zgoda Microsoft Entra na dostęp delegowany.