O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Conecte seu aplicativo ao emulador de autenticação

Antes de usar o emulador de autenticação com seu aplicativo, certifique-se de compreender o fluxo de trabalho geral do Firebase Local Emulator Suite e de instalar e configurar o Local Emulator Suite.

O que posso fazer com o emulador de autenticação?

O emulador de autenticação fornece emulação local de alta fidelidade dos serviços do Firebase Authentication, fornecendo muitas das funcionalidades encontradas na produção do Firebase Authentication . Emparelhado com os SDKs do Firebase para iOS, Android e web, o emulador permite:

  • Crie, atualize e gerencie contas de usuário emuladas para testar e-mail / senha, número de telefone / SMS e login com provedores de identidade de terceiros (como o Google)
  • Ver e editar usuários emulados
  • Verifique as mensagens relacionadas à autenticação na guia Logs de IU do emulador.

Instrumentar seu aplicativo para falar com o emulador de autenticação

Android, iOS e SDKs da web

Defina sua configuração no aplicativo ou classes de teste para interagir com o emulador de autenticação da seguinte maneira.

Android
FirebaseAuth.getInstance().useEmulator('10.0.2.2', 9099);
iOS - Swift
Auth.auth().useEmulator(withHost:"localhost", port:9099)

Web v8

var auth = firebase.auth();
auth.useEmulator("http://localhost:9099");
emulator-suite.js

Web v9

import { getAuth, useAuthEmulator } from "firebase/auth";

const auth = getAuth();
useAuthEmulator(auth, "http://localhost:9099");
auth_emulator_connect.js

Nenhuma configuração adicional é necessária para prototipar e testar as interações entre Authentication e Cloud Functions ou Firebase Security Rules para Cloud Firestore ou Realtime Database. Quando o emulador de autenticação é configurado e outros emuladores estão em execução, eles trabalham juntos automaticamente.

SDK Admin

O SDK Admin do Firebase se conecta automaticamente ao emulador de autenticação quando a variável de ambiente FIREBASE_AUTH_EMULATOR_HOST é definida.

export FIREBASE_AUTH_EMULATOR_HOST="localhost:9099"

Observe que o emulador do Cloud Functions reconhece automaticamente o emulador do Authentication, então você pode pular esta etapa ao testar as integrações entre o Cloud Functions e os emuladores do Authentication. A variável de ambiente será definida automaticamente para o SDK Admin no Cloud Functions.

Com a variável de ambiente definida, os SDKs Admin do Firebase aceitarão tokens de ID não assinados e cookies de sessão emitidos pelo emulador de autenticação (por verifyIdToken createSessionCookie métodos createSessionCookie e createSessionCookie respectivamente) para facilitar o desenvolvimento e os testes locais. Certifique-se de não definir a variável de ambiente na produção.

Ao se conectar ao emulador de autenticação, você precisará especificar um ID de projeto. Você pode passar um ID de projeto para initializeApp diretamente ou definir a variável de ambiente GCLOUD_PROJECT . Observe que você não precisa usar seu ID de projeto real do Firebase; o emulador de autenticação aceitará qualquer ID de projeto.

SDK Admin para Node.js
admin.initializeApp({ projectId: "your-project-id" });
Variável de ambiente
export GCLOUD_PROJECT="your-project-id"

Tokens de identificação

Por motivos de segurança, o emulador de autenticação emite tokens de ID não assinados , que só são aceitos por outros emuladores do Firebase ou pelo SDK Admin do Firebase quando configurados . Esses tokens serão rejeitados pelos serviços de produção do Firebase ou pelo SDK Admin do Firebase em execução no modo de produção (por exemplo, o comportamento padrão sem as etapas de configuração descritas acima).

Para começar a prototipagem interativa com o emulador de autenticação e a IU do Emulator Suite, inicie o Firebase Local Emulator Suite.

firebase emulators:start

Para autenticação anônima , seu aplicativo pode exercer a lógica de login para sua plataforma ( iOS , Android , web ).

Para autenticação de e-mail / senha , você pode iniciar a prototipagem adicionando contas de usuário ao emulador de autenticação de seu aplicativo usando métodos SDK de autenticação ou usando a interface do usuário do Emulator Suite.

  1. Na IU do Emulator Suite, clique na guia Autenticação .
  2. Clique no botão Adicionar usuário .
  3. Siga o assistente de criação de conta de usuário, preenchendo os campos de autenticação de e-mail.

Com um usuário de teste criado, seu aplicativo pode conectar e desconectar o usuário com a lógica SDK para sua plataforma ( iOS , Android , web ).

Para testar a verificação / login de e-mail com fluxos de link de e-mail, o emulador imprime um URL no terminal no qual os firebase emulators:start foram executados.

i  To verify the email address customer@ex.com, follow this link:
http://localhost:9099/emulator/action?mode=verifyEmail&lang=en&oobCode=XYZ123&apiKey=fake-api-key

Cole o link em seu navegador para simular o evento de verificação e verifique se a verificação foi bem-sucedida.

{
  "authEmulator": {
    "success": "The email has been successfully verified.",
    "email": "customer@example.com"
  }
}

Para testar redefinições de senha, o emulador imprime uma URL semelhante, incluindo um parâmetro newPassword (que você pode alterar conforme necessário), no terminal.

http://localhost:9099/emulator/action?mode=resetPassword&oobCode=XYZ!23&apiKey=fake-api-key&newPassword=YOUR_NEW_PASSWORD

Teste não interativo

Em vez de usar o Emulator Suite UI ou código de cliente para gerenciar contas de usuário de e-mail / senha, você pode escrever scripts de configuração de teste que chamam APIs REST para criar e excluir contas de usuário e buscar códigos de verificação de e-mail fora da banda para preencher a verificação de e-mail do emulador URL Isso mantém a plataforma e o código de teste separados e permite que você teste de forma não interativa.

Para fluxos de teste de senha e email não interativos, a sequência típica é a seguinte.

  1. Crie usuários com o ponto de extremidade REST de inscrição de autenticação.
  2. Faça login de usuários usando e-mails e senhas para realizar testes.
  3. Se aplicável aos seus testes, busque os códigos de verificação de e-mail fora de banda disponíveis no endpont REST específico do emulador .
  4. Libere os registros do usuário com o ponto de extremidade REST específico do emulador para limpar os dados.

Autenticação de telefone / SMS emulada

Para autenticação por telefone, o emulador Auth não oferece suporte a:

  • Fluxos de reCAPTCHA e APN. Depois de configurados para interagir com o emulador, os SDKs do cliente desabilitam esses métodos de verificação de maneira semelhante à descrita para o teste de integração ( iOS , Android , web ).
  • Teste os números de telefone com códigos pré-configurados no console do Firebase.

Caso contrário, em termos de código do cliente, o fluxo de autenticação por telefone / SMS é idêntico ao descrito para produção ( iOS , Android , web ).

Usando a IU do Emulator Suite:

  1. Na IU do Emulator Suite, clique na guia Autenticação .
  2. Clique no botão Adicionar usuário .
  3. Siga o assistente de criação de conta de usuário, preenchendo os campos de autenticação do telefone.

No entanto, para fluxos de autenticação por telefone, o emulador NÃO acionará a entrega de nenhuma mensagem de texto, uma vez que entrar em contato com uma operadora está fora do escopo e não é amigável para testes locais! Em vez disso, o emulador imprime o código que teria sido enviado via SMS para o mesmo terminal em que você executou os firebase emulators:start ; insira este código no aplicativo para simular os usuários verificando suas mensagens de texto.

Teste não interativo

Para teste de autenticação de telefone não interativo, use a API REST do emulador de autenticação para recuperar os códigos SMS disponíveis. Observe que o código é diferente a cada vez que você inicia o fluxo.

A seqüência típica é a seguinte.

  1. Chame a plataforma signInWithPhoneNumber para iniciar o processo de verificação.
  2. Recupere o código de verificação usando o terminal REST específico do emulador .
  3. Chame confirmationResult.confirm(code) normalmente com o código de verificação.

Autenticação emulada de provedor de identidade de terceiros (IDP)

O emulador de autenticação permite que você teste muitos fluxos de autenticação de terceiros em seus aplicativos iOS, Android ou web sem alterações do código de produção. Para exemplos de fluxos de autenticação, consulte a documentação de várias combinações de provedores e plataformas que você pode usar em seu aplicativo .

De modo geral, você pode usar o Firebase SDK para autenticar de duas maneiras:

  • Seu aplicativo permite que o SDK lide com todo o processo de ponta a ponta, incluindo todas as interações com provedores de IDP terceirizados para recuperar credenciais.
  • Seu aplicativo recupera manualmente as credenciais de um provedor terceirizado usando o SDK desse terceiro e passa essas credenciais para o SDK de autenticação.

Mais uma vez, verifique o link de documentação acima e certifique-se de estar familiarizado com o fluxo - gerenciado pelo Firebase SDK vs. recuperação manual de credenciais - que deseja usar. O emulador de autenticação oferece suporte a testes de qualquer abordagem.

Teste de fluxos de IDP baseados no SDK do Firebase

Se seu aplicativo usa qualquer fluxo de ponta a ponta do Firebase SDK, como OAuthProvider para login com Microsoft, GitHub ou Yahoo, para teste interativo, o emulador de autenticação fornece uma versão local da página de login correspondente para ajudá-lo a testar autenticação de aplicações web que chamam a signinWithPopup ou signInWithRedirect método. Esta página de login servida localmente também aparece em aplicativos móveis, renderizados pela biblioteca de webview de sua plataforma.

O emulador cria contas de usuário de terceiros simuladas e credenciais conforme necessário à medida que o fluxo prossegue.

Teste de fluxos de IDP com recuperação manual de credenciais

Se você usar técnicas de login "manuais" e chamar o método signInWithCredentials sua plataforma, então, como de costume, seu aplicativo solicitará login real de terceiros e recuperará credenciais reais de terceiros.

Observe que o emulador só oferece suporte signInWithCredential autenticação signInWithCredential para credenciais recuperadas do Google Sign-In, Apple e outros provedores que usam tokens de ID implementados como JSON Web Tokens (JWTs). Tokens de acesso (por exemplo, aqueles fornecidos pelo Facebook ou Twitter, que não são JWTs) não são suportados. A próxima seção discute uma alternativa nesses casos.

Teste não interativo

Uma abordagem para o teste não interativo é automatizar os cliques do usuário na página de login servida pelo emulador. Para aplicativos da web, use uma interface de controle como o WebDriver. Para dispositivos móveis, use as ferramentas de teste de IU da sua plataforma, como Espresso ou Xcode.

Como alternativa, você pode atualizar seu código para usar signInWithCredential (por exemplo, em uma ramificação de código) e usar um fluxo de autenticação de token com tokens de ID simulados para contas em vez de credenciais reais.

  1. Retribua ou comente a parte do seu código que recupera idTokens do IDP; isso elimina a necessidade de inserir nomes de usuário e senhas reais durante seus testes e libera seus testes de cotas de API e limites de taxa no IDP.
  2. Em segundo lugar, use uma string JSON literal no lugar do token para signInWithCredential . Usando o SDK da web como exemplo, você pode alterar o código para:
firebase.auth().signInWithCredential(firebase.auth.GoogleAuthProvider.credential(
  '{"sub": "abc123", "email": "foo@example.com", "email_verified": true}'
));

Quando usado com o emulador, este código autentica com sucesso um usuário com o e-mail foo@example.com no Google. Pense no subcampo como uma chave primária, que pode ser alterada para qualquer string, simulando a assinatura de diferentes usuários. Você pode substituir firebase.auth.GoogleAuthProvider por, por exemplo, new firebase.auth.OAuthProvider('yahoo.com') ou qualquer outro ID de provedor que você deseja simular.

Qual o proximo?