Firebase proporciona varias funciones que pueden usarse juntas en tu app y que se ofrecen en proyectos creados en la consola de Firebase. Normalmente, basta con que un solo proyecto proporcione todos los recursos de tu app. Sin embargo, hay casos en los cuales te convendrá que una sola app tenga acceso a datos de varios proyectos. Por ejemplo, es posible que necesites acceder a datos de dos bases de datos diferentes y tener la capacidad de autenticar usuarios para el acceso a cada una de ellas. En esta entrada del blog, te mostraré la manera de hacerlo.
Primero, veamos algo de terminología:
| Proyecto heredado de Firebase.com
|
Proyecto creado en la consola heredada, asociada con una base de datos de Firebase que no se ha actualizado a la nueva consola.
|
| Proyecto de Google API
|
Proyecto empleado para acceder a Google API, generalmente desde https://console.developers.google.com o https://console.cloud.google.com
|
| Proyecto de Firebase
|
Proyecto creado en la nueva consola de Firebase. Cada proyecto de Firebase también contiene un proyecto de Google API subyacente.
|
| App
|
Cliente para una plataforma específica. Cada proyecto puede tener asociadas varias apps...
|
Se actualizaron el proyecto heredado de Firebase.com y el proyecto de Google API existente
Existe una situación particular en el caso de los desarrolladores que desean actualizar su base de datos existente de Firebase.com a un nuevo proyecto de Firebase y, al mismo tiempo, tener la posibilidad de usar servicios de otro proyecto de Google API. El proyecto heredado actualizado se convierte en un proyecto de Firebase nuevo, y esto debe aplicarse en combinación con el proyecto de Google API que proporciona autenticación de inicio de sesión de Google para usuarios existentes.
El desafío aquí es el siguiente: para que el componente de inicio de sesión de Google funcione en Android, necesita un SHA-1 (huella digital de la clave que se usa para firmar el APK) y un nombre de paquete (p. ej., com.foo.bar) que permitan el registro para la app. Esta combinación permite que el inicio de sesión de Google determine el proyecto de Google API en uso a través de una app en particular. Un par de SHA1 y nombre de paquete es exclusivo en términos generales dentro de Google (y proyectos de Firebase). Por lo tanto, si intentas agregar el mismo par de SHA-1 y nombre de paquete a un proyecto actualizado de Firebase recibirás un mensaje de error en el cual se indicará que el cliente OAuth2 ya existe (en el proyecto de Google API):
Advertencia: Si ves esto, no borres tu ID de cliente existente para apps que estén en producción. Esto ocasionará fallas en tu app para los clientes existentes. La opción correcta es crear una nueva app con el mismo nombre de paquete en la consola de Firebase para el proyecto actualizado
sin incluir un SHA1.
Luego, implementa
el inicio de sesión de Google con autenticación de Firebase de manera normal. En un punto determinado, deberás configurar tu objeto de opciones de inicio de sesión de Google:
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
.requestIdToken(getString(R.string.default_web_client_id))
.requestEmail()
.build();
Aquí, la string
default_web_client_id se usa para configurar el
campo de público del token de ID. El valor proviene del archivo google-services.json, que corresponde al proyecto de Firebase y no al de Google. Deberás reemplazarlo por un ID de cliente del proyecto de Google. Podrás usar cualquier ID de cliente web o crear uno nuevo:
A continuación, en el proyecto de Firebase, incluye en la lista blanca el ID de cliente que acabas de configurar para
GoogleSignInOptions en la sección
Auth > Sign In Providers > Google de la consola de Firebase.
Asegúrate de descargar el archivo
google-services.json y agregarlo a tu app de Android. En este punto, tu proyecto de Firebase aceptará tokens de Google ID generados por tu proyecto de Google. De esta manera, tu app de Android iniciará sesión en Google sin problemas usando el proyecto de Google y luego realizará la autenticación con tu proyecto de Firebase usando el token de ID de Google aplicando el
enfoque normal. Podrás realizar llamadas autenticadas a Google API asociadas con el proyecto de Google API; también a Firebase API, con el proyecto de Firebase.
Cómo acceder a las bases de datos desde dos proyectos de Firebase diferentes
En la situación anterior, había un solo proyecto de Firebase que también debía acceder a un proyecto de Google. Esto funciona debido a que las API son independientes. Sin embargo, a veces es necesario acceder a diferentes proyectos usando las mismas API (por ejemplo, accediendo a varias instancias de bases de datos).
En el caso de las apps de Android que usen Firebase, hay un objeto
FirebaseApp central que administra la configuración para todas las Firebase API. Se inicializa de manera automática a través de un proveedor de contenido cuando se lanza tu app y normalmente no es necesario que interactúes con él. Sin embargo, cuando desees acceder a varios proyectos desde una sola app, necesitarás un FirebaseApp diferente para hacer referencia a cada uno de manera individual. Depende de ti inicializar las instancias que no sean las predeterminadas, de cuya creación se encarga Firebase.
Por ejemplo, para establecer una conexión con la instancia de la base de datos de Firebase, se usa de manera implícita la app de Firebase predeterminada:
FirebaseDatabase database = FirebaseDatabase.getInstance();
Para establecer una conexión con otra base de datos en tiempo real de Firebase desde otro proyecto, primero debes inicializar una instancia de FirebaseApp para ese otro proyecto de Firebase y proporcionarle un identificador. En este caso,
"secondary":
FirebaseOptions options = new FirebaseOptions.Builder()
.setApplicationId("1:530266078999:android:481c4ecf3253701e") // Required for Analytics.
.setApiKey("AIzaSyBRxOyIj5dJkKgAVPXRLYFkdZwh2Xxq51k") // Required for Auth.
.setDatabaseUrl("https://project-1765055333176374514.firebaseio.com/") // Required for RTDB.
.build();
FirebaseApp.initializeApp(this /* Context */, options, "secondary");
Luego, puedes acceder a la base de datos usando las mismas API de cliente, pero esta vez debes especificar el proyecto al que deseas acceder pasando el
FirebaseApp correspondiente a
FirebaseDatabase.getInstance():
// Retrieve my other app.
FirebaseApp app = FirebaseApp.getInstance("secondary");
// Get the database for the other app.
FirebaseDatabase secondaryDatabase = FirebaseDatabase.getInstance(app);
Cómo realizar la autenticación en dos bases de datos de Firebase diferentes
Se pueden combinar las dos técnicas anteriores para permitir el uso compartido de datos de autenticación entre proyectos de Firebase cuando se dispone de un ID externo para la incorporación.
Por ejemplo, si tu app permite el acceso con el inicio de sesión de Google, y las reglas de bases de datos de los proyectos predeterminado y secundario se configuran para requerir la autenticación, se puede usar la misma credencial de Google para iniciar sesión en ambos sistemas.
Primero, se debe configurar la app para el inicio de sesión de Google en el proyecto predeterminado de manera
normal. Luego se debe obtener el ID de cliente subyacente del proyecto predeterminado. Un ID de cliente es simplemente un identificador de un cliente de app determinado (web, de Android o de iOS) que generalmente se encuentra dentro del propio cliente. Un proyecto puede tener varios ID de cliente, pero el que se debe incluir en la lista blanca es el que se especifica en la llamada de requestIdToken al
generador GoogleSignInOptions:
.requestIdToken(getString(R.string.default_web_client_id))
Generalmente, puedes hallarlo como el primer client_id de tipo “3” en el archivo google-services.json. Mi caso:
{
"client_id": "56865680640-e8mr503bun5eaevqctn4u807q4hpi44s.apps.googleusercontent.com",
"client_type": 3
},
Una vez obtenido esto, se debe acceder al
panel de Google de la sección
Auth > Sign In Providers del proyecto
secundario, donde se puede incluir en la lista blanca el ID de cliente.
Ahora se puede tomar el mismo objeto
GoogleSignInAccount del resultado del inicio de sesión de Google y realizar la autenticación en las apps predeterminada y secundaria:
AuthCredential credential = GoogleAuthProvider.getCredential(account.getIdToken(), null);
FirebaseAuth.getInstance().signInWithCredential(credential);
FirebaseApp app = FirebaseApp.getInstance("secondary");
FirebaseAuth.getInstance(app).signInWithCredential(credential);
Con un inicio de sesión del usuario, se autentican en ambos proyectos.
Uso compartido de UID entre proyectos
Un aspecto que plantea un desafío en este caso es el hecho de que los ID de usuario de Firebase de cada proyecto serán diferentes. Por ejemplo, usando la misma credencial de Google obtengo los dos UID siguientes:
Default Auth UID: 0960868722032022577213DA4EA8B7A1683D92B405DD
Secondary Auth UID: 7h6XOeSxmkNsSseFJ1jU31WZHDP2
Si la app no ofrece
vinculación de cuentas, se puede usar el ID de usuario de Google (o el de Facebook o Twitter, entre otros) para elementos como estructuras de bases de datos y reglas de seguridad. Sin embargo, si se necesita el mismo ID de usuario en cada proyecto, o si se usa autenticación mediante correo electrónico o contraseña, o como usuario anónimo, la situación es un poco más compleja.
Afortunadamente, esto puede resolverse usando recursos de autenticación personalizados, combinados con código en el servidor, ya que los tokens de autenticación personalizados especifican sus propios UID.
En este caso, no se incluye en la lista blanca ningún elemento del proyecto secundario, pero se
descarga la cuenta de servicio tanto para este como para nuestros proyectos predeterminados. En el cliente de Android, primero se debe iniciar sesión y tomar el token de ID de Firebase del cliente de FirebaseAuth:
Nota: Se puede usar cualquier proveedor de inicio de sesión. Se usará el token personalizado para vincular los ID de usuario en los proyectos.
firebaseAuth.getCurrentUser().getToken(false /* forceRefresh */)
.addOnCompleteListener(new OnCompleteListener() {
@Override
public void onComplete(@NonNull Task task) {
String token = task.getResult().getToken(); // Send this to the server.
}
});
Esto se envía al servidor, donde se usa para crear un token personalizado de Firebase. Al igual que en Android, se debe inicializar cada una de las apps. aunque se usan cuentas de servicio debido al posicionamiento en el servidor (en este caso se usa el SDK del servidor de Java, pero se puede usar NodeJS de la misma manera).
FirebaseOptions options = new FirebaseOptions.Builder()
.setServiceAccount(new FileInputStream("default-service-account.json"))
.build();
FirebaseApp.initializeApp(options);
FirebaseOptions secondaryOptions = new FirebaseOptions.Builder()
.setServiceAccount(new FileInputStream("secondary-service-account.json"))
.build();
FirebaseApp.initializeApp(secondaryOptions, "secondary");
La app principal se usa para verificar el token que proviene del cliente y la secundaria para crear el token de autenticación personalizado con el conjunto de UID correspondiente:
// Verify the ID token using the default app.
FirebaseAuth.getInstance().verifyIdToken(idToken)
.addOnSuccessListener(new OnSuccessListener() {
@Override
public void onSuccess(FirebaseToken decodedToken) {
String uid = decodedToken.getUid();
System.out.println("User " + uid + " verified");
FirebaseApp app = FirebaseApp.getInstance("secondary");
String customToken = FirebaseAuth.getInstance(app).createCustomToken(uid);
// TODO: Send the token back to the client!
}
});
En la app de Android, se toma el token personalizado del servidor y se usa para la autenticación en el proyecto secundario.
FirebaseApp app = FirebaseApp.getInstance("secondary");
FirebaseAuth.getInstance(app).signInWithCustomToken(token);
Con esto, el UID de Firebase de ambos proyectos coincidirá.
Default Auth UID: 0960868722032022577213DA4EA8B7A1683D92B405DD
Secondary Auth UID: 0960868722032022577213DA4EA8B7A1683D92B405DD
También para iOS y la Web
Se espera que esto permita ofrecer opciones para el manejo de varios proyectos de Firebase desde una sola app. En caso de que te preguntes si lo mismo funciona en iOS y la Web, la respuesta es afirmativa. Solo debes usar el equivalente de FirebaseApp de Android para crear una referencia al proyecto secundario.
Con JavaScript, debe usarse
firebase.app:
var config = {
apiKey: "",
authDomain: ".firebaseapp.com",
databaseURL: "https://.firebaseio.com",
storageBucket: ".appspot.com",
messagingSenderId: "",
};
var secondary = firebase.initializeApp(otherAppConfig, "secondary");
var secondaryDatabase = secondary.database();
Con iOS,
FIRApp:
// Alt: load from plist using |FIROptions(contentsOfFile:)|
let options = FIROptions(googleAppID: googleAppID, bundleID: bundleID, GCMSenderID: GCMSenderID, APIKey: nil, clientID: nil, trackingID: nil, androidClientID: nil, databaseURL: databaseURL, storageBucket: nil, deepLinkURLScheme: nil)
FIRApp.configure(withName: "secondary", options: fileopts)
guard let secondary = FIRApp.init(named: "secondary")
else { assert(false, "Could not retrieve secondary app") }
let secondaryDatabase = FIRDatabase.database(app: secondary);
Para obtener más información y acceder a enlaces, visita la nueva página relacionada con la
configuración de un proyecto de Firebase, en la documentación de Firebase.
