Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Registrazione dei numeri di telefono di prova

Questo documento illustra come registrare i numeri di telefono con Identity Platform a scopo di sviluppo. In questo modo puoi testare metodi di autenticazione che prevedono l'invio di un messaggio SMS, come l'accesso al telefono e l'autenticazione a più fattori.

L'utilizzo di un numero di test (anziché di un numero reale di tua proprietà) ha numerosi vantaggi:

  • Si integra perfettamente con gli emulatori iOS e Android.
  • Elimina l'overhead associato all'invio di SMS effettivi.
  • Puoi eseguire test consecutivi con lo stesso numero di telefono senza essere limitato.
  • Puoi scrivere test di integrazione senza essere bloccati da controlli di sicurezza.
  • Non consuma la tua quota di utilizzo.

Puoi registrare fino a 10 numeri di telefono per lo sviluppo.

Registrazione di un numero di telefono di test

Per registrare un numero di telefono di prova:

  1. Vai alla pagina Provider di Identity Platform nella console Google Cloud.
    Vai alla pagina Provider di identità

  2. Se stai eseguendo il test dell'autenticazione telefonica, individuala nell'elenco dei provider, quindi fai clic sull'icona Modifica. Se stai testando l'autenticazione a più fattori, seleziona la scheda SMS a più fattori, quindi fai clic su Modifica.

  3. Nella sezione Numeri di telefono per i test, inserisci un numero di telefono e un codice di verifica per registrarti.

    Il numero di telefono deve utilizzare il formato E.164 e non può essere già assegnato a un utente di Identity Platform esistente. Il codice di verifica deve essere di sei cifre. Per motivi di sicurezza, scegli numeri difficili da indovinare ed evita pattern ovvi come +1 123-456-7890.

  4. Fai clic su Salva.

I numeri di telefono di test vengono trattati come numeri di telefono reali da Identity Platform, quindi archiviali in modo sicuro e ruotali a intervalli regolari.

Test manuali

Puoi iniziare subito a utilizzare i numeri di telefono di test nella tua app, direttamente o utilizzando gli emulatori iOS e Android. Quando accedi con un numero di telefono di prova, non viene inviato alcun codice di verifica SMS; inserisci invece il codice che hai registrato durante la creazione del numero di test.

Dopo l'accesso, viene creato un utente di Identity Platform utilizzando il numero di telefono di test. Questo utente ha lo stesso comportamento e le stesse proprietà di un utente reale, incluso un token ID valido, il che significa che può accedere a tutte le tue app e a tutti i tuoi servizi.

Per limitare l'accesso degli utenti di prova, valuta la possibilità di creare un ruolo di test con autorizzazioni limitate e di assegnarlo tramite rivendicazioni personalizzate.

Test di integrazione

Oltre al test manuale, l'SDK client contiene API che possono aiutarti a scrivere i test di integrazione. Queste API disabilitano i requisiti di reCAPTCHA e di verifica delle app, semplificando la loro esclusione con l'automazione.

L'esempio seguente mostra come testare l'accesso di un utente con un numero di telefono:

JavaScript

// Turn off phone app verification.
firebase.auth().settings.appVerificationDisabledForTesting = true;

var phoneNumber = "+16505554567";
var testVerificationCode = "123456";

// Render a fake reCAPTCHA and resolve without app verification.
var appVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container');
// signInWithPhoneNumber will call appVerifier.verify(), which will resolve
// with a fake reCAPTCHA response.
firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier)
  .then(function (confirmationResult) {
    // confirmationResult can resolve using testVerificationCode.
    return confirmationResult.confirm(testVerificationCode)
  }).catch(function (error) {
    // Error; SMS not sent
    // ...
  });

Le verifiche reCAPTCHA visibili e invisibili si comportano in modo diverso quando la verifica delle app è disattivata:

  • reCAPTCHA visibile: per simulare un clic di un utente, il reCAPTCHA si risolve automaticamente dopo un breve ritardo.

  • reCAPTCHA visibile: per simulare la verifica dell'app, il reCAPTCHA si risolve automaticamente quando viene chiamato appVerifier.verify().

I modelli di reCAPTCHA simulano l'attivazione dei callback quando vengono risolti o scadono.

Passaggi successivi

  • Aggiungi l'autenticazione a più fattori alla tua app Web, iOS o Android.