Mapowanie tożsamości użytkowników w Cloud Search

Aby zachować uprawnienia dostępu do elementów z repozytorium innej firmy, Google Cloud Search musi mapować tożsamości między repozytorium a kontami Google. Na przykład w bazie danych użytkownik może mieć nazwę użytkownika jankowalski@twoja-firma.com. Tę nazwę użytkownika należy zmapować na konto Google, na przykład jkowalski@solarmora.com.

Aby zarządzać tym mapowaniem, utwórz źródło tożsamości w Cloud Search. Źródło tożsamości umożliwia programiście zmapowanie kont użytkowników z repozytorium innej firmy na konta Google. Dowiedz się, jak programista może synchronizować różne systemy tożsamości.

Zanim zaczniesz

1. Tworzenie źródła tożsamości

Aby zmapować nazwy użytkowników z usług innych firm na konta Google, utwórz źródło tożsamości.

  1. W konsoli administracyjnej Google otwórz Menu  a potem Aplikacje a potem Google Workspace a potem Cloud Search.

    Wymaga uprawnień administratora Cloud Search.

  2. Kliknij kartę Źródła tożsamości.

    Zostanie wyświetlona lista źródeł tożsamości organizacji.

  3. W lewym górnym rogu kliknij Dodaj .

  4. Wpisz nazwę w polu Nazwa źródła tożsamości.

  5. Kliknij Dodaj konto usługi.

  6. Wpisz adres e-mail konta usługi, które może uzyskiwać dostęp do danych użytkowników i grup za pomocą interfejsu Admin SDK Users API i interfejsu Cloud Identity API.

    Użyj adresu e-mail wygenerowanego dla identyfikatora konta usługi w trakcie jego tworzenia.

  7. Ustaw poziom dostępu konta usługi do interfejsu Admin SDK Users API:

    • Odczyt i zapis – przyznaje pełne uprawnienia dostępu do interfejsu API.
    • Istniejące – zachowuje już przyznane uprawnienia do interfejsu API.

      Jeśli konto usługi miało wcześniej uprawnienia do odczytu i zapisu przyznane przez inne źródło tożsamości, te uprawnienia zostaną zachowane. Jeśli konto usługi nie ma jeszcze dostępu, nadal nie będzie go mieć.

      Uwaga: jeśli źródło tożsamości, które przyznało kontu usługi dostęp do odczytu i zapisu, zostanie usunięte, konto usługi utraci dostęp. Jeśli to źródło tożsamości musi używać tego konta usługi, ustaw opcję Odczyt i zapis.

  8. Ustaw poziom dostępu konta usługi do interfejsu Cloud Identity API:

    • Odczyt i zapis – przyznaje pełne uprawnienia dostępu do interfejsu API.
    • Odczyt – przyznaje uprawnienia do odczytu interfejsu API.
    • Brak dostępu – uniemożliwia dostęp do interfejsu API.
  9. Kliknij Dodaj konto usługi.

  10. Dodaj kolejne konto usługi lub, jeśli nie chcesz już dodawać kont usługi, kliknij Dodaj źródło tożsamości.

    Gdy źródło tożsamości zostanie dodane, pojawi się komunikat z automatycznie wygenerowanym identyfikatorem źródła tożsamości. Skopiuj ten identyfikator i przekaż go deweloperowi oprogramowania sprzęgającego tożsamości.

  11. Kliknij OK.

Po dodaniu źródła tożsamości znajdziesz je na liście źródeł tożsamości. Twój programista potrzebuje identyfikatora źródła tożsamości dla interfejsów API Google, aby uzyskiwać dostęp do danych użytkowników i grup. Aby skopiować identyfikator źródła tożsamości do schowka, kliknij Kopiuj.

Rozwiązywanie problemów z błędami interfejsu API źródła tożsamości

  • HTTP 403 (Permission Denied) – upewnij się, że Twoje konto usługi ma wyraźne uprawnienia do odczytu i zapisu zarówno w przypadku interfejsu pakietu Admin SDK API, jak i Cloud Identity API. Jeśli źródło tożsamości, które pierwotnie przyznało dostęp, zostanie usunięte, konto usługi natychmiast utraci dostęp.
  • HTTP 404 (Nie znaleziono) – sprawdź, czy prefiks identitysources/ID pasuje do aktywnego źródła tożsamości w konsoli administracyjnej i czy wszystkie zmapowane konta innych firm odpowiadają aktywnym kontom Google.

2. Importowanie kont innych firm do Google Workspace

Gdy utworzysz źródło tożsamości, Cloud Search doda atrybut niestandardowy do wszystkich Twoich kont użytkowników Google. W atrybucie niestandardowym przechowywany jest identyfikator konta z usługi innej firmy, którego dotyczy mapowanie na konto Google.

