Към съдържанието
Съдържание на курса

Урок 05 — Вход с Microsoft

От · съосновател и Chief Executive Officer на Hábil ·

Преди да четете, пет думи. По един ред за всяка; останалите идват на стъпката, където се използват.

  • Microsoft Entra: услугата на Microsoft, където се регистрират приложенията, които позволяват вход с акаунт в Microsoft. Конзолата ѝ е на entra.microsoft.com.
  • Директория: пространството в Entra, което принадлежи на един човек или на една организация. Приложението се регистрира в рамките на една директория. Документацията на английски я нарича tenant.
  • Адрес за връщане: уеб адресът, към който Microsoft праща човека, когато той приключи с влизането. Документацията го нарича redirect URI.
  • Клиентски ключ: парола на приложението, а не на човек. С него онзи, който го притежава, се представя пред Microsoft като това приложение. Документацията го нарича client secret.
  • Висящ резултат: отговорът на един вход, който е приключил, когато вашето приложение вече не е било там, за да го получи.

Какво отнасяте: бутонът „Вход с Microsoft“ до този на Google, написан от вас, който поема входа дори ако Android е затворил приложението ви по средата; вашето приложение, регистрирано в Entra, без ключът му да докосне нито един файл; и ваша таблица, която казва кое е еднакво и кое се променя между двата доставчика.

Новата идея на този урок: втори доставчик, който се регистрира извън Firebase, с точен адрес за връщане и с ключ, който никога не докосва приложението. Останалото —библиотеките, браузърът, третата „врата“ и вторият бутон на екрана— идва готово и обяснено и тук не се оценява.

Бележка за текстовете на приложението. Както в предишните уроци, проектът носи екранните си текстове на испански, а verifica търси точно тези текстове. В блоковете с код, в изходите на терминала и в скиците на екрана те остават такива, каквито са в проекта; в прозата урокът ги дава на български и първия път поставя оригинала в скоби: бутонът „Вход с Microsoft“ (в проекта: „Entrar con Microsoft“) и екранът „Магазинът“ (в проекта: „La tienda“).


Сцената

Страницата на Microsoft е отворена в телефона. Човекът още не е избрал акаунта си. Зад тази страница вашето приложение вече не съществува: Android го е затворил.

Страницата си стои там и чака.

Това беше предизвикано нарочно при изпробването на тази поредица на 13 ноември 2026 г., в емулатор. С отворена на преден план страницата на Microsoft процесът на приложението беше прекратен от терминала, както би направил Android, ако му трябваше памет. После се избра акаунтът. Android стартира приложението отново от нулата, без нищо от онова, което е имало в паметта.

Човекът вече беше влязъл. Въпросът е дали приложението го научава, или го моли да влезе пак.

При изпробването го научи, защото при стартиране питаше едно нещо преди всичко останало: има ли недовършен вход? Този въпрос е един ред и този урок го пише. Пише и онова, което е преди него: регистрирането на вашето приложение при Microsoft, което не става във Firebase, и грижата за един ключ, който се показва само веднъж.


Преди да започнете

Какво ви трябва: завършеният урок 04 (неговият verifica на 20 от 20) и средата от урок 00. За стъпка 7 е достатъчен отворен емулатор или свързан телефон. Важи онова за „Акаунт и доверен компютър“ от урок 00.

За стъпки 8 и 9, освен това: акаунт в Microsoft, с който да влезете, и директория в Entra, където да можете да регистрирате приложение. Те са две различни неща, а второто е онова, което е трудно:

  • Ръководството на Microsoft иска акаунт в Azure с активен абонамент и ролята Application Developer.
  • При изпробването на 13 ноември 2026 г. личен акаунт, който вече имаше директория, регистрира приложението през entra.microsoft.com, без абонамент и без карта.
  • В същия ден новосъздаден акаунт не можа: „Nuevo registro“ (в конзолата на испански) отвори панел без формуляр. Отвори се, след като се активира безплатният пробен период на Azure, който поиска потвърден телефон, адрес за фактуриране и карта.
  • Ако сте студент, проверете дали отговаряте на условията за Azure for Students. Страницата му казва, че не иска карта, че проверява с имейла на вашето училище и че не важи за масови онлайн курсове, нито за обучения на организации с търговска цел. Този урок не твърди, че отговаряте на условията.

Ако нямате директория, правите изцяло стъпки от 1 до 7, които не изискват никакъв акаунт. Стъпки 8 и 9 остават за момента, в който я имате.

Началният проект. От корена на хранилището на поредицата:

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

Втората команда пренася файла ви от урок 03 в проекта на този урок. Там също остава игнориран от git. До него е solucion/: можете да я четете, без да настройвате нищо, а ./verifica solucion излиза червено в чисто копие (клонинг) на хранилището, защото без вашия файл проектът не се компилира (измерено на 18 ноември 2026 г.: 0 изпълнени теста). Отговорите ви отиват в respuestas/05.md, в корена на хранилището.

Какво вече носи проектът (скелето). Тук не се оценява; стъпка 3 го обхожда:

Какво носи Къде Защо
Всичко, което остави урок 04: EntradaConGoogle, двете му врати, неговите тестове и дубльорите му Същите файлове, без нито една промяна verifica ги сравнява, байт по байт, с решението на урок 04
Пети резултат, CuentaConOtroProveedor, и интерфейсът EntradaQueSeRetoma Entrada.kt С Microsoft има нов начин да не се влезе и вход, който може да остане недовършен
Третата врата, с истинската ѝ имплементация PuertaDelNavegador.kt През нея кодът ви излиза към браузъра и към Firebase
Вторият бутон и съобщението за колизията PantallaEntrada.kt, Tienda.kt Тези два са се променили спрямо урок 04. Идват дадени: не пипате никакъв екран
MainActivity, която сглобява частите и ги предава на Tienda MainActivity.kt Идва дадена и не се променя: verifica я сравнява с тази на урока
Мястото, където се решава коя част се сглобява; засега такава, която не върши нищо Armado.kt Това е файлът, в който свързвате онова, което напишете
Тестовете на този урок, техните дубльори и едно „приложение за тестове“ app/src/test, app/src/androidTest Те са тези, които пуска verifica. Не ги променяйте
Скелет на EntradaConMicrosoft EntradaConMicrosoft.kt Това е файлът, който пишете вие

Каталогът с версии е този от урок 04, без нови библиотеки: Microsoft идва във Firebase Authentication.

Какво не прави този урок. Не свързва Google и Microsoft в един и същ потребител: тук приложението разпознава колизията и казва с кой бутон да се влезе; свързването е урок 06. Не запазва сесията и не я затваря (урок 07), и не различава първия път (урок 08).


Стъпка 1 · Без ИИ: същият път, по друг маршрут

Тази стъпка е ваша, без Claude Code. Това е упражнение 5.3.

В урок 04 приложението ви поиска токен от телефона и го отнесе до Firebase. С Microsoft приложението ви не носи нищо: отваря браузъра и чака.

# От кого към кого Какво пътува
1 Вашето приложение → Firebase (неговата библиотека) Заявка: „искам да вляза с доставчика microsoft.com“
2 Firebase → браузърът Отваря страницата на Microsoft, с ID-то на клиента от вашата регистрация и вашия адрес за връщане
3 Човекът → Microsoft Акаунтът му и каквото Microsoft му поиска. Случва се в браузъра, извън вашето приложение
4 Microsoft → Firebase (неговите сървъри) Еднократен код, изпратен на вашия адрес за връщане
5 Firebase → Microsoft Този код, заедно с ID-то на клиента и ключа, който сте запазили в конзолата на Firebase
6 Firebase → вашето приложение Потребител, с неговия идентификатор във вашия проект и, ако доставчикът го е предал, името му

Ред 5 е онзи, който с Google не съществуваше. Ръководството на Firebase го казва така: Firebase се грижи за целия поток и за размяната на кода, като използва ID-то на клиента и ключа, зададени в неговата конзола. А документацията на Microsoft обяснява защо този ключ не отива в приложението: иска да не се използва в нативно приложение, защото на устройство не може да се пази надеждно.

Затова ред 2 изисква точност. Документацията на Microsoft казва, че нейният сървър праща човека само към адрес, който е добавен към регистрацията на приложението, и че адресът в заявката трябва да съвпада точно с един от регистрираните. Ако не съвпада, отговаря с грешка.

Предвидете преди да продължите, в respuestas/05.md: от шестте реда в кои участва кодът, който ще напишете вие?

Направете вашата таблица. В respuestas/05.md сравнете двата доставчика с тези пет въпроса. Попълнете я, без да гледате „Сравнете отговорите си“, и после я сравнете:

  1. Кой регистрира приложението при доставчика и в коя конзола?
  2. Коя част показва на човека къде да влезе?
  3. Какво получава вашето приложение от доставчика?
  4. Има ли ключ? Къде живее?
  5. Какво трябва да съвпада точно, за да работи?

Доказва се с: вашата таблица, сравнена с тази на урока (цел 5.3). Никой тест не я чете.


Стъпка 2 · Правилото за данните, преди да пипнете нещо

В урок 04 правилото беше: никой не отпечатва, не поставя и не запазва токена. Тук се разширява с още три неща.

  • Клиентският ключ се ражда в Entra и се поставя направо във Firebase. Не минава през кода, през файл, през respuestas/05.md, през терминала, през снимка на екрана или през съобщение. Firebase го използва от страна на своята услуга, никога в телефона. От него се записва само датата му на изтичане.
  • Токенът за достъп на Microsoft не се чете. Резултатът от Firebase носи един, с който би могло да се викат услуги на Microsoft от името на човека. От този резултат излиза само името.
  • ID-то на клиента от Entra не отива в кода. Не е тайна, но приложението не го иска: използва го Firebase. В таблицата ви от стъпка 8 го записвате.

Ако ключът докосне файл, терминала или снимка на екрана, той вече не е таен: изтрива се в Entra и се създава друг. Изтриването на файла не стига. Добавете го, заедно с токените за достъп, към списъка с онова, което никога не се качва.


Стъпка 3 · Какво вече носи проектът

Отворете тези файлове; още не ги редактирайте. Ще видите три нови части от Kotlin:

  • String?: тип, който завършва на ?, приема null. String? е „текст или нищо“.
  • a ?: b: ако a не е null, връща a; ако е, връща b.
  • when { … }: списък от условия; запазва първото, което е изпълнено.

Entrada.kt: две нови неща. Resultado има пети случай, CuentaConOtroProveedor. И има още един интерфейс:

interface EntradaQueSeRetoma : Entrada {
    suspend fun retomar(): Resultado?
}

Това е Entrada, която освен entrar() умее да отговори дали е останало нещо недовършено. Връща Resultado или null, ако не е останало нищо.

PuertaDelNavegador.kt: третата врата.

interface NavegadorDeProveedor {
    suspend fun pendiente(): String?
    suspend fun abrir(proveedor: OAuthProvider): String
}

abrir отваря браузъра и връща името на онзи, който е влязъл; истинската му версия вика startActivityForSignInWithProvider. pendiente пита за недовършен вход; истинската му версия чете pendingAuthResult. Това са двете повиквания от ръководството на Firebase. Според референцията този резултат съществува, когато е започнат вход през уеб и системата е изчистила екрана, който го е чакал; носи същия успех или същото изключение, които входът би дал; и за един вход се предава само веднъж.

Тази врата предава само име. Това е правилото за данните от стъпка 2, превърнато в код: токенът за достъп не излиза оттам.

PantallaEntrada.kt и Tienda.kt: вторият бутон. Tienda получава сега втори вход, по избор. Ако не му го подадат, няма втори бутон и всичко е както в урок 04; затова тестовете на урок 04 продължават да минават, без да ги пипате. И като се отвори, пита дали е останало нещо недовършено:

val pendiente = entradaConMicrosoft?.retomar()
if (pendiente != null) recibe(pendiente)

Тези редове са вътре в един LaunchedEffect, който е начинът на Compose да каже „направи това веднъж, при появяването, а не при всяко прерисуване на екрана“. Носи ключ: ако ключът се промени, Compose отменя работата и я стартира отново, според документацията си. Тук ключът никога не се променя, така че въпросът се задава само веднъж, при отварянето на приложението.

MainActivity.kt и Armado.kt. onCreate сглобява частите и ги предава на Tienda. Коя част се сглобява за Microsoft, решава една функция на Armado.kt, която засега връща MicrosoftSinConectar(): тя не пуска никого. Променяте Armado.kt; MainActivity.kt не се пипа.

Тестовете. На вашия компютър Firebase не се подготвя сам, както в телефон: без помощ тестовете дадоха „Default FirebaseApp is not initialized“ (измерено на 18 ноември 2026 г.). Затова src/test носи AppDePruebas, който го подготвя на ръка. Да се подготви не е да се свърже.

Измерете изходната точка. От корена на хранилището:

./lecciones/05-entrar-con-microsoft/verifica

На 18 ноември 2026 г., с пълен измислен файл, последният ред беше Resultado: 23 de 44 pruebas en verde (21 en rojo, 0 con error, 0 saltadas). Общо са 44, защото влизат 20-те от урок 04 и 24 нови. 20-те от урок 04 вече са зелени, и три от новите също: те са от скелето. Останалите 21 чакат вашия код.

(Резултат: 23 от 44 теста са зелени, 21 червени, 0 с грешка, 0 пропуснати.)


Стъпка 4 · С Claude Code: вход и поемане

Тук влиза инструментът и влиза винаги по един и същ начин: предвиждате → искате → четете какво е генерирал → пускате verifica → обяснявате със свои думи.

  1. Предвидете. Запишете в respuestas/05.md: ако при отварянето на приложението не е останал никакъв недовършен вход, какво трябва да върне retomar() и какво трябва да стане на екрана?
  2. Поискайте от Claude Code, стоейки в inicio/, втория вход, като вземе първия за образец. Това е упражнение 5.4, а поръчката е кратка нарочно: „Вземи EntradaConGoogle.kt за образец и напиши EntradaConMicrosoft.kt само за случая, в който всичко минава добре, с retomar() и entrar(), като използваш вратата navegador. Още не хващай изключения. В Armado.kt смени само тялото на armarEntradaConMicrosoft, за да връща EntradaConMicrosoft с вратата, която получава, и изтрий там MicrosoftSinConectar. Не променяй никой друг файл.“
  3. Прочетете цялата промяна, преди да я приемете, и избройте онова, което не е копирал добре. Първият вход е добър образец за стила и лош за същината: Google предава токен, а Microsoft не. Отговорете с да или не на осемте въпроса от „Сравнете отговорите си“, упражнение 5.4, и запишете в respuestas/05.md всяко „не“ с файла и реда. После поискайте поправка на всяко, като кажете защо. Ако осемте дадат „да“, напишете „No encontré desvíos en las ocho revisiones“ (не намерих отклонения в осемте проверки) и запазете таблицата: не измисляйте грешка. Центърът трябва да остане подобен на това:
override suspend fun retomar(): Resultado? {
    val nombre = navegador.pendiente()
    return if (nombre == null) null else Resultado.Entro(nombre)
}

override suspend fun entrar(): Resultado {
    // Редове 1 и 2: заявката, с доставчика.
    val proveedor = OAuthProvider.newBuilder("microsoft.com")
        .addCustomParameter("prompt", "select_account")
        .build()
    // Първо, висящото. Само ако няма (null), се отваря браузърът.
    val nombre = navegador.pendiente() ?: navegador.abrir(proveedor)
    return Resultado.Entro(nombre)
}
  1. Пуснете verifica. С този код даде Resultado: 32 de 44 pruebas en verde на 18 ноември 2026 г. Червените са начините да не се влезе: стъпка 5.
  2. Обяснете, в три реда на respuestas/05.md: защо entrar() пита за висящото, щом retomar() вече го е направило при отварянето на приложението.

Какво прави select_account? Според документацията на Microsoft прекъсва автоматичното влизане и показва списъка с акаунти за избор. Microsoft го отбелязва като по желание: този урок го препоръчва и това е стойността, която използва изпробването от 13 ноември 2026 г. Не е условие за успех: никой тест не чете този параметър, а ако липсва, verifica само предупреждава.

Какво доказва и докъде. На симулираното ниво verifica доказва, че едно докосване отваря браузъра само веднъж и с доставчика microsoft.com; че при нещо недовършено не се отваря отново; и че retomar() връща кой е влязъл или null. Друг тест отваря MainActivity, подава вратата дубльор на crearEntradaConMicrosoft и чете кой доставчик е поискан.

Вратата беше дубльор: не се отвори никакъв браузър. „Остана нещо недовършено“ го каза дубльорът; никой тест не е затварял приложението.

А инсталираното приложение използва ли вашата част? Никой тест не го вижда от край до край. Има две подкрепи:

  • MainActivity.kt трябва да е идентичен с този на урока. Ако го промените, verifica го отбелязва в червено, дори 44-те теста да дават зелено (измерено на 18 ноември 2026 г.).
  • Ако Armado.kt сглоби нещо друго, един тест става червен (43 от 44).

Отметките „Texto:“ само търсят думи във вашите файлове. Пълното доказателство е истинското ниво, в стъпка 9.


Стъпка 5 · Без ИИ: трите начина да не влезете

Тази стъпка се прави без Claude Code. Това е функция с три клона и я пишете вие.

Когато вратата към браузъра не може да предаде име, хвърля изключение на Firebase. Референцията на Firebase изброява тези за това повикване. Три групи имат значение тук:

Изключение Кога, според референцията Вашият вход отговаря
FirebaseAuthUserCollisionException с кода ERROR_ACCOUNT_EXISTS_WITH_DIFFERENT_CREDENTIAL Този имейл вече има потребител с друг начин на влизане. Случва се само с включена опцията „един акаунт на имейл адрес“ (урок 06) Resultado.CuentaConOtroProveedor
FirebaseAuthWebException с кода ERROR_WEB_CONTEXT_CANCELED Човекът е отказал висящата операция Resultado.Cancelada
Всяко друго, включително тези два класа с друг код Референцията назовава друга уеб операция в ход, браузър без поддръжка, грешка вътре в страницата и лошо конфигуриран доставчик. Тук влиза и всичко друго, което се провали Resultado.Fallo

При изпробването на 13 ноември 2026 г. се влезе с акаунт в Microsoft, чийто имейл вече беше влизал с Google, и Firebase отговори с това изключение и с този текст: «An account already exists with the same email address but different sign-in credentials».

Класът не стига. Същото изключение носи още два кода, а референцията иска да се проверява кодът, за да се узнае причината: само този означава „влезте с другия бутон“. Друга колизия се показва като грешка, без да ѝ се измисля причина.

1. Предвидете. Първите два реда назовават различни класове. Ако във втория махнете условието за кода и оставите само „е FirebaseAuthWebException“, какво съобщение ще види човек, на когото страницата се е провалила, без да е отказвал нищо?

2. Напишете го. Добавете тази функция вътре в класа си:

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
}

И обвийте тялото на retomar() и това на entrar() с try { … } и тези два catch, в този ред:

} catch (e: CancellationException) {
    throw e
} catch (e: Exception) {
    resultadoDe(e)
}

Първият е този от урок 04: CancellationException не е грешка на входа, а Kotlin, който известява, че задачата е отменена, и се оставя да мине. retomar() носи същите catch, защото според референцията висящият резултат носи и изключенията, с които входът би завършил.

3. Пуснете verifica. Сега редът е Resultado: 44 de 44 pruebas en verde. Остава една отметка в червено, тази на respuestas/05.md: попълва се в стъпка 6.

4. Проверете предвиждането си. Махнете && falla.errorCode == "ERROR_WEB_CONTEXT_CANCELED" и пуснете verifica: стават червени още два теста, двата от случая „грешка“ (измерено на 18 ноември 2026 г. върху решението: 42 от 44). Върнете го. Ако махнете условието за кода на колизията, става червен един (43 от 44).

Текстовете, които човекът вижда, вече са в mensajeDe:

Резултат Съобщение
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.» (Този имейл вече е влизал в магазина с друг бутон. Влезте с онзи, който използвахте първия път.)

Първите два са тези от урок 04. Третият не казва „Google“ нарочно: изключението не носи с кой доставчик е създаден потребителят.

Доказва се с: симулираният verifica, трите случая. Всеки случай носи тестове от два вида: едни хвърлят изключението на вашия клас и четат какво е отговорил; друг чертае екрана с вашия клас и търси неговото съобщение. Изключенията ги сглоби дубльор, с кодове, написани на ръка: нито едно не дойде от Firebase. Кое изключение дава в истински телефон затварянето на раздела на браузъра, още не сме го измерили с акаунт.


Стъпка 6 · Без ИИ: счупете едно нарочно

Също без Claude Code. Ще предизвикате лошия край на сцената.

1. Предвидете. Ще направите retomar() да отговаря винаги null, сякаш никога не остава нищо недовършено. Компилира ли се? Бутонът на Microsoft продължава ли да работи? Колко теста стават червени?

2. Счупете го и измерете. В EntradaConMicrosoft.kt сменете двата реда от тялото на retomar() с гол null, вътре в try. Пуснете verifica. Ето какво даде на 18 ноември 2026 г. (съкратено):

❌ 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 …

(Това е изходът на verifica, на испански. На български, в червено: вашият вход не поема: остана недовършен вход, а retomar() не го взе (стъпка 4); Поемане: 1 от 4 теста са зелени, прегледайте retomar() и дали entrar() пита първо за висящото; При отваряне на приложението: 0 от 3 теста са зелени, Tienda.kt идва даден и вика retomar(), прегледайте какво е останало. Резултат: 37 от 44 теста са зелени.)

Копирайте в respuestas/05.md реда, който казва „Tu entrada no retoma“ (вашият вход не поема).

3. Какво тези тестове не ви казват. Компилира се и тестовете на бутона си остават зелени: докосването на „Entrar con Microsoft“ води до началния екран пак. Дефектът съществува само ако Android затвори приложението по средата на вход, а това не се случва в един тест, който трае секунда. В телефон се измери отделно, на 13 ноември 2026 г., с пробен код:

  • С отворена на преден план страницата на Microsoft процесът на приложението се прекрати с adb shell am kill и после се избра акаунтът: Android стартира приложението отново и висящият резултат предаде входа.
  • Опцията за разработчици „Don't keep activities“ (в Android на испански: „No conservar actividades“) не свърши работа за изпробването: унищожава екрана, но процесът остава жив и завършва входа сам. За да видите случая, трябва да затворите процеса, а не екрана.

4. Поправете го. Върнете двата реда на retomar(). Пуснете verifica: 44 от 44, и вече и отметката на respuestas/05.md.

Упражнението е завършено, когато можете да отметнете и трите:

  • Предвиждането ви от точка 1 е написано, с онова, което сте видели под него.
  • Поставили сте реда с червеното.
  • Казали сте защо тестовете на бутона останаха зелени с код, който в телефон с малко памет би накарал човека да влезе два пъти.

Доказва се с: „Счупете едно нарочно“. Основа е на цел 5.2: да знаете какво поема retomar().


Стъпка 7 · Вътре в Android: инструментираното ниво

С отворен емулатор, от корена на хранилището:

./lecciones/05-entrar-con-microsoft/verifica inicio instrumentado

Повтаря симулираното ниво и после инсталира приложението и неговото приложение за тестове на устройството. Там чертае Tienda с вашия EntradaConMicrosoft и същата врата дубльор, докосва бутоните и търси текстовете. С решението, в нов емулатор и без акаунт (Pixel 9, образ google_apis_playstore на Android 37), това даде на 18 ноември 2026 г. (съкратено):

✅ 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 …

(Инструментиран: вътре в Android, с вратата дубльор, докосването на „Entrar con Microsoft“ води до началния екран; отказът, грешката и колизията показват всеки своето съобщение, без да минават…; с недовършен вход, на който отговаря дубльорът, приложението стига до началния екран…; 4-те теста на бутона на Google от урок 04 остават зелени. Резултат: 44 от 44 теста са зелени. Инструментиран: 9 от 9 теста са зелени.)

Общо са девет: пет от този урок и четирите от урок 04. Върху непипнатия начален проект даде 4 от 9, четирите от урок 04. Без свързано устройство verifica излиза червено и казва, че не е изпълнено.

Какво доказва и докъде. Доказва, че екраните, докосването и вашият клас работят вътре в Android, с библиотеката на Firebase Authentication на устройството, която сглобява доставчика. Не доказва нищо за вашата регистрация в Entra, нито за вашия проект: вратата продължава да е дубльор, браузърът не се отваря и не са нужни нито акаунт, нито мрежа към Microsoft. А тестът на „retomar“ е дубльорът, който отговаря, че е останало нещо недовършено: Android не е затворил никакво приложение.

Погледнете бутона истински, без регистрация. В същия емулатор, с измислен файл, приложението се инсталира и се докосна „Entrar con Microsoft“ (18 ноември 2026 г.). Не се отвори никаква страница. Приложението показа «No se pudo entrar. Revisa tu conexión y vuelve a intentar.» (Влизането не успя. Проверете връзката си и опитайте отново.), а системният дневник каза [GetAuthDomainTask] Error getting project config. Failed with API key not valid. Това се очаква: файлът беше измислен. С вашия истински файл и с още невключен Microsoft във Firebase резултатът още не е измерен; ако го видите, разкажете ни какво съобщение ви даде.


Стъпка 8 · В конзолите: регистрирайте приложението, без ключът да докосне файл

Тази стъпка и следващата изискват директорията от „Преди да започнете“. Тук не се пише код. Отворете двете конзоли в два раздела, защото три данни ще минат от едната в другата:

Данна Ражда се в Поставя се в
Адресът за връщане Firebase Entra
Application (client) ID Entra Firebase
Клиентският ключ Entra Firebase и в никое друго място

Менютата и бутоните са на английски, както в документацията. На испански изпробването от 13 ноември 2026 г. видя «Registros de aplicaciones», «Nuevo registro» и «Registrar una aplicación» (в конзолата на испански). Останалите надписи на испански не ги обходихме от край до край: ако вашата конзола казва друго, водете се по английската версия на всеки от тях и ни разкажете как се показва.

1. Във Firebase копирайте адреса си за връщане. В Authentication, раздел Sign-in method, изберете Microsoft и го включете. Още не запазвайте: панелът иска ID и ключ, които още нямате. Оставете този раздел отворен така, недовършен; връщате се към него в точка 5. При изпробването адресът беше копиран от същия този панел. Има този вид:

https://<tu-proyecto>.firebaseapp.com/__/auth/handler

Ръководството на Firebase за пренасочванията казва, че краят /__/auth/handler има значение.

2. В Entra влезте през entra.microsoft.com. Не през portal.azure.com: при изпробването акаунтът без абонамент получи там грешката AADSTS16000, а през Entra отвори собствената си директория.

3. Регистрирайте приложението. Според ръководството на Microsoft: Entra ID › App registrations › New registration.

  • Name: такова, което разпознавате. Ръководството предупреждава, че хората, които влизат, могат да го видят.
  • Supported account types: Any Entra ID Tenant + Personal Microsoft accounts, за акаунти на организации и лични. Това е тази, която използва изпробването.
  • Register.

Страницата Overview показва Application (client) ID. Него го записвате и вече можете да го поставите в раздела на Firebase. Не е ключът: ключът още не съществува.

4. Добавете адреса за връщане. Според ръководството: Manage › Authentication › Add Redirect URI › платформа Web › поставете адреса от точка 1 › Configure. Поставете го; не го пишете на ръка. Microsoft иска да започва с https и различава главните от малките букви.

5. Създайте ключа. Според ръководството: Certificates & secrets › Client secrets › New client secret. Задайте описание и изберете срок на изтичане. Ръководството казва, че не може да надвишава 24 месеца, и препоръчва по-малко от 12. Add.

Ключът се появява в колоната Value, а ръководството предупреждава, че не се показва отново, след като напуснете страницата. С тази страница отворена:

  • Копирайте го с бутона за копиране и го поставете направо в полето за ключа на панела на Microsoft, в раздела на Firebase. Проверете дали Application (client) ID от точка 3 вече е в своето поле. Save.
  • Не го поставяйте на никое друго място. После копирайте някакъв друг текст, за да го изкарате от клипборда (препоръка на тази поредица).
  • Запишете датата на изтичане. Когато настъпи, входът с Microsoft спира да работи, докато не създадете друг ключ и не го занесете във Firebase.
  • Не правете никаква снимка на екрана, докато колоната Value показва ключа.

Една граница, за да не се извади оттук някаква архитектура: Firebase иска това ID и този ключ за този доставчик, а същото ръководство на Microsoft препоръчва сертификати вместо ключове, преди приложението да се пусне в продукция. За истински продукт това се преглежда с онзи, който отговаря за сигурността: политиката на Entra, ротацията на ключа и видът на удостоверението.

6. Оставете доказателство. В respuestas/05.md:

Данна Записвате
Application (client) ID Да, цялото
Вид акаунти Да, името на опцията
Адрес за връщане Да, целият
Изтичане на ключа Да, датата
Стойност на ключа Никога

И една снимка на Certificates & secrets, направена след като напуснете тази страница и влезете пак. Ако на снимката остане на показ каквато и да е част от стойността, закрийте я, преди да я запазите.

7. Накарайте verifica да търси. Пуснете го: двете отметки „Clave:“ (ключ) трябва да са зелени. За да знаете, че това търсене наистина вижда, посейте измислен ключ. Тази команда го сглобява на части, за да не остане написан никъде, и го добавя като коментар в края на един файл:

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

Пуснете verifica. На 18 ноември 2026 г., върху непипнатия начален проект, отговори с файла и номера на реда, без да отпечата текста (вашият номер на ред може да е друг):

❌ Hay un texto con forma de clave de cliente de Entra en: inicio/app/src/main/java/…/Armado.kt:19. No la imprimo. …

(На български: има текст с формата на клиентски ключ на Entra в посочения файл, ред 19. Не го отпечатвам.)

Изтрийте този последен ред във вашия редактор и пуснете verifica отново: зелено.

Какво доказва и докъде. Отметките „Clave:“ доказват, че никой текстов файл от inicio/ и respuestas/05.md не носи текст с формата на такива ключове и не назовава клиентска тайна. Формата е вдъхновена от публично правило на gitleaks, но verifica не изпълнява gitleaks и не замества сканиране за тайни: по-просто е, може да отбележи невинен текст и пропуска други форми, двоичните файлове, променливите на средата и историята на git. Не вижда и вашия терминал, вашите снимки на екрана, нито клипборда ви. Тази част я пазите вие, а вашата таблица и снимка ги сравнявате вие.


Стъпка 9 · В телефона: истинското ниво

Тази стъпка говори с Microsoft, веднъж, на ръка. Тя е единствената, която проверява стъпка 8: че адресът за връщане е точният, че ID-то е от вашата регистрация и че ключът, който сте запазили, е действащият.

С отворен емулатор, стоейки в inicio/:

./gradlew installDebug

Отворете „Магазинът“ („La tienda“), докоснете „Вход“ („Entrar“) и после „Вход с Microsoft“ („Entrar con Microsoft“).

Онова, което се видя при изпробването на 13 ноември 2026 г. (Mac, емулатор, лични акаунти). Това изпробване използва пробен код със същите повиквания, не този от solucion/:

Случай Какво се видя
Първият път Отвори се браузърът със страницата на Microsoft; написа се акаунтът; приложението поздрави с името
Разрешението Екран „Let this app access your info?“, с отметката unverified до името на приложението, „Read your profile“ и бутоните Deny и Accept. Очаква се при примерно приложение без потвърден издател. Microsoft запази приемането: не се появи отново
Повторно влизане Microsoft показа вече влезлия акаунт, за да се избере без парола
Имейл, който вече е влизал с Google Изключението за колизия от стъпка 5
Приложението, затворено по средата на вход Онова от стъпка 6: висящият резултат предаде входа

Класът NavegadorConFirebase на този урок го пуснахме само до грешката с измисления файл от стъпка 7; пълният вход с истински акаунт още не. Ако при изпробването му видите нещо различно, разкажете ни какво се е появило.

Ако акаунтът ви използва ключ за достъп (passkey). При изпробването екранът „Sign in with your passkey“ остана на „Verifying…“ в емулатора. Докосна се Cancel и се влезе с паролата.

Ако браузърът предложи да запази паролата: на компютър, който не е ваш, „No“.

Опитайте края на сцената. С отворена на преден план страницата на Microsoft и преди да изберете акаунт, в друг терминал:

adb shell am kill mx.habil.ejemplo.tienda
adb shell pidof mx.habil.ejemplo.tienda

Първата прекратява процесите на приложението, които е безопасно да се прекратят, според документацията на adb. Втората не бива да отпечата нищо: процесът вече не съществува. Сега изберете акаунта си. Приложението трябва да стартира и да ви поздрави, без да докосвате бутона отново.

Като приключите, на компютър, който не е ваш: излезте от Microsoft в браузъра на емулатора и изтрийте данните му (урок 00).

Доказва се с: истинското влизане доказва, че регистрацията, адресът за връщане, ID-то и ключът са наред. Не доказва случаите на невлизане: те ги покрива симулираното ниво.


Вашите упражнения

Стъпки 1, 5 и 6 се правят без ИИ.

# Правите Готово е, когато
5.1 Регистрирате приложението в Entra с точния адрес за връщане и занасяте неговото ID и ключ във Firebase Три доказателства. Вашата таблица от стъпка 8 и вашата снимка без ключ на показ: сравнявате ги вие. Двете отметки „Clave:“ на verifica в зелено, които казват само, че никой файл от inicio/ и respuestas/05.md не носи тази форма или това име. И истинското влизане от стъпка 9, което е единственото, което валидира регистрацията
5.2 Имплементирате EntradaConMicrosoft, без да променяте екраните, и поемате висящия резултат Три доказателства. Симулирано: отметките му на verifica в зелено; валидира какво иска вашият клас и какво отговаря, с врата дубльор, и че 20-те теста от урок 04 остават зелени със своите файлове идентични. Не удостоверява само по себе си, че инсталираното приложение използва вашия вход: това го подкрепят MainActivity.kt, идентичен с този на урока, и тестът за онова, което сглобява Armado.kt. Инструментирано: 9 от 9, същото вътре в Android. Реално: влизате в стъпка 9 и затваряте процеса по средата на вход; това е единственото, което валидира, че Android наистина ви връща в приложението
5.3 Сравнявате Google и Microsoft с петте въпроса от стъпка 1 Таблицата ви съвпада с тази от „Сравнете отговорите си“. Сравнявате я вие
5.4 Искате от Claude Code втория вход, като вземе първия за образец, и изброявате онова, което не е копирал добре Вашият списък с да и не от стъпка 4, с файл и ред на всяко „не“, спрямо осемте въпроса от „Сравнете отговорите си“. Ако осемте дадат „да“, вашето предаване е тази таблица и изречението „No encontré desvíos en las ocho revisiones“. Оценявате я вие; verifica не я чете

Време: отделете около четири часа, с регистрацията в Entra, „Счупете едно нарочно“, инструментираното ниво и истинското влизане; без стъпки 8 и 9, около два часа и половина. Това е оценка: ще я уточним според времето, което отнеме на първата група. Набавянето на директорията не е сметнато: при изпробването пробният абонамент се появи като активен след около 15 минути.


Не ви ли тръгва?

Виждате Вероятна причина Какво правите
File google-services.json is missing. Не сте копирали файла си в inicio/app/ cp от „Преди да започнете“. Върху solucion/ това се очаква в чисто копие (клонинг) на хранилището
❌ „Estos archivos ya no son los de la lección 04“ (тези файлове вече не са тези от урок 04) Някой, вие или Claude Code, е променил тест, врата или екран от урок 04 git diff -- <файл> и върнете го на ръка
❌ „Tu entrada no retoma“ (вашият вход не поема) retomar() не използва онова, което връща pendiente() Стъпка 4. Ако идвате от „Счупете едно нарочно“, стъпка 6, точка 4
❌ Случаят „error“ в червено, с написана resultadoDe Всяко FirebaseAuthWebException се брои за отказ Стъпка 5: липсва условието за кода
❌ „Hay un texto con forma de clave de cliente de Entra“ (има текст с формата на клиентски ключ на Entra) Ключ, или нещо с неговата форма, е във файл Ако е вашият ключ: изтрийте го от файла, елиминирайте го в Entra и създайте друг (стъпка 8). Ако е измисленият от контрола: изтрийте този ред
В тестовете Default FirebaseApp is not initialized Променени са robolectric.properties или AppDePruebas.kt (измерено на 18 ноември 2026 г. без тях) Върнете ги: те са скеле
В инструментираните тестове NoSuchMethodException: android.hardware.input.InputManager.getInstance Махнат е редът на Espresso 3.7.0 и е останал този, който Compose носи по подразбиране. Измерено на 18 ноември 2026 г. на Android 37: 0 от 9 Върнете androidTestImplementation(libs.espresso.core)
В телефона „No se pudo entrar…“ (влизането не успя…), без да се отвори никаква страница С измислен файл дневникът каза API key not valid (измерено на 18 ноември 2026 г.). С вашия файл, какво дава с невключен Microsoft или с изтекъл ключ, още не сме измерили Проверете дали сте копирали вашия google-services.json и стъпка 8
В браузъра грешка AADSTS50011 Според Microsoft: адресът за връщане от заявката не съвпада с нито един от регистрираните. Не е измерено тук Стъпка 8, точка 4: поставете го отново, цял
В portal.azure.com, AADSTS16000 Измерено на 13 ноември 2026 г. с акаунт без абонамент Влезте през entra.microsoft.com
„Nuevo registro“ (в конзолата на испански) отваря панел без формуляр Акаунтът ви няма директория (измерено на 13 ноември 2026 г. с новосъздаден акаунт) „Преди да започнете“: първо ви трябва директория
„Ese correo ya entró a la tienda con otro botón…“ (този имейл вече е влизал в магазина с друг бутон…) Този имейл вече има потребител във вашия проект, създаден с друг доставчик; в тази поредица, Google Влезте с Google. Двата бутона да стигат до един и същ потребител е урок 06
Екранът на ключа за достъп остава на „Verifying…“ Измерено на 13 ноември 2026 г. в емулатора Cancel и влезте с паролата
❌ „EntradaConMicrosoft.kt nombra una puerta concreta“ (EntradaConMicrosoft.kt назовава конкретна врата) Вашият код назовава истинската врата (NavegadorConFirebase) или дубльор от тестовете. Тестовете му подават само дубльори: ако кодът ви пита коя му се е паднала, зеленото не казва какво прави с истинската Кодът ви да говори само с NavegadorDeProveedor. Истинската врата я избира MainActivity.kt, който е даден (стъпка 4)

