Zwei grundlegend verschiedene Bedeutungen von „NFC“ bei Wallet-Pässen
Wichtig: Bevor Sie kontaktlosen Checkout oder Zutrittskontrolle mit Beteiligten planen, unterscheiden Sie klar zwischen NDEF-NFC-Tag-Verteilung (offene Standard-URL-Tags, die mit jedem Smartphone sofort funktionieren) und verschlüsseltem Tap-to-Redeem (Apple VAS und Google Smart Tap, die ein verschlüsseltes Pass-Payload aus dem Wallet an ein spezialisiertes NFC-Leseterminal übertragen).
| Funktion | Zweck | Protokoll & Modell | Benötigte Hardware & Freigabe |
|---|---|---|---|
| NDEF-NFC-Tag-Verteilung | Kundin/Kunde hält entsperrtes Smartphone an Kassensticker -> öffnet URL für Wallet oder PassFlow | ISO/IEC 14443 NDEF URI Record | Nur preiswerter NTAG213/215-Sticker; kein NFC-Lesegerät und kein Apple VAS erforderlich. |
| Tap-to-Redeem (Apple VAS / Google Smart Tap) | Kundin/Kunde hält Smartphone/Watch ans Terminal -> Lesegerät entschlüsselt Pass-Payload (message) | Apple VAS & Google Smart Tap (NFC-Modell & Template.nfc) | Erfordert VAS-/Smart-Tap-NFC-Lesehardware + Händler-Schlüsselpaarung (nicht bei jedem Konto standardmäßig aktiv). |
Pass-NFC-Modell & Architektur des nfc-Dictionary in pass.json
Wenn die kontaktlose Einlösung auf einer Vorlage aktiviert ist (Template.nfc / Passinstance database-NFC-Modell), bettet Passinstance kryptografische NFC-Metadaten sowohl in das nfc-Dictionary von Apple Wallets pass.json als auch in smartTapRedemptionValue des Google-Wallet-Objekts ein:
NFC-Konfigurationseigenschaften & Vorgaben
Eigenschaft (NFC / Template.nfc) | Apple-pass.json-Schlüssel | Typ & Einschränkung | Technisches Verhalten |
|---|---|---|---|
message | nfc.message | string (Max. 64 Bytes UTF-8) | Das vom Gerät verschlüsselte und an den NFC-Reader übertragene Klartext-Payload (Standard: serialNumber oder externalId des Passes). |
encryptionPublicKey | nfc.encryptionPublicKey | string (Base64 DER/PEM) | Komprimierter oder unkomprimierter ECDH-P-256 (prime256v1) Public Key passend zum Private Key auf Ihren NFC-Leseterminals. |
nfcFaceIdRequired | nfc.requiresAuthentication | boolean | Bei true verlangt iOS eine Authentifizierung per Face ID, Touch ID oder Gerätecode, bevor das VAS-Payload gesendet wird. |
nfcNoBarcode | Lässt barcodes[] weg | boolean | Bei true wird der visuelle 2D-QR-/Aztec-Barcode auf der Vorderseite ausgeblendet, sodass der Pass nur per verschlüsseltem NFC-Tap vorgezeigt werden kann. |
Beispiel: nfc-Dictionary in Apple Wallet pass.json & Vorlagenkonfiguration
Wenn nfcEnabled: true auf einer Vorlage konfiguriert ist, serialisiert Passinstance das nfc-Dictionary im Wurzelobjekt von pass.json:
{
"formatVersion": 1,
"passTypeIdentifier": "pass.com.phenixroasters.access",
"serialNumber": "PI-8849-2026-X9",
"nfc": {
"message": "PI-8849-2026-X9",
"encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
"requiresAuthentication": true
}
}
Um die NFC-Einstellungen einer Vorlage per REST-API zu aktualisieren, patchen Sie die Vorlagenressource (und prüfen Sie die Konfiguration mit POST /api/v1/nfc/test):
PATCH /api/v1/templates/7b9e4c12-3f81-4a90-b8d2-19c48a70e112
{
"nfc": {
"message": "{serialNumber}",
"encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
"requiresAuthentication": true
},
"nfcFaceIdRequired": true,
"nfcNoBarcode": false
}
Best Practice: Optischen 2D-Barcode-Fallback aktiviert lassen
Sofern Sie keine Hochsicherheits-Mitarbeiterausweise ausgeben, bei denen Barcode-Screenshots strikt ausgeschlossen werden müssen (nfcNoBarcode: true oder addSecurityAnimation: true), lassen Sie nfcNoBarcode: false, damit Pässe weiterhin einen 2D-QR- oder Aztec-Barcode als Fallback anzeigen. So kann Ihr Personal Pässe weiterhin per Kamera scannen, falls ein Terminal offline oder das NFC-Modul eines Kundengeräts deaktiviert ist.
Lesen Sie auch Funktionsumfang NFC-Wallet-Pässe, Apple VAS, Google Smart Tap sowie Kompatible NFC-Lesegeräte.
