19. November 2026

AD-FS-MFA mit Bestätigung am Telefon: das Notakey-Plugin, auch in der Farm

Bestätigung am Telefon für AD-FS-Anmeldungen: Notakey-Plugin, Registry, Reihenfolge in der Farm und was der Benutzer sieht. Getestet mit zwei Servern.

Melden sich Benutzer an Ihren Anwendungen über die Active Directory-Verbunddienste (AD FS) an, gehört der zweite Faktor ebenfalls in AD FS. Das Notakey-MFA-Plugin trägt sich in AD FS als zusätzliche Authentifizierungsmethode ein: Nach der normalen Anmeldung des Benutzers fragt AD FS das Plugin, das Plugin sendet eine Anfrage an das Telefon des Benutzers, und die Anmeldung geht weiter, sobald der Benutzer sie bestätigt.

Getestet haben wir am 19. November 2026: AD FS unter Windows Server 2022 in einer Farm aus zwei Servern, Plugin 1.1.68, Notakey Appliance 5.2.2, Edge auf einem Windows-10-Rechner in der Domäne und Notakey Authenticator unter iOS und Android. Der Benutzer auf den Screenshots ist ein Testkonto, skippy@ntklab.internal.

Was der Benutzer sieht

Der Benutzer meldet sich wie bisher an AD FS an. In unserem Test geschah das per integrierter Windows-Authentifizierung von einem Domänenrechner aus, ohne ein Passwort einzutippen; auf anderen Clients gibt der Benutzer sein Passwort in das Anmeldeformular von AD FS ein.

Da die vertrauende Seite MFA verlangt, fragt AD FS anschließend nach einer zusätzlichen Methode. In unserer Farm war außerdem die Zertifikatauthentifizierung aktiviert, deshalb bot AD FS beide zur Auswahl an.

Die AD-FS-Seite „For security reasons, we require additional information to verify your account“ mit zwei Links: „Sign in using a certificate“ und „Notakey Authentication for ADFS v1.0“.

Die Notakey-Seite fordert den Benutzer dann auf, die Anfrage am Telefon zu bestätigen. Die Seite wird alle 3 Sekunden automatisch erneut abgesendet, um die Antwort abzufragen; der Benutzer muss also nichts anklicken.

Die AD-FS-Seite mit einem Ladesymbol und dem Text „Authentication request created successfully. Please proceed with authentication on your mobile device.“, einem Notakey-Logo und dem Link „Sign in with other options“.

Auf dem Telefon nennt die Anfrage den Benutzer, der sich gerade anmeldet.

Notakey Authenticator mit einer Anfrage des Dienstes „AD FS“: Titel „AD FS login request“, Text „Proceed with login for user skippy@ntklab.internal?“, ein Countdown bei etwa 4:45 und die Schaltflächen Deny und Approve.

Nach der Bestätigung leitet AD FS den Benutzer zur Anwendung weiter. Eine zweite Anmeldung in derselben AD-FS-Sitzung verlangte keine erneute MFA.

Auf der Appliance

  1. Einen Dienst für AD FS. Seine ID kommt auf den AD-FS-Servern in die Registry.
  2. Benutzer, die nach ihrem UPN benannt sind. Das Plugin verwendet die Identität, die AD FS ihm übergibt, also den Benutzerprinzipalnamen (UPN), als Notakey-Benutzernamen. In unserem Test existierte der Benutzer skippy@ntklab.internal im Dienst unter genau diesem Namen.
  3. Mindestens eine Registrierungsanforderung, damit Benutzer den Dienst in Notakey Authenticator hinzufügen können. Diesen Teil beschreibt der Beitrag Von null zur ersten Bestätigung am Telefon.

Auf einem einzelnen AD-FS-Server

  1. Laden Sie das Plugin von der Download-Seite herunter und prüfen Sie den SHA-256-Wert.
  2. Installieren Sie das MSI-Paket. Es kopiert die Dateien, verändert AD FS aber nicht.
  3. Führen Sie in einer PowerShell mit Administratorrechten AdfsPluginInstall.ps1 aus dem Programmordner aus. Das Skript registriert das Plugin bei AD FS, legt die Ereignisquelle Notakey ADFS an, bietet an, eine MFA-Richtlinie anzuwenden, und startet AD FS neu.
  4. Hinterlegen Sie für das Plugin die Adresse der Appliance und die ID des Dienstes in der Registry und starten Sie AD FS danach neu:
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 muss auf /api/ enden. Mit optionalen Werten legen Sie fest, wie lange eine Anfrage gültig bleibt (MessageTtlSeconds, standardmäßig 300 Sekunden) und welchen Text das Telefon anzeigt (MessageActionTitle, MessageDescription); das Handbuch des Plugins führt alle auf.

Verlangen Sie zum Schluss MFA dort, wo Sie sie brauchen, etwa mit der Zugriffssteuerungsrichtlinie „Permit everyone and require MFA“ für eine vertrauende Seite.

In einer Farm kommt es auf die Reihenfolge an

In einer AD-FS-Farm wird das Plugin einmal für die ganze Farm registriert, seine Bibliotheken müssen aber auf jedem Server liegen. Ein Fehler an dieser Stelle kann den zweiten Faktor unbemerkt außer Kraft setzen.

Ein Server, dem die Bibliotheken der registrierten Version fehlen, kann den Notakey-Provider nicht laden und fordert Notakey deshalb auch nicht an. Ist Notakey die einzige zusätzliche Authentifizierungsmethode, meldet sich ein Benutzer, der auf diesem Server landet, ohne zweiten Faktor an. AD FS schreibt auf diesem Server das Ereignis 105 in sein Admin-Protokoll, und auf der Anmeldeseite deutet nichts darauf hin.

Genau das ist uns bei der Vorbereitung dieses Beitrags im eigenen Testaufbau passiert: Auf dem sekundären Server lagen noch die Bibliotheken einer älteren Version, während in der Farm bereits die neue registriert war, und der Server protokollierte das Ereignis 105, bis wir die neuen Bibliotheken dort installiert hatten.

In einer Farm gehen Sie deshalb so vor:

  1. Installieren Sie zuerst auf jedem sekundären Server das MSI-Paket und führen Sie AdfsPluginInstall.ps1 aus. Dort installiert das Skript nur die Bibliotheken.
  2. Setzen Sie die Registry-Werte auf jedem Server.
  3. Installieren Sie das MSI-Paket auf dem primären Server und führen Sie dort AdfsPluginInstall.ps1 aus. Damit wird das Plugin für die Farm registriert.
  4. Starten Sie AD FS auf den sekundären Servern neu, sobald sie sich mit dem primären Server synchronisiert haben (standardmäßig alle fünf Minuten; siehe LastSyncTime in Get-AdfsSyncProperties).
  5. Prüfen Sie das AD-FS-Admin-Protokoll jedes Servers auf das Ereignis 105.

In einer Farm mit SQL Server meldet sich jeder Server als primär. Führen Sie dort AdfsPluginInstall.ps1 -LibrariesOnly auf allen Servern bis auf einen aus und auf dem verbleibenden das Skript ohne Parameter. Upgrades folgen derselben Reihenfolge.

Upgrade von 1.1.67 oder älter

Version 1.1.68 enthält wichtige Sicherheitskorrekturen, und wir empfehlen sie für alle Installationen. Installieren Sie das neue MSI-Paket über das alte und führen Sie das neue AdfsPluginInstall.ps1 aus. Führen Sie vorher nicht das alte Deinstallationsskript aus, denn es leert die gesamte Liste der zusätzlichen Authentifizierungsanbieter. Haben Sie für ältere Versionen den Content-Security-Policy-Header von AD FS angepasst, können Sie ihn auf den Standardwert zurücksetzen, sobald alle Server der Farm aktualisiert sind. Einzelheiten stehen im Handbuch des Plugins.

Wenn etwas nicht funktioniert

Die Anmeldeseite zeigt dem Benutzer nur einen Fehlercode. Die Ursache steht im Anwendungsprotokoll des Servers, der die Anmeldung bearbeitet hat, unter der Quelle Notakey ADFS, in einem Eintrag, der mit demselben Code beginnt. Die beiden Codes, denen Sie am wahrscheinlichsten begegnen:

  • 1114: Die Anfrage konnte nicht angelegt werden. Meist ist der Benutzer im Notakey-Dienst nicht unter seinem UPN angelegt, die ID des Dienstes ist falsch, oder die Appliance ist nicht erreichbar.
  • 5642: Der Status der Anfrage konnte nicht abgefragt werden, weil die Appliance nicht erreichbar ist oder die Anfrage nicht kennt.

Wird überhaupt nichts protokolliert, fehlt die Ereignisquelle: Führen Sie AdfsPluginInstall.ps1 auf diesem Server aus und starten Sie AD FS neu.

Was das Plugin nicht leistet

  • Es schützt Anmeldungen, die über AD FS laufen, und nur dort, wo Ihre Richtlinie MFA verlangt. Anwendungen, die AD FS nicht nutzen, und Protokolle, die an AD FS vorbeigehen, sind nicht abgedeckt.
  • Eine Bestätigung ist ein Fingertipp. Ein Benutzer kann eine Anfrage bestätigen, die er nicht selbst ausgelöst hat, und der Benutzername in der Anfrage verhindert das nicht. Siehe unseren Beitrag zu Push-Bombing.
  • Es hängt von der Appliance ab. Erreicht AD FS sie nicht, können Anmeldungen, die MFA verlangen, nicht abgeschlossen werden. Berücksichtigen Sie das, bevor Sie die Richtlinie für alle Benutzer aktivieren.

← Alle Artikel

Ihre erste passwortlose Anmeldung – noch diese Woche

30 Minuten mit einem Ingenieur statt einer Vertriebspräsentation. Gemeinsam planen wir, wie in Ihrer VPN-, SSO- oder Windows-Umgebung ein funktionierendes Pilotprojekt an den Start geht.