На Linux Mint 22.3 (x86_64) verifica на този урок излезе същото като на Mac (18 ноември 2026 г.), на симулираното ниво и с пробен файл, който носеше отпечатъка на този компютър: върху inicio/, 23 от 44 зелени; върху solucion/, 44 от 44. Инструментираното ниво не е измервано на Linux.


В заключение

Отговорете, без да четете отново:

  1. Къде живее клиентският ключ, кой го използва и защо не отива в приложението?
  2. Какво трябва да съвпада точно между Firebase и Entra?
  3. Вашият verifica дава 44 от 44 и отметките „Clave:“ са зелени. Кажете едно нещо, което това доказва, и две, които не доказва.
  4. Защо „Don't keep activities“ не върши работа за изпробване на retomar()?

Какво следва: в урок 06 човекът със същия имейл в двата доставчика остава с един потребител, и то само ако сам го потвърди.


Сравнете отговорите си

Стъпка 1. Вашият код участва в ред 1, когато сглобява заявката, и получава ред 6. Редове от 2 до 5 се случват между Firebase, браузъра и Microsoft. Вашата таблица:

Въпрос Google (урок 04) Microsoft (този урок)
Кой регистрира приложението и къде? Вие регистрирате приложението във Firebase и добавяте отпечатъка; клиентите на Google не ги добавяте на ръка: идват във вашия google-services.json, след като включите Google (урок 03) Вие, на ръка, в конзолата на Entra, която е извън Firebase
Какво показва на човека къде да влезе? Credential Manager, с прозореца с акаунтите на Android Браузърът, със страницата на Microsoft
Какво получава вашето приложение от доставчика? Токен за самоличност, който то само носи до Firebase Нищо: кодът пътува от Microsoft до Firebase. Приложението получава от Firebase потребителя
Има ли ключ? Къде живее? Вие не управлявате никакъв: в приложението отива само ID-то на уеб клиента, което не е тайна Да, клиентският ключ. Създавате го в Entra и живее в конзолата на Firebase
Какво трябва да съвпада? Името на пакета и отпечатъкът Адресът за връщане, знак по знак

Еднакво е шаблонът: един Entrada с неговата врата, един Resultado за всеки начин на завършване, тестовете с дубльор и Firebase, който в края предава потребител. Екраните не разбраха, че има нов доставчик.

Стъпка 4. retomar() връща null и екранът остава на приветствието, без съобщение. entrar() пита отново, защото това иска ръководството на Firebase, преди да отвори друг поток: който докосне бутона, не бива да влезе два пъти, ако вече има чакащ отговор.

Упражнение 5.4. Осем въпроса с да или не за онова, което е генерирал Claude Code. Очакват се осем „да“; всяко „не“ е нещо, което не е копирал добре, и отива във вашия списък с файл и ред. Списъкът казва какво да се провери, не какво ще се провали: не е измерено какво генерира инструментът.

# Въпрос Защо
1 Доставчикът текстът "microsoft.com" ли е, без https://? Така го пише ръководството на Firebase
2 Оставило ли е вън онова, което беше на Google: GetCredentialRequest, GetSignInWithGoogleOption, GoogleIdTokenCredential? Тук няма токен, който да се иска от телефона
3 Класът получава ли само вратата navegador, без idDeClienteWeb, нито друг идентификатор? ID-то и ключът живеят в конзолите
4 entrar() пита ли pendiente() преди abrir? Това иска ръководството, за да не накара да се влезе два пъти
5 retomar() никога ли не вика abrir? Вика се при отварянето на приложението, без никой да докосва бутон
6 Не са ли записани никакво ID на клиент, никакъв ключ, нито идентификатор на директория? Правилото за данните от стъпка 2. Параметърът tenant със стойност common не е ваша данна: това е стойността по подразбиране
7 Никой ли не назовава accessToken, idToken или OAuthCredential? Правило за данните: от Firebase излиза само името
8 Останали ли са непипнати тестовете, вратите, екраните и вашият google-services.json? verifica сравнява тези файлове

Стъпка 5. Би видял този на отказа, „Cerraste la ventana…“ (затворихте прозореца…), въпреки че не е затворил нищо. Без условието всяка грешка на браузъра се брои за отказ.

Стъпка 6. Компилира се и бутонът продължава да работи. Стават червени седем теста: тези на retomar() и трите, които отварят приложението с нещо недовършено. Тези на бутона остават зелени, защото никой не затваря приложението: в тях браузърът дубльор отговаря начаса.

В заключение:

  1. Ражда се в Entra и живее в конзолата на Firebase. Използват го сървърите на Firebase, за да сменят кода на Microsoft за данните на човека. Не отива в приложението, защото всеки, който има инсталирано приложението, би могъл да го извади: Microsoft иска да не се използва в нативни приложения.
  2. Адресът за връщане: този, който използва Firebase, и този, който сте регистрирали в Entra.
  3. Доказва какво иска вашият клас и какво отговаря във всеки случай, с врата дубльор, и че никой прегледан файл не носи текст с формата на ключ. Не доказва, че вашата регистрация в Entra работи, нито че ключът не е във вашия терминал, в снимка на екрана или в историята на git.
  4. Защото унищожава екрана, но оставя жив процеса, който завършва входа сам. retomar() съществува за случая, когато процесът вече го няма.

Източници на урока

Отворени на 18 ноември 2026 г.

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx