Cette page a été traduite par l'API Cloud Translation.

Authentifiez-vous auprès de Firebase à l'aide d'un numéro de téléphone et de C++

Vous pouvez utiliser l'authentification Firebase pour connecter un utilisateur en envoyant un message SMS sur le téléphone de l'utilisateur. L'utilisateur se connecte à l'aide d'un code à usage unique contenu dans le message SMS.

Ce document décrit comment implémenter un flux de connexion par numéro de téléphone à l'aide du SDK Firebase.

Avant que tu commences

Ajoutez Firebase à votre projet C++ .
Si vous n'avez pas encore connecté votre application à votre projet Firebase, faites-le depuis la console Firebase .
Comprendre les exigences de la plate-forme pour la connexion par numéro de téléphone :
- La connexion par numéro de téléphone est réservée aux plates-formes mobiles.
- Sur iOS, la connexion par numéro de téléphone nécessite un appareil physique et ne fonctionnera pas sur un simulateur.

Problèmes de sécurité

L'authentification utilisant uniquement un numéro de téléphone, bien que pratique, est moins sécurisée que les autres méthodes disponibles, car la possession d'un numéro de téléphone peut être facilement transférée entre utilisateurs. De plus, sur les appareils dotés de plusieurs profils utilisateur, tout utilisateur pouvant recevoir des messages SMS peut se connecter à un compte à l'aide du numéro de téléphone de l'appareil.

Si vous utilisez la connexion par numéro de téléphone dans votre application, vous devez la proposer parallèlement à des méthodes de connexion plus sécurisées et informer les utilisateurs des compromis en matière de sécurité liés à l'utilisation de la connexion par numéro de téléphone.

Pour connecter des utilisateurs par SMS, vous devez d'abord activer la méthode de connexion par numéro de téléphone pour votre projet Firebase :

Dans la console Firebase , ouvrez la section Authentification .
Sur la page Méthode de connexion , activez la méthode de connexion par numéro de téléphone .

Le quota de demandes de connexion par numéro de téléphone de Firebase est suffisamment élevé pour que la plupart des applications ne soient pas affectées. Toutefois, si vous devez connecter un très grand nombre d’utilisateurs avec l’authentification téléphonique, vous devrez peut-être mettre à niveau votre plan tarifaire. Voir la page des tarifs .

Commencez à recevoir des notifications APN (plateformes Apple)

Pour utiliser l'authentification par numéro de téléphone sur les plates-formes Apple, votre application doit pouvoir recevoir des notifications APN de Firebase. Lorsque vous connectez un utilisateur avec son numéro de téléphone pour la première fois sur un appareil, Firebase Authentication envoie une notification push silencieuse à l'appareil pour vérifier que la demande de connexion par numéro de téléphone provient de votre application. (Pour cette raison, la connexion par numéro de téléphone ne peut pas être utilisée sur un simulateur.)

Pour activer les notifications APN à utiliser avec l'authentification Firebase :

Dans Xcode, activez les notifications push pour votre projet.
Téléchargez votre certificat APNs sur Firebase. Si vous ne disposez pas déjà d'un certificat APNs, assurez-vous d'en créer un dans le Centre des membres des développeurs Apple .
1. Dans votre projet dans la console Firebase, sélectionnez l'icône d'engrenage, sélectionnez Paramètres du projet , puis sélectionnez l'onglet Messagerie cloud .
2. Sélectionnez le bouton Télécharger le certificat pour votre certificat de développement, votre certificat de production ou les deux. Il en faut au moins un.
3. Pour chaque certificat, sélectionnez le fichier .p12 et fournissez le mot de passe, le cas échéant. Assurez-vous que l'ID de bundle de ce certificat correspond à l'ID de bundle de votre application. Sélectionnez Enregistrer .

Envoyer un code de vérification au téléphone de l'utilisateur

Pour lancer la connexion par numéro de téléphone, présentez à l'utilisateur une interface qui l'invite à fournir son numéro de téléphone, puis appelez PhoneAuthProvider::VerifyPhoneNumber pour demander à Firebase d'envoyer un code d'authentification au téléphone de l'utilisateur par SMS :

Obtenez le numéro de téléphone de l'utilisateur.
Les exigences légales varient, mais à titre de bonne pratique et pour définir les attentes de vos utilisateurs, vous devez les informer que s'ils utilisent la connexion par téléphone, ils peuvent recevoir un message SMS pour vérification et que les tarifs standard s'appliquent.

Appelez PhoneAuthProvider::VerifyPhoneNumber en lui transmettant le numéro de téléphone de l'utilisateur.

class PhoneListener : public PhoneAuthProvider::Listener {
 public:
  ~PhoneListener() override {}

  void OnVerificationCompleted(PhoneAuthCredential credential) override {
    // Auto-sms-retrieval or instant validation has succeeded (Android only).
    // No need for the user to input the verification code manually.
    // `credential` can be used instead of calling GetCredential().
  }

  void OnVerificationFailed(const std::string& error) override {
    // Verification code not sent.
  }

  void OnCodeSent(const std::string& verification_id,
                  const PhoneAuthProvider::ForceResendingToken&
                      force_resending_token) override {
    // Verification code successfully sent via SMS.
    // Show the Screen to enter the Code.
    // Developer may want to save that verification_id along with other app states in case
    // the app is terminated before the user gets the SMS verification code.
  }
};

PhoneListener phone_listener;
PhoneAuhtOptions options;
options.timeout_milliseconds = kAutoVerifyTimeOut;
options.phone_number = phone_number;
PhoneAuthProvider& phone_provider = PhoneAuthProvider::GetInstance(auth);
phone_provider->VerifyPhoneNumber(options, &phone_listener);

Lorsque vous appelez PhoneAuthProvider::VerifyPhoneNumber , Firebase,

(sur iOS) envoie une notification push silencieuse à votre application,
envoie un message SMS contenant un code d'authentification au numéro de téléphone spécifié et transmet un identifiant de vérification à votre fonction d'achèvement. Vous aurez besoin du code de vérification et de l'ID de vérification pour connecter l'utilisateur.
Remarque : En fonction de votre forfait de facturation, vous pouvez être limité à un quota quotidien de messages SMS envoyés. Voir Limites d'authentification Firebase .

Enregistrez l'ID de vérification et restaurez-le lors du chargement de votre application. Ce faisant, vous pouvez vous assurer que vous disposez toujours d'un identifiant de vérification valide si votre application est fermée avant que l'utilisateur ait terminé le processus de connexion (par exemple, lors du passage à l'application SMS).
Vous pouvez conserver l'ID de vérification comme vous le souhaitez. Si vous écrivez avec un framework C++ multiplateforme, il doit fournir des notifications pour la résiliation et la restauration de l'application. Lors de ces événements, vous pouvez respectivement enregistrer et restaurer l'ID de vérification.

Si l'appel à VerifyPhoneNumber entraîne l'appel OnCodeSent sur votre écouteur, vous pouvez inviter l'utilisateur à saisir le code de vérification lorsqu'il le reçoit dans le message SMS.

D'un autre côté, si l'appel à VerifyPhoneNumber aboutit à OnVerificationCompleted , alors la vérification automatique a réussi et vous disposerez désormais d'un PhoneAuthCredential avec lequel vous pourrez utiliser comme décrit ci-dessous.

Une fois que l'utilisateur a fourni à votre application le code de vérification du message SMS, connectez-le en créant un objet PhoneAuthCredential à partir du code de vérification et de l'ID de vérification et en transmettant cet objet à Auth::SignInWithCredential .

Obtenez le code de vérification de l'utilisateur.

Créez un objet Credential à partir du code de vérification et de l'ID de vérification.

PhoneAuthCredential credential = phone_auth_provider->GetCredential(
    verification_id_.c_str(), verification_code.c_str());

Connectez l'utilisateur avec l'objet Credential :

Future<User> future = auth_->SignInWithCredential(credential);
future.OnCompletion(
    [](const Future<User*>& result, void*) {
      if (result.error() == kAuthErrorNone) {
        // Successful.
        // User is signed in.
        User user = *result.result();

        // This should display the phone number.
        printf("Phone number: %s", user.phone_number().c_str());

        // The phone number provider UID is the phone number itself.
        printf("Phone provider uid: %s", user.uid().c_str());

        // The phone number providerID is 'phone'
        printf("Phone provider ID: %s", user.provider_id().c_str());
      } else {
        // Error.
        printf("Sign in error: %s", result.error_message().c_str());
      }
    },
    nullptr);

Prochaines étapes

Après qu'un utilisateur se connecte pour la première fois, un nouveau compte utilisateur est créé et lié aux informations d'identification (c'est-à-dire le nom d'utilisateur et le mot de passe, le numéro de téléphone ou les informations du fournisseur d'authentification) avec lesquels l'utilisateur s'est connecté. Ce nouveau compte est stocké dans le cadre de votre projet Firebase et peut être utilisé pour identifier un utilisateur dans chaque application de votre projet, quelle que soit la manière dont l'utilisateur se connecte.

Dans vos applications, vous pouvez obtenir les informations de base du profil de l'utilisateur à partir de l'objet firebase::auth::User :

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  std::string name = user.display_name();
  std::string email = user.email();
  std::string photo_url = user.photo_url();
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use firebase::auth::User::Token() instead.
  std::string uid = user.uid();
}

Dans vos règles de sécurité Firebase Realtime Database et Cloud Storage, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable auth et l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.

Vous pouvez autoriser les utilisateurs à se connecter à votre application à l'aide de plusieurs fournisseurs d'authentification en associant les informations d'identification du fournisseur d'authentification à un compte utilisateur existant.

Pour déconnecter un utilisateur, appelez SignOut() :

auth->SignOut();