Per Anhalter durch OIDC

Manchmal heisst es: «Security ist schwierig». Und das stimmt, zumindest teilweise. Es ist schwierig, jedes Konzept im riesigen Feld der Security zu verstehen. Und es ist schwierig, all den Übeltäter*innen einen Schritt voraus zu sein, die auf Systeme zugreifen wollen, auf die sie keinen Zugriff haben. Also bringen wir etwas Licht ins Dunkel und erklären einen populären Baustein des modernen Webs: OIDC.
Authentifizierung versus Autorisierung
OIDC steht für «OpenID Connect». Es ist ein offenes Authentifizierungs-Framework. Mit anderen Worten: Es prüft, ob jemand wirklich die Person ist, die sie vorgibt zu sein. Um den Zweck von OIDC zu verstehen, müssen wir OAuth 2.0 kennen. Im Gegensatz zu OIDC ist OAuth ein Autorisierungs-Framework. Aber was ist eigentlich der Unterschied zwischen Authentifizierung und Autorisierung?
Authentifizierung (OIDC)

AuthN (Abkürzung für Authentifizierung) ist der Prozess, der prüft, ob jemand wirklich die Person ist, die sie vorgibt zu sein.
Bei der Authentifizierung fragt eine Applikation die Nutzer*innen nach ihrem Passwort oder ihrem Social-Media-Login.
Autorisierung (OAuth 2.0)

AuthZ (Abkürzung für Autorisierung) ist ein Sicherheitsprozess, der festlegt, ob jemand eine bestimmte Aktion auf einem bestimmten Service oder einer bestimmten Maschine ausführen darf.
Die Autorisierung definiert die Zugriffsrechte, die authentifizierte Nutzer*innen auf einem bestimmten System haben.
Meistens arbeiten diese beiden Mechanismen harmonisch zusammen und werden kombiniert eingesetzt. Egal, ob du dich mit deinem Social Login bei deinem Twitter-Feed anmeldest oder auf deinem Smart TV in deinen Netflix-Account einloggst.
Alles begann mit OAuth 1.0, definiert in RFC5849 [1]. OAuth 1.0 setzte allerdings tiefes Wissen über Kryptografie voraus und war eine Herausforderung in der Umsetzung. Um das Sicherheitskonzept von OAuth breiter nutzbar zu machen, entstand deshalb OAuth 2.0, definiert in RFC6749 [2].
OAuth ist ein offenes Autorisierungs-Framework, das definiert, wie Nutzer*innen den Zugriff auf ein bestimmtes System gewähren. Es definiert aber nicht, wie Credentials (zum Beispiel eine Kombination aus Benutzername und Passwort) übermittelt oder geprüft werden [2].
OIDC wurde geschaffen, um OAuth zu ergänzen, indem es die Authentifizierungs-Flows definiert. OIDC selbst ist nicht in einem RFC festgelegt, sondern hat eine eigene Spezifikation der OIDF (OpenID Foundation) [3].
Kurz zusammengefasst: OIDC steht für Authentifizierung (Identitätsprüfung), OAuth für Autorisierung (Zugriffsverwaltung).
OIDC-Authentifizierungs-Flows
Da OAuth nicht definiert, wie die Credentials der Nutzer*innen übermittelt werden, führt OIDC mehrere Authentifizierungs-Flows ein, die sich sicher einsetzen lassen. Bei allen diesen Flows ist der Datenverkehr per HTTPS (TLS) gesichert. Nicht alle definierten Flows schaffen es in die nächste Version von OAuth (OAuth 2.1). Einige (wie der «Password Grant») sind aus Sicherheitsgründen deprecated.
In den folgenden Abschnitten beschreiben wir die drei meistgenutzten Grants («Grant» bedeutet in der OIDC/OAuth-Welt «Authentifizierungs-Flow»), denen du wahrscheinlich begegnen wirst, sowie einige Grundbegriffe.
Ausführlicher erklärt die OIDC-Spezifikation [3] die Authentifizierungs-Flows.
Begriffe
Jedes Thema in der Informatik hat seine eigenen Fachbegriffe. OAuth und OIDC sind da keine Ausnahme. Damit du die folgenden Abschnitte und Diagramme verstehst, hier ein paar Erklärungen zur Terminologie:
- Identity Provider (IdP): Ein externes System, das die Accounts der Nutzer*innen enthält und die Login-Credentials sowie weitere Sicherheitsmechanismen kennt.
- Relying Party (RP): Ein System (z. B. eine Applikation oder eine API), das die Authentifizierung der Endnutzer*innen voraussetzt oder auf deren Account zugreifen will.
- Client oder User-Agent: Die ursprüngliche Applikation, die im Namen der Nutzer*innen handelt.

Das Bild oben zeigt die Situation, wenn dein Client (oder deine Applikation) eine Single Page Application (SPA) ist. Die Nutzerin greift über einen Browser auf die SPA zu und erhält auf irgendeinem Weg ein Access Token vom IdP. Dieses Token legt sie dann der Relying Party vor, um auf deren API zuzugreifen. Die RP prüft das Access Token anschliessend beim IdP.
Greift die Nutzerin auf eine statische Webapplikation zu (keine SPA), verschmelzen Client und Relying Party. Der Client wird dann von der Relying Party an die Nutzerin ausgeliefert. Am grundsätzlichen Ablauf der Authentifizierung ändert das aber nichts.
Authorization Code Flow
Der beliebteste unter den «Grants» ist der Authorization Code Flow. Er wird unter anderem für Single Page Applications, Webapplikationen und native Apps (iOS / Android) eingesetzt.

Das Diagramm oben zeigt den Authorization Code Flow in OIDC mit einer Single Page Application.
Die Nutzerin («Alice») greift auf eine Applikation («Client») zu. Klickt sie auf «Login», wird sie zum IdP weitergeleitet. Dort gibt sie ihre Login-Credentials ein und durchläuft allenfalls eine Zwei-Faktor-Authentifizierung.
Sobald der IdP die Credentials validiert hat, wird Alice mit einem «Code» zurück zur Applikation geleitet. Dieser Authorization Code kann nur ein einziges Mal verwendet werden und ist sehr kurzlebig. Der Code dient dazu, den Client zu autorisieren. Ohne diesen Schritt könnte sich jeder beliebige Client den Authorization Code schnappen und sich dann als Nutzer*in beim IdP ausgeben.
Der Client tauscht den Code anschliessend gegen ein Access Token und ein ID Token (das sogenannte «Token Set») ein. Das Access Token kann dann an die API (Relying Party) geschickt werden, um die Nutzerin zu authentifizieren und zu autorisieren. Die RP prüft das Token beim IdP und erlaubt oder verweigert den Zugriff [3].
Device Authorization Flow
Der nächste Flow ist der «Device Authorization» Flow. Er wird häufig für Smart Devices, CLIs und andere Geräte genutzt, die keinen Browser bieten oder keine zugängliche Benutzeroberfläche haben. In der Regel vertrauen die Nutzer*innen dem Gerät in irgendeiner Form (z. B. dem eigenen Fernseher). Auf öffentlichen Geräten sollte dieser Flow nicht verwendet werden.
Mit diesem Flow kannst du dich zum Beispiel in der Netflix-App auf einem Smart TV authentifizieren. Der Fernseher zeigt dir eine URL und einen Device Code an. Rufst du die URL auf deinem Smartphone auf, gibst du deine Login-Credentials ein und autorisierst dann den Device Code. Damit ist das Gerät autorisiert und kann im Namen der Nutzer*in ein Access Token abrufen.

Das Bild oben zeigt ein Beispiel für den Device Authorization Flow in OIDC/OAuth.
Will sich die Nutzerin («Alice») auf einem Gerät (z. B. einer Smart-TV-App) einloggen, erstellt das Gerät einen Authorization Request beim IdP. Danach pollt das Gerät den IdP, bis es autorisiert ist oder ein Timeout eintritt.
Während das Gerät pollt, ruft Alice eine Login-Seite des IdP auf und gibt ihre Login-Credentials sowie den Device Authorization Code ein, den ihr das Gerät angezeigt hat. Der IdP markiert das Gerät dann im Kontext dieser Nutzerin als autorisiert.
Beim nächsten Poll erhält das Gerät ein Access Token für die entsprechende Nutzerin. Bis die Autorisierung widerrufen wird, darf das Gerät mit diesem Access Token auf APIs zugreifen, und die RP kann prüfen, ob das Gerät dafür authentifiziert und autorisiert ist [3].
Client Credentials Flow
Der letzte Flow, den wir uns anschauen, ist der «Client Credentials» Flow. Er wird für die Kommunikation von Maschine zu Maschine verwendet. Ein Beispiel dafür ist OAuth 2.0 Introspection (RFC7662), mit der eine API ein von einem Client übermitteltes Access Token prüfen kann. Der Introspection-Endpoint eines IdP (eine URL des IdP, die für OAuth Introspection genutzt wird) gibt für ein empfangenes Access Token active: true oder active: false zusammen mit weiteren Informationen zurück [4]. Damit sich die API gegenüber dem IdP authentifizieren und auf diese Informationen zugreifen kann, braucht es einen Client Credentials Flow.

Das Diagramm oben zeigt ein Beispiel für einen Client Credentials Flow. Zwei APIs wollen miteinander kommunizieren. Die erste API («GoLang API») authentifiziert sich beim IdP mit vorab bekannten Client Credentials. Diese Credentials können in vielen Formaten vorliegen. Gängig sind eine Kombination aus ClientID und ClientSecret (HTTP Basic) oder ein JWT-Profil.
Bei einem JWT-Profil [5] erstellt die erste API ein signiertes JWT (JSON Web Token) [6] und schickt es an den IdP. Der IdP prüft dann den verwendeten privaten RSA-Schlüssel anhand des hinterlegten Public Keys. Passen die beiden zusammen, ist die Maschine autorisiert.
Sobald die Maschine das Access Token erhalten hat, kann sie damit die zweite API («.NET API») aufrufen. Die .NET API prüft das Access Token beim IdP und liefert Daten zurück, falls die GoLang API autorisiert ist [3].
Fazit
Auch wenn OIDC nicht die ultimative Antwort auf alle Security-Fragen ist (kleiner Tipp: Die Antwort lautet 42), bietet es eine sichere Möglichkeit, Nutzer*innen in modernen Applikationen zu authentifizieren. Dabei spielt es keine Rolle, ob die Apps auf einem Webserver oder deinem Fernseher laufen oder ob es sich um ein Mobile Game handelt. OIDC deckt in Kombination mit OAuth all diese Fälle ab.
Einen IdP baut man nicht einfach mal so selbst. Es gibt Unternehmen, die dir einen IdP zur Verfügung stellen (z. B. ZITADEL oder KeyCloak). Statt also selbst mit Benutzername-Passwort-Magie zu hantieren, binde einen IdP an und überlass ihm die Schwerstarbeit, die Daten deiner Nutzer*innen zu schützen.
Quellen
- E. Hammer-Lahav, «The OAuth 1.0 Protocol», Internet Engineering Task Force IETF, 1. April 2010. https://www.rfc-editor.org/rfc/rfc5849 (abgerufen am 26. Oktober 2022).
- D. Hardt, «The OAuth 2.0 Authorization Framework», Internet Engineering Task Force IETF, Oktober 2012. https://www.rfc-editor.org/rfc/rfc6749 (abgerufen am 26. Oktober 2022).
- N. Sakimura, J. Bradley, M. Jones, B. De Medeiros und C. Mortimore, «OpenID Connect Core 1.0», The OpenID Foundation OIDF, 8. November 2014. https://openid.net/specs/openid-connect-core-1_0.html (abgerufen am 26. Oktober 2022).
- J. Richer, «OAuth 2.0 Token Introspection», Internet Engineering Task Force IETF, 1. Oktober 2015. https://www.rfc-editor.org/rfc/rfc7662 (abgerufen am 26. Oktober 2022).
- M. Jones, B. Campbell und C. Mortimore, «JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants», Internet Engineering Task Force IETF, 1. Mai 2015. https://www.rfc-editor.org/rfc/rfc7523 (abgerufen am 26. Oktober 2022).
- M. Jones, J. Bradley und N. Sakimura, «JSON Web Token (JWT)», Internet Engineering Task Force IETF, Mai 2015. https://www.rfc-editor.org/rfc/rfc7519 (abgerufen am 26. Oktober 2022).

Geschrieben von
Christoph Bühler
Ähnliche Challenge auf dem Tisch? Lass uns drüber reden.





