CodeB Wallet · PKI-Karten · Windows-CA

Ihr Smartphone als Smartcard: PKI-Karten und die Windows-CA.

Eine CodeB-PKI-Karte macht ein Android-Smartphone mit CodeB Wallet zu einer kontaktlosen Smartcard für einen Windows-PC mit NFC-Leser: Die les- und beschreibbare Karte trägt ein Zertifikat aus Ihrer eigenen CA, dessen privater Schlüssel in der sicheren Hardware des Smartphones entsteht und sie nie verlässt, die nur lesbare Karte trägt das Signaturzertifikat des Mitglieds vom Server, und jede Nutzung braucht die Karten-PIN. Diese Anleitung erklärt, wie das funktioniert, wie Administratoren die Karten ausgeben und wie Sie die Windows-Zertifizierungsstelle (AD CS) einrichten, damit Zertifikate auf das Smartphone kommen.

Stand: PKI-Karten werden in geschlossenen Gruppen getestet. Dort bestätigt: die Ausgabe der Karten, die Windows-Registrierung auf eine les- und beschreibbare PKI-Karte und die Windows-Anmeldung damit (Windows 11, AD-CS-Enterprise-CA, PC/SC-NFC-Leser, Android-16-Smartphone). Schritte, die noch getestet werden, sind gekennzeichnet. CodeB Wallet für Android ist in einer geschlossenen Testphase.

So funktioniert es

  1. Der Administrator gibt auf phone.codeb.io einem Mitglied eine PKI-Karte aus (Admin-Seite „PKI cards on phones“). Das Mitglied erhält einen Einladungslink oder QR-Code.
  2. Das Mitglied fügt die Karte zu CodeB Wallet hinzu. Das Smartphone weist nach, dass sein Schlüssel in sicherer Hardware liegt (Key Attestation); die Geheimnisse der Karte erreichen nur dieses Smartphone, einmal und verschlüsselt.
  3. Das Mitglied wählt eine Karten-PIN auf dem Smartphone. Die nur lesbare Karte zeigt außerdem einmal ihren Entsperrcode (PUK).
  4. Das Zertifikat kommt auf das Smartphone, von Ihrer eigenen Windows-CA: Bei der les- und beschreibbaren Karte erzeugt Windows den Schlüssel und schreibt das Zertifikat selbst; die nur lesbare Karte erhält direkt nach dem Abholen das Signaturzertifikat des Mitglieds vom Server.
  5. Nutzung am PC: Das Mitglied öffnet die Karte in CodeB Wallet, tippt „Am PC verwenden“, hält das entsperrte Smartphone an den NFC-Leser, und Windows zeigt eine Smartcard. Die Karten-PIN gibt den Schlüssel frei.

Bei der les- und beschreibbaren Karte kommt das Zertifikat aus Ihrer PKI: phone.codeb.io gibt die Karte und ihre Verwaltungsschlüssel aus, sieht nie den privaten Schlüssel dieser Karte und stellt nie das Anmeldezertifikat aus. Die nur lesbare Karte ist nie leer: Sie trägt das Signaturzertifikat des Mitglieds von phone.codeb.io, denselben Schlüssel, mit dem das Mitglied aus der Ferne signiert; dieser Schlüssel liegt also auch auf dem Server.

Die zwei PKI-Karten

Les- und beschreibbare PKI-Karte in CodeB Wallet
Les- und beschreibbare PKI-Karte in CodeB Wallet
Nur lesbare PKI-Karte in CodeB Wallet
Nur lesbare PKI-Karte in CodeB Wallet
Les- und beschreibbare PKI-KarteNur lesbare PKI-Karte
Wer schreibt das ZertifikatWindows selbst, mit seinem eingebauten Smartcard-Treiber (Zertifikatsregistrierung am NFC-Leser)Der Server, einmal: Direkt nach dem Abholen legt CodeB Wallet das Signaturzertifikat des Mitglieds in den Signatur-Slot der Karte; Windows liest und nutzt es nur
SchlüsselWird bei der Registrierung auf dem Smartphone erzeugt, in seiner sicheren Hardware; er verlässt das Smartphone nieDer Fernsignatur-Schlüssel des Mitglieds, auf dem Server erzeugt, falls das Mitglied noch keinen hat, und in die sichere Hardware des Smartphones importiert; der Server behält ihn für die Fernsignatur
ZertifikatAus Ihrer CA (AD-CS-Vorlage)Das Signaturzertifikat des Mitglieds, heute pro Mitglied selbstsigniert: Windows, Office und PDF-Reader zeigen den Unterzeichner als unbekannt, solange sie ihm nicht vertrauen. Es ist keine qualifizierte oder fortgeschrittene elektronische Signatur
SchlüsseltypenRSA 2048 oder ECC P-256 (andere Typen lehnt die Karte ab)ECC P-256
Karten-PIN4–16 druckbare Zeichen (ohne Leerzeichen), in der App gewählt6–8 Ziffern, in der App gewählt
Gesperrte PINNach 5 falschen PINs ist die Karte gesperrt; der Administrator gibt eine neue Karte ausNach 3 falschen PINs ist die Karte gesperrt; Entsperren mit der 8-stelligen PUK, die die App einmal zeigt (der Administrator kann sie auch vom Server lesen). Nach 3 falschen PUKs: neue Karte
Typischer EinsatzOrganisationen, die Smartcards heute mit Windows-Werkzeugen registrierenDokumente am PC mit dem Signaturzertifikat des Mitglieds signieren; ein Windows-Anmeldezertifikat auf dieser Karte braucht die CodeB-Software Ihrer Organisation, die später kommt

Was Sie brauchen

PKI-Karte ausgeben (phone.codeb.io)

  1. Melden Sie sich als Administrator an und öffnen Sie Admin → PKI cards on phones.
  2. Schalten Sie PKI-Karten für diese Website ein. Solange sie ausgeschaltet sind, kann keine Karte ausgegeben werden und die PC-Software keine Kartenschlüssel abrufen; Karten auf Smartphones funktionieren weiter, bis sie enden oder gesperrt werden.
  3. Wählen Sie unter Issue a PKI card das Mitglied, die Karte (Read/write PKI card oder Read-only PKI card), wie viele Tage sie gilt (bis 1096, Standard 365) und wie lange die Einladung offen bleibt. Mit „E-mail the invitation to the member“ wird sie verschickt.
  4. Das Mitglied öffnet den Link auf dem Smartphone (oder scannt den QR-Code) und fügt die Karte zu CodeB Wallet hinzu. Eine Karte kann nur einmal abgeholt werden, nur mit einem Schlüssel in sicherer Hardware.
  5. Die Liste zeigt den Stand jeder Karte: Einladung offen, aktiv, beendet oder nicht abgeholt, gesperrt. Sobald das Smartphone sie meldet, zeigt die Spalte Certificate Seriennummer und Aussteller des Zertifikats auf der Karte.

Alles auf dieser Seite steht auch als JSON-API für Ihre eigenen Werkzeuge bereit (siehe openapi.json, Tag pki-cards).

Windows-CA einrichten (AD CS)

Für Windows verhält sich das Smartphone wie eine Smartcard, daher ist die Einrichtung der CA dieselbe wie für Plastik-Smartcards. Sie ist einmal pro Domäne nötig. Die Namen unten sind die der englischen Windows-Konsolen.

  1. Domänencontroller prüfenJeder Domänencontroller braucht ein Zertifikat für die Kerberos-Authentifizierung (Vorlage Kerberos Authentication oder Domain Controller Authentication, meist automatisch registriert). Eine Unternehmens-CA wird automatisch in den NTAuth-Speicher eingetragen. Nur wenn Ihre ausstellende CA keine AD-CS-Unternehmens-CA ist, veröffentlichen Sie sie mit certutil -dspublish -f ca.cer NTAuthCA.
  2. Vorlage „Smartcard Logon“ duplizierenÖffnen Sie certtmpl.msc, klicken Sie mit der rechten Maustaste auf Smartcard Logon und wählen Sie Duplicate Template. Vergeben Sie einen klaren Namen, zum Beispiel „CodeB Phone PKI Card“.
  3. Registerkarte CompatibilityCertification Authority: Windows Server 2016. Certificate recipient: Windows 10 / Windows Server 2016. Damit stehen die Einstellungen unter Cryptography zur Verfügung.
  4. Registerkarte General: GültigkeitWählen Sie die Gültigkeit nicht länger als die Gültigkeit der PKI-Karte im Admin-Bereich, damit das Zertifikat die Karte nicht überdauert.
  5. Registerkarte Cryptography: Schlüssel auf dem SmartphoneProvider category: Key Storage Provider. Algorithm: RSA, minimale Schlüssellänge 2048. Wählen Sie „Requests must use one of the following providers“ und nur Microsoft Smart Card Key Storage Provider. So erzeugt Windows den Schlüssel auf der Karte (dem Smartphone), nicht auf dem PC.
  6. Registerkarte Request Handling: kein Export„Allow private key to be exported“ bleibt aus. Der Schlüssel entsteht in der sicheren Hardware des Smartphones und lässt sich ohnehin nicht exportieren.
  7. Registerkarte Subject Name: starke Zuordnung„Build from this Active Directory information“, mit dem User principal name (UPN) im alternativen Antragstellernamen. Wählen Sie nicht „Supply in the request“. Domänencontroller verlangen eine starke Zertifikatzuordnung (Microsoft KB5014754): Eine aktuelle Unternehmens-CA fügt Zertifikaten, die aus Active Directory gebildet werden, die SID des Kontos automatisch hinzu. Halten Sie CA und Domänencontroller aktuell; andernfalls legen Sie eine explizite Zuordnung an (altSecurityIdentities).
  8. Registerkarte Extensions: AnwendungsrichtlinienDie Anwendungsrichtlinien müssen Smart Card Logon und Client Authentication enthalten (in der Vorlage Smartcard Logon bereits vorhanden).
  9. Registerkarte Security: wer registrieren darfGeben Sie den Benutzern (oder einer Gruppe wie „Smartphone-PKI-Karten“) Read und Enroll. Vergeben Sie kein Autoenroll (siehe Hinweise zu Gruppenrichtlinien).
  10. Vorlage ausstellenÖffnen Sie certsrv.msc, klicken Sie mit der rechten Maustaste auf Certificate Templates → New → Certificate Template to Issue und wählen Sie die neue Vorlage.
  11. SperrdatenDomänencontroller prüfen das Zertifikat des Benutzers und die PCs das Zertifikat des Domänencontrollers; beide müssen die Sperrliste (CRL) oder den OCSP-Dienst der CA erreichen, sonst schlägt die Smartcard-Anmeldung fehl. Sperrlisten werden bis zu ihrem Ablauf zwischengespeichert, wählen Sie daher kurze CRL- und Delta-CRL-Zeiträume.

Schlüssellänge und Algorithmus: Die les- und beschreibbare Karte akzeptiert Schlüssel mit RSA 2048 oder ECC P-256; alle anderen Algorithmen und Längen lehnt sie ab (zum Beispiel RSA 3072 / 4096 oder P-384). Stellen Sie die Vorlage auf einen dieser beiden ein.

Zertifikat auf das Smartphone bringen

Les- und beschreibbare PKI-Karte: Windows registriert das Zertifikat auf dem Smartphone

  1. Melden Sie sich am PC als das Mitglied an (das Zertifikat wird für den angemeldeten Benutzer beantragt).
  2. Öffnen Sie in CodeB Wallet die les- und beschreibbare PKI-Karte, tippen Sie Am PC verwenden und halten Sie das entsperrte Smartphone an den NFC-Leser. Lassen Sie es während der nächsten Schritte dort.
  3. Öffnen Sie certmgr.msc → Personal → All Tasks → Request New Certificate, wählen Sie Active Directory Enrollment Policy, aktivieren Sie das Kontrollkästchen der Vorlage „CodeB Phone PKI Card“ und klicken Sie Enroll.
  4. Windows fragt nach der Karten-PIN, erzeugt den Schlüssel auf dem Smartphone und schreibt das Zertifikat darauf.
  5. Prüfen Sie das Ergebnis mit certutil -scinfo -silent, solange die Karte aktiv ist. Der Admin-Bereich zeigt Seriennummer und Aussteller des Zertifikats, sobald das Smartphone sie meldet.

Dasselbe auf der Kommandozeile (die Vorlage legt Schlüssel und Provider fest):

certreq -enroll -user "CodeBPhonePKICard"

Verwenden Sie den Namen der Vorlage (standardmäßig der Anzeigename ohne Leerzeichen, siehe Registerkarte General). Fügen Sie kein -q hinzu: Windows muss nach der Karten-PIN fragen können.

In einem Test in geschlossenen Gruppen bestätigt: Windows findet die les- und beschreibbare Karte ohne Registry-Eintrag, akzeptiert die Karten-PIN, legt einen Schlüsselcontainer an und erzeugt einen RSA-2048-Schlüssel in der sicheren Hardware des Smartphones. Ebenfalls bestätigt: Windows schreibt das Zertifikat auf die Karte und liest es zurück, Signaturen mit dem neuen Schlüssel funktionieren, und das Mitglied meldet sich mit der Karte an Windows an (getestet mit Windows 11, einer AD-CS-Enterprise-CA, einem PC/SC-NFC-Leser und einem Android-16-Smartphone). Die Schritte oben sind die übliche Windows-Smartcard-Registrierung, für die die Karte gebaut ist. Das Erzeugen des Schlüssels in der sicheren Hardware des Smartphones kann einige Sekunden dauern; die Karte bleibt bereit, bis Sie das Smartphone vom Leser nehmen oder den Kartenbildschirm schließen – lassen Sie das Smartphone am Leser, bis die Anforderung abgeschlossen ist.

Nur lesbare PKI-Karte: das Signaturzertifikat des Mitglieds vom Server

  1. Geben Sie die nur lesbare Karte wie oben aus. Wenn das Mitglied sie abholt, holt CodeB Wallet Signaturzertifikat und Schlüssel des Mitglieds vom Server (erzeugt, falls das Mitglied noch keine hat) und legt sie in den Signatur-Slot der Karte; danach wählt das Mitglied die Karten-PIN.
  2. Am PC liest Windows die Karte mit seinem eingebauten Treiber und bietet das Zertifikat zum Signieren an, etwa in Office oder einem PDF-Reader. Jede Signatur braucht die Karten-PIN.

Im Test: CodeB Wallet holt das Signaturzertifikat direkt nach dem Abholen der Karte ab; das wird in geschlossenen Gruppen getestet. Der Schlüssel wird pro Karte einmal geliefert, verschlüsselt für einen Schlüssel in der sicheren Hardware des Smartphones, den das Smartphone per Key Attestation nachweist; er bleibt auch auf dem Server, weil das Mitglied mit demselben Schlüssel aus der Ferne signiert. Heute ist das Zertifikat pro Mitglied selbstsigniert, daher zeigen Empfänger einen unbekannten Unterzeichner, solange sie ihm nicht vertrauen; es ist keine qualifizierte oder fortgeschrittene elektronische Signatur. Der Anmelde-Slot der Karte bleibt frei für ein Windows-Anmeldezertifikat aus Ihrer CA, eingerichtet von der CodeB-Software Ihrer Organisation, die später kommt; fragen Sie CodeB.

Sie haben bereits ein Zertifikat im CodeB Key Storage Provider auf dem PC? Die Admin-Seite „Copy a Windows certificate to a phone“ beschreibt, wie ein vorhandenes Zertifikat stattdessen an das Smartphone übergeben werden kann (in geschlossenen Gruppen getestet).

Mit dem Smartphone anmelden

  1. Wählen Sie auf dem Windows-Anmeldebildschirm Anmeldeoptionen → Smartcard (oder drücken Sie Strg+Alt+Entf, wenn die Karte erkannt wird).
  2. Öffnen Sie in CodeB Wallet die PKI-Karte und tippen Sie Am PC verwenden; halten Sie das entsperrte Smartphone an den Leser.
  3. Windows zeigt die Smartcard mit dem Zertifikat des Mitglieds. Geben Sie die Karten-PIN ein.
  4. Das funktioniert auch für andere Zertifikatsnutzungen am PC (zum Beispiel Signieren oder eine Web-Anmeldung mit Client-Zertifikat), solange die Karte aktiv ist. Dafür muss der Windows-Dienst Certificate Propagation (Zertifikatverteilung) laufen, damit das Zertifikat der Karte im Benutzerspeicher erscheint.

In einem Test in geschlossenen Gruppen bestätigt: die Windows-Anmeldung an einem Domänenkonto (Kerberos-Smartcard-Anmeldung) mit einer les- und beschreibbaren PKI-Karte und ihrer Karten-PIN. Die zwischengespeicherte Anmeldung und weitere Umgebungen werden getestet. Die nur lesbare PKI-Karte hat kein Anmeldezertifikat. Nur die gewählte Karte antwortet, nur solange ihr Kartenbildschirm offen und das Smartphone entsperrt ist. Türzugang, Bezahl-Apps und andere Karten auf dem Smartphone sind nicht betroffen.

Hinweise zu Gruppenrichtlinien

Verlorenes Smartphone und Sperrung

  1. Sperren Sie im Admin-Bereich die PKI-Karte. Die Karte antwortet nicht mehr, sobald das Smartphone die Sperrung erhalten hat (über die Statusliste).
  2. Sperren Sie das Zertifikat bei Ihrer CA (certsrv.msc → Issued Certificates → Revoke Certificate) und veröffentlichen Sie eine neue Sperrliste. Bis die zwischengespeicherten Sperrlisten auf den Domänencontrollern ablaufen, kann das Zertifikat noch anmelden; halten Sie die Zeiträume daher kurz. Der Admin-Bereich zeigt die Seriennummer, wenn das Smartphone sie gemeldet hat.
  3. Nur lesbare Karte: Ihre Sperrung stoppt nur die Karte. Fernsignatur-Schlüssel und -Zertifikat des Mitglieds bleiben bestehen, bis sie gesondert gesperrt werden.
  4. Geben Sie eine neue PKI-Karte an das neue Smartphone des Mitglieds aus und registrieren Sie ein neues Zertifikat.

Sicherheit

Fehlerbehebung

Fragen

Ersetzt das Smartphone eine Plastik-Smartcard?

Dafür sind PKI-Karten gebaut: An einem PC mit NFC-Leser antwortet das Smartphone als Smartcard, mit dem Zertifikat aus Ihrer eigenen CA und Vorlage. PKI-Karten werden in geschlossenen Gruppen getestet; die Windows-Registrierung und -Anmeldung mit der les- und beschreibbaren PKI-Karte sind dort bestätigt.

Windows meldet, dass die Karte einen Treiber braucht – was tun?

Prüfen Sie die NFC-Einstellung des Smartphones: Stellen Sie bei manchen Android-Smartphones Einstellungen → Verbindung und Freigabe → NFC → Position des Sicherheitselements auf HCE Wallet und halten Sie das Smartphone dann mit offenem Kartenbildschirm erneut an den Leser. Mehr unter Fehlerbehebung.

Kann ich die Karten-PIN ändern?

Ja. Öffnen Sie in CodeB Wallet die PKI-Karte und tippen Sie auf Karten-PIN ändern: Geben Sie die aktuelle PIN und zweimal die neue PIN ein (les- und beschreibbare Karte 4–16 Zeichen, nur lesbare Karte 6–8 Ziffern) und bestätigen Sie mit Fingerabdruck, Gesicht oder Bildschirmsperre. Eine falsche aktuelle PIN zählt wie am PC gegen den Fehlbedienungszähler. Eine gesperrte nur lesbare Karte entsperren Sie auf dem Smartphone mit Mit PUK entsperren (die 8-stellige PUK, die Sie beim Erhalt der Karte notiert haben); eine gesperrte les- und beschreibbare Karte entsperrt Ihre Organisation oder stellt eine neue aus. Auch Windows kann die PIN ändern (Strg+Alt+Entf → Kennwort ändern → Smartcard).

Welche CA brauche ich?

Die Windows-CA (AD CS), die heute Ihre Smartcard-Zertifikate ausstellt. phone.codeb.io gibt die Karte aus; das Anmeldezertifikat kommt immer aus Ihrer PKI.

Les- und beschreibbare oder nur lesbare PKI-Karte?

Wählen Sie die les- und beschreibbare Karte, wenn Sie Smartcards mit Windows-Werkzeugen registrieren: Windows erzeugt den Schlüssel und schreibt das Zertifikat selbst auf das Smartphone. Wählen Sie die nur lesbare Karte, wenn die CodeB-Software Ihrer Organisation die Karte einmal einrichten und Windows sie nur lesen soll.

Welche Smartphones funktionieren?

Android 10 oder neuer mit NFC-Kartenemulation und CodeB Wallet; das Smartphone muss entsperrt sein. Die nur lesbare Karte braucht außerdem einen NFC-Chip, der nach Anwendungskennung weiterleitet – die App prüft das.

Lässt sich der private Schlüssel vom Smartphone kopieren?

Nein. Bei der les- und beschreibbaren Karte entsteht er in der sicheren Hardware des Smartphones (StrongBox, wenn vorhanden, sonst TEE) und verlässt sie nie. Der Schlüssel der nur lesbaren Karte wird in diese sichere Hardware importiert und lässt sich vom Smartphone nicht exportieren; er ist der Fernsignatur-Schlüssel des Mitglieds und liegt daher auch auf dem Server. Jede Nutzung braucht die Karten-PIN.

Wird einer Signatur mit der nur lesbaren Karte vertraut?

Nur dort, wo der Empfänger dem Zertifikat vertraut. Heute ist das Signaturzertifikat des Mitglieds selbstsigniert, daher zeigen Windows, Office und PDF-Reader den Unterzeichner als unbekannt, solange sie ihm nicht vertrauen. Es ist keine qualifizierte oder fortgeschrittene elektronische Signatur.

Was passiert, wenn ein Smartphone verloren geht?

Sperren Sie die PKI-Karte im Admin-Bereich (die Karte antwortet nicht mehr, sobald das Smartphone die Sperrung erhalten hat), sperren Sie das Zertifikat bei Ihrer CA und veröffentlichen Sie eine neue Sperrliste. Geben Sie dann eine neue Karte an das neue Smartphone aus.

Funktioniert es offline?

Das Smartphone braucht kein Netz, um am PC zu antworten. Windows prüft das Zertifikat wie bei jeder Smartcard mit den Sperrdaten Ihrer CA.

Stört es andere Karten auf dem Smartphone?

Nein. Nur die gewählte PKI-Karte antwortet, solange ihr Kartenbildschirm offen und das Smartphone entsperrt ist. Türzugang und Bezahl-Apps sind nicht betroffen.

Zuletzt aktualisiert: