Narzedzia AI · 7 min czytania · 21 listopada 2026

Własny interfejs Gemini Enterprise: trzy logowania są na Tobie

Przejdź do treści i przykładów
Własny interfejs Gemini Enterprise: trzy logowania są na Tobie

Gotowa aplikacja webowa Gemini Enterprise załatwia logowanie za kulisami. Kiedy firma buduje własny interfejs (Customer UI) i jej backend (Customer BE) wywołuje StreamAssist API bezpośrednio, trzy przepływy uwierzytelniania spadają na zespół, który ten interfejs robi. Google opisał to w przewodniku na blogu Google Developers, razem z wzorcami i repozytorium z kodem.

Bez technobełkotu: poniżej masz, co to za trzy przepływy, którym wzorcem się logować i co zrobić, żeby użytkownik nie utknął w ścianie okienek.

Co przestaje działać samo, gdy budujesz własny interfejs?

W wbudowanej aplikacji pracownicy logują się przez Google Identity albo Workforce Identity Federation (np. Microsoft Entra ID lub Okta). Wyniki wyszukiwania same respektują uprawnienia do dokumentów (ACL, czyli listy: kto co może zobaczyć). Okienka logowania do konektorów i agentów pojawiają się w czacie automatycznie. W Twoim interfejsie nic z tego nie ma.

Według Google trzy rzeczy trzeba obsłużyć ręcznie:

  • Logowanie do StreamAssist: przekazanie tożsamości pracownika albo tożsamości maszyny.
  • Federated Connectors: zgoda użytkownika na dostęp do Google Drive, SharePoint Online, Jira, Box, ServiceNow czy Confluence. Interfejs nie ma wbudowanego przycisku Connect, więc musi go sobie zrobić.
  • OAuth dla narzędzi agenta ADK: osobne zgody dla każdego narzędzia, gdy agent łączy się z kilkoma systemami firmy.
Trzy warstwy logowania, które wbudowana aplikacja robiła za Ciebie
Trzy warstwy logowania, które wbudowana aplikacja robiła za Ciebie

Którym wzorcem logować się do StreamAssist: 1A, 1B czy 1C?

Zależy od jednego pytania: czy interfejs działa w imieniu konkretnego pracownika, czy jako wspólny bot. Każdy podmiot wywołujący API musi mieć rolę IAM Discovery Engine User w projekcie GCP. We wzorcach 1A i 1B użytkownik (albo grupa z Workforce Pool) potrzebuje dodatkowo aktywnej licencji Gemini Enterprise nadanej w Admin Console.

  • Wzorzec 1A (czysty Google Identity): Customer UI loguje pracownika przez Google Identity Services (OAuth 2.0) ze scope Google Cloud Platform, Google zwraca token dostępu, a Customer BE wysyła go wprost do StreamAssist. Zero dodatkowych przeskoków.
  • Wzorzec 1B (Workforce Identity Federation): dla firm logujących się przez Entra ID lub Okta. Dodajesz Client ID aplikacji do dostawcy OIDC w istniejącym Workforce Pool. Po zalogowaniu backend wymienia token z IdP w Google STS na krótkotrwały token Google, który niesie uprawnienia grupowe i ACL pracownika.
  • Wzorzec 1C (Workload Identity Federation): dla bota backendowego, webhooka Slack/Teams czy wspólnego portalu wiedzy. Backend bierze maszynowy JWT z zewnętrznego IdP i wymienia go w Google STS, bez kluczy JSON Service Account na dysku.

Haczyk wzorca 1C: Gemini Enterprise widzi wtedy każde zapytanie jako pochodzące z jednej tożsamości. Nadaje się więc do botów bez personalizacji na wspólnych bazach wiedzy. Gdy potrzebujesz ACL per użytkownik, konektorów z osobistą zgodą albo ograniczonych agentów, wybierasz 1A lub 1B.

Jeśli Twoja firma loguje się przez Microsoft Entra ID albo Okta, wzorzec 1B to droga, którą i tak już masz częściowo ułożoną: ten sam Workforce Pool, który obsługuje Gemini Enterprise, obsłuży też Twój interfejs. Brak kluczy na dysku to zresztą rozsądna higiena, bo hasła wyciekające jawnym tekstem do repozytoriów to nie teoria.

Darmowy webinar na żywo z Janem Gajosem · w najbliższą środę o 19:00

Czytasz o AI, a w pracy dalej robisz wszystko ręcznie? Znam to.

Sam tak robiłem. Na webinarze pokazuję na swoim ekranie, jak oddać AI powtarzalne zadania: maile, proste automatyzacje, asystenta do pracy. Bez programowania i bez teorii. 90 minut, a na końcu pytasz, o co chcesz.

Link do pokoju przyjdzie mailem. Zapisując się, zgadzasz się na wiadomości e-mail zgodnie z polityką prywatności. Wolisz zacząć od lektury? Zobacz e-booki Jana Gajosa

Jak podpiąć Drive i SharePoint, żeby nie trzymać cudzych poświadczeń?

Federated Connectors przeszukują na żywo API firm trzecich i egzekwują uprawnienia użytkownika po stronie tamtego systemu. Dlatego każdy pracownik autoryzuje konektor jednorazowo przez 3-Legged OAuth (3LO, czyli okienko, w którym sam klikasz zgodę). Tokeny odświeżania lądują w zarządzanym Keystore Gemini Enterprise, więc Customer BE nie trzyma poświadczeń zewnętrznych we własnej bazie.

Przepływ ma 11 kroków i trzy fazy:

  1. Odkrycie i sprawdzenie Keystore (kroki 1-4): backend pobiera listę konektorów podpiętych do silnika i pyta Keystore o ważny token. Interfejs pokazuje przycisk autoryzacji tam, gdzie zgody brakuje.
  2. Okienko zgody (kroki 5-7): po kliknięciu otwiera się popup u dostawcy zewnętrznego, a po zatwierdzeniu strona przekierowania Google odsyła callback do Twojego interfejsu i zamyka okno.
  3. Zapis tokenu (kroki 8-11): backend przekazuje kod do GE Server, ten wymienia go na token i zapisuje w Keystore.

Po autoryzacji Customer BE dodaje identyfikator data store konektora do zapytań StreamAssist, dzięki czemu wyszukiwanie odbywa się na żywo w momencie pytania.

Jedna pułapka dla własnej domeny: wszystkie konektory używają stałego adresu /oauth-redirect po stronie Google, który domyślnie wysyła wiadomość tylko do origin wbudowanej aplikacji. Przy własnej domenie trzeba z zespołem Gemini Enterprise włączyć flagę custom origin. Bez niej krok 7 nie przekaże callbacku i popup nie zamknie się automatycznie.

Zgoda raz, tokeny w Keystore, backend bez cudzych haseł
Zgoda raz, tokeny w Keystore, backend bez cudzych haseł

Dlaczego agent ADK nie powinien blokować wszystkiego logowaniem na starcie?

Kiedy budujesz własnego agenta w ADK i wdrażasz go na Vertex AI Agent Engine, kuszące jest przypięcie statycznego OAuth do rejestracji głównego agenta. Google wskazuje dwa problemy. Po pierwsze, taka brama zamyka cały agent przed pierwszą turą rozmowy. Jeśli agent łączy się z Google Drive i SharePointem, użytkownik nie zada nawet ogólnego pytania o politykę firmy, dopóki nie przejdzie wszystkich logowań. Zupełnie jakby bramkarz sprawdzał Ci dowód przy windzie, choć jedziesz na parter. Po drugie, taka autoryzacja jest zaprojektowana pod wbudowany interfejs Gemini Enterprise, a nie pod prompty autoryzacji narzędzi zwracane przez StreamAssist API.

Trzy kroki konfiguracji na żądanie

  • Opakuj chronione narzędzia: zwykłe narzędzia działają jako normalne funkcje Pythona bez żadnych promptów OAuth. Narzędzia wołające chronione API (SharePoint, Drive) opakowujesz w AuthenticatedFunctionTool i GcpAuthProvider, wskazujący zasób Auth Provider w GCP Auth Manager.
  • Wdróż z Agent Identity: agent trafia na Vertex AI Agent Engine z włączoną tożsamością (wbudowana tożsamość SPIFFE). Tej tożsamości nadajesz rolę IAM Agent Identity Service Agent, żeby mogła pobierać tokeny z Token Vault.
  • Utwórz 3LO Auth Provider w konsoli Google Cloud: osobny dla każdej zewnętrznej aplikacji OAuth. Default Continue URI ustawiasz na adres-twojej-strony/validateUserId w Customer UI, a callback GCP Auth Manager (/oauthcallback) dodajesz jako Redirect URI w aplikacji Entra ID lub u innego dostawcy.

Efekt opisany w 19-krokowym przepływie: popup pojawia się dopiero, gdy agent wywoła chronione narzędzie po raz pierwszy. Po zapisaniu tokenu w Token Vault Customer BE sam ponawia zapytanie w tej samej sesji, a kolejne pytania lecą w jednej turze, bez okienek. To samo dotyczy agentów AI pracujących na danych firmy, o których pisałem przy okazji tekstu o tym, że agenci AI wymagają jednej bazy danych: uprawnienia muszą jechać razem z użytkownikiem, nie obok niego.

Gdzie jest kod i co sprawdzić jako pierwsze?

Autor wpisu, Neeraj Agrawal z Google Cloud, udostępnił repozytorium gemini-enterprise-custom-ui-auth na GitHubie. Dla każdej z trzech warstw są tam skrypty Pythona, polecenia curl, narzędzie CLI oraz interaktywne testowe interfejsy webowe. Przy częściach 2 i 3 dochodzi jeszcze implementacja wieloagentowa ADK i skrypt wdrożenia na Agent Engine.

Google nie podał cen licencji Gemini Enterprise w tym wpisie. Sprawdzisz je w cenniku i dokumentacji Google Cloud, a to ważne, bo we wzorcach 1A i 1B każdy użytkownik potrzebuje aktywnej licencji. Jeśli chodzi o kontrolę dostępu w narzędziach AI, podobny temat poruszyłem w tekście o tym, jak Goldman Sachs zawęża dostęp do Claude Code do programistów: ktoś zawsze decyduje, kto wchodzi i do czego.

Werdykt: sam interfejs to najmniejsza część roboty. Trudniejsze jest to, kto się loguje, w czyim imieniu i gdzie leżą tokeny. Wypisz na kartce, kto ma korzystać z Twojego interfejsu: konkretni pracownicy z własnymi uprawnieniami do dokumentów czy wspólny bot na jednej bazie wiedzy. Pierwsza odpowiedź prowadzi do wzorca 1A lub 1B, druga do 1C. To zajmie 10 minut i oszczędzi Ci przebudowy po pierwszym teście.

Jedno pytanie na kartce rozstrzyga wybór wzorca
Jedno pytanie na kartce rozstrzyga wybór wzorca

Na podstawie: Google Developers Blog: How to handle user, connector, and agent auth in Gemini Enterprise with a custom UI

Powiązane tematy

Informacje o artykule

Darmowy webinar na żywo z Janem Gajosem · w najbliższą środę o 19:00

Czytasz o AI, a w pracy dalej robisz wszystko ręcznie? Znam to.

Sam tak robiłem. Na webinarze pokazuję na swoim ekranie, jak oddać AI powtarzalne zadania: maile, proste automatyzacje, asystenta do pracy. Bez programowania i bez teorii. 90 minut, a na końcu pytasz, o co chcesz.

Link do pokoju przyjdzie mailem. Zapisując się, zgadzasz się na wiadomości e-mail zgodnie z polityką prywatności. Wolisz zacząć od lektury? Zobacz e-booki Jana Gajosa

Udostępnij:
Nie przegap nowych artykułów - dodaj SukcesAI do swoich źródeł w wyszukiwarce Google.
Dodaj do preferowanych źródeł
Jan Gajos

Ekspert AI & Founder, AI Evolution

Pasjonat sztucznej inteligencji, który od 18 lat działa z sukcesem biznesowo i szkoleniowo. Wprowadzam AI do swoich firm oraz codziennego życia. Fascynują mnie nowe technologie, gry wideo i składanie klocków Lego - tam też widzę logikę i kreatywność, które AI potrafi wzmacniać. Wierzę, że dobrze użyta sztuczna inteligencja to nie ogłupiające ułatwienie, lecz prawdziwy przełom w sposobie, w jaki myślimy, tworzymy i pracujemy.

Newsletter SukcesAI

Raz w tygodniu najważniejsze nowości z AI i nowe poradniki z tego bloga.

Link do wypisania się jest w każdym mailu. Polityka prywatności