Uproszczone łączenie za pomocą protokołu OAuth i Logowania przez Google

Przegląd

Uproszczone łączenie za pomocą Zaloguj się przez Google opartego na protokole OAuth dodaje Zaloguj się przez Google do łączenia za pomocą protokołu OAuth. Zapewnia to użytkownikom Google płynne łączenie kont, a także umożliwia tworzenie konta, dzięki czemu użytkownik może utworzyć nowe konto w Twojej usłudze za pomocą konta Google.

Aby połączyć konta za pomocą OAuth i zalogować się przez Google, wykonaj te ogólne czynności:

  1. Najpierw poproś użytkownika o zgodę na dostęp do jego profilu Google.
  2. Użyj informacji z profilu, aby sprawdzić, czy konto użytkownika istnieje.
  3. W przypadku dotychczasowych użytkowników połącz konta.
  4. Jeśli w systemie uwierzytelniania nie możesz znaleźć użytkownika Google, sprawdź token identyfikatora otrzymany od Google. Następnie możesz utworzyć użytkownika na podstawie informacji o profilu zawartych w tokenie identyfikatora.
Ilustracja przedstawiająca kroki, które użytkownik musi wykonać, aby połączyć konto Google za pomocą uproszczonego procesu łączenia. Pierwszy zrzut ekranu pokazuje, jak użytkownik może wybrać Twoją aplikację do połączenia. Drugi zrzut ekranu pozwala użytkownikowi potwierdzić, czy ma już konto w Twojej usłudze. Na trzecim zrzucie ekranu użytkownik może wybrać konto Google, które chce połączyć. Czwarty zrzut ekranu przedstawia potwierdzenie połączenia konta Google z aplikacją. Piąty zrzut ekranu pokazuje połączone konto użytkownika w aplikacji Google.
Łączenie konta na telefonie użytkownika za pomocą uproszczonego łączenia

Rysunek 1. Łączenie kont na telefonie użytkownika za pomocą uproszczonego łączenia

Uproszczone łączenie: proces OAuth + Zaloguj się przez Google

Poniższy diagram sekwencji przedstawia interakcje między użytkownikiem, Google i punktem końcowym wymiany tokenów w przypadku uproszczonego łączenia.

Użytkownik Aplikacja / serwer Google Twój token Punkt wymiany Twój interfejs API 1. Użytkownik inicjuje połączenie 2. Poproś o zalogowanie się przez Google 3. Zaloguj się przez Google 4. sprawdź intencję (asercja JWT) 5. account_found: true/false Jeśli konto zostało znalezione: 6. pobierz intencję Jeśli konto nie zostało znalezione: 6. utwórz intencję 7. token dostępu, token odświeżania 8. Przechowywanie tokenów użytkowników 9. Dostęp do materiałów dla użytkowników
Rysunek 2. Sekwencja zdarzeń w procesie uproszczonego łączenia
.

Role i obowiązki

W tabeli poniżej znajdziesz definicje ról i obowiązków podmiotów w procesie uproszczonego łączenia.

Użytkownik, który wykonał czynność lub komponent Rola GAL Podmiot odpowiedzialny
Aplikacja / serwer Google Klient OAuth Uzyskuje zgodę użytkownika na Zaloguj się przez Google, przekazuje do serwera potwierdzenia tożsamości (JWT) i bezpiecznie przechowuje uzyskane tokeny.
Punkt końcowy wymiany tokenów Dostawca tożsamości / serwer autoryzacji Weryfikuje potwierdzenia tożsamości, sprawdza, czy istnieją już konta, obsługuje intencje łączenia kont (check, get, create) i wydaje tokeny na podstawie żądanych intencji.
Interfejs API usługi Serwer zasobów Umożliwia dostęp do danych użytkownika po okazaniu prawidłowego tokena dostępu.

Wymagania dotyczące uproszczonego łączenia

Logika podejmowania decyzji dotycząca uproszczonego łączenia

Oto logika, która określa, jak wywoływane są intencje podczas uproszczonego procesu łączenia:

  1. Czy użytkownik ma konto w Twoim systemie uwierzytelniania? (Użytkownik decyduje, wybierając TAK lub NIE)
    1. TAK : czy użytkownik loguje się na Twoją platformę za pomocą adresu e-mail powiązanego z kontem Google? (Użytkownik decyduje, wybierając TAK lub NIE)
      1. YES : czy użytkownik ma pasujące konto w Twoim systemie uwierzytelniania? (check intent jest wywoływana w celu potwierdzenia)
        1. TAK : wywoływana jest funkcja get intent, a konto jest łączone, jeśli funkcja get intent zwróci wynik.
        2. NIE : Utworzyć nowe konto? (Użytkownik decyduje, wybierając TAK lub NIE)
          1. TAK : wywoływana jest funkcja create intent, a konto jest łączone, jeśli intencja utworzenia zostanie zwrócona.
          2. NIE : uruchamiany jest proces łączenia OAuth, użytkownik jest przekierowywany do przeglądarki i ma możliwość połączenia z innym adresem e-mail.
      2. NIE : uruchamiany jest proces łączenia OAuth, użytkownik jest przekierowywany do przeglądarki i ma możliwość połączenia się z innym adresem e-mail.
    2. NIE : czy użytkownik ma pasujące konto w Twoim systemie uwierzytelniania? (check intent jest wywoływana w celu potwierdzenia)
      1. TAK : wywoływana jest funkcja get intent, a konto jest łączone, jeśli funkcja get intent zwróci wynik.
      2. NIE : wywoływana jest funkcja create intent, a konto jest połączone, jeśli intencja utworzenia zostanie zwrócona.

Przepis na wdrożenie

Aby obsługiwać uproszczone łączenie, punkt końcowy wymiany tokenów musi implementować intencje check, get i create.

Aby obsłużyć różne intencje, wykonaj te czynności:

Sprawdzanie, czy istnieje konto użytkownika (intencja check)

Google wywołuje Twój punkt końcowy wymiany tokenów, aby sprawdzić, czy użytkownik Google istnieje w Twoim systemie. Szczegółowe informacje o parametrach znajdziesz w artykule Uproszczone intencje łączenia.

Przepis na implementację

Aby obsłużyć intencję check, wykonaj te czynności:

  1. Sprawdź poprawność żądania:

    • Sprawdź client_id, client_secret i grant_type (musi to być urn:ietf:params:oauth:grant-type:jwt-bearer).
    • Sprawdź assertion (JWT) zgodnie z kryteriami opisanymi w sekcji Weryfikacja JWT.

  2. Wyszukaj użytkownika:

    • Sprawdź, czy identyfikator konta Google (sub) lub adres e-mail w tokenie JWT pasuje do użytkownika w Twojej bazie danych.

  3. Odpowiedz:

    • Jeśli użytkownik zostanie znaleziony, zwróć kod HTTP 200 OK z treścią {"account_found": "true"}.
    • Jeśli użytkownik nie zostanie znaleziony, zwróć kod HTTP 404 Not Found z treścią {"account_found": "false"}.

Obsługa automatycznego łączenia (pobieranie intencji)

Jeśli konto istnieje, Google wywołuje Twój punkt końcowy z parametrem intent=get, aby pobrać tokeny. Szczegółowe informacje o parametrach znajdziesz w sekcji Uproszczone intencje łączenia.

Przepis na implementację

Aby obsłużyć intencję get, wykonaj te czynności:

  1. Sprawdź żądanie:

    • Sprawdź client_id, client_secret i grant_type.
    • Sprawdź assertion (JWT).

  2. Wyszukaj użytkownika:

    • Sprawdź, czy użytkownik istnieje, używając deklaracji sub lub email.

  3. Odpowiedz:

    • Jeśli operacja się uda: wygeneruj i zwróć access_token, refresh_token i expires_in w odpowiedzi JSON (HTTP 200 OK).
    • Jeśli łączenie się nie powiedzie: zwróć HTTP 401 Unauthorized z {"error": "linking_error"} i opcjonalnym parametrem login_hint, aby wrócić do standardowego łączenia OAuth.

Handle account creation using Sign in with Google (create intent)

If no account exists, Google calls your endpoint with intent=create to create a new user. For parameter details, see Streamlined Linking Intents.

Implementation Recipe

To handle the create intent, perform the following actions:

  1. Validate the request:

    • Verify client_id, client_secret, and grant_type.
    • Validate the assertion (JWT).

  2. Verify user does not exist:

    • Check if the sub or email is already in your database.
    • If the user does exist: Return HTTP 401 Unauthorized with {"error": "linking_error", "login_hint": "USER_EMAIL"} to force fallback to OAuth linking.

  3. Create account:

    • Use the sub, email, name, and picture claims from the JWT to create a new user record.

  4. Respond:

    • Generate and return tokens in a JSON response (HTTP 200 OK).

Uzyskiwanie identyfikatora klienta Google API

Podczas procesu rejestracji łączenia konta musisz podać identyfikator klienta interfejsu Google API. Aby uzyskać identyfikator klienta interfejsu API, użyj projektu utworzonego podczas wykonywania czynności związanych z łączeniem OAuth. Aby to zrobić, wykonaj te czynności:

  1. Otwórz stronę Klienci.

  2. Utwórz lub wybierz projekt interfejsów API Google.

    Jeśli w Twoim projekcie nie ma identyfikatora klienta dla typu aplikacji internetowej, kliknij Utwórz klienta, aby go utworzyć. W polu Autoryzowane źródła JavaScriptu podaj domenę swojej witryny. Podczas przeprowadzania testów lokalnych lub tworzenia aplikacji musisz dodać zarówno http://localhost, jak i http://localhost:<port_number> do pola Autoryzowane źródła JavaScript.

Sprawdzanie poprawności implementacji

Implementację możesz zweryfikować za pomocą narzędzia OAuth 2.0 Playground.

W narzędziu wykonaj te czynności:

  1. Kliknij Konfiguracja , aby otworzyć okno Konfiguracja OAuth 2.0.
  2. W polu OAuth flow (Proces OAuth) wybierz Client-side (Po stronie klienta).
  3. W polu Punkty końcowe OAuth wybierz Niestandardowe.
  4. W odpowiednich polach podaj punkt końcowy OAuth 2.0 i identyfikator klienta przypisany do Google.
  5. W sekcji Krok 1 nie wybieraj żadnych zakresów Google. Zamiast tego pozostaw to pole puste lub wpisz zakres ważny dla Twojego serwera (albo dowolny ciąg znaków, jeśli nie używasz zakresów OAuth). Gdy skończysz, kliknij Autoryzuj interfejsy API.
  6. W sekcjach Krok 2 i Krok 3 przejdź przez przepływ OAuth 2.0 i sprawdź, czy każdy krok działa zgodnie z oczekiwaniami.

Możesz sprawdzić, czy implementacja jest prawidłowa, korzystając z narzędzia Google Account Linking Demo.

W narzędziu wykonaj te czynności:

  1. Kliknij przycisk Zaloguj się przez Google.
  2. Wybierz konto, które chcesz połączyć.
  3. Wpisz identyfikator usługi.
  4. Opcjonalnie wpisz co najmniej jeden zakres, do którego chcesz uzyskać dostęp.
  5. Kliknij Uruchom wersję pokazową.
  6. Gdy pojawi się komunikat, potwierdź, że możesz wyrazić zgodę na prośbę o połączenie lub ją odrzucić.
  7. Sprawdź, czy nastąpiło przekierowanie na Twoją platformę.