Inicie sessão nos utilizadores com o Google

Este documento mostra como usar a Identity Platform para iniciar sessão de utilizadores com o Google.

Antes de começar

Este tutorial pressupõe que já ativou a Identity Platform e tem uma app Web básica escrita em HTML e JavaScript. Para saber como ativar o Identity Platform e iniciar sessão, consulte o Início rápido.

Configure o Google como fornecedor

Para configurar o Google como um Fornecedor de identidade:

1. Aceda à página Fornecedores de identidade na Google Cloud consola.

   Aceda à página Fornecedores de identidade

2. Clique em Adicionar um fornecedor.
3. Selecione Google na lista.
4. Introduza o seu ID de cliente Web e segredo Web do Google. Se ainda não tiver um ID e um segredo, pode obtê-los na página APIs e serviços.
5. Para permitir o acesso a partir de IDs de cliente externos, clique em Adicionar e adicione o seu ID de cliente.
6. Para configurar o ecrã de consentimento, clique em Configurar ecrã. A página da plataforma de autenticação da Google é aberta num separador separado.
7. Na página Google Auth Platform, configure o seu ecrã de consentimento OAuth.
8. Navegue novamente para a página Fornecedores de identidade. No painel lateral Definições do projeto, clique em Adicionar domínio e adicione o domínio da sua app.

   Recomendamos que não inclua localhost nos seus projetos de produção.

   Nota: para projetos criados antes de 28 de abril de 2025, localhost está ativado por predefinição.
9. Na secção Configure a sua aplicação, clique em Detalhes da configuração. Copie o fragmento para o código da sua app para inicializar o SDK do cliente do Identity Platform.
10. Clique em Guardar.

Inicie sessão nos utilizadores com o SDK do cliente

1. Crie uma instância do objeto do fornecedor Google:

   Versão Web 9

   import { GoogleAuthProvider } from "firebase/auth";
   
   const provider = new GoogleAuthProvider();
   auth_google_provider_create.js

   Versão Web 8

   var provider = new firebase.auth.GoogleAuthProvider();
   google-signin.js

2. Opcional: adicione âmbitos do OAuth. Os âmbitos especificam os dados que está a pedir à Google. Os dados mais confidenciais podem exigir âmbitos específicos. Consulte a documentação do fornecedor para determinar os âmbitos de que a sua app precisa.

   Versão Web 9

   provider.addScope('https://www.googleapis.com/auth/contacts.readonly');
   auth_google_provider_scopes.js

   Versão Web 8

   provider.addScope('https://www.googleapis.com/auth/contacts.readonly');
   google-signin.js

3. Opcional: localize o fluxo de autenticação. Pode especificar um idioma ou usar o idioma predefinido do dispositivo:

   Versão Web 9

   import { getAuth } from "firebase/auth";
   
   const auth = getAuth();
   auth.languageCode = 'it';
   // To apply the default browser preference instead of explicitly setting it.
   // auth.useDeviceLanguage();
   auth_set_language_code.js

   Versão Web 8

   firebase.auth().languageCode = 'it';
   // To apply the default browser preference instead of explicitly setting it.
   // firebase.auth().useDeviceLanguage();
   index.js

4. Opcional: especifique parâmetros de OAuth personalizados adicionais. Estes são específicos da Google e são normalmente usados para personalizar a experiência de autenticação. Não pode transmitir parâmetros reservados pelo OAuth ou pela Identity Platform.

   Versão Web 9

   provider.setCustomParameters({
     'login_hint': '[e-mail]'
   });
   auth_google_provider_params.js

   Versão Web 8

   provider.setCustomParameters({
     'login_hint': '[e-mail]'
   });
   google-signin.js

5. Use o objeto do fornecedor Google para iniciar sessão no utilizador. Pode abrir uma janela de pop-up ou redirecionar a página atual. O redirecionamento é mais fácil para os utilizadores em dispositivos móveis.

   Para mostrar um pop-up, chame signInWithPopup():

   Versão Web 9

   import { getAuth, signInWithPopup, GoogleAuthProvider } from "firebase/auth";
   
   const auth = getAuth();
   signInWithPopup(auth, provider)
     .then((result) => {
       // This gives you a Google Access Token. You can use it to access the Google API.
       const credential = GoogleAuthProvider.credentialFromResult(result);
       const token = credential.accessToken;
       // The signed-in user info.
       const user = result.user;
       // IdP data available using getAdditionalUserInfo(result)
       // ...
     }).catch((error) => {
       // Handle Errors here.
       const errorCode = error.code;
       const errorMessage = error.message;
       // The email of the user's account used.
       const email = error.customData.email;
       // The AuthCredential type that was used.
       const credential = GoogleAuthProvider.credentialFromError(error);
       // ...
     });
   auth_google_signin_popup.js

   Versão Web 8

   firebase.auth()
     .signInWithPopup(provider)
     .then((result) => {
       /** @type {firebase.auth.OAuthCredential} */
       var credential = result.credential;
   
       // This gives you a Google Access Token. You can use it to access the Google API.
       var token = credential.accessToken;
       // The signed-in user info.
       var user = result.user;
       // IdP data available in result.additionalUserInfo.profile.
         // ...
     }).catch((error) => {
       // Handle Errors here.
       var errorCode = error.code;
       var errorMessage = error.message;
       // The email of the user's account used.
       var email = error.email;
       // The firebase.auth.AuthCredential type that was used.
       var credential = error.credential;
       // ...
     });
   google-signin.js

   Para redirecionar a página, chame primeiro signInWithRedirect().

   Siga as práticas recomendadas quando usar signInWithRedirect, linkWithRedirect ou reauthenticateWithRedirect.

   Versão Web 9

   import { getAuth, signInWithRedirect } from "firebase/auth";
   
   const auth = getAuth();
   signInWithRedirect(auth, provider);
   auth_signin_redirect.js

   Versão Web 8

   firebase.auth().signInWithRedirect(provider);
   index.js

   Em seguida, obtenha o token Google chamando getRedirectResult() quando a página for carregada:

   Versão Web 9

   import { getAuth, getRedirectResult, GoogleAuthProvider } from "firebase/auth";
   
   const auth = getAuth();
   getRedirectResult(auth)
     .then((result) => {
       // This gives you a Google Access Token. You can use it to access Google APIs.
       const credential = GoogleAuthProvider.credentialFromResult(result);
       const token = credential.accessToken;
   
       // The signed-in user info.
       const user = result.user;
       // IdP data available using getAdditionalUserInfo(result)
       // ...
     }).catch((error) => {
       // Handle Errors here.
       const errorCode = error.code;
       const errorMessage = error.message;
       // The email of the user's account used.
       const email = error.customData.email;
       // The AuthCredential type that was used.
       const credential = GoogleAuthProvider.credentialFromError(error);
       // ...
     });
   auth_google_signin_redirect_result.js

   Versão Web 8

   firebase.auth()
     .getRedirectResult()
     .then((result) => {
       if (result.credential) {
         /** @type {firebase.auth.OAuthCredential} */
         var credential = result.credential;
   
         // This gives you a Google Access Token. You can use it to access the Google API.
         var token = credential.accessToken;
         // ...
       }
       // The signed-in user info.
       var user = result.user;
       // IdP data available in result.additionalUserInfo.profile.
         // ...
     }).catch((error) => {
       // Handle Errors here.
       var errorCode = error.code;
       var errorMessage = error.message;
       // The email of the user's account used.
       var email = error.email;
       // The firebase.auth.AuthCredential type that was used.
       var credential = error.credential;
       // ...
     });
   google-signin.js

Depois de ter um token de acesso, pode usá-lo para chamar a API Google. Por exemplo:

REST

curl -H "Authorization: Bearer [TOKEN]" https://www.googleapis.com/oauth2/v2/userinfo

Inicie sessão dos utilizadores manualmente

Se não quiser usar o SDK do cliente, também pode processar o fluxo de início de sessão manualmente:

1. Integre a autenticação Google na sua app seguindo os passos na respetiva documentação para programadores.
2. Inicie sessão no utilizador com o Google através do fluxo que implementou no passo anterior.
3. Troque o token que recebe da Google por uma credencial da Identity Platform:

   Versão Web 9

   import { GoogleAuthProvider } from "firebase/auth";
   
   const credential = GoogleAuthProvider.credential(idToken);
   auth_google_provider_credential.js

   Versão Web 8

   var credential = firebase.auth.GoogleAuthProvider.credential(idToken);
   google-signin.js

4. Use a credencial para iniciar sessão no utilizador com a Identity Platform:

   Versão Web 9

   import { getAuth, signInWithCredential } from "firebase/auth";
   
   // Sign in with the credential from the user.
   const auth = getAuth();
   signInWithCredential(auth, credential)
     .then((result) => {
       // Signed in 
       // ...
     })
     .catch((error) => {
       // Handle Errors here.
       const errorCode = error.code;
       const errorMessage = error.message;
       // The email of the user's account used.
       const email = error.customData.email;
       // ...
     });
   auth_signin_credential.js

   Versão Web 8

   // Sign in with the credential from the user.
   firebase.auth()
     .signInWithCredential(credential)
     .then((result) => {
       // Signed in 
       // ...
     })
     .catch((error) => {
       // Handle Errors here.
       const errorCode = error.code;
       const errorMessage = error.message;
       // The email of the user's account used.
       const email = error.email;
       // ...
     });
   index.js

O que se segue?

• Saiba mais acerca dos utilizadores da Identity Platform.
• Inicie sessão com utilizadores com outros fornecedores de identidade.