Identification physique, QR et NFC

Un produit physique doit porter quelque chose qu'un téléphone peut lire. Cette page vous donne les deux porteurs disponibles, le QR imprimé et le sceau NFC. En la quittant, vous saurez quelle adresse exacte est imprimée ou écrite dans la puce, ce que le serveur répond quand vous la lisez, ce que chaque porteur apporte au moment du scan, et le travail que chacun demande avant de lancer une production.

Le règlement ESPR autorise le passeport à trois niveaux : le modèle, le lot et l'exemplaire. L'acte délégué de votre groupe de produits décide lequel s'applique. Les deux formes d'adresse décrites ci-dessous couvrent le modèle et l'exemplaire. Un passeport de modèle couvre tous les exemplaires qui partagent le même code produit.

Voici le trajet complet, du porteur physique jusqu'à la page que voit la personne qui scanne. Le reste de la page reprend chaque étape en détail.

#Les trois combinaisons possibles

Chaque produit porte une valeur de méthode d'authentification. Le produit en stocke une parmi trois.

Vous choisissez cette valeur à la création du produit, dans le formulaire de la console ou dans son import CSV. Renseignez-la toujours. Une valeur absente vaut nfc. Le serveur refuse alors la création en 403 si votre offre n'autorise que le QR. Pour un produit QR seul, écrivez explicitement qr.

Le serveur accepte aussi l'écriture nfc,qr et la casse haute. Écrivez exactement l'une des trois valeurs du tableau, dans l'une de ces écritures. Une autre valeur ne vous donne pas le porteur que vous demandez.

Demander une valeur qui contient nfc exige que votre offre autorise l'authentification NFC. Sinon le serveur répond un 403 portant le code AUTH_METHOD_NOT_ALLOWED, avec la méthode demandée et la liste de celles que votre offre autorise. Une demande qr seule n'exige pas cette autorisation.

#Le QR imprimé

#Ce qu'il encode

Le QR imprimé sur une unité encode une seule adresse, de cette forme :

https://sealtrust.io/p/0ABCDEFGHJKM

Le dernier segment est le numéro de série public de l'unité. Cette forme /p/{serial} est l'identifiant unique de produit destiné au registre européen, et c'est elle que porte l'étiquette. La génération du code refuse de produire une image pour une unité qui n'a pas de numéro de série.

#Le numéro de série

Le numéro fait douze caractères. Son alphabet compte trente-deux caractères : les chiffres de 0 à 9 et les lettres de A à Z privées de I, L, O et U. Nous retirons ces quatre lettres parce qu'elles se confondent avec des chiffres sur une étiquette.

Trois conséquences pratiques :

• Le serveur corrige un numéro recopié à la main. Il lit un I et un L comme un 1, et un O comme un 0.
• La casse n'a aucune importance. Le serveur remet le numéro en majuscules avant toute recherche.
• Un numéro qui n'a pas la bonne longueur ou qui contient un caractère hors de cet alphabet reçoit un 404 immédiat.

Nous tirons le numéro au hasard. Il ne suit pas l'ordre de production et ne révèle donc ni vos volumes ni votre ancienneté.

#Ce qui se passe au scan

L'appareil photo d'un téléphone ouvre l'adresse. Le serveur répond une seule redirection 302 vers la page produit, sur le site public.

curl -sS -i "https://sealtrust.io/p/0ABCDEFGHJKM"

HTTP/1.1 302 Found
Location: https://sealtrust.io/fr/product/0ABCDEFGHJKM

Le serveur choisit la langue de la page à partir de l'en-tête Accept-Language du lecteur, parmi le français et l'anglais, le français par défaut. Il n'y a jamais qu'un seul saut de redirection.

La page produit répond aux questions qu'une personne se pose en scannant : ce qu'est l'objet, s'il est authentique, qui le détient, où se trouve la preuve. Elle renvoie vers le passeport numérique.

#Demander le passeport avec le paramètre linkType

Un lecteur machine qui veut le document lui-même ajoute un paramètre linkType.

curl -sS -i "https://sealtrust.io/p/0ABCDEFGHJKM?linkType=dpp"

HTTP/1.1 302 Found
Location: https://sealtrust.io/fr/passport/<identifiant de l'unité>

Le dernier segment est l'empreinte de l'unité, ou à défaut son identifiant de jeton, ou à défaut son numéro de série.

Cinq valeurs sont reconnues : dpp, passport, gs1:dpp, gs1:digitalproductpassport et digitalproductpassport. Toute autre valeur est traitée comme si le paramètre était absent, et le lecteur arrive sur la page produit.

Une unité retirée de la circulation part toujours vers son passeport, même sans ce paramètre. Son identifiant continue de répondre, ce que la norme exige.

#Le lien GS1 Digital Link

#La forme exacte

