2026. gada 19. novembris

AD FS MFA ar apstiprinājumu tālrunī: Notakey spraudnis, arī serveru fermā

Apstiprinājums tālrunī AD FS pieteikšanai ar Notakey MFA spraudni: instalēšana, reģistrs, secība fermā, lietotāja skats. Pārbaudīts divu serveru fermā.

Ja jūsu lietotnēs lietotāji piesakās caur Active Directory Federation Services (AD FS), arī otrajam faktoram vieta ir AD FS. Notakey MFA spraudnis pievienojas AD FS kā papildu autentifikācijas metode: pēc lietotāja ierastās pieteikšanās AD FS vēršas pie spraudņa, spraudnis nosūta pieprasījumu uz lietotāja tālruni, un pieteikšanās turpinās, tiklīdz lietotājs to apstiprina.

Testējām 2026. gada 19. novembrī: AD FS uz Windows Server 2022 divu serveru fermā, spraudņa versija 1.1.68, Notakey iekārta 5.2.2, Edge domēnam pievienotā Windows 10 datorā un Notakey Authenticator iOS un Android tālruņos. Ekrānuzņēmumos redzamais lietotājs ir testa konts skippy@ntklab.internal.

Ko redz lietotājs

Lietotājs piesakās AD FS tāpat kā līdz šim. Mūsu testa vidē tā bija Windows integrētā autentifikācija no domēna datora, tāpēc parole netika ievadīta; citos klientos lietotājs ievada paroli AD FS pieteikšanās veidlapā.

Tā kā atkarīgā puse (relying party) pieprasa MFA, AD FS pēc tam prasa papildu metodi. Mūsu fermā bija ieslēgta arī autentifikācija ar sertifikātu, tāpēc AD FS piedāvāja izvēlēties vienu no abām.

AD FS lapa „For security reasons, we require additional information to verify your account“ ar divām saitēm: „Sign in using a certificate“ un „Notakey Authentication for ADFS v1.0“.

Pēc tam Notakey lapa aicina lietotāju apstiprināt pieprasījumu tālrunī. Lapa ik pēc 3 sekundēm pati sevi iesniedz no jauna, lai pārbaudītu, vai atbilde ir saņemta, tāpēc lietotājam nekas nav jāklikšķina.

AD FS lapa ar gaidīšanas indikatoru un tekstu „Authentication request created successfully. Please proceed with authentication on your mobile device.“, Notakey logotipu un saiti „Sign in with other options“.

Tālrunī pieprasījumā redzams, kurš lietotājs piesakās.

Notakey Authenticator ar pieprasījumu no servisa „AD FS“: virsraksts „AD FS login request“, teksts „Proceed with login for user skippy@ntklab.internal?“, taimeris, kas rāda aptuveni 4:45, un pogas Deny un Approve.

Pēc apstiprināšanas AD FS novirza lietotāju tālāk uz lietotni. Atkārtoti piesakoties tajā pašā AD FS sesijā, MFA vairs netika prasīts.

Iekārtā

  1. Serviss AD FS vajadzībām. Tā ID tiek ierakstīts AD FS serveru reģistrā.
  2. Lietotāji, kuru vārdi ir viņu UPN. Spraudnis par Notakey lietotājvārdu izmanto identitāti, ko tam nodod AD FS, proti, lietotāja pamatvārdu (user principal name, UPN). Mūsu testa vidē lietotājs skippy@ntklab.internal servisā bija tieši ar šādu vārdu.
  3. Vismaz viena reģistrācijas prasība, lai lietotāji varētu pievienot servisu Notakey Authenticator lietotnē. Šī daļa aprakstīta ceļvedī par pirmo apstiprinājumu tālrunī.

Vienā AD FS serverī

  1. Lejupielādējiet spraudni no lejupielāžu lapas un pārbaudiet tā SHA-256.
  2. Instalējiet MSI. Tas nokopē failus, bet AD FS neaiztiek.
  3. PowerShell logā ar administratora tiesībām palaidiet AdfsPluginInstall.ps1 no programmas mapes. Skripts reģistrē spraudni AD FS, izveido notikumu žurnāla avotu Notakey ADFS, piedāvā piemērot MFA politiku un restartē AD FS.
  4. Reģistrā norādiet spraudnim iekārtas adresi un servisa ID, pēc tam restartējiet AD FS:
Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Notakey]

[HKEY_LOCAL_MACHINE\SOFTWARE\Notakey\AdfsMfa]
"ServiceURL"="https://your-appliance.example.com/api/"
"ServiceID"="<service ID>"

ServiceURL jābeidzas ar /api/. Ar neobligātām vērtībām var iestatīt, cik ilgi pieprasījums ir derīgs (MessageTtlSeconds, pēc noklusējuma 300 sekundes), un tekstu, ko rāda tālrunis (MessageActionTitle, MessageDescription); visas tās uzskaitītas spraudņa rokasgrāmatā.

Visbeidzot pieprasiet MFA tur, kur tas vajadzīgs, piemēram, piešķirot atkarīgajai pusei piekļuves kontroles politiku „Permit everyone and require MFA“.

Fermā svarīga ir secība

AD FS fermā spraudni reģistrē vienreiz, visai fermai, taču tā bibliotēkām jābūt katrā serverī. Kļūda šajā vietā var nemanāmi atņemt otro faktoru.

Serveris, kurā nav reģistrētās versijas bibliotēku, nevar ielādēt Notakey nodrošinātāju un to arī neprasa. Ja Notakey ir vienīgā papildu autentifikācijas metode, lietotājs, kura pieteikšanās nonāk šajā serverī, piesakās bez otrā faktora. AD FS šī servera administratora žurnālā ieraksta notikumu 105, bet pieteikšanās lapā tas nekādi neparādās.

Tieši to mēs pieredzējām paši savā testa vidē, gatavojot šo rakstu: sekundārajā serverī vēl bija vecākas versijas bibliotēkas, kamēr fermā jau bija reģistrēta jaunā, un šis serveris ierakstīja žurnālā notikumu 105, līdz instalējām tajā jaunās bibliotēkas.

Tāpēc fermā rīkojieties šādi:

  1. Vispirms katrā sekundārajā serverī instalējiet MSI un palaidiet AdfsPluginInstall.ps1. Tur skripts instalē tikai bibliotēkas.
  2. Iestatiet reģistra vērtības katrā serverī.
  3. Instalējiet MSI un palaidiet AdfsPluginInstall.ps1 primārajā serverī. Tas reģistrē spraudni visai fermai.
  4. Restartējiet AD FS sekundārajos serveros, kad tie ir sinhronizējušies ar primāro (pēc noklusējuma ik pēc piecām minūtēm; skatiet LastSyncTime komandas Get-AdfsSyncProperties izvadē).
  5. Pārbaudiet, vai katra servera AD FS administratora žurnālā nav notikuma 105.

Fermā, kas izmanto SQL Server, katrs serveris sevi uzrāda kā primāro; visos serveros, izņemot vienu, palaidiet AdfsPluginInstall.ps1 -LibrariesOnly, bet atlikušajā — skriptu bez parametriem. Jaunināšana notiek tādā pašā secībā.

Jaunināšana no versijas 1.1.67 vai vecākas

Versijā 1.1.68 ir svarīgi drošības labojumi, un iesakām to visām instalācijām. Instalējiet jauno MSI virs vecā un palaidiet jauno AdfsPluginInstall.ps1; vecās versijas atinstalēšanas skriptu iepriekš nepalaidiet, jo tas iztīra visu papildu autentifikācijas nodrošinātāju sarakstu. Ja vecāku versiju dēļ mainījāt AD FS galveni Content-Security-Policy, varat atjaunot tās noklusējuma vērtību, kad visi fermas serveri ir jaunināti. Sīkāka informācija ir spraudņa rokasgrāmatā.

Ja kaut kas nedarbojas

Pieteikšanās lapa lietotājam rāda tikai kļūdas kodu. Cēlonis meklējams Application notikumu žurnālā tajā serverī, kas apstrādāja pieteikšanos: avots Notakey ADFS, ieraksts, kas sākas ar to pašu kodu. Visbiežāk sastopamie kodi:

  • 1114: pieprasījumu neizdevās izveidot. Parasti lietotājs Notakey servisā nav atrodams ar savu UPN, servisa ID ir nepareizs vai iekārta nav sasniedzama.
  • 5642: pieprasījuma statusu neizdevās pārbaudīt, jo iekārta nav sasniedzama vai tai šis pieprasījums nav zināms.

Ja žurnālā nav ierakstīts vispār nekas, trūkst notikumu žurnāla avota: palaidiet AdfsPluginInstall.ps1 attiecīgajā serverī un restartējiet AD FS.

Ko spraudnis nedara

  • Tas aizsargā tikai pieteikšanos, kas notiek caur AD FS, un tikai tur, kur jūsu politika pieprasa MFA. Lietotnes, kas neizmanto AD FS, un protokoli, kas to apiet, netiek aizsargāti.
  • Apstiprinājums ir viens pieskāriens. Lietotājs var apstiprināt pieprasījumu, ko pats nav ierosinājis, un pieprasījumā norādītais lietotājvārds to nenovērš. Skatiet mūsu rakstu par push-bombing.
  • Tas ir atkarīgs no iekārtas. Ja AD FS to nevar sasniegt, pieteikšanās, kurām vajadzīgs MFA, nevar tikt pabeigtas. Paredziet šādu situāciju, pirms attiecināt politiku uz visiem lietotājiem.

← Visi raksti

Pirmā pieteikšanās bez paroles — jau šonedēļ

30 minūšu saruna ar inženieri, nevis pārdošanas prezentācija. Kopīgi izplānosim, kā jūsu VPN, SSO vai Windows vidē palaist strādājošu pilotprojektu.