Aby wyświetlić ten atrybut niestandardowy w konsoli administracyjnej:

  1. Kliknij Użytkownicy.
  2. W prawym górnym rogu kliknij Zarządzaj atrybutami niestandardowymi .

Ważne: nie modyfikuj tego atrybutu niestandardowego. Jeśli zmienisz jego nazwę lub dowolne z jego pól, Cloud Search nie będzie działać prawidłowo.

Aby zaimportować nazwy użytkowników z usługi innej firmy do pola atrybutu niestandardowego, użyj jednej z następujących metod:

Importowanie na wszystkie konta jednocześnie za pomocą łącznika tożsamości

Synchronizuj dane użytkowników i grup za pomocą Google Cloud Directory Sync.

Możesz też wybrać łącznik tożsamości opracowany we współpracy z programistą. Dowiedz się, jak utworzyć łącznik tożsamości (artykuł w języku angielskim).

Importowanie na wszystkie konta jednocześnie za pomocą interfejsu Cloud Identity API

Zaimportuj konta użytkowników z usługi innej firmy do atrybutu niestandardowego za pomocą interfejsu Cloud Identity API.

Importowanie na poszczególne konta za pomocą konsoli administracyjnej Google

  1. W konsoli administracyjnej Google otwórz Menu  a potem  Katalog a potem Użytkownicy.

    Musisz mieć odpowiednie uprawnienie Zarządzanie użytkownikami. Bez odpowiedniego uprawnienia nie zobaczysz wszystkich opcji wymaganych do wykonania tych czynności.

  2. Na stronie konta każdego użytkownika w sekcji Zarządzaj atrybutami użytkownika kliknij Edytuj.
  3. w polu atrybutu niestandardowego dodaj nazwę użytkownika z usługi innej firmy, która jest mapowana na konto użytkownika Google Workspace.
  4. Kliknij Zaktualizuj użytkownika.

3. Znajdowanie identyfikatora klienta organizacji

Aby skonfigurować oprogramowanie sprzęgające tożsamości, programista musi mieć identyfikator klienta Twojego konta Google, który zostanie uwzględniony w pliku właściwości oprogramowania sprzęgającego.

  1. W konsoli administracyjnej Google otwórz Menu  a potem Bezpieczeństwo a potem Uwierzytelnianie a potem Logowanie jednokrotne w aplikacjach SAML.

    Aby wykonać te czynności, musisz zalogować się na konto superadministratora.

  2. Obok opcji Adres URL logowania jednokrotnego znajdź wartość idpid na końcu adresu URL. Wartość po literze C to Twój identyfikator klienta.

    Na przykład w tym adresie URL identyfikator klienta to 0123tvz4:
    https://accounts.google.com/o/saml2/idp?idpid=C0123tvz4

Następny krok

Podaj identyfikator źródła tożsamości i swój identyfikator klienta programiście, który może synchronizować różne systemy tożsamości.

Edytowanie i usuwanie źródła tożsamości

Edytowanie źródła tożsamości

  1. W konsoli administracyjnej Google otwórz Menu  a potem Aplikacje a potem Google Workspace a potem Cloud Search.

    Wymaga uprawnień administratora Cloud Search.

  2. Kliknij kartę Źródła tożsamości.
  3. Zostanie wyświetlona lista źródeł tożsamości organizacji.
  4. Wskaż źródło tożsamości, które chcesz zaktualizować, i kliknij Edytuj .
  5. W oknie źródła tożsamości wybierz element, który chcesz zmienić:
    • Aby zaktualizować istniejące konto usługi, najedź na nie kursorem i kliknij Edytuj .
      Możesz zmienić nazwę konta usługi i uprawnienia dostępu.
    • Aby dodać nowe konto usługi, kliknij Dodaj konto usługi.
  6. Kliknij Edytuj źródło tożsamości.

Usuwanie źródła tożsamości

  1. W konsoli administracyjnej Google otwórz Menu  a potem Aplikacje a potem Google Workspace a potem Cloud Search.

    Wymaga uprawnień administratora Cloud Search.

  2. Kliknij kartę Źródła tożsamości.
  3. Zostanie wyświetlona lista źródeł tożsamości organizacji.
  4. Wskaż źródło tożsamości, które chcesz usunąć, i kliknij Usuń .
  5. W oknie ostrzeżenia kliknij Usuń.

Ważne: jeśli usuniesz źródło tożsamości, Cloud Search usunie też wszystkie powiązane z nim dane. Obejmuje to wszystkie jego niestandardowe dane użytkowników i grup.