CodeB Wallet · NFC · ISO/IEC 18013-5

Türzutritt auf dem Smartphone, an einen Hardwareschlüssel gebunden

Eine CodeB-Zutrittskarte ist eine Zutrittskarte in der CodeB Wallet. Ihre Administration stellt sie mit Standorten, Türgruppen und Gültigkeit aus; die Karte ist von Ihrer Website signiert und an einen Schlüssel gebunden, der die sichere Hardware des Smartphones nie verlässt. Leser prüfen sie offline, und ein verlorenes Smartphone wird in einem Schritt ersetzt.

NFC · ISO/IEC 18013-5 mdoc · SD-JWT VC · OpenID4VCI 1.0 · Hardware-Schlüsselattestierung · Statusliste

Die Ausstellung ist verfügbar; die Nutzung an Türlesern wird in der geschlossenen Beta der CodeB Wallet getestet. Testnachweise, nicht zertifiziert.

CodeB-Zutrittskarte in der Wallet: ein Smartphone funkt über NFC zu einer Tür

Kurz gesagt

Was
Eine Zutrittskarte in der Android-App CodeB Wallet, ausgestellt von der Administration der Website.
Formate
Eine Karte in zwei Standardformaten mit denselben Daten: ein ISO/IEC-18013-5-mdoc (io.codeb.access.1) für Leser und ein SD-JWT VC für die Online-Nutzung.
Auf der Karte
Eine zufällige Kartennummer, Standorte, Türgruppen, Beginn und Ende, optional Zeitplan und Name sowie die Entsperrregel. Kein Foto, kein Geburtsdatum, nie der Anmeldename.
Schlüssel
An einen Schlüssel in der sicheren Hardware des Smartphones (StrongBox oder TEE) gebunden, nachgewiesen durch eine Schlüsselattestierung beim Abholen.
Sperrung
Sofort, über die Statusliste der Website, für beide Formate.
Verlust
Ein Schritt: Die alte Karte wird gesperrt, und derselbe Zutritt geht mit einer neuen Kartennummer auf das neue Smartphone.

So funktioniert es

Die Website stellt aus, das Smartphone hält den Schlüssel, der Leser prüft offline.

Die Administration stellt aus

Auf der Admin-Seite wählt die Administration das Mitglied, die Standorte und Türgruppen, den Beginn und die Zahl der Tage (standardmäßig 30) oder ein Enddatum und ob das Smartphone nur entsperrt sein muss oder jede Berührung mit Fingerabdruck oder Displaysperre bestätigt.

Das Mitglied holt ab

Das Mitglied öffnet den Einladungslink oder QR-Code mit der CodeB Wallet und meldet sich selbst an. Das Smartphone erzeugt einen Schlüssel in seiner sicheren Hardware und weist ihn mit einer Schlüsselattestierung nach; ohne diesen Nachweis wird keine Karte ausgestellt.

An der Tür

Sie wählen die Karte in der CodeB Wallet und halten das Smartphone an den Leser. Das Smartphone beantwortet die frische Aufforderung des Lesers mit einer Signatur seines Hardwareschlüssels, zusammen mit den von der Website signierten Kartendaten.

Der Leser prüft

Offline: das Wurzelzertifikat der Website, den Document Signer, die signierten Kartendaten, die Signatur des Smartphones, die Gültigkeit und die zwischengespeicherte Statusliste. Danach Standort und Türgruppe.

Sperren oder ersetzen

Die Administration sperrt eine Karte mit einem Klick oder ersetzt sie nach einem Verlust. Leser weisen sie ab, sobald sie die neue Statusliste haben.

Sicherheit

Keine Kopien, keine Wiederholung

Die Karte ist an einen Schlüssel in der sicheren Hardware des Smartphones gebunden. Jede Vorlage signiert eine frische Aufforderung; aufgezeichnete oder kopierte Daten öffnen keine Tür.

Nur echte Smartphones

Eine Karte wird erst ausgestellt, wenn das Smartphone seinen Schlüssel mit einer Hardware-Schlüsselattestierung des CodeB-Wallet-Anbieters nachgewiesen hat. Ein Smartphone, das das nicht kann, erhält keine Karte.

Das Smartphone in der richtigen Hand

Das Smartphone muss entsperrt sein oder, wenn die Administration es so festlegt, jede Berührung mit Fingerabdruck oder Displaysperre bestätigen.

Von der Website signiert

Die Kartendaten sind vom Document Signer der Website unter ihrem eigenen Wurzelzertifikat (IACA) signiert. Geänderte Daten fallen durch; ein selbstsignierter Schlüssel wird nie verwendet.

Funktioniert offline

Ein Leser braucht für die Entscheidung kein Netz: Wurzelzertifikat und Statusliste sind zwischengespeichert. Online ist der Status nur aktueller.

Befristet

Jede Karte hat ein bei der Ausstellung festgelegtes Ende (höchstens 366 Tage) und wird danach nie mehr ausgestellt.

Datenschutz von Anfang an

  • Die Kartennummer ist zufällig. Der Anmeldename des Mitglieds erreicht nie einen Leser.
  • Kein Foto, kein Geburtsdatum, keine Adresse. Ein Name steht nur auf der Karte, wenn die Administration ihn einträgt.
  • Jede Karte wird einmal abgeholt, mit Anmeldung als das Mitglied; ein weitergeleiteter Link allein genügt nicht.

Was der Server speichert

  • Die Karte, ihren Zustand und wem sie gehört.
  • Den Schlüsseldatensatz des Smartphones, das sie abgeholt hat: Schlüsselspeicher (StrongBox oder TEE) und Fingerabdrücke der öffentlichen Schlüssel, damit ein verlorenes Smartphone ersetzt werden kann. Keine privaten Schlüssel.
  • Keine Datenbank: die eigenen Dateien der Website auf ihrem eigenen Server.

Smartphone verloren

Die Administration klickt bei der Karte auf „Lost phone“. Die Karte auf dem verlorenen Smartphone wird sofort in beiden Formaten gesperrt. Das Mitglied erhält eine Einladung für das neue Smartphone mit denselben Standorten, Türgruppen, Zeitplan, Entsperrregel und Enddatum und einer neuen Kartennummer. Die Kette von der alten zur neuen Karte bleibt für die Administration sichtbar.

Für Administration und Entwicklung

Admin-Seite
/access-cards-admin.html: ausstellen, auflisten, sperren, Verlust.
Ausstellen
POST /vci.ashx?access-offer
Auflisten
GET /vci.ashx?access-cards
Verlust
POST /vci.ashx?access-reenroll
Sperren
POST /vci.ashx?revoke-offer
Referenz
API-Dokumentation (EN) und openapi.json. Alle Admin-Aufrufe erfordern die Anmeldung einer Administratorin oder eines Administrators.

Standards

  • ISO/IEC 18013-5: mdoc-Datenmodell, Aussteller- und Geräteauthentisierung
  • OpenID for Verifiable Credential Issuance (OpenID4VCI) 1.0
  • SD-JWT-basierte Verifiable Credentials (SD-JWT VC)
  • X.509-Zertifikate (RFC 5280), COSE (RFC 9052)
  • EU Architecture and Reference Framework (ARF) 3.0 (Designziel, nicht zertifiziert)
  • eIDAS 2.0, Verordnung (EU) 2024/1183
  • Android-Hardware-Schlüsselattestierung (StrongBox / TEE)
  • ISO/IEC 14443 (NFC)

Häufige Fragen

Was ist eine CodeB-Zutrittskarte?

Eine Zutrittskarte in der CodeB Wallet. Ihre Administration legt Standorte, Türgruppen, Gültigkeit und die Entsperrregel des Smartphones fest; Sie holen die Karte einmal ab, indem Sie sich anmelden. Die Karte ist von der Website signiert und an einen Schlüssel in der sicheren Hardware Ihres Smartphones gebunden.

Welche Smartphones funktionieren?

Android-Smartphones mit der CodeB Wallet, deren Schlüssel in sicherer Hardware (StrongBox oder TEE) liegt, nachgewiesen durch eine Schlüsselattestierung beim Abholen der Karte. iPhones werden nicht unterstützt.

Braucht das Smartphone an der Tür Internet?

Nein. Die Karte und ihre Signaturen liegen auf dem Smartphone, und ein Leser, der ISO/IEC-18013-5-mdocs prüft, kontrolliert die Signatur der Ausstellerin und eine frische Signatur des Smartphones offline. Sperrungen erreichen die Leser über die Statusliste.

Kann eine Karte auf ein anderes Smartphone kopiert werden?

Nein. Jede Vorlage wird mit einem Schlüssel signiert, der die sichere Hardware des Smartphones nie verlässt, über eine frische Aufforderung des Lesers. Kopierte Kartendaten ohne diesen Schlüssel werden abgewiesen.

Was erfährt ein Türleser über mich?

Die Kartennummer (eine Zufallszahl, nicht Ihr Anmeldename), Ihre Standorte, Türgruppen und die Gültigkeit sowie die Entsperrregel. Ihr Name steht nur auf der Karte, wenn die Administration ihn eingetragen hat. Es gibt kein Foto und kein Geburtsdatum.

Ich habe mein Smartphone verloren. Was nun?

Melden Sie es Ihrer Administration. Die Karte auf dem verlorenen Smartphone wird sofort gesperrt, und Sie erhalten denselben Zutritt auf Ihrem neuen Smartphone mit einer neuen Kartennummer.

Ist das zertifiziert?

Nein. CodeB-Zutrittskarten sind Testnachweise während der geschlossenen Beta der CodeB Wallet. Sie sind auf ISO/IEC 18013-5, OpenID4VCI 1.0 und das EU Architecture and Reference Framework (ARF) 3.0 ausgelegt, aber nicht zertifiziert.

Wie kann ich es ausprobieren?

Die CodeB Wallet ist in der geschlossenen Beta. Wenn Sie testen möchten, schreiben Sie an info@aloaha.com.

Türzutritt ohne Plastikkarten?

Schreiben Sie uns zu Zutrittskarten in der CodeB Wallet, zur Admin-Seite oder zur API. Testerinnen und Tester für die CodeB Wallet sind ebenfalls willkommen.