Panoramica
Il collegamento semplificato di Accedi con Google basato su OAuth aggiunge Accedi con Google oltre ad altre funzionalità. Collegamento OAuth. Ciò fornisce un'esperienza di collegamento perfetta per Per gli utenti Google e consente anche la creazione di account, che consente all'utente di creare un nuovo account sul tuo servizio utilizzando il proprio Account Google.
Per eseguire il collegamento dell'account con OAuth e Accedi con Google, segui queste informazioni generali passaggi:
- Per prima cosa, chiedi all'utente di dare il consenso per accedere al suo profilo Google.
- Utilizzare le informazioni presenti nel profilo dell'utente per verificare se l'account utente esiste.
- Per gli utenti esistenti, collega gli account.
- Se non riesci a trovare una corrispondenza per l'utente Google nel tuo sistema di autenticazione, convalidare il token ID ricevuto da Google. Puoi quindi creare un'interfaccia utente nelle informazioni del profilo contenute nel token ID.
Figura 1. Collegamento dell'account sullo smartphone di un utente con Collegamento semplificato
Requisiti per il collegamento semplificato
- Implementare il flusso di collegamento OAuth web di base. Il servizio deve supportare la conformità a OAuth 2.0 endpoint di autorizzazione e di scambio di token.
- L'endpoint di scambio di token deve supportare le asserzioni del token web JSON (JWT) e implementare gli intent
check
,create
eget
.
Implementare il server OAuth
L'endpoint per lo scambio di token deve supportare gli intent check
, create
e get
. Di seguito sono riportati i passaggi completati durante la procedura di collegamento dell'account e viene indicato quando vengono richiamati i diversi intent:
- L'utente dispone di un account nel tuo sistema di autenticazione? (L'utente decide selezionando SÌ o NO)
- SÌ : l'utente utilizza l'indirizzo email associato al proprio Account Google per accedere alla piattaforma? (L'utente decide selezionando SÌ o NO)
- SÌ : l'utente dispone di un account corrispondente nel tuo sistema di autenticazione? (
check intent
viene chiamato per confermare)- SÌ :
get intent
viene chiamato e l'account viene collegato se la richiesta di ritorno per intenzione riesce. - NO : creare un nuovo account? (L'utente decide selezionando SÌ o NO)
- SÌ :
create intent
viene chiamato e l'account viene collegato se la funzionalità di creazione dell'intent viene restituita correttamente. - NO : viene attivato il flusso OAuth per il web, l'utente viene indirizzato al browser e gli viene offerta la possibilità di collegarsi a un indirizzo email diverso.
- SÌ :
- SÌ :
- NO : viene attivato il flusso OAuth web, l'utente viene indirizzato al browser e gli viene offerta la possibilità di collegarsi a un'altra email.
- SÌ : l'utente dispone di un account corrispondente nel tuo sistema di autenticazione? (
- NO : l'utente dispone di un account corrispondente nel tuo sistema di autenticazione? (
check intent
viene chiamato per confermare)- SÌ :
get intent
viene chiamato e l'account viene collegato se la richiesta di ritorno per intenzione riesce. - NO :
create intent
viene chiamato e l'account viene collegato se la funzionalità di creazione dell'intent viene restituita correttamente.
- SÌ :
- SÌ : l'utente utilizza l'indirizzo email associato al proprio Account Google per accedere alla piattaforma? (L'utente decide selezionando SÌ o NO)
Verificare la presenza di un account utente esistente (check intent)
Dopo che l'utente acconsente ad accedere al proprio profilo Google, Google invia una contenente un'asserzione firmata dell'identità dell'utente Google. La l'asserzione contiene informazioni che includono l'ID dell'Account Google dell'utente, nome e indirizzo email. L'endpoint di scambio di token configurato per il progetto gestisce la richiesta.
Se l'Account Google corrispondente è già presente nella tua autenticazione
di sistema, il tuo endpoint di scambio di token risponde con account_found=true
. Se
L'Account Google non corrisponde a un utente esistente, il tuo endpoint di scambio di token
restituisce un errore HTTP 404 - Non trovato con account_found=false
.
La richiesta ha il seguente modulo:
POST /token HTTP/1.1 Host: oauth2.example.com Content-Type: application/x-www-form-urlencoded grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&intent=check&assertion=JWT&scope=SCOPES&client_id=GOOGLE_CLIENT_ID&client_secret=GOOGLE_CLIENT_SECRET
L'endpoint di scambio di token deve essere in grado di gestire i seguenti parametri:
Parametri endpoint token | |
---|---|
intent |
Per queste richieste, il valore di questo parametro è
check . |
grant_type |
Il tipo di token che viene scambiato. Per queste richieste,
ha il valore urn:ietf:params:oauth:grant-type:jwt-bearer . |
assertion |
un token JWT (JSON Web Token) che fornisce un'asserzione firmata dei l'identità dell'utente. Il JWT contiene informazioni che includono il ID dell'Account Google, nome e indirizzo email. |
client_id |
L'ID client che hai assegnato a Google. |
client_secret |
Il client secret che hai assegnato a Google. |
Per rispondere alle richieste di intent check
, l'endpoint dello scambio di token deve eseguire i seguenti passaggi:
- Convalida e decodifica l'asserzione JWT.
- Verifica se l'Account Google è già presente nel sistema di autenticazione.
convalida e decodifica l'asserzione JWT
Puoi convalidare e decodificare l'asserzione JWT utilizzando un Libreria di decodifica JWT per la tua lingua. Utilizza le funzionalità di Chiavi pubbliche di Google, disponibili in JWK o formati PEM, per verificare la firma del token.
Una volta decodificata, l'asserzione JWT è simile all'esempio seguente:
{ "sub": "1234567890", // The unique ID of the user's Google Account "iss": "https://accounts.google.com", // The assertion's issuer "aud": "123-abc.apps.googleusercontent.com", // Your server's client ID "iat": 233366400, // Unix timestamp of the assertion's creation time "exp": 233370000, // Unix timestamp of the assertion's expiration time "name": "Jan Jansen", "given_name": "Jan", "family_name": "Jansen", "email": "jan@gmail.com", // If present, the user's email address "email_verified": true, // true, if Google has verified the email address "hd": "example.com", // If present, the host domain of the user's GSuite email address // If present, a URL to user's profile picture "picture": "https://lh3.googleusercontent.com/a-/AOh14GjlTnZKHAeb94A-FmEbwZv7uJD986VOF1mJGb2YYQ", "locale": "en_US" // User's locale, from browser or phone settings }
Oltre a verificare la firma del token, verifica che l'asserzione
l'emittente (campo iss
) è https://accounts.google.com
, che il pubblico
(campo aud
) è l'ID cliente che ti è stato assegnato e che il token non è scaduto
(campo exp
).
Utilizzando i campi email
, email_verified
e hd
puoi determinare se
Google ospita un indirizzo email ed è autorevole. Nei casi in cui Google
ufficiale che l'utente sia attualmente noto per essere il legittimo proprietario dell'account
e puoi saltare l'uso della password o altri metodi di verifica. In caso contrario, questi metodi
può essere utilizzato per verificare l'account prima del collegamento.
Casi in cui Google è autorevole:
email
ha un suffisso@gmail.com
, questo è un account Gmail.email_verified
è true ehd
è impostato, questo è un account G Suite.
Gli utenti possono registrarsi per creare Account Google senza utilizzare Gmail o G Suite. Quando
email
non contiene un suffisso @gmail.com
e hd
non è presente
autoritativi e con password o altri metodi di verifica per verificare
per l'utente. Il valore email_verified
può anche essere vero perché Google ha verificato inizialmente il valore
all'utente quando è stato creato l'account Google, ma la proprietà della terza parte
l'account email potrebbe essere cambiato da allora.
Controllare se l'Account Google è già presente nel sistema di autenticazione
Controlla se è vera una delle seguenti condizioni:
- L'ID Account Google, che si trova nel campo
sub
dell'asserzione, è nel tuo utente per configurare un database. - L'indirizzo email nell'asserzione corrisponde a un utente nel tuo database utenti.
Se una delle condizioni è vera, l'utente ha già effettuato la registrazione. In questo caso, restituiscono una risposta simile alla seguente:
HTTP/1.1 200 Success Content-Type: application/json;charset=UTF-8 { "account_found":"true", }
Se né l'ID Account Google né l'indirizzo email specificato nella
asserzione corrisponde a un utente presente nel tuo database, l'utente non si è ancora registrato. Nella
In questo caso, l'endpoint di scambio di token deve rispondere con un errore HTTP 404.
che specifica "account_found": "false"
, come nell'esempio seguente:
HTTP/1.1 404 Not found Content-Type: application/json;charset=UTF-8 { "account_found":"false", }
Gestire il collegamento automatico (ottenere l'intenzione)
Dopo che l'utente acconsente ad accedere al proprio profilo Google, Google invia una contenente un'asserzione firmata dell'identità dell'utente Google. La l'asserzione contiene informazioni che includono l'ID dell'Account Google dell'utente, nome e indirizzo email. L'endpoint di scambio di token configurato per il progetto gestisce la richiesta.
Se l'Account Google corrispondente è già presente nell'autenticazione
il tuo endpoint di scambio di token restituisce un token per l'utente. Se
L'Account Google non corrisponde a un utente esistente, il tuo endpoint di scambio di token
restituisce un errore linking_error
e un valore facoltativo per il campo login_hint
.
La richiesta ha il seguente modulo:
POST /token HTTP/1.1 Host: oauth2.example.com Content-Type: application/x-www-form-urlencoded grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&intent=get&assertion=JWT&scope=SCOPES&client_id=GOOGLE_CLIENT_ID&client_secret=GOOGLE_CLIENT_SECRET
L'endpoint di scambio di token deve essere in grado di gestire i seguenti parametri:
Parametri endpoint token | |
---|---|
intent |
Per queste richieste, il valore di questo parametro è get . |
grant_type |
Il tipo di token che viene scambiato. Per queste richieste,
ha il valore urn:ietf:params:oauth:grant-type:jwt-bearer . |
assertion |
un token JWT (JSON Web Token) che fornisce un'asserzione firmata dei l'identità dell'utente. Il JWT contiene informazioni che includono il ID dell'Account Google, nome e indirizzo email. |
scope |
Facoltativo:tutti gli ambiti che hai configurato per le richieste da parte di Google utenti. |
client_id |
L'ID client che hai assegnato a Google. |
client_secret |
Il client secret che hai assegnato a Google. |
Per rispondere alle richieste di intent get
, l'endpoint dello scambio di token deve eseguire i seguenti passaggi:
- Convalida e decodifica l'asserzione JWT.
- Verifica se l'Account Google è già presente nel sistema di autenticazione.
convalida e decodifica l'asserzione JWT
Puoi convalidare e decodificare l'asserzione JWT utilizzando un Libreria di decodifica JWT per la tua lingua. Utilizza le funzionalità di Chiavi pubbliche di Google, disponibili in JWK o formati PEM, per verificare la firma del token.
Una volta decodificata, l'asserzione JWT è simile all'esempio seguente:
{ "sub": "1234567890", // The unique ID of the user's Google Account "iss": "https://accounts.google.com", // The assertion's issuer "aud": "123-abc.apps.googleusercontent.com", // Your server's client ID "iat": 233366400, // Unix timestamp of the assertion's creation time "exp": 233370000, // Unix timestamp of the assertion's expiration time "name": "Jan Jansen", "given_name": "Jan", "family_name": "Jansen", "email": "jan@gmail.com", // If present, the user's email address "email_verified": true, // true, if Google has verified the email address "hd": "example.com", // If present, the host domain of the user's GSuite email address // If present, a URL to user's profile picture "picture": "https://lh3.googleusercontent.com/a-/AOh14GjlTnZKHAeb94A-FmEbwZv7uJD986VOF1mJGb2YYQ", "locale": "en_US" // User's locale, from browser or phone settings }
Oltre a verificare la firma del token, verifica che l'asserzione
l'emittente (campo iss
) è https://accounts.google.com
, che il pubblico
(campo aud
) è l'ID cliente che ti è stato assegnato e che il token non è scaduto
(campo exp
).
Utilizzando i campi email
, email_verified
e hd
puoi determinare se
Google ospita un indirizzo email ed è autorevole. Nei casi in cui Google
ufficiale che l'utente sia attualmente noto per essere il legittimo proprietario dell'account
e puoi saltare l'uso della password o altri metodi di verifica. In caso contrario, questi metodi
può essere utilizzato per verificare l'account prima del collegamento.
Casi in cui Google è autorevole:
email
ha un suffisso@gmail.com
, questo è un account Gmail.email_verified
è true ehd
è impostato, questo è un account G Suite.
Gli utenti possono registrarsi per creare Account Google senza utilizzare Gmail o G Suite. Quando
email
non contiene un suffisso @gmail.com
e hd
non è presente
autoritativi e con password o altri metodi di verifica per verificare
per l'utente. Il valore email_verified
può anche essere vero perché Google ha verificato inizialmente il valore
all'utente quando è stato creato l'account Google, ma la proprietà della terza parte
l'account email potrebbe essere cambiato da allora.
Controllare se l'Account Google è già presente nel sistema di autenticazione
Controlla se è vera una delle seguenti condizioni:
- L'ID Account Google, che si trova nel campo
sub
dell'asserzione, è nel tuo utente per configurare un database. - L'indirizzo email nell'asserzione corrisponde a un utente nel tuo database utenti.
Se viene trovato un account per l'utente, invia un token di accesso e restituisci i valori in un oggetto JSON nel corpo della risposta HTTPS, come nell'esempio seguente:
{ "token_type": "Bearer", "access_token": "ACCESS_TOKEN", "expires_in": SECONDS_TO_EXPIRATION }
In alcuni casi, il collegamento dell'account basato sul token ID potrebbe non riuscire per l'utente. Se
lo fa per qualsiasi motivo, l'endpoint di scambio di token deve rispondere con un
Errore 401 che specifica error=linking_error
, come mostrato nell'esempio seguente:
HTTP/1.1 401 Unauthorized Content-Type: application/json;charset=UTF-8 { "error":"linking_error", "login_hint":"foo@bar.com" }
Quando Google riceve una risposta di errore 401 con linking_error
, invia
l'utente all'endpoint di autorizzazione con login_hint
come parametro. La
l'utente completa il collegamento dell'account utilizzando il flusso di collegamento OAuth nel proprio browser.
Gestire la creazione di account tramite Accedi con Google (creazione di un intent)
Quando un utente deve creare un account nel tuo servizio, Google effettua una richiesta
all'endpoint di scambio di token che specifica intent=create
.
La richiesta ha il seguente modulo:
POST /token HTTP/1.1 Host: oauth2.example.com Content-Type: application/x-www-form-urlencoded response_type=token&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&scope=SCOPES&intent=create&assertion=JWT&client_id=GOOGLE_CLIENT_ID&client_secret=GOOGLE_CLIENT_SECRET
L'endpoint di scambio di token deve essere in grado di gestire i seguenti parametri:
Parametri endpoint token | |
---|---|
intent |
Per queste richieste, il valore di questo parametro è create . |
grant_type |
Il tipo di token che viene scambiato. Per queste richieste,
ha il valore urn:ietf:params:oauth:grant-type:jwt-bearer . |
assertion |
un token JWT (JSON Web Token) che fornisce un'asserzione firmata dei l'identità dell'utente. Il JWT contiene informazioni che includono il ID dell'Account Google, nome e indirizzo email. |
client_id |
L'ID client che hai assegnato a Google. |
client_secret |
Il client secret che hai assegnato a Google. |
Il JWT all'interno del parametro assertion
contiene l'ID dell'Account Google dell'utente,
nome e indirizzo email che potrai utilizzare per creare un nuovo account sul tuo
completamente gestito di Google Cloud.
Per rispondere alle richieste di intent create
, l'endpoint dello scambio di token deve eseguire i seguenti passaggi:
- Convalida e decodifica l'asserzione JWT.
- Convalida le informazioni dell'utente e crea un nuovo account.
convalida e decodifica l'asserzione JWT
Puoi convalidare e decodificare l'asserzione JWT utilizzando un Libreria di decodifica JWT per la tua lingua. Utilizza le funzionalità di Chiavi pubbliche di Google, disponibili in JWK o formati PEM, per verificare la firma del token.
Una volta decodificata, l'asserzione JWT è simile all'esempio seguente:
{ "sub": "1234567890", // The unique ID of the user's Google Account "iss": "https://accounts.google.com", // The assertion's issuer "aud": "123-abc.apps.googleusercontent.com", // Your server's client ID "iat": 233366400, // Unix timestamp of the assertion's creation time "exp": 233370000, // Unix timestamp of the assertion's expiration time "name": "Jan Jansen", "given_name": "Jan", "family_name": "Jansen", "email": "jan@gmail.com", // If present, the user's email address "email_verified": true, // true, if Google has verified the email address "hd": "example.com", // If present, the host domain of the user's GSuite email address // If present, a URL to user's profile picture "picture": "https://lh3.googleusercontent.com/a-/AOh14GjlTnZKHAeb94A-FmEbwZv7uJD986VOF1mJGb2YYQ", "locale": "en_US" // User's locale, from browser or phone settings }
Oltre a verificare la firma del token, verifica che l'asserzione
l'emittente (campo iss
) è https://accounts.google.com
, che il pubblico
(campo aud
) è l'ID cliente che ti è stato assegnato e che il token non è scaduto
(campo exp
).
Utilizzando i campi email
, email_verified
e hd
puoi determinare se
Google ospita un indirizzo email ed è autorevole. Nei casi in cui Google
ufficiale che l'utente sia attualmente noto per essere il legittimo proprietario dell'account
e puoi saltare l'uso della password o altri metodi di verifica. In caso contrario, questi metodi
può essere utilizzato per verificare l'account prima del collegamento.
Casi in cui Google è autorevole:
email
ha un suffisso@gmail.com
, questo è un account Gmail.email_verified
è true ehd
è impostato, questo è un account G Suite.
Gli utenti possono registrarsi per creare Account Google senza utilizzare Gmail o G Suite. Quando
email
non contiene un suffisso @gmail.com
e hd
non è presente
autoritativi e con password o altri metodi di verifica per verificare
per l'utente. Il valore email_verified
può anche essere vero perché Google ha verificato inizialmente il valore
all'utente quando è stato creato l'account Google, ma la proprietà della terza parte
l'account email potrebbe essere cambiato da allora.
Convalida le informazioni dell'utente e crea un nuovo account
Controlla se è vera una delle seguenti condizioni:
- L'ID Account Google, che si trova nel campo
sub
dell'asserzione, è nel tuo utente per configurare un database. - L'indirizzo email nell'asserzione corrisponde a un utente nel tuo database utenti.
Se una delle condizioni è vera, chiedi all'utente di collegare il suo account esistente
con il proprio Account Google. Per farlo, rispondi alla richiesta con un errore HTTP 401
che specifica error=linking_error
e fornisce l'indirizzo email dell'utente come
login_hint
. Di seguito è riportato un esempio di risposta:
HTTP/1.1 401 Unauthorized Content-Type: application/json;charset=UTF-8 { "error":"linking_error", "login_hint":"foo@bar.com" }
Quando Google riceve una risposta di errore 401 con linking_error
, invia
l'utente all'endpoint di autorizzazione con login_hint
come parametro. La
l'utente completa il collegamento dell'account utilizzando il flusso di collegamento OAuth nel proprio browser.
Se nessuna delle due condizioni è vera, crea un nuovo account utente con le informazioni forniti nel JWT. In genere per i nuovi account non è impostata una password. È ti consigliamo di aggiungere Accedi con Google ad altre piattaforme per consentire agli utenti di accedere con Google sulle piattaforme della tua applicazione. In alternativa, puoi inviare all'utente via email un link che avvia la procedura di recupero della password per consentire di impostare una password per accedere su altre piattaforme.
Al termine della creazione, invia un token di accesso e restituisce i valori in un oggetto JSON in il corpo della risposta HTTPS, come nell'esempio seguente:
{ "token_type": "Bearer", "access_token": "ACCESS_TOKEN", "expires_in": SECONDS_TO_EXPIRATION }
Ottenere l'ID client API di Google
Ti verrà chiesto di fornire il tuo ID client API di Google durante la procedura di registrazione al collegamento degli account.
Per ottenere il tuo ID client API tramite il progetto che hai creato durante il completamento dei passaggi di collegamento OAuth. Per farlo, segui questa procedura.
- Apri la pagina Credentials (Credenziali) della Console API di Google.
Crea o seleziona un progetto delle API di Google.
Se il progetto non ha un ID client per il tipo di applicazione web, fai clic su Crea le credenziali > ID client OAuth per crearne uno. Assicurati di includere al dominio del tuo sito nella casella Origini JavaScript autorizzate. Quando esegui per i test o lo sviluppo locale, devi aggiungere sia
http://localhost
http://localhost:<port_number>
al campo Origini JavaScript autorizzate.
Convalida dell'implementazione
您可以通过使用验证实现的OAuth 2.0游乐场工具。
在工具中,执行以下步骤:
- 单击配置 打开的OAuth 2.0配置窗口。
- 在OAuth流场中,选择客户端。
- 在OAuth端点字段中,选择自定义。
- 在相应字段中指定您的 OAuth 2.0 端点和您分配给 Google 的客户端 ID。
- 在步骤1部分,不要选择任何谷歌范围。相反,将此字段留空或键入对您的服务器有效的范围(如果不使用 OAuth 范围,则输入任意字符串)。当您完成后,单击授权的API。
- 在步骤2和步骤3段,完成OAuth 2.0流程和验证每个步骤按预期工作。
您可以通过验证您的实现谷歌帐户链接演示工具。
在工具中,执行以下步骤:
- 点击登录在与谷歌按钮。
- 选择您要关联的帐户。
- 输入服务标识。
- (可选)输入您将请求访问的一个或多个范围。
- 单击开始演示。
- 出现提示时,确认您可以同意并拒绝链接请求。
- 确认您被重定向到您的平台。