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

Authentifier avec Firebase à l'aide d'un système d'authentification personnalisé et de C++

Pour intégrer Firebase Authentication à un système d'authentification personnalisé, procédez comme suit : modifier votre serveur d'authentification pour produire des jetons signés personnalisés lorsqu'un utilisateur se connecte avec succès. Votre application reçoit ce jeton et l'utilise pour s'authentifier auprès de Firebase.

Avant de commencer

Ajoutez Firebase à votre projet C++.
Obtenez les clés de serveur de votre projet:
1. Accédez à la page Comptes de service. dans les paramètres de votre projet.
2. Cliquez sur Générer une nouvelle clé privée en bas de la Section SDK Admin Firebase de la page Comptes de service
3. La paire de clés publique/privée du nouveau compte de service enregistrées sur votre ordinateur. Copiez ce fichier sur votre serveur d'authentification.

Authentifier avec Firebase

La classe Auth sert de passerelle pour tous les appels d'API.

Ajoutez les fichiers d'en-tête Auth et App:

#include "firebase/app.h"
#include "firebase/auth.h"

Dans votre code d'initialisation, créez firebase::App.

#if defined(__ANDROID__)
  firebase::App* app =
      firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
#else
  firebase::App* app = firebase::App::Create(firebase::AppOptions());
#endif  // defined(__ANDROID__)

Procurez-vous la classe firebase::auth::Auth pour votre firebase::App. Il existe une correspondance un à un entre App et Auth.
```
firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
```

Appelez Auth::SignInWithCustomToken avec le jeton de votre serveur d'authentification.

Lorsque les utilisateurs se connectent à votre application, envoyez leurs identifiants (par par exemple, son nom d'utilisateur et son mot de passe) à votre serveur d'authentification. Votre vérifie les identifiants et renvoie un jeton personnalisé si elles sont valides.
Une fois que vous avez reçu le jeton personnalisé de votre serveur d'authentification, transmettez-le à Auth::SignInWithCustomToken pour connecter l'utilisateur :
```
firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithCustomToken(custom_token);
```

Si votre programme comporte une boucle de mise à jour qui s'exécute régulièrement (par exemple à 30 ou 60 fois par seconde), vous pouvez vérifier les résultats une fois par mise à jour avec Auth::SignInWithCustomTokenLastResult:

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithCustomTokenLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::AuthResult auth_result = *result.result();
    printf("Sign in succeeded for `%s`\n",
           auth_result.user.display_name().c_str());
  } else {
    printf("Sign in failed with error '%s'\n", result.error_message());
  }
}

Si votre programme est axé sur des événements, vous pouvez enregistrer un rappel sur la Futur.

Étapes suivantes

Lorsqu'un utilisateur se connecte pour la première fois, un compte utilisateur est créé et associés aux identifiants, c'est-à-dire au nom d'utilisateur et au mot de passe, ou des informations sur le fournisseur d'authentification, c'est-à-dire l'utilisateur avec lequel il s'est connecté. Cette nouvelle est stocké dans votre projet Firebase et peut servir à identifier un utilisateur dans toutes les applications de votre projet, quelle que soit la façon dont l'utilisateur se connecte.

Dans vos applications, vous pouvez obtenir les informations de base du profil de l'utilisateur à partir des 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 votre Firebase Realtime Database et votre Cloud Storage Règles de sécurité, vous pouvez obtenez 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 appli à l'aide de plusieurs authentifications fournisseurs en associant leurs identifiants compte utilisateur existant.

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

auth->SignOut();