JAAS & 2FA

vorhergehende Artikel in: Java Komponenten Security
19.12.2023

Ich habe an dieser Stelle bereits früher über Möglichkeiten der Nutzung von Einmalpasswörtern entsprechend RFC RFC 6238 in Java-Anwendungen berichtet. Nun wollte ich untersuchen, ob sich 2-Faktor-Authentifizierung in das Framework Java Authentication and Authorization Service (JAAS) integrieren lasen würde.

JAAS ist ein Framework, das es gestattet, Authentifizierung unkompliziert den Gegebenheiten und Anforderungen der jeweiligen Anwendung anzupassen: Die zu nutzenden Module für die eigentliche Authentifizierung werden in einer Konfigurationsdatei spezifiziert und zur Laufzeit instantiiert.

Ich wollte nun basierend auf dem UnixLoginModule und dem com.sun.security.auth.module.NTLoginModule eine 2-Faktor-Authentifizierung realisieren. Prinzipiell müsste aber jedes LoginModule nutzbar sein, sofern es einen Principal in den LoginContext einfügt. Ich wollte dazu über TOTP ein Token erzeugen, das als zweiter Faktor dienen sollte. Dazu erstellte ich zunächst eine Klasse, die ein einfaches Enrollment für HOTP/TOTP erlaubte. Damit erstellte ich für den Testanwender eine Datei in seinem Home-Verzeichnis. Das ist ein ähnliches Verfahren, wie es auch beim Yubikey oder dem originalen Google-Authenticator für die Benutzung mit Linux Pluggable Authentication Modules (PAM) genutzt wird.

Das neu zu erstellende LoginModule liest diese Datei ein - sofern sie nur die Rechte OWNER_READ und OWNER_WRITE gesetzt hat (unter Linux - unter Windows muss dieser Test aus naheliegenden Gründen entfallen)- und sucht das Secret des betreffenden Nutzers. Als Schlüssel dieser Suche wird der Name des durch eines der anderen definierten Module in den LoginContext eingefügten Principal benutzt. Mit diesem Secret wird dann der aktuell gültige Token ermittelt und mit dem, der vom Anwender eingegeben wurde verglichen.

Wichtig hierbei ist, dass das (komfortabel) nur möglich ist, wenn das in der Phase Commit des JAAS-Prozesses erledigt wird - nur dann sind Principals bereits gesetzt und man kann den Namen eines solchen Principal benutzen, um das entsprechende Secret aus der Datei zu lesen - die Alternative wäre, den Namen nochmals abzufragen.

Im Zuge dieses Experiments wurde der gesamte Code zum Thema OTP nochmals großmaßstäblich neu geschrieben. Die entsprechenden Klassen werden ab dem nächsten Update des Artefakts de/elbosso/util zur Verfügung stehen.

Die folgenden Zeilen zeigen eine beispielhafte Konfiguration jaas_2fa.config für eine Anwendung, die unter Linux und Windows gleichermaßen funktionieren soll:

twofa {
    com.sun.security.auth.module.UnixLoginModule optional debug=true;
    com.sun.security.auth.module.NTLoginModule optional debug=true;
    de.elbosso.util.security.TOTPLoginModule required debug=true otpuri=".TOTPTest.uri" principalClass="com.sun.security.auth.UnixPrincipal,com.sun.security.auth.NTUserPrincipal";
};

Der Parameter otpuri beschreibt falls er wie in diesem Beispiel einen relativen Dateinamen darstellt den Ort der Datei mit den Secrets relativ zum Home-Verzeichnis des Nutzers, der die Anwendung ausführt. Ist hier ein absoluter Pfad angegeben, wird dieser benutzt - egal welcher Nutzer die Anwendung ausführt.

Ich habe hier noch einige Links zu diesen Themen zusammengefasst:

Aktualisierung vom 19. Dezember 2023

Ich habe Repsy verlassen - meine Maven-Artefakte sind nun hier

<repository>
	<id>gitlab</id>
	<name>EL BOSSOs (https://elbosso.github.io/index.html) Maven Repository</name>
	<url>https://elbosso.gitlab.io/mvn/repository/</url>
</repository>

zu finden. Für dieses Artefakt heißt das, dass auch alle RELEASE Versionen und die aktuellste SNAPSHOT Version demnächst dorthin umziehen werden:

<dependency>
	<groupId>de.elbosso</groupId>
	<artifactId>util</artifactId>
	<version>2.3.0-SNAPSHOT</version>
</dependency>

In der Übergangszeit kann es zu einigen Problemen kommen - falls das so ist, bitte ich um ein kurzes Feedback - zum Beispiel in Gestalt eines Issues an dem betreffenden Projekt.

Alle Artikel rss Wochenübersicht Monatsübersicht Github Repositories Gitlab Repositories Mastodon Über mich home xmpp


Vor 5 Jahren hier im Blog

  • Mandelbrot-Sets mittels Shadern berechnen

    17.05.2019

    Nachdem ich in den letzten verregneten Tagen auf Youtube in den Videos von Numberphile versunken bin, hat mich eines davon angestachelt, mich selbst mit dem Mandelbrotset zu beschäftigen. Als ich dann noch Code fand, der behauptete, das auf einer Graphikkarte mittels Shadern berechnen zu können, war es um mich geschehen...

    Weiterlesen...

Neueste Artikel

  • Erste Vor-Version eines Gis-Plugin für die sQLshell

    Wie bereits in einem früheren Artikel erwähnt plane ich, demnächst ein Plugin für die sQLshell anzubieten, das eine Visualisierung von Daten mit räumlichem Bezug im Stil eines Geoinformationssystems erlaubt.

    Weiterlesen...
  • bad-certificates Version 2.1.0

    Das bereits vorgestellte Projekt zur automatisierten Erzeugung von Zertifikaten mit allen möglichen Fehlern hat eine Erweiterung erfahren und verfügt über ein Partnerprojekt - beide sind nunmehr in der Version 2.1.0 freigegeben

    Weiterlesen...
  • SQLite als Geodatenbank

    Wie bereits in einem früheren Artikel beschrieben treibe ich derzeit Anstrengungen voran, die sQLshell attraktiver für Nutzer zu machen, die mit Geodatenbanken arbeiten.

    Weiterlesen...

Manche nennen es Blog, manche Web-Seite - ich schreibe hier hin und wieder über meine Erlebnisse, Rückschläge und Erleuchtungen bei meinen Hobbies.

Wer daran teilhaben und eventuell sogar davon profitieren möchte, muß damit leben, daß ich hin und wieder kleine Ausflüge in Bereiche mache, die nichts mit IT, Administration oder Softwareentwicklung zu tun haben.

Ich wünsche allen Lesern viel Spaß und hin und wieder einen kleinen AHA!-Effekt...

PS: Meine öffentlichen GitHub-Repositories findet man hier - meine öffentlichen GitLab-Repositories finden sich dagegen hier.