19 novembre 2026

MFA per AD FS con approvazione sul telefono: il plugin Notakey, farm compresa

Plugin MFA Notakey per AD FS: approvazione sul telefono, installazione, registro, ordine nella farm, cosa vede l’utente. Testato su una farm di due server.

Se le vostre applicazioni autenticano gli utenti tramite Active Directory Federation Services (AD FS), anche il secondo fattore va collocato in AD FS. Il plugin MFA di Notakey si aggiunge ad AD FS come metodo di autenticazione aggiuntivo: dopo il normale accesso dell’utente, AD FS interpella il plugin, il plugin invia una richiesta al telefono dell’utente e l’accesso prosegue quando l’utente la approva.

L’abbiamo testato il 19 novembre 2026: AD FS su Windows Server 2022 in una farm di due server, plugin 1.1.68, appliance Notakey 5.2.2, Edge su una macchina Windows 10 aggiunta al dominio e Notakey Authenticator su iOS e Android. L’utente che compare nelle schermate è un account di laboratorio, skippy@ntklab.internal.

Che cosa vede l’utente

L’utente accede ad AD FS come sempre. Nel nostro laboratorio si trattava dell’autenticazione integrata di Windows da una macchina del dominio, quindi non è stata digitata alcuna password; su altri client l’utente inserisce la password nel modulo di accesso di AD FS.

Poiché la relying party richiede l’MFA, AD FS chiede a quel punto un metodo aggiuntivo. Nella nostra farm era attiva anche l’autenticazione tramite certificato, perciò AD FS ha proposto una scelta fra i due.

La pagina di AD FS “For security reasons, we require additional information to verify your account” con due link: “Sign in using a certificate” e “Notakey Authentication for ADFS v1.0”.

La pagina Notakey invita quindi l’utente ad approvare sul telefono. La pagina si reinvia da sola ogni 3 secondi per verificare se è arrivata la risposta, quindi l’utente non deve fare clic su nulla.

La pagina di AD FS con un indicatore di attesa e il testo “Authentication request created successfully. Please proceed with authentication on your mobile device.”, un logo Notakey e un link “Sign in with other options”.

Sul telefono la richiesta indica quale utente sta effettuando l’accesso.

Notakey Authenticator che mostra una richiesta del servizio “AD FS”: titolo “AD FS login request”, testo “Proceed with login for user skippy@ntklab.internal?”, un conto alla rovescia a circa 4:45 e i pulsanti Deny e Approve.

Dopo l’approvazione AD FS indirizza l’utente all’applicazione. Un secondo accesso nella stessa sessione AD FS non ha richiesto di nuovo l’MFA.

Sull’appliance

  1. Un servizio per AD FS. Il suo ID va inserito nel registro dei server AD FS.
  2. Utenti denominati con il loro UPN. Il plugin usa come nome utente Notakey l’identità che AD FS gli passa, ossia il nome principale dell’utente (UPN). Nel nostro laboratorio l’utente skippy@ntklab.internal esisteva nel servizio esattamente con quel nome.
  3. Almeno un requisito di registrazione, affinché gli utenti possano aggiungere il servizio in Notakey Authenticator. La guida alla prima approvazione sul telefono tratta questa parte.

Su un singolo server AD FS

  1. Scaricate il plugin dalla pagina dei download e verificatene lo SHA-256.
  2. Installate l’MSI. Copia i file ma non modifica AD FS.
  3. In una PowerShell da amministratore, eseguite AdfsPluginInstall.ps1 dalla cartella del programma. Lo script registra il plugin in AD FS, crea l’origine del registro eventi Notakey ADFS, propone di applicare un criterio MFA e riavvia AD FS.
  4. Inserite nel registro l’indirizzo dell’appliance e l’ID del servizio, poi riavviate 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 deve terminare con /api/. Valori facoltativi stabiliscono per quanto tempo una richiesta resta valida (MessageTtlSeconds, 300 secondi per impostazione predefinita) e il testo mostrato sul telefono (MessageActionTitle, MessageDescription); il manuale del plugin li elenca tutti.

Infine, richiedete l’MFA dove vi serve, ad esempio con il criterio di controllo di accesso “Permit everyone and require MFA” su una relying party.

In una farm l’ordine conta

In una farm AD FS il plugin si registra una sola volta, per l’intera farm, ma le sue librerie devono trovarsi su ogni server. Un errore in questa fase può eliminare il secondo fattore senza che nessuno se ne accorga.

Un server che non dispone delle librerie della versione registrata non riesce a caricare il provider Notakey e non lo richiede. Se Notakey è l’unico metodo di autenticazione aggiuntivo, un utente che arriva su quel server accede senza il secondo fattore. AD FS registra l’evento 105 nel proprio registro Admin su quel server, e nella pagina di accesso non compare nulla.

Ci è successo nel nostro stesso laboratorio mentre preparavamo questo articolo: il server secondario aveva ancora le librerie di una versione precedente mentre nella farm era registrata quella nuova, e ha continuato a registrare l’evento 105 finché non vi abbiamo installato le nuove librerie.

Quindi, in una farm:

  1. Installate prima l’MSI ed eseguite AdfsPluginInstall.ps1 su ogni server secondario. Lì lo script installa soltanto le librerie.
  2. Impostate i valori di registro su ogni server.
  3. Installate l’MSI ed eseguite AdfsPluginInstall.ps1 sul server primario. Questo registra il plugin per la farm.
  4. Riavviate AD FS sui server secondari dopo che si sono sincronizzati con il primario (per impostazione predefinita ogni cinque minuti; controllate LastSyncTime in Get-AdfsSyncProperties).
  5. Controllate il registro Admin di AD FS di ciascun server per l’evento 105.

In una farm basata su SQL Server ogni server si presenta come primario: eseguite AdfsPluginInstall.ps1 -LibrariesOnly su tutti i server tranne uno e lo script senza parametri su quello rimanente. Gli aggiornamenti seguono lo stesso ordine.

Aggiornamento dalla versione 1.1.67 o precedenti

La versione 1.1.68 contiene importanti correzioni di sicurezza e la raccomandiamo per tutte le installazioni. Installate il nuovo MSI sopra quello vecchio ed eseguite il nuovo AdfsPluginInstall.ps1; non eseguite prima il vecchio script di disinstallazione, perché quello script svuota l’intero elenco dei provider di autenticazione aggiuntivi. Se per le versioni precedenti avevate modificato l’intestazione Content-Security-Policy di AD FS, potete ripristinarne il valore predefinito una volta aggiornati tutti i server della farm. Il manuale del plugin riporta i dettagli.

Quando qualcosa non funziona

La pagina di accesso mostra all’utente soltanto un codice di errore. La causa si trova nel registro eventi Applicazione del server che ha gestito l’accesso, origine Notakey ADFS, in una voce che inizia con lo stesso codice. I due codici che incontrerete più probabilmente:

  • 1114: non è stato possibile creare la richiesta. Di solito l’utente non esiste nel servizio Notakey con il proprio UPN, l’ID del servizio è errato oppure l’appliance non è raggiungibile.
  • 5642: non è stato possibile verificare lo stato della richiesta, perché l’appliance non è raggiungibile o non conosce la richiesta.

Se non viene registrato nulla, manca l’origine del registro eventi: eseguite AdfsPluginInstall.ps1 su quel server e riavviate AD FS.

Che cosa non fa

  • Protegge gli accessi che passano da AD FS, e solo dove il vostro criterio richiede l’MFA. Le applicazioni che non usano AD FS e i protocolli che lo aggirano restano scoperti.
  • Un’approvazione è un tocco. Un utente può approvare una richiesta che non ha avviato lui, e il nome utente indicato nella richiesta non lo impedisce. Si veda il nostro articolo sul push-bombing.
  • Dipende dall’appliance. Se AD FS non riesce a raggiungerla, gli accessi che richiedono l’MFA non possono essere completati. Tenetene conto prima di applicare il criterio a tutti.

← Tutti gli articoli

Il vostro primo accesso senza password, già questa settimana

30 minuti con un ingegnere, non una presentazione commerciale. Insieme pianificheremo come avviare un progetto pilota funzionante nel vostro ambiente VPN, SSO o Windows.