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

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

Vous pouvez intégrer l'authentification Firebase à un système d'authentification personnalisé en modifiant 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 que tu commences

Ajoutez Firebase à votre projet C++ .
Obtenez les clés du 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 Firebase Admin SDK de la page Comptes de service .
3. La paire de clés publique/privée du nouveau compte de service est automatiquement enregistrée sur votre ordinateur. Copiez ce fichier sur votre serveur d'authentification.

S'authentifier avec Firebase

La classe Auth est la passerelle pour tous les appels 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 une classe 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__)

Acquérir la classe firebase::auth::Auth pour votre firebase::App . Il existe un mappage individuel 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 informations de connexion (par exemple, leur nom d'utilisateur et leur mot de passe) à votre serveur d'authentification. Votre serveur vérifie les informations d'identification et renvoie un jeton personnalisé s'ils sont valides.
Après avoir 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 dispose d'une boucle de mise à jour qui s'exécute régulièrement (disons 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());
  }
}

Ou, si votre programme est piloté par des événements, vous préférerez peut-être pour enregistrer un rappel sur le Future .

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();