Le même produit est adressable par un lien GS1 Digital Link. Sa forme est fixée par la structure du chemin.

https://sealtrust.io/01/03701234567890/21/0ABCDEFGHJKM

• 01 est l'identifiant d'application du GTIN, le code article international.
• 03701234567890 est le GTIN ramené à quatorze chiffres.
• 21 est l'identifiant d'application du numéro de série.
• 0ABCDEFGHJKM est le même numéro de série public que dans la forme courte.

Les deux formes désignent la même unité et mènent à la même page. Le domaine ne fait pas le lien GS1 Digital Link, c'est la structure du chemin qui le fait. Un résolveur hébergé sur votre propre domaine reste conforme.

Servir ces résolveurs sur votre propre nom de domaine fait partie de l'offre SealTrust Inside. Sans elle, vos liens restent sur sealtrust.io.

#Ce que le serveur vérifie

curl -sS -i "https://sealtrust.io/01/03701234567890/21/0ABCDEFGHJKM"

HTTP/1.1 302 Found
Location: https://sealtrust.io/fr/product/0ABCDEFGHJKM

Le GTIN du chemin doit correspondre au GTIN du modèle auquel l'unité appartient. Sinon le serveur répond un 404. Une unité dont le modèle ne porte aucun GTIN n'est donc pas adressable par cette forme, et reste adressable par la forme courte /p/{serial}.

Un GTIN qui ne peut pas être normalisé reçoit un 400 avec le message Invalid GTIN. Le serveur retient les chiffres du segment, refuse au delà de quatorze, et complète à gauche par des zéros jusqu'à quatorze. Les formes GTIN-8, GTIN-12, GTIN-13 et GTIN-14 passent donc, avec ou sans séparateurs.

Il vérifie ensuite la clé de contrôle GS1, et répond 400 avec le message Invalid GTIN: the check digit does not match. quand le dernier chiffre ne correspond pas aux précédents. Cette vérification a lieu à la résolution, et plus seulement à l'enregistrement du modèle : un code mal recopié est donc nommé comme tel, au lieu de répondre « produit inconnu » et d'envoyer le lecteur chercher au mauvais endroit.

Toutes les autres impasses reçoivent le même 404 avec le même message. Un numéro inconnu et un numéro connu sous un autre GTIN sont indiscernables de l'extérieur.

#La forme sans numéro de série

Un lien sans le segment 21 désigne un modèle commercial. Il ne désigne aucune unité en particulier.

curl -sS -i "https://sealtrust.io/01/03701234567890"

HTTP/1.1 302 Found
Location: https://sealtrust.io/fr/passport/01/03701234567890

Il résout vers le passeport de niveau modèle, celui qui est rattaché à un modèle et à aucune unité. Le serveur ne sert jamais ici un passeport rattaché à une unité : les données d'un exemplaire ne doivent pas être montrées pour un autre exemplaire du même modèle.

Le serveur répond un 404 dans quatre cas, sans les distinguer : le GTIN est inconnu, aucun passeport de modèle public n'est publié pour ce GTIN, plusieurs marques publient un passeport de modèle sous le même GTIN, ou le GTIN appartient à une autre marque que celle du domaine sur lequel le scan arrive.

C'est la forme qui convient à tout ce qui se vend au mètre, à la boîte ou à la palette. Un seul code, imprimé sur chaque unité du modèle, et rien de créé par exemplaire.

Le niveau lot n'a pas de forme d'adresse à lui. Un passeport se rattache soit à un modèle, soit à un exemplaire. Le code imprimé est donc celui du modèle ou celui de l'exemplaire.

#La limite de cinquante caractères

Le registre européen plafonne l'identifiant unique de produit à cinquante caractères. La structure GS1 en consomme vingt-deux à elle seule, en plus du domaine : /01/, quatorze chiffres de GTIN, /21/. Le domaine que vous choisissez décide donc du nombre de caractères qu'il reste pour le numéro de série.

Prenez le domaine le plus court dont vous disposez. Un sous-domaine api. est un piège. L'identifiant destiné au registre est la forme courte /p/{serial}, qui ne dépense pas ces vingt-deux caractères.

Le passeport publié porte les deux valeurs : le GTIN normalisé dans le champ gtin, et le lien complet dans le champ gs1_digital_link.

#Ce que le QR seul apporte

• Il porte l'identifiant destiné au registre. La forme /p/{serial} est l'identifiant unique de produit qu'attend le registre européen. Le champ qui doit servir le document porte la même adresse suivie de ?linkType=dpp.
• Il fonctionne au niveau modèle. Un seul code pour tout un modèle, sans rien créer par exemplaire, avec la forme /01/{gtin}. Ce niveau sert le passeport et se scanne.
• Il ne demande aucun matériel. Le code est une image que vous téléchargez et envoyez à l'impression.
• Il mène à une page web ordinaire. Aucune application n'est nécessaire pour la lire.

Ce qu'il ne fait pas : un QR imprimé encode une adresse fixe. Une photographie de l'étiquette encode la même adresse. Le résolveur cherche le numéro de série et redirige ; il n'a rien d'autre à examiner. Le QR identifie donc un objet, et ne prouve pas à lui seul que l'étiquette n'a pas été recopiée.

#Ce que le sceau NFC ajoute

Le sceau NFC est une puce NTAG 424 DNA. À chaque lecture, elle écrit elle-même deux paramètres dans l'adresse : une donnée chiffrée et un sceau de vérification. L'adresse change donc à chaque lecture.

https://sealtrust.io/verify?e=<donnée chiffrée>&c=<sceau>

Le paramètre e fait trente-deux caractères hexadécimaux. Le paramètre c en fait seize. Un téléphone qui approche la puce ouvre cette adresse déjà complétée. La page /verify interroge ensuite le point d'entrée de vérification de l'API, sur api.sealtrust.io.

Sur l'offre SealTrust Inside, nous gravons votre propre nom de domaine dans la puce, à la place de sealtrust.io. Ce choix se fige au premier encodage : une fois une puce gravée, le serveur refuse en 409 tout changement de domaine, parce que les puces déjà posées pointeraient dans le vide.

Trois choses en découlent.

Une adresse déjà utilisée est refusée. La puce incrémente un compteur à chaque lecture. Le serveur exige que ce compteur avance strictement. Une adresse capturée puis rejouée reçoit un 409. Une signature qui ne correspond pas reçoit un 403 avec le code SDM_MAC_MISMATCH. Des paramètres mal formés reçoivent un 422.

Le sceau d'ouverture, sur les puces qui en portent un. Certaines puces embarquent un fil qui se rompt à l'ouverture. Elles ajoutent alors un paramètre t de deux caractères, placé entre e et c. La réponse expose trois champs :

Le champ seal_intact a trois états. La valeur null ne veut pas dire rompu : une puce ordinaire et une puce dont la fonction n'a jamais été activée donnent toutes deux null. L'afficher en alerte poserait un avertissement de contrefaçon sur des produits authentiques.

Une réponse plus riche que la redirection du QR. La lecture d'une puce renvoie directement un document, avec le nom du produit, la marque, l'identifiant de jeton, l'adresse du contrat, l'historique, la valeur du compteur, un indicateur declared_stolen si une déclaration de vol est ouverte sur l'unité, et une zone de scan au grain de la ville quand la position est fournie.

#Ce que chacun coûte en préparation

#Le QR

Vous demandez l'image au moment où vous en avez besoin, et le serveur la renvoie en PNG. Vous choisissez une taille entre 100 et 1000 pixels. La correction d'erreur est de niveau M et la marge blanche fait deux modules. Gardez cette marge à l'impression, sinon la lecture devient incertaine.

Vous pouvez télécharger le code d'un produit, celui d'un certificat, ou l'archive ZIP de tous les codes d'un lot en une fois.

Pour un QR de niveau modèle, la console refuse de générer l'image tant qu'aucun passeport de modèle public n'est publié pour ce GTIN. Le message est explicite. Imprimer un code qui ne mène nulle part coûte plus cher que d'attendre.

En résumé : aucun matériel, aucune manipulation par exemplaire, aucun délai d'approvisionnement.

#Le sceau NFC

La préparation est d'une autre nature.

1. Votre offre doit comprendre l'authentification NFC. Sinon le serveur refuse la création des produits en 403.
2. Vous approvisionnez les puces. Ce sont des composants physiques, avec un délai et un coût par exemplaire.
3. Chaque puce passe devant un lecteur avant la création du produit. Nous lisons son identifiant matériel, vous l'associez à une ligne de votre lot, vous créez les produits, nous encodons les puces. C'est un parcours en quatre étapes, et il se fait puce par puce.
4. Nous écrivons l'adresse dans la puce au moment de l'encodage. Vous ne pouvez pas la modifier à distance ensuite. Une puce mal encodée est une puce à remplacer physiquement.

Sur un lot NFC, vous pouvez produire en parallèle un QR imprimé pour les mêmes unités. L'inverse ne marche pas : une adresse de puce imprimée dans un QR ne fonctionne pas, parce que c'est la puce qui remplit les paramètres e et c, et qu'une image imprimée ne remplit rien.

#Choisir

Un dernier point sur les domaines. Si vous servez ces résolveurs sur votre propre nom de domaine, un lien reste sur ce domaine du début à la fin, et vos clients ne voient jamais le nôtre. Un domaine de marque ne résout que les produits de cette marque : le code d'une autre marque scanné sur votre domaine reçoit un 404.