Antes de comenzar
- Agrega Firebase a tu proyecto de C++.
- En el archivo
build.gradle
de nivel de proyecto, asegúrate de incluir el repositorio Maven de Google en las seccionesbuildscript
yallprojects
. - Obtén las claves del servidor del proyecto:
- Ve a la página Cuentas de servicio en la configuración del proyecto.
- Haz clic en Generar nueva clave privada en la parte inferior de la sección SDK de Firebase Admin de la página Cuentas de servicio.
- El par de claves públicas o privadas de la cuenta de servicio nueva se guarda de manera automática en la computadora. Copia este archivo en el servidor de autenticación.
Autentica con Firebase
La claseAuth
es la puerta de enlace para todas las llamadas de API.
- Agrega los archivos de encabezados de autenticación y de app:
#include "firebase/app.h" #include "firebase/auth.h"
- En tu código de inicialización, crea una clase
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__)
- Obtén la clase
firebase::auth::Auth
para tufirebase::App
. Existe una asignación uno a uno entreApp
yAuth
.firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
Auth::SignInWithCustomToken
con el token del servidor de autenticación.
- Cuando los usuarios acceden a la app, envía sus credenciales de acceso (por ejemplo, el nombre de usuario y la contraseña) al servidor de autenticación. El servidor verifica las credenciales y devuelve un token personalizado si son válidas.
- Después de recibir el token personalizado del servidor de autenticación, pásalo a
Auth::SignInWithCustomToken
para que el usuario acceda:firebase::Future<firebase::auth::User*> result = auth->SignInWithCustomToken(custom_token);
- Si el programa tiene un bucle de actualización que se ejecuta de manera regular (por ejemplo, 30 o 60 veces por segundo), puedes verificar los resultados una vez por actualización con
Auth::SignInWithCustomTokenLastResult
:firebase::Future<firebase::auth::User*> result = auth->SignInWithCustomTokenLastResult(); if (result.status() == firebase::kFutureStatusComplete) { if (result.error() == firebase::auth::kAuthErrorNone) { firebase::auth::User* user = *result.result(); printf("Sign in succeeded for `%s`\n", user->display_name().c_str()); } else { printf("Sign in failed with error '%s'\n", result.error_message()); } }
Si el programa es controlado por eventos, te recomendamos que registres una devolución de llamada en Future.
Pasos siguientes
Cuando un usuario accede por primera vez, se crea una cuenta de usuario nueva y se la vincula con las credenciales (el nombre de usuario y la contraseña, el número de teléfono o la información del proveedor de autenticación) que el usuario usó para acceder. Esta cuenta se almacena como parte de tu proyecto de Firebase y se puede usar para identificar a un usuario en todas las apps del proyecto, sin importar cómo acceda.
-
En las apps, puedes obtener la información básica del perfil del usuario a partir del objeto
firebase::auth::User
:firebase::auth::User* user = auth->current_user(); if (user != nullptr) { 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(); }
En las reglas de seguridad de Firebase Realtime Database y Cloud Storage, puedes obtener el ID del usuario único que accedió a partir de la variable
auth
y usarlo para controlar a qué datos podrá acceder.
Para permitir que los usuarios accedan a tu app con varios proveedores de autenticación, puedes vincular las credenciales de proveedores de autenticación a una cuenta de usuario existente.
Para cerrar la sesión de un usuario, llama a SignOut()
de la siguiente manera:
auth->SignOut();