Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire la migrazione dall'accesso a Google+

Importante:l'ambito profile.emails.read è ora classificato come ambito sensibile. Puoi ottenere la stessa funzionalità con l'ambito OpenID Connect (OIDC) di email. Per ridurre al minimo l'impatto sui tuoi utenti, completa i passaggi di questa guida.

Se non completi questi passaggi, a qualsiasi utente con un token attivo che ha ancora accesso all'ambito che abbiamo eliminato gradualmente potrebbe essere visualizzata una schermata dell'app non verificata o un messaggio "Accesso disattivato" e ricevere un avviso del Centro sicurezza che invita il Centro sicurezza a rimuovere l'accesso rischioso ai propri dati. Questo accade perché l'utente ha un token attivo in cui l'ambito API non è più verificato. Se la tua applicazione non revoca il token come descritto nei passaggi prescritti, l'utente potrebbe continuare a ricevere un avviso.

Passaggi per ridurre al minimo l'impatto delle modifiche dell'ambito sugli utenti

Se la tua applicazione richiede l'indirizzo email di un utente autenticato e in precedenza hai utilizzato profile.emails.read per tale scopo, usa invece email.
Ottieni l'approvazione di profile.emails.read con una richiesta di verifica approvata. Consulta l'articolo Come faccio a richiedere la verifica?
Revoca il token dell'utente precedente all'ambito che deve essere rimosso oppure rimuovi completamente l'accesso all'applicazione. Ad esempio, un token con accesso profile.emails.read dovrebbe essere revocato. Ti consigliamo di applicare la revoca mentre gli utenti sono all'interno dell'applicazione, per poter ottenere immediatamente il consenso degli utenti.
Chiedi agli utenti di fornire nuovamente il consenso con il nuovo ambito, ad esempio email, senza profile.emails.read.
Rimuovi l'ambito da eliminare gradualmente dalla configurazione della schermata di consenso OAuth delle API di Google.

Le modifiche da apportare per eseguire la migrazione del sito dall'Accesso a Google+ dipendono dal flusso di accesso a Google+ che utilizzi. In genere, la migrazione richiede l'aggiornamento del pulsante di accesso, degli ambiti richiesti e delle istruzioni su come recuperare le informazioni del profilo da Google.

Quando aggiorni il pulsante di accesso, non fare riferimento a G+ e non utilizzare il colore rosso. Rispetta le nostre linee guida per il branding aggiornate.

La maggior parte delle applicazioni di Accesso a Google+ ha richiesto una combinazione degli ambiti: plus.login, plus.me e plus.profile.emails.read. Devi rimappare gli ambiti come segue:

Ambito precedente	Nuovo ambito
`plus.login`	`profile`
`plus.me`	`openid`
`plus.profile.emails.read`	`email`

Molti strumenti di implementazione della funzionalità Accesso a Google+ hanno utilizzato il flusso di codice. Ciò significa che le app per Android, iOS o JavaScript ricevono un codice OAuth da Google che il client restituisce al server, insieme alla protezione dalla falsificazione delle richieste tra siti. Il server convalida quindi il codice e ottiene i token di aggiornamento e di accesso per estrarre le informazioni del profilo utente dall'API people.get.

Google ora consiglia di richiedere un token ID e di inviarlo dal client al server. I token ID hanno protezioni dalla contraffazione tra siti integrate e possono inoltre essere verificati in modo statico sul server, evitando chiamate API aggiuntive per ottenere le informazioni del profilo dell'utente dai server di Google. Segui le istruzioni per convalidare i token ID sul tuo server.

Se preferisci comunque utilizzare il flusso di codice per ottenere le informazioni del profilo, puoi farlo. Una volta che il server dispone di un token di accesso, devi ottenere le informazioni del profilo utente dagli endpoint userinfo specificati nel nostro documento di rilevamento per l'accesso. La risposta dell'API è formattata in modo diverso rispetto alla risposta del profilo Google+, quindi devi aggiornare l'analisi nel nuovo formato.

Eseguire la migrazione di un pulsante di accesso HTML

Se hai incluso nella pagina un pulsante Accedi con Google+ assegnando il corso g-signin a un elemento, apporta le seguenti modifiche:

Quando specifichi il tuo ID client in un tag <meta>, un attributo data- o un oggetto parametri, modifica la stringa clientid in client_id, come nell'esempio seguente:

<!-- Google+ Sign-in (old) -->
<meta name="google-signin-clientid" content="YOUR_CLIENT_ID">

<!-- Google Sign-in (new) -->
<meta name="google-signin-client_id" content="YOUR_CLIENT_ID">

Assegna la classe g-signin2 all'elemento pulsante di accesso anziché g-signin. Inoltre, specifica callback di operazione riuscita e non riuscita anziché un singolo callback, come nell'esempio seguente:

<!-- Google+ Sign-in (old) -->
<div
  class="g-signin"
  data-callback="signinCallback">
</div>

<!-- Google Sign-in (new) -->
<div
  class="g-signin2"
  data-onsuccess="onSignIn"
  data-onfailure="onSignInFailure">
</div>

Anziché un singolo gestore di callback, definisci i gestori di operazioni riuscite e non riuscite, come illustrato nell'esempio seguente:

// Google+ Sign-in (old)
function signinCallback(authResult) {
  if (authResult['status']['signed_in']) {
    // Handle successful sign-in
  } else {
    // Handle sign-in errors
    console.log('Sign-in error: ' + authResult['error']);
  }
}

// Google Sign-in (new)
function onSignIn(googleUser) {
  // Handle successful sign-in
}
function onSignInFailure() {
  // Handle sign-in errors
}

Queste modifiche aggiornano gli ambiti predefiniti a profile email openid. Puoi ottenere le informazioni di base del profilo dell'utente, come nome, email e URL della foto, nel seguente modo:

// Google Sign-in (new)
function onSignIn(googleUser) {
  let profile = googleUser.getBasicProfile();
  let fullName = profile.getName();
  let email = profile.getEmail();
  let imageUrl = profile.getImageUrl();
}

Eseguire la migrazione di un pulsante di accesso con rendering dinamico

Se hai incluso un pulsante Accesso a Google+ nella tua pagina chiamando il numero gapi.signin.render(), apporta le seguenti modifiche:

Quando specifichi il tuo ID client in un tag <meta>, un attributo data- o un oggetto parametri, modifica la stringa clientid in client_id, come nell'esempio seguente:

<!-- Google+ Sign-in (old) -->
<meta name="google-signin-clientid" content="YOUR_CLIENT_ID">

<!-- Google Sign-in (new) -->
<meta name="google-signin-client_id" content="YOUR_CLIENT_ID">

Visualizza il pulsante di accesso con gapi.signin2.render() anziché gapi.signin.render(), come nell'esempio seguente:

// Google+ Sign-in (old)
gapi.signin.render('myButton', additionalParams);

// Google Sign-in (new)
gapi.signin2.render('myButton', additionalParams);

Anziché un singolo gestore di callback, definisci i gestori di operazioni riuscite e non riuscite, come illustrato nell'esempio seguente:

// Google+ Sign-in (old)
function signinCallback(authResult) {
  if (authResult['status']['signed_in']) {
    // Handle successful sign-in
  } else {
    // Handle sign-in errors
    console.log('Sign-in error: ' + authResult['error']);
  }
}

// Google Sign-in (new)
function onSignIn(googleUser) {
  // Handle successful sign-in
}
function onSignInFailure() {
  // Handle sign-in errors
}

Queste modifiche aggiornano gli ambiti predefiniti a profile email openid. Puoi ottenere le informazioni di base del profilo di base dell'utente con il metodo getBasicProfile().

Eseguire la migrazione di un flusso di accesso avviato da JavaScript

Se hai avviato il flusso di accesso con una chiamata al numero gapi.auth.signIn() quando gli utenti fanno clic sul pulsante di accesso, apporta le seguenti modifiche:

Quando specifichi il tuo ID client in un tag <meta>, un attributo data- o un oggetto parametri, modifica la stringa clientid in client_id, come nell'esempio seguente:

<!-- Google+ Sign-in (old) -->
<meta name="google-signin-clientid" content="YOUR_CLIENT_ID">

<!-- Google Sign-in (new) -->
<meta name="google-signin-client_id" content="YOUR_CLIENT_ID">

Utilizza gapi.auth2.attachClickHandler() per avviare il flusso di accesso quando viene premuto un pulsante, come nell'esempio seguente:

// Google+ Sign-in (old)
var signinButton = document.getElementById('signinButton');
signinButton.addEventListener('click', function() {
  gapi.auth.signIn(additionalParams);
});

// Google Sign-in (new)
auth2 = gapi.auth2.init();
auth2.attachClickHandler('signinButton', additionalParams, onSignIn, onSignInFailure);

Anziché un singolo gestore di callback, definisci i gestori di operazioni riuscite e non riuscite, come illustrato nell'esempio seguente:

// Google+ Sign-in (old)
function signinCallback(authResult) {
  if (authResult['status']['signed_in']) {
    // Handle successful sign-in
  } else {
    // Handle sign-in errors
    console.log('Sign-in error: ' + authResult['error']);
  }
}

// Google Sign-in (new)
function onSignIn(googleUser) {
  // Handle successful sign-in
}
function onSignInFailure() {
  // Handle sign-in errors
}

Queste modifiche aggiornano gli ambiti predefiniti a profile email openid. Puoi recuperare le informazioni di base del profilo dell'utente tramite una chiamata al metodo getBasicProfile().

Esegui la migrazione di un flusso lato server ibrido

Se hai utilizzato l'API JavaScript per acquisire un codice di autorizzazione una tantum da trasmettere al server, apporta le seguenti modifiche:

Modifica l'ambito da https://www.googleapis.com/auth/plus.login a profile.

Utilizza il metodo gapi.auth2.grantOfflineAccess() con la funzione di callback esistente, come nell'esempio seguente:

<!-- Google+ Sign-in (old) -->
<div class="g-signin"
  data-scope="https://www.googleapis.com/auth/plus.login"
  data-clientid="YOUR_CLIENT_ID"
  data-redirecturi="postmessage"
  data-accesstype="offline"
  data-callback="signInCallback">
</div>

// Google Sign-in (new)
auth2 = gapi.auth2.init({
  client_id: 'YOUR_CLIENT_ID',
  scope: 'profile'
});

...

auth2.grantOfflineAccess().then(signInCallback);

Se hai bisogno di accedere anche all'email dell'utente, aggiungi email al parametro di ambito.