Índice del curso
Lección 05 — Entrar con Microsoft
Por Dorian Chávez · cofundador y Chief Executive Officer de Hábil ·
Antes de leer, cinco palabras. Una línea cada una; las demás llegan en el paso donde se usan.
- Microsoft Entra: el servicio de Microsoft donde se dan de alta las apps que dejan entrar con una cuenta de
Microsoft. Su consola está en
entra.microsoft.com. - Directorio: el espacio de Entra que pertenece a una persona o a una organización. Una app se registra dentro de un directorio. La documentación en inglés lo llama tenant.
- Dirección de retorno: la dirección web a la que Microsoft manda a la persona cuando termina de entrar. La documentación la llama redirect URI.
- Clave de cliente: una contraseña de la app, no de una persona. Con ella, quien la tiene se identifica ante Microsoft como esa app. La documentación la llama client secret.
- Resultado pendiente: la respuesta de una entrada que terminó cuando tu app ya no estaba ahí para recibirla.
Qué te llevas: el botón «Entrar con Microsoft» junto al de Google, escrito por ti, que recoge la entrada aunque Android haya cerrado tu app a la mitad; tu app registrada en Entra sin que su clave toque un solo archivo; y una tabla tuya que dice qué es igual y qué cambia entre los dos proveedores.
Idea nueva de esta lección: un segundo proveedor que se registra fuera de Firebase, con una dirección de retorno exacta y una clave que nunca toca la app. Lo demás —las librerías, el navegador, la tercera «puerta» y el segundo botón en la pantalla— viene dado y explicado, y no se evalúa aquí.
La escena
La página de Microsoft está abierta en el teléfono. La persona todavía no elige su cuenta. Detrás de esa página, tu app ya no existe: Android la cerró.
La página sigue ahí, esperando.
Eso se provocó a propósito en el ensayo de esta serie, el 13 de noviembre de 2026, en un emulador. Con la página de Microsoft al frente se cerró el proceso de la app desde la terminal, como lo haría Android si necesitara memoria. Luego se eligió la cuenta. Android volvió a arrancar la app desde cero, sin nada de lo que tenía en memoria.
La persona ya había entrado. La pregunta es si la app se entera, o si le pide que entre otra vez.
En el ensayo se enteró, porque al arrancar preguntaba una cosa antes que nada: ¿quedó una entrada a medias? Esa pregunta es una línea, y esta lección la escribe. También escribe lo que va antes: registrar tu app con Microsoft, que no se hace en Firebase, y cuidar una clave que solo se muestra una vez.
Antes de empezar
Qué necesitas: la 04 terminada (su verifica en 20 de 20) y el ambiente de la
00. Para el paso 7 basta un emulador abierto o tu teléfono conectado. Aplica lo de
«Cuenta y equipo de confianza» de la 00.
Para los pasos 8 y 9, además: una cuenta de Microsoft para entrar y un directorio de Entra donde puedas registrar una app. Son dos cosas distintas, y la segunda es la que cuesta:
- La guía de Microsoft pide una cuenta de Azure con suscripción activa y el papel de Application Developer.
- En el ensayo del 13-nov-2026, una cuenta personal que ya tenía directorio registró la app por
entra.microsoft.com, sin suscripción y sin tarjeta. - Ese día, una cuenta recién creada no pudo: «Nuevo registro» abrió un panel sin formulario. Abrió después de activar la prueba gratuita de Azure, que pidió teléfono verificado, dirección de facturación y tarjeta.
- Si eres estudiante, revisa si calificas para Azure for Students. Su página dice que no pide tarjeta, que verifica con el correo de tu escuela y que no aplica a cursos masivos en línea ni a capacitaciones de organizaciones con fines de lucro. Esta lección no afirma que califiques.
Si no tienes directorio, haces completos los pasos 1 a 7, que no necesitan ninguna cuenta. Los pasos 8 y 9 quedan para cuando lo tengas.
El proyecto de inicio. Desde la raíz del repo de la serie:
git pull
cp lecciones/03-la-app-conoce-a-firebase/inicio/app/google-services.json lecciones/05-entrar-con-microsoft/inicio/app/
cd lecciones/05-entrar-con-microsoft/inicio
El segundo comando lleva tu archivo de la 03 al proyecto de esta lección. Ahí también queda ignorado por git.
Junto está solucion/: puedes leerla sin configurar nada, y ./verifica solucion sale en rojo en un clon
limpio, porque sin tu archivo el proyecto no compila (medido el 18-nov-2026: 0 pruebas corridas). Tus
respuestas van en respuestas/05.md, en la raíz del repo.
Lo que el proyecto ya trae (andamiaje). No se evalúa aquí; el paso 3 lo recorre:
| Qué trae | Dónde | Por qué |
|---|---|---|
Todo lo que dejó la 04: EntradaConGoogle, sus dos puertas, sus pruebas y sus dobles |
Los mismos archivos, sin un solo cambio | El verifica los compara, byte por byte, contra la solución de la 04 |
Un quinto resultado, CuentaConOtroProveedor, y la interfaz EntradaQueSeRetoma |
Entrada.kt |
Con Microsoft hay una forma nueva de no entrar, y una entrada que puede quedarse a medias |
| La tercera puerta, con su implementación de verdad | PuertaDelNavegador.kt |
Por ahí sale tu código al navegador y a Firebase |
| El segundo botón y el mensaje de la colisión | PantallaEntrada.kt, Tienda.kt |
Estos dos sí cambiaron respecto a la 04. Vienen dados: tú no tocas ninguna pantalla |
MainActivity, que arma las piezas y se las pasa a Tienda |
MainActivity.kt |
Viene dado y no se cambia: el verifica lo compara contra el de la lección |
| Dónde se decide qué pieza se arma; por ahora, una que no hace nada | Armado.kt |
Es el archivo donde conectas lo que escribas |
| Las pruebas de esta lección, sus dobles y una «app de pruebas» | app/src/test, app/src/androidTest |
Son las que corre el verifica. No las cambies |
Un esqueleto de EntradaConMicrosoft |
EntradaConMicrosoft.kt |
Es el archivo que escribes tú |
El catálogo de versiones es el de la 04, sin librerías nuevas: Microsoft viene en Firebase Authentication.
Lo que no hace esta lección. No enlaza Google y Microsoft en un mismo usuario: aquí la app reconoce la colisión y dice con qué botón entrar; enlazar es la 06. No guarda la sesión ni la cierra (lección 07), y no distingue la primera vez (lección 08).
Paso 1 · Sin IA: el mismo viaje, por otro camino
Este paso es tuyo, sin Claude Code. Es el ejercicio 5.3.
En la 04, tu app le pidió un token al teléfono y se lo llevó a Firebase. Con Microsoft, tu app no carga nada: abre el navegador y espera.
| # | De quién a quién | Qué viaja |
|---|---|---|
| 1 | Tu app → Firebase (su librería) | Una solicitud: «quiero entrar con el proveedor microsoft.com» |
| 2 | Firebase → el navegador | Abre la página de Microsoft, con el ID de cliente de tu registro y tu dirección de retorno |
| 3 | La persona → Microsoft | Su cuenta y lo que Microsoft le pida. Ocurre en el navegador, fuera de tu app |
| 4 | Microsoft → Firebase (sus servidores) | Un código de un solo uso, mandado a tu dirección de retorno |
| 5 | Firebase → Microsoft | Ese código, junto con el ID de cliente y la clave que guardaste en la consola de Firebase |
| 6 | Firebase → tu app | Un usuario, con su identificador en tu proyecto y, si el proveedor lo entregó, su nombre |
La fila 5 es la que no existía con Google. La guía de Firebase lo dice así: Firebase maneja todo el flujo y el intercambio del código usando el ID de cliente y la clave configurados en su consola. Y la documentación de Microsoft explica por qué esa clave no va en la app: pide no usarla en una app nativa, porque en un dispositivo no se puede guardar de forma confiable.
Por eso la fila 2 exige exactitud. La documentación de Microsoft dice que su servidor solo manda a la persona a una dirección que esté agregada al registro de la app, y que la dirección de la solicitud debe coincidir exactamente con una de las registradas. Si no coincide, responde con un error.
Predice antes de seguir, en respuestas/05.md: de las seis filas, ¿en cuáles participa el código que vas a
escribir tú?
Haz tu tabla. En respuestas/05.md, compara los dos proveedores con estas cinco preguntas. Llénala sin
mirar «Compara tus respuestas» y luego compárala:
- ¿Quién registra la app con el proveedor, y en qué consola?
- ¿Qué pieza le muestra a la persona dónde entrar?
- ¿Qué recibe tu app del proveedor?
- ¿Hay una clave? ¿Dónde vive?
- ¿Qué tiene que coincidir exactamente para que funcione?
Lo demuestra: tu tabla, comparada con la de la lección (objetivo 5.3). Ninguna prueba la lee.
Paso 2 · La regla de datos, antes de tocar nada
En la 04 la regla fue: nadie imprime, pega ni guarda el token. Aquí se extiende a tres cosas más.
- La clave de cliente nace en Entra y se pega directo en Firebase. No pasa por el código, un archivo,
respuestas/05.md, la terminal, una captura ni un mensaje. Firebase la usa del lado de su servicio, nunca en el teléfono. De ella solo se anota su fecha de caducidad. - El token de acceso de Microsoft no se lee. El resultado de Firebase trae uno, con el que se podría llamar a servicios de Microsoft a nombre de la persona. De ese resultado solo sale el nombre.
- El ID de cliente de Entra no va en el código. No es un secreto, pero la app no lo necesita: lo usa Firebase. En tu tabla del paso 8 sí lo anotas.
Si la clave llega a tocar un archivo, la terminal o una captura, ya no es secreta: se elimina en Entra y se crea otra. Borrar el archivo no alcanza. Súmala, con los tokens de acceso, a la lista de lo que nunca se sube.
Paso 3 · Lo que el proyecto ya trae
Abre estos archivos; todavía no los edites. Vas a ver tres piezas de Kotlin nuevas:
String?: un tipo que termina en?aceptanull.String?es «un texto, o nada».a ?: b: siano esnull, regresaa; si lo es, regresab.when { … }: una lista de condiciones; se queda con la primera que se cumple.
Entrada.kt: dos cosas nuevas. Resultado tiene un quinto caso, CuentaConOtroProveedor. Y hay una
interfaz más:
interface EntradaQueSeRetoma : Entrada {
suspend fun retomar(): Resultado?
}
Es una Entrada que, además de entrar(), sabe contestar si quedó algo a medias. Regresa un Resultado, o
null si no quedó nada.
PuertaDelNavegador.kt: la tercera puerta.
interface NavegadorDeProveedor {
suspend fun pendiente(): String?
suspend fun abrir(proveedor: OAuthProvider): String
}
abrir abre el navegador y regresa el nombre de quien entró; su versión de verdad llama a
startActivityForSignInWithProvider. pendiente pregunta por una entrada a medias; su versión de verdad lee
pendingAuthResult. Son las dos llamadas de la guía de Firebase. Según la referencia, ese resultado existe
cuando se inició una entrada por la web y el sistema limpió la pantalla que la esperaba; trae el mismo éxito o
la misma excepción que la entrada hubiera dado; y para una entrada se entrega una sola vez.
Esta puerta solo entrega un nombre. Es la regla de datos del paso 2 hecha código: el token de acceso no sale de ahí.
PantallaEntrada.kt y Tienda.kt: el segundo botón. Tienda recibe ahora una segunda entrada, opcional.
Si no se la pasan, no hay segundo botón y todo es como en la 04; por eso las pruebas de la 04 siguen pasando sin
tocarlas. Y al abrirse pregunta si quedó algo a medias:
val pendiente = entradaConMicrosoft?.retomar()
if (pendiente != null) recibe(pendiente)
Esas líneas van dentro de un LaunchedEffect, que es la forma de Compose de decir «haz esto una vez al
aparecer, no cada vez que la pantalla se vuelva a dibujar». Lleva una clave: si la clave cambia, Compose
cancela el trabajo y lo arranca de nuevo, según su documentación. Aquí la clave nunca cambia, así que la
pregunta se hace una sola vez, al abrirse la app.
MainActivity.kt y Armado.kt. onCreate arma las piezas y se las pasa a Tienda. Qué pieza se arma
para Microsoft lo decide una función de Armado.kt, que por ahora regresa MicrosoftSinConectar(): no deja
pasar a nadie. Tú cambias Armado.kt; MainActivity.kt no se toca.
Las pruebas. En tu computadora, Firebase no se prepara solo como en un teléfono: sin ayuda, las pruebas
dieron «Default FirebaseApp is not initialized» (medido el 18-nov-2026). Por eso src/test trae AppDePruebas,
que lo prepara a mano. Preparar no es conectarse.
Mide el punto de partida. Desde la raíz del repo:
./lecciones/05-entrar-con-microsoft/verifica
El 18-nov-2026, con un archivo inventado completo, la última línea fue
Resultado: 23 de 44 pruebas en verde (21 en rojo, 0 con error, 0 saltadas). Son 44 porque van las 20 de la
lección 04 y 24 nuevas. Las 20 de la 04 ya están en verde, y tres de las nuevas también: son del andamiaje.
Las otras 21 esperan tu código.
Paso 4 · Con Claude Code: entrar y retomar
Aquí entra la herramienta, y entra siempre igual: predices → le pides → lees lo que generó → corres el
verifica → lo explicas con tus palabras.
- Predice. Escribe en
respuestas/05.md: si al abrirse la app no quedó ninguna entrada a medias, ¿qué debe regresarretomar(), y qué debe pasar en la pantalla? - Pídele a Claude Code, parado en
inicio/, la segunda entrada tomando la primera como referencia. Este es el ejercicio 5.4, y el encargo es corto a propósito: «TomaEntradaConGoogle.ktcomo referencia y escribeEntradaConMicrosoft.ktsolo para el caso en que todo sale bien, conretomar()yentrar(), usando la puertanavegador. No atrapes excepciones todavía. EnArmado.kt, cambia solo el cuerpo dearmarEntradaConMicrosoftpara que regreseEntradaConMicrosoftcon la puerta que recibe, y borra ahíMicrosoftSinConectar. No cambies ningún otro archivo.» - Lee el cambio completo antes de aceptarlo y lista lo que no copió bien. La primera entrada es una
buena referencia para el estilo y una mala para el fondo: Google entrega un token y Microsoft no. Contesta
sí o no a las ocho preguntas de «Compara tus respuestas», ejercicio 5.4, y anota en
respuestas/05.mdcada «no» con el archivo y la línea. Luego pide la corrección de cada uno, diciendo por qué. Si las ocho dan «sí», escribe «No encontré desvíos en las ocho revisiones» y conserva la tabla: no inventes un error. El centro debe quedar parecido a esto:
override suspend fun retomar(): Resultado? {
val nombre = navegador.pendiente()
return if (nombre == null) null else Resultado.Entro(nombre)
}
override suspend fun entrar(): Resultado {
// Filas 1 y 2: la solicitud, con el proveedor.
val proveedor = OAuthProvider.newBuilder("microsoft.com")
.addCustomParameter("prompt", "select_account")
.build()
// Primero, lo pendiente. Solo si no hay (null) se abre el navegador.
val nombre = navegador.pendiente() ?: navegador.abrir(proveedor)
return Resultado.Entro(nombre)
}
- Corre el
verifica. Con ese código dioResultado: 32 de 44 pruebas en verdeel 18-nov-2026. Las rojas son las formas de no entrar: el paso 5. - Explica, en tres líneas de
respuestas/05.md: por quéentrar()pregunta por lo pendiente siretomar()ya lo hizo al abrir la app.
¿Qué hace select_account? Según la documentación de Microsoft, interrumpe el inicio de sesión automático
y muestra la lista de cuentas para elegir. Microsoft lo marca como opcional: esta lección lo recomienda, y es
el valor que usó el ensayo del 13-nov-2026. No es condición para aprobar: ninguna prueba lee ese parámetro, y
si falta, el verifica solo lo avisa.
Lo demuestra, y hasta dónde. En el nivel simulado, el verifica demuestra que un toque abre el navegador
una sola vez y con el proveedor microsoft.com; que con algo a medias no se vuelve a abrir; y que retomar()
regresa quién entró o null. Otra prueba abre MainActivity, le pasa la puerta de mentira a
crearEntradaConMicrosoft y lee qué proveedor se pidió.
La puerta era de mentira: no se abrió ningún navegador. «Quedó algo a medias» lo dijo el doble; ninguna prueba cerró la app.
¿Y la app instalada usa tu pieza? Ninguna prueba lo ve de punta a punta. Hay dos respaldos:
MainActivity.kttiene que ser idéntico al de la lección. Si lo cambias, elverificalo marca en rojo aunque las 44 pruebas den verde (medido el 18-nov-2026).- Si
Armado.ktarma otra cosa, una prueba se pone roja (43 de 44).
Las marcas «Texto:» solo buscan palabras en tus archivos. La prueba completa es el nivel real, en el paso 9.
Paso 5 · Sin IA: las tres formas de no entrar
Este paso se hace sin Claude Code. Es una función de tres ramas, y la escribes tú.
Cuando la puerta del navegador no puede entregar un nombre, lanza una excepción de Firebase. La referencia de Firebase lista las de esta llamada. Tres grupos importan aquí:
| Excepción | Cuándo, según la referencia | Tu entrada contesta |
|---|---|---|
FirebaseAuthUserCollisionException con el código ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL |
Ese correo ya tiene usuario con otra forma de entrar. Solo ocurre con la opción «una cuenta por correo» activada (lección 06) | Resultado.CuentaConOtroProveedor |
FirebaseAuthWebException con el código ERROR_WEB_CONTEXT_CANCELED |
La persona canceló la operación pendiente | Resultado.Cancelada |
| Cualquier otra, incluidas esas dos clases con otro código | La referencia nombra otra operación web en curso, un navegador sin soporte, una falla dentro de la página y el proveedor mal configurado. Aquí entra también todo lo demás que falle | Resultado.Fallo |
En el ensayo del 13-nov-2026 se entró con una cuenta de Microsoft cuyo correo ya había entrado con Google, y Firebase contestó con esa excepción y este texto: «An account already exists with the same email address but different sign-in credentials».
No basta con la clase. La misma excepción trae otros dos códigos, y la referencia pide revisar el código para saber la causa: solo este quiere decir «entra con el otro botón». Otra colisión se muestra como falla, sin inventarle una causa.
1. Predice. Las dos primeras filas nombran clases distintas. Si en la segunda quitas la condición del
código y dejas solo «es una FirebaseAuthWebException», ¿qué mensaje verá una persona a la que le falló la
página, sin haber cancelado nada?
2. Escríbelo. Agrega esta función dentro de tu clase:
private fun resultadoDe(falla: Exception): Resultado = when {
falla is FirebaseAuthUserCollisionException &&
falla.errorCode == "ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL" ->
Resultado.CuentaConOtroProveedor
falla is FirebaseAuthWebException && falla.errorCode == "ERROR_WEB_CONTEXT_CANCELED" ->
Resultado.Cancelada
else -> Resultado.Fallo
}
Y envuelve el cuerpo de retomar() y el de entrar() con try { … } y estos dos catch, en este orden:
} catch (e: CancellationException) {
throw e
} catch (e: Exception) {
resultadoDe(e)
}
El primero es el de la 04: CancellationException no es una falla de la entrada, es Kotlin avisando que la
tarea se canceló, y se deja pasar. retomar() lleva los mismos catch porque, según la referencia, el
resultado pendiente trae también las excepciones con las que la entrada hubiera terminado.
3. Corre el verifica. Ahora la línea es Resultado: 44 de 44 pruebas en verde. Queda una marca en rojo,
la de respuestas/05.md: se llena en el paso 6.
4. Comprueba tu predicción. Quita && falla.errorCode == "ERROR_WEB_CONTEXT_CANCELED" y corre el
verifica: se ponen rojas dos pruebas más, las dos del caso «error» (medido el 18-nov-2026 sobre la
solución: 42 de 44). Regrésalo. Si lo que quitas es la condición del código de la colisión, se pone roja una
(43 de 44).
Los textos que ve la persona ya están en mensajeDe:
| Resultado | Mensaje |
|---|---|
Cancelada |
«Cerraste la ventana sin elegir cuenta. Toca el botón cuando quieras intentar otra vez.» |
Fallo |
«No se pudo entrar. Revisa tu conexión y vuelve a intentar.» |
CuentaConOtroProveedor |
«Ese correo ya entró a la tienda con otro botón. Entra con el que usaste la primera vez.» |
Los dos primeros son los de la 04. El tercero no dice «Google» a propósito: la excepción no trae con qué proveedor se creó el usuario.
Lo demuestra: el verifica simulado, los tres casos. Cada caso lleva pruebas de dos tipos: unas le lanzan
la excepción a tu clase y leen qué contestó; otra dibuja la pantalla con tu clase y busca su mensaje. Las
excepciones las armó un doble, con códigos escritos a mano: ninguna vino de Firebase. Qué excepción da en un
teléfono real cerrar la pestaña del navegador todavía no lo medimos con una cuenta.
Paso 6 · Sin IA: rompe uno a propósito
También sin Claude Code. Vas a provocar el final malo de la escena.
1. Predice. Vas a hacer que retomar() conteste siempre null, como si nunca quedara nada a medias.
¿Compila? El botón de Microsoft, ¿sigue funcionando? ¿Cuántas pruebas se ponen rojas?
2. Rómpelo y mide. En EntradaConMicrosoft.kt, cambia las dos líneas del cuerpo de retomar() por un
null a secas, dentro del try. Corre el verifica. Esto dio el 18-nov-2026 (recortado):
❌ Tu entrada no retoma: quedó una entrada a medias y retomar() no la recogió (paso 4)
❌ Retomar: 1 de 4 pruebas en verde. Revisa retomar(), que entrar() pregunte primero por lo pendiente, y …
❌ Al abrir la app: 0 de 3 pruebas en verde. Tienda.kt viene dado y llama a retomar(): revisa lo que …
Resultado: 37 de 44 pruebas en verde (7 en rojo, 0 con error, 0 saltadas), leído de …
Copia a respuestas/05.md la línea que dice «Tu entrada no retoma».
3. Lo que esas pruebas no te dicen. Compila, y las pruebas del botón siguen en verde: tocar «Entrar con Microsoft» lleva al inicio igual. El defecto solo existe si Android cierra la app a media entrada, y eso no pasa en una prueba que dura un segundo. En un teléfono se midió aparte, el 13-nov-2026, con un código de ensayo:
- Con la página de Microsoft al frente se cerró el proceso de la app con
adb shell am killy luego se eligió la cuenta: Android arrancó la app otra vez y el resultado pendiente entregó la entrada. - La opción de desarrollador «No conservar actividades» no sirvió para probarlo: destruye la pantalla, pero el proceso sigue vivo y termina la entrada por su cuenta. Para ver el caso hay que cerrar el proceso, no la pantalla.
4. Arréglalo. Regresa las dos líneas de retomar(). Corre el verifica: 44 de 44, y ahora también la
marca de respuestas/05.md.
El ejercicio está terminado cuando puedes marcar las tres:
- Tu predicción del punto 1 está escrita, con lo que viste debajo.
- Pegaste la línea del rojo.
- Dijiste por qué las pruebas del botón siguieron en verde con un código que, en un teléfono con poca memoria, haría entrar dos veces a la persona.
Lo demuestra: «Rompe uno a propósito». Es base del objetivo 5.2: saber qué recoge retomar().
Paso 7 · Dentro de Android: el nivel instrumentado
Con el emulador abierto, desde la raíz del repo:
./lecciones/05-entrar-con-microsoft/verifica inicio instrumentado
Repite el nivel simulado y después instala la app y su app de pruebas en el dispositivo. Ahí dibuja Tienda con
tu EntradaConMicrosoft y la misma puerta de mentira, toca los botones y busca los textos. Con la solución, en
un emulador nuevo y sin cuenta (Pixel 9, imagen google_apis_playstore de Android 37), esto dio el 18-nov-2026
(recortado):
✅ Instrumentado: dentro de Android, con la puerta de mentira, tocar «Entrar con Microsoft» lleva al inicio …
✅ Instrumentado: dentro de Android, cancelación, error y colisión muestran cada uno su mensaje sin pasar …
✅ Instrumentado: dentro de Android, con una entrada a medias que contesta el doble, la app llega al inicio …
✅ Instrumentado: dentro de Android, las 4 pruebas del botón de Google de la lección 04 siguen en verde
Resultado: 44 de 44 pruebas en verde (0 en rojo, 0 con error, 0 saltadas), leído de …
Instrumentado: 9 de 9 pruebas en verde (0 en rojo, 0 con error, 0 saltadas), leído de …
Son nueve: cinco de esta lección y las cuatro de la 04. Sobre el proyecto de inicio sin tocar dio 4 de 9, las
cuatro de la 04. Sin ningún dispositivo conectado, el verifica sale en rojo y dice que no se corrió.
Lo demuestra, y hasta dónde. Demuestra que las pantallas, el toque y tu clase funcionan dentro de Android, con la librería de Firebase Authentication del dispositivo armando el proveedor. No demuestra nada de tu registro en Entra ni de tu proyecto: la puerta sigue siendo de mentira, no se abre el navegador y no hace falta cuenta ni red hacia Microsoft. Y la prueba de «retomar» es el doble contestando que quedó algo a medias: Android no cerró ninguna app.
Mira el botón de verdad, sin registro. En ese mismo emulador, con un archivo inventado, se instaló la app y
se tocó «Entrar con Microsoft» (18-nov-2026). No se abrió ninguna página. La app mostró «No se pudo entrar.
Revisa tu conexión y vuelve a intentar.», y el registro del sistema dijo
[GetAuthDomainTask] Error getting project config. Failed with API key not valid. Es lo esperado: el archivo
era inventado. Con tu archivo de verdad y Microsoft todavía sin habilitar en Firebase, el resultado no lo
medimos todavía; si lo ves, cuéntanos qué mensaje te dio.
Paso 8 · En las consolas: registrar la app sin que la clave toque un archivo
Este paso y el siguiente piden el directorio de «Antes de empezar». Aquí no se escribe código. Abre las dos consolas en dos pestañas, porque tres datos van a cruzar de una a otra:
| Dato | Nace en | Se pega en |
|---|---|---|
| La dirección de retorno | Firebase | Entra |
| El Application (client) ID | Entra | Firebase |
| La clave de cliente | Entra | Firebase, y en ningún otro lugar |
Los menús y botones van en inglés, como en la documentación. En español, el ensayo del 13-nov-2026 vio «Registros de aplicaciones», «Nuevo registro» y «Registrar una aplicación». El resto de los rótulos en español no lo recorrimos de punta a punta: si tu consola dice otra cosa, guíate por la versión en inglés de cada uno y cuéntanos cómo aparece.
1. En Firebase, copia tu dirección de retorno. En Authentication, pestaña Sign-in method, elige Microsoft y habilítalo. Todavía no guardes: el panel pide el ID y la clave, que aún no tienes. Deja esa pestaña abierta así, a medias; vuelves a ella en el punto 5. En el ensayo, la dirección se copió de ese mismo panel. Tiene esta forma:
https://<tu-proyecto>.firebaseapp.com/__/auth/handler
La guía de Firebase sobre redirecciones dice que el final /__/auth/handler importa.
2. En Entra, entra por entra.microsoft.com. No por portal.azure.com: en el ensayo, la cuenta sin
suscripción dio ahí el error AADSTS16000, y por Entra abrió su propio directorio.
3. Registra la app. Según la guía de Microsoft: Entra ID › App registrations › New registration.
- Name: uno que reconozcas. La guía avisa que las personas que entren pueden verlo.
- Supported account types: Any Entra ID Tenant + Personal Microsoft accounts, para cuentas de organizaciones y personales. Es la que usó el ensayo.
- Register.
La página Overview muestra el Application (client) ID. Ese sí se anota, y ya lo puedes pegar en la pestaña de Firebase. No es la clave: la clave todavía no existe.
4. Agrega la dirección de retorno. Según la guía: Manage › Authentication › Add Redirect URI ›
plataforma Web › pega la dirección del punto 1 › Configure. Pégala; no la escribas a mano. Microsoft pide
que empiece con https y distingue mayúsculas de minúsculas.
5. Crea la clave. Según la guía: Certificates & secrets › Client secrets › New client secret. Ponle una descripción y elige una caducidad. La guía dice que no puede pasar de 24 meses y recomienda menos de 12. Add.
La clave aparece en la columna Value, y la guía avisa que no se vuelve a mostrar después de salir de la página. Con esa página abierta:
- Cópiala con el botón de copiar y pégala directo en el campo de la clave del panel de Microsoft, en la pestaña de Firebase. Revisa que el Application (client) ID del punto 3 ya esté en su campo. Save.
- No la pegues en ningún otro lugar. Después copia cualquier otro texto, para sacarla del portapapeles (recomendación de esta serie).
- Anota la fecha de caducidad. Cuando llegue, la entrada con Microsoft deja de funcionar hasta que crees otra clave y la lleves a Firebase.
- No tomes ninguna captura mientras la columna Value muestre la clave.
Una frontera, para no sacar de aquí una arquitectura: Firebase pide ese ID y esa clave para este proveedor, y la misma guía de Microsoft recomienda certificados en lugar de claves antes de llevar una app a producción. Para un producto real, eso se revisa con quien lleve la seguridad: la política de Entra, la rotación de la clave y el tipo de credencial.
6. Deja la evidencia. En respuestas/05.md:
| Dato | Lo anotas |
|---|---|
| Application (client) ID | Sí, completo |
| Tipo de cuentas | Sí, el nombre de la opción |
| Dirección de retorno | Sí, completa |
| Caducidad de la clave | Sí, la fecha |
| Valor de la clave | Nunca |
Y una captura de Certificates & secrets tomada después de salir de esa página y volver a entrar. Si en la captura queda a la vista cualquier parte del valor, tápala antes de guardarla.
7. Pídele al verifica que busque. Córrelo: las dos marcas «Clave:» deben estar en verde. Para saber que
esa búsqueda sí ve, siembra una clave inventada. Este comando la arma por partes, para que no quede escrita
en ningún lado, y la agrega como comentario al final de un archivo:
printf '// %s%s%s\n' 'Inv8' 'Q~' "$(printf 'x%.0s' $(seq 34))" >> lecciones/05-entrar-con-microsoft/inicio/app/src/main/java/mx/habil/ejemplo/tienda/Armado.kt
Corre el verifica. El 18-nov-2026, sobre el proyecto de inicio sin tocar, contestó con el archivo y el número
de línea, sin imprimir el texto (tu número de línea puede ser otro):
❌ Hay un texto con forma de clave de cliente de Entra en: inicio/app/src/main/java/…/Armado.kt:19. No la imprimo. …
Borra esa última línea en tu editor y corre el verifica otra vez: verde.
Lo demuestra, y hasta dónde. Las marcas «Clave:» demuestran que ningún archivo de texto de inicio/ ni
respuestas/05.md trae un texto con la forma de esas claves ni nombra un secreto de cliente. La forma está
inspirada en una regla pública de gitleaks, pero el verifica no ejecuta gitleaks ni sustituye un escaneo de
secretos: es más simple, puede marcar texto inocente, y se le escapan otras formas, los binarios, las variables
de entorno y el historial de git. Tampoco ve tu terminal, tus capturas ni tu portapapeles. Esa parte la cuidas
tú, y tu tabla y tu captura las comparas tú.
Paso 9 · En el teléfono: el nivel real
Este paso sí habla con Microsoft, una vez, a mano. Es el único que comprueba el paso 8: que la dirección de retorno es la exacta, que el ID es el de tu registro y que la clave que guardaste es la vigente.
Con el emulador abierto, parado en inicio/:
./gradlew installDebug
Abre «La tienda», toca «Entrar» y luego «Entrar con Microsoft».
Lo que se vio en el ensayo del 13-nov-2026 (Mac, emulador, cuentas personales). Ese ensayo usó un código de
prueba con las mismas llamadas, no el de solucion/:
| Caso | Qué se vio |
|---|---|
| Primera vez | Se abrió el navegador con la página de Microsoft; se escribió la cuenta; la app saludó con el nombre |
| El permiso | Una pantalla «Let this app access your info?», con la marca unverified junto al nombre de la app, «Read your profile» y los botones Deny y Accept. Es lo esperado en una app de ejemplo sin editor verificado. Microsoft guardó la aceptación: no volvió a aparecer |
| Volver a entrar | Microsoft mostró la cuenta ya iniciada, para elegirla sin contraseña |
| Un correo que ya entró con Google | La excepción de colisión del paso 5 |
| La app cerrada a media entrada | Lo del paso 6: el resultado pendiente entregó la entrada |
La clase NavegadorConFirebase de esta lección solo la corrimos hasta el error del archivo inventado del paso 7;
la entrada completa con una cuenta real todavía no. Si al probarla ves algo distinto, cuéntanos qué apareció.
Si tu cuenta usa llave de acceso (passkey). En el ensayo, la pantalla «Sign in with your passkey» se quedó en «Verifying…» en el emulador. Se tocó Cancel y se entró con la contraseña.
Si el navegador ofrece guardar la contraseña: en un equipo que no es tuyo, «No».
Prueba el final de la escena. Con la página de Microsoft al frente y antes de elegir cuenta, en otra terminal:
adb shell am kill mx.habil.ejemplo.tienda
adb shell pidof mx.habil.ejemplo.tienda
El primero cierra los procesos de la app que es seguro cerrar, según la documentación de adb. El segundo no
debe imprimir nada: el proceso ya no existe. Ahora elige tu cuenta. La app debe arrancar y saludarte sin que
toques el botón otra vez.
Al terminar, en un equipo que no es tuyo: cierra la sesión de Microsoft en el navegador del emulador y borra sus datos (lección 00).
Lo demuestra: la entrada real demuestra que el registro, la dirección de retorno, el ID y la clave están bien. No demuestra los casos de no entrar: esos los cubre el nivel simulado.
Tus ejercicios
Los pasos 1, 5 y 6 se hacen sin IA.
| # | Haces | Está hecho cuando |
|---|---|---|
| 5.1 | Registras la app en Entra con la dirección de retorno exacta y llevas su ID y su clave a Firebase | Tres evidencias. Tu tabla del paso 8 y tu captura sin clave a la vista: las comparas tú. Las dos marcas «Clave:» del verifica en verde, que solo dicen que ningún archivo de inicio/ ni respuestas/05.md trae esa forma o ese nombre. Y la entrada real del paso 9, que es lo único que valida el registro |
| 5.2 | Implementas EntradaConMicrosoft sin cambiar las pantallas, y retomas el resultado pendiente |
Tres evidencias. Simulado: sus marcas del verifica en verde; valida qué pide tu clase y qué contesta, con una puerta de mentira, y que las 20 pruebas de la 04 siguen en verde con sus archivos idénticos. No acredita por sí solo que la app instalada use tu entrada: eso lo respaldan MainActivity.kt idéntico al de la lección y la prueba de lo que arma Armado.kt. Instrumentado: 9 de 9, lo mismo dentro de Android. Real: entras en el paso 9 y cierras el proceso a media entrada; es lo único que valida que Android de verdad te regresa a la app |
| 5.3 | Comparas Google y Microsoft con las cinco preguntas del paso 1 | Tu tabla coincide con la de «Compara tus respuestas». La comparas tú |
| 5.4 | Le pides a Claude Code la segunda entrada tomando la primera como referencia, y listas lo que no copió bien | Tu lista de sí y no del paso 4, con archivo y línea en cada «no», contra las ocho preguntas de «Compara tus respuestas». Si las ocho dan «sí», tu entrega es esa tabla y la frase «No encontré desvíos en las ocho revisiones». La calificas tú; el verifica no la lee |
Tiempo: calcula unas cuatro horas, con el registro en Entra, el «Rompe uno a propósito», el nivel instrumentado y la entrada real; sin los pasos 8 y 9, unas dos y media. Es un estimado: lo ajustamos con lo que tarde la primera cohorte. Conseguir el directorio no está contado: en el ensayo, la suscripción de prueba tardó unos 15 minutos en aparecer como activa.
¿No te corre?
| Ves | Causa probable | Qué haces |
|---|---|---|
File google-services.json is missing. |
No copiaste tu archivo a inicio/app/ |
El cp de «Antes de empezar». Sobre solucion/ es lo esperado en un clon limpio |
| ❌ «Estos archivos ya no son los de la lección 04» | Alguien, tú o Claude Code, cambió una prueba, una puerta o una pantalla de la 04 | git diff -- <archivo> y deshazlo a mano |
| ❌ «Tu entrada no retoma» | retomar() no usa lo que regresa pendiente() |
Paso 4. Si vienes del «Rompe uno», paso 6, punto 4 |
❌ El caso «error» en rojo, con resultadoDe escrita |
Toda FirebaseAuthWebException se está contando como cancelación |
Paso 5: falta la condición del código |
| ❌ «Hay un texto con forma de clave de cliente de Entra» | Una clave, o algo con su forma, está en un archivo | Si es tu clave: bórrala del archivo, elimínala en Entra y crea otra (paso 8). Si es la inventada del control: borra esa línea |
En las pruebas, Default FirebaseApp is not initialized |
Se cambió robolectric.properties o AppDePruebas.kt (medido el 18-nov-2026 sin ellos) |
Regrésalos: son andamiaje |
En las pruebas instrumentadas, NoSuchMethodException: android.hardware.input.InputManager.getInstance |
Se quitó la línea de Espresso 3.7.0 y quedó el que Compose trae por omisión. Medido el 18-nov-2026 en Android 37: 0 de 9 | Regresa androidTestImplementation(libs.espresso.core) |
| En el teléfono, «No se pudo entrar…» sin que se abra ninguna página | Con un archivo inventado, el registro dijo API key not valid (medido el 18-nov-2026). Con tu archivo, qué da con Microsoft sin habilitar o con la clave vencida todavía no lo medimos |
Revisa que copiaste tu google-services.json y el paso 8 |
En el navegador, un error AADSTS50011 |
Según Microsoft: la dirección de retorno de la solicitud no coincide con ninguna de las registradas. No se midió aquí | Paso 8, punto 4: pégala otra vez, completa |
En portal.azure.com, AADSTS16000 |
Medido el 13-nov-2026 con una cuenta sin suscripción | Entra por entra.microsoft.com |
| «Nuevo registro» abre un panel sin formulario | Tu cuenta no tiene directorio (medido el 13-nov-2026 con una cuenta recién creada) | «Antes de empezar»: necesitas un directorio primero |
| «Ese correo ya entró a la tienda con otro botón…» | Ese correo ya tiene usuario en tu proyecto, creado con otro proveedor; en esta serie, Google | Entra con Google. Que los dos botones lleguen al mismo usuario es la lección 06 |
| La pantalla de la llave de acceso se queda en «Verifying…» | Medido el 13-nov-2026 en el emulador | Cancel y entra con la contraseña |
| ❌ «EntradaConMicrosoft.kt nombra una puerta concreta» | Tu código nombra la puerta de verdad (NavegadorConFirebase) o un doble de las pruebas. Las pruebas solo le pasan dobles: si tu código pregunta cuál le tocó, el verde no dice qué hace con la de verdad |
Que tu código hable solo con NavegadorDeProveedor. La puerta de verdad la escoge MainActivity.kt, que viene dado (paso 4) |
En Linux Mint 22.3 (x86_64), el verifica de esta lección salió igual que en la Mac (18-nov-2026), en el nivel
simulado y con un archivo de prueba que traía la huella de esa computadora: sobre inicio/, 23 de 44 en verde;
sobre solucion/, 44 de 44. El nivel instrumentado no se midió en Linux.
Para cerrar
Contesta sin volver a leer:
- ¿Dónde vive la clave de cliente, quién la usa y por qué no va en la app?
- ¿Qué tiene que coincidir exactamente entre Firebase y Entra?
- Tu
verificada 44 de 44 y las marcas «Clave:» están en verde. Di una cosa que eso demuestra y dos que no. - ¿Por qué «No conservar actividades» no sirve para probar
retomar()?
Lo que sigue: en la 06, la persona con el mismo correo en los dos proveedores termina con un solo usuario, y solo si ella lo confirma.
Compara tus respuestas
Paso 1. Tu código participa en la fila 1, cuando arma la solicitud, y recibe la fila 6. Las filas 2 a 5 ocurren entre Firebase, el navegador y Microsoft. Tu tabla:
| Pregunta | Google (lección 04) | Microsoft (esta lección) |
|---|---|---|
| ¿Quién registra la app, y dónde? | Tú registras la app en Firebase y agregas la huella; los clientes de Google no los das de alta a mano: llegan en tu google-services.json después de habilitar Google (lección 03) |
Tú, a mano, en la consola de Entra, que está fuera de Firebase |
| ¿Qué le muestra a la persona dónde entrar? | Credential Manager, con la ventana de cuentas de Android | El navegador, con la página de Microsoft |
| ¿Qué recibe tu app del proveedor? | Un token de identidad, que ella misma lleva a Firebase | Nada: el código viaja de Microsoft a Firebase. Tu app recibe de Firebase el usuario |
| ¿Hay una clave? ¿Dónde vive? | Tú no manejas ninguna: en la app solo va el ID de cliente web, que no es secreto | Sí, la clave de cliente. La creas en Entra y vive en la consola de Firebase |
| ¿Qué tiene que coincidir? | El nombre de paquete y la huella | La dirección de retorno, carácter por carácter |
Lo que es igual es el patrón: una Entrada con su puerta, un Resultado por cada forma de terminar, las
pruebas con un doble, y Firebase entregando al final un usuario. Las pantallas no supieron que había un
proveedor nuevo.
Paso 4. retomar() regresa null y la pantalla se queda en la bienvenida, sin mensaje. entrar() pregunta
otra vez porque es lo que pide la guía de Firebase antes de abrir otro flujo: quien toca el botón no debe entrar dos veces si ya hay una respuesta esperando.
Ejercicio 5.4. Ocho preguntas de sí o no sobre lo que generó Claude Code. Lo esperado son ocho «sí»; cada «no» es algo que no copió bien y va en tu lista con archivo y línea. La lista dice qué revisar, no qué va a fallar: no se midió qué genera la herramienta.
| # | Pregunta | Por qué |
|---|---|---|
| 1 | ¿El proveedor es el texto "microsoft.com", sin https://? |
Así lo escribe la guía de Firebase |
| 2 | ¿Dejó fuera lo que era de Google: GetCredentialRequest, GetSignInWithGoogleOption, GoogleIdTokenCredential? |
Aquí no hay token que pedirle al teléfono |
| 3 | ¿La clase recibe solo la puerta navegador, sin idDeClienteWeb ni otro identificador? |
El ID y la clave viven en las consolas |
| 4 | ¿entrar() pregunta pendiente() antes de abrir? |
Es lo que pide la guía, para no hacer entrar dos veces |
| 5 | ¿retomar() nunca llama a abrir? |
Se llama al abrirse la app, sin que nadie toque un botón |
| 6 | ¿No hay escritos ningún ID de cliente, ninguna clave ni el identificador de un directorio? | Regla de datos del paso 2. El parámetro tenant con el valor common no es un dato tuyo: es el valor por omisión |
| 7 | ¿Nadie nombra accessToken, idToken ni OAuthCredential? |
Regla de datos: de Firebase solo sale el nombre |
| 8 | ¿Quedaron sin tocar las pruebas, las puertas, las pantallas y tu google-services.json? |
El verifica compara esos archivos |
Paso 5. Vería el de la cancelación, «Cerraste la ventana…», aunque no cerró nada. Sin la condición, toda falla del navegador se cuenta como cancelación.
Paso 6. Compila, y el botón sigue funcionando. Se ponen rojas siete pruebas: las de retomar() y las tres
que abren la app con algo a medias. Las del botón siguen en verde porque ninguna cierra la app: en ellas, el
navegador de mentira contesta al instante.
Para cerrar:
- Nace en Entra y vive en la consola de Firebase. La usan los servidores de Firebase para cambiar el código de Microsoft por los datos de la persona. No va en la app porque cualquiera que tenga la app instalada podría sacarla: Microsoft pide no usarla en apps nativas.
- La dirección de retorno: la que usa Firebase y la que registraste en Entra.
- Demuestra qué pide tu clase y qué contesta en cada caso, con una puerta de mentira, y que ningún archivo revisado trae un texto con forma de clave. No demuestra que tu registro en Entra funcione, ni que la clave no esté en tu terminal, en una captura o en el historial de git.
- Porque destruye la pantalla pero deja vivo el proceso, que termina la entrada por su cuenta.
retomar()existe para cuando el proceso ya no está.
Fuentes de la lección
Abiertas el 18-nov-2026.
- Firebase. Authenticate Using Microsoft on Android (el proveedor, el resultado pendiente, la entrada y el intercambio del código con la clave de la consola). https://firebase.google.com/docs/auth/android/microsoft-oauth
- Firebase. Referencia de
FirebaseAuth(getPendingAuthResulty las excepciones destartActivityForSignInWithProvider). https://firebase.google.com/docs/reference/android/com/google/firebase/auth/FirebaseAuth - Firebase. Referencia de
FirebaseAuthUserCollisionException(sus tres códigos;ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIALsolo con «una cuenta por correo», que recomienda; revisar el código). https://firebase.google.com/docs/reference/android/com/google/firebase/auth/FirebaseAuthUserCollisionException - Firebase. Referencia de
FirebaseAuthWebException(sus cuatro códigos;ERROR_WEB_CONTEXT_CANCELED). https://firebase.google.com/docs/reference/android/com/google/firebase/auth/FirebaseAuthWebException - Firebase. Best practices for using signInWithRedirect (la dirección
https://<project>.firebaseapp.com/__/auth/handler). https://firebase.google.com/docs/auth/web/redirect-best-practices - Microsoft Learn. How to register an app in Microsoft Entra ID (requisitos, pasos y tipos de cuenta). https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app
- Microsoft Learn. How to add a redirect URI to your application (los pasos y la plataforma Web). https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-redirect-uri
- Microsoft Learn. Redirect URI (reply URL) best practices and limitations (direcciones registradas,
https, mayúsculas yAADSTS50011). https://learn.microsoft.com/en-us/entra/identity-platform/reply-url - Microsoft Learn. Add and manage app credentials in Microsoft Entra ID (la clave: 24 meses como máximo y un valor que no se vuelve a mostrar). https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-credentials
- Microsoft Learn. Microsoft identity platform and OAuth 2.0 authorization code flow (
select_account, la coincidencia exacta y la clave fuera de las apps nativas). https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow - Microsoft Azure. Azure for Students (condiciones de la oferta). https://azure.microsoft.com/en-us/pricing/offers/ms-azr-0170p
- Android Developers. Side-effects in Compose (
LaunchedEffect). https://developer.android.com/develop/ui/compose/side-effects - Android Developers. Android Debug Bridge (
am kill). https://developer.android.com/tools/adb - Kotlin. Null safety (los tipos con
?y el operador?:). https://kotlinlang.org/docs/null-safety.html - gitleaks, herramienta pública de búsqueda de secretos: su regla
azure-ad-client-secretinspiró la forma que busca elverifica, que no ejecuta gitleaks ni aplica sus delimitadores ni su umbral de entropía. No es un formato publicado por Microsoft. https://github.com/gitleaks/gitleaks/blob/master/config/gitleaks.toml - Repositorio Maven de Google: el BoM de Firebase 35.2.0 sigue siendo el más reciente y trae
firebase-auth25.0.0. https://dl.google.com/dl/android/maven2/com/google/firebase/firebase-bom/maven-metadata.xml · https://dl.google.com/dl/android/maven2/com/google/firebase/firebase-bom/35.2.0/firebase-bom-35.2.0.pom - Ensayo de la serie, 13-nov-2026, Mac con Apple silicon, con un código de prueba: el registro en Entra por
entra.microsoft.com;AADSTS16000en el portal de Azure; la cuenta recién creada y la prueba gratuita; la entrada real, el permiso, la colisión y el resultado pendiente trasadb shell am kill; la llave de acceso en el emulador. - Medición propia: Mac con Apple silicon, 18-nov-2026. El
verificasobreinicio/ysolucion/, cada paso de la lección y cada sabotaje, con archivos inventados y sin tocar la consola de Entra, la de Azure ni la de Firebase, ni ninguna cuenta. Las pruebas instrumentadas y el botón de Microsoft con un archivo inventado, en un emulador nuevo, sin cuenta, que se borró al terminar. Los cuatro códigos deFirebaseAuthWebExceptionse cotejaron además dentro de la libreríafirebase-auth25.0.0.
¿Prefiere correo? Escríbanos a hola@habil.mx