Due utilizzi molto diversi della tecnologia "NFC" nei pass Wallet
Importante: Prima di progettare flussi di cassa contactless o controllo accessi con gli stakeholder, occorre distinguere tra Distribuzione tramite tag NFC NDEF (tag URL a standard aperto che funzionano subito su qualsiasi smartphone) e Tap-to-Redeem cifrato (Apple VAS e Google Smart Tap, che trasmettono un payload cifrato del pass dal Wallet a un lettore NFC dedicato).
| Funzionalità | Scopo | Protocollo e modello | Hardware e approvazioni richiesti |
|---|---|---|---|
| Distribuzione tag NFC NDEF | Il cliente avvicina il telefono sbloccato allo sticker da banco -> apre URL Aggiungi al Wallet o PassFlow | Record URI NDEF ISO/IEC 14443 | Solo un economico sticker NTAG213/215; nessun lettore hardware né Apple VAS necessario. |
| Tap-to-Redeem (Apple VAS / Google Smart Tap) | Il cliente avvicina telefono/Watch al terminale -> il lettore decifra il payload del pass (message) | Apple VAS e Google Smart Tap (modello NFC e Template.nfc) | Richiede lettori hardware NFC VAS/Smart Tap + configurazione chiavi pubbliche/private merchant (non attiva per default su tutti gli account). |
Architettura del modello NFC e del dizionario nfc in pass.json
Quando il riscatto contactless è abilitato su un modello (Template.nfc / modello Passinstance database NFC), Passinstance integra i metadati crittografici contactless sia nel dizionario nfc di pass.json su Apple Wallet sia in smartTapRedemptionValue sull'oggetto Google Wallet:
Proprietà e vincoli di configurazione NFC
Proprietà (NFC / Template.nfc) | Chiave Apple pass.json | Tipo e vincolo | Comportamento tecnico |
|---|---|---|---|
message | nfc.message | string (Max 64 byte UTF-8) | Il payload in chiaro cifrato dal dispositivo e trasmesso al lettore NFC (predefinito: serialNumber o externalId del pass). |
encryptionPublicKey | nfc.encryptionPublicKey | string (Base64 DER/PEM) | Chiave pubblica ECDH P-256 (prime256v1) compressa o non compressa corrispondente alla chiave privata caricata sui lettori NFC. |
nfcFaceIdRequired | nfc.requiresAuthentication | boolean | Quando true, iOS richiede al titolare l'autenticazione tramite Face ID, Touch ID o codice prima di trasmettere il payload VAS. |
nfcNoBarcode | Omette barcodes[] | boolean | Quando true, nasconde il codice a barre ottico 2D QR/Aztec sul fronte affinché il pass possa essere presentato solo tramite tap NFC cifrato. |
Esempio: dizionario nfc in pass.json Apple Wallet e configurazione modello
Quando nfcEnabled: true è attivo su un modello, Passinstance serializza il dizionario nfc alla radice di pass.json:
{
"formatVersion": 1,
"passTypeIdentifier": "pass.com.phenixroasters.access",
"serialNumber": "PI-8849-2026-X9",
"nfc": {
"message": "PI-8849-2026-X9",
"encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
"requiresAuthentication": true
}
}
Per aggiornare le impostazioni NFC di un modello tramite REST API, invii una patch sulla risorsa template (e verifichi la configurazione con 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: mantenere attivo il codice a barre ottico 2D di riserva
A meno che non si stiano distribuendo badge di accesso aziendali ad alta sicurezza in cui gli screenshot dei codici a barre devono essere rigorosamente impediti (nfcNoBarcode: true oppure addSecurityAnimation: true), mantenga nfcNoBarcode: false affinché i pass mostrino un codice a barre 2D QR o Aztec di backup. Ciò garantisce che lo staff possa comunque validare i pass con fotocamere ottiche se un terminale è offline o se l'antenna NFC sullo smartphone del cliente è disattivata.
Consulti Ambito NFC Wallet Passes, Apple VAS, Google Smart Tap e Lettori NFC compatibili.
