Twee zeer verschillende toepassingen van "NFC" in Wallet-passen
Belangrijk: Maak voordat u contactloos afrekenen of toegangscontrole met stakeholders afbakent onderscheid tussen NDEF NFC Tag-distributie (open-standaard URL-tags die out-of-the-box op elke smartphone werken) en versleutelde Tap-to-Redeem (Apple VAS en Google Smart Tap, waarbij een versleutelde paspayload vanuit de wallet naar een gespecialiseerde NFC-lezerterminal wordt verzonden).
| Mogelijkheid | Doel | Protocol & model | Benodigde hardware & goedkeuring |
|---|---|---|---|
| NDEF NFC Tag-distributie | Klant tikt met ontgrendelde telefoon op baliesticker -> opent URL voor Toevoegen aan Wallet of PassFlow | ISO/IEC 14443 NDEF URI Record | Alleen goedkope NTAG213/215-sticker; geen lezerhardware of Apple VAS nodig. |
| Tap-to-Redeem (Apple VAS / Google Smart Tap) | Klant houdt telefoon/Watch bij terminal -> lezer ontsleutelt paspayload (message) | Apple VAS & Google Smart Tap (NFC-model & Template.nfc) | Vereist VAS/Smart Tap NFC-lezerhardware + configuratie van publieke/privésleutels van de handelaar (niet standaard op elk account ingeschakeld). |
Architectuur van het Pas-NFC-model & het pass.json nfc-woordenboek
Wanneer contactloos inwisselen op een sjabloon is ingeschakeld (Template.nfc / Passinstance database NFC-model), sluit Passinstance cryptografische contactloze metadata in zowel het nfc-woordenboek van Apple Wallet pass.json als in smartTapRedemptionValue van het Google Wallet-object:
NFC-configuratie-eigenschappen & beperkingen
Eigenschap (NFC / Template.nfc) | Apple pass.json-sleutel | Type & beperking | Technisch gedrag |
|---|---|---|---|
message | nfc.message | string (Max. 64 bytes UTF-8) | De leesbare payload die door het apparaat wordt versleuteld en verzonden naar de NFC-lezer (standaard de serialNumber of externalId van de pas). |
encryptionPublicKey | nfc.encryptionPublicKey | string (Base64 DER/PEM) | Gecomprimeerde of ongecomprimeerde ECDH P-256 (prime256v1) publieke sleutel die overeenkomt met de privésleutel die op uw NFC-lezerterminals is geladen. |
nfcFaceIdRequired | nfc.requiresAuthentication | boolean | Indien true, vereist iOS dat de pashouder zich authenticeert via Face ID, Touch ID of toegangscode voordat de VAS-payload wordt verzonden. |
nfcNoBarcode | Laat barcodes[] weg | boolean | Indien true, wordt de visuele 2D QR-/Aztec-barcode aan de voorzijde van de pas onderdrukt zodat de pas alleen via een versleutelde NFC-tap kan worden aangeboden. |
Voorbeeld: Apple Wallet pass.json nfc-woordenboek & sjabloonconfiguratie
Wanneer nfcEnabled: true op een sjabloon is geconfigureerd, serialiseert Passinstance het nfc-woordenboek aan de root van pass.json:
{
"formatVersion": 1,
"passTypeIdentifier": "pass.com.phenixroasters.access",
"serialNumber": "PI-8849-2026-X9",
"nfc": {
"message": "PI-8849-2026-X9",
"encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
"requiresAuthentication": true
}
}
Om de NFC-instellingen van een sjabloon via de REST API bij te werken, patcht u de sjabloonresource (en verifieert u de configuratie met 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: houd de optische 2D-barcode als terugvaloptie ingeschakeld
Tenzij u hoogbeveiligde werknemerstoegangspassen uitrolt waarbij screenshots van visuele barcodes strikt moeten worden voorkomen (nfcNoBarcode: true of addSecurityAnimation: true), kunt u nfcNoBarcode: false het best ingeschakeld houden zodat passen een optische 2D QR- of Aztec-barcode tonen als back-up. Zo kunnen medewerkers passen alsnog valideren met optische camera's als een terminal offline is of de NFC-antenne op de telefoon van een klant is uitgeschakeld.
Bekijk Bereik van NFC Wallet-passen, Apple VAS, Google Smart Tap en Compatibele NFC-lezers.
