NT4H NTAG® 424 DNA Tag Read/Write Software

Exemplele de cod sursă software explicate pe această pagină se referă la soluțiile tehnologice NFC NTAG® ADN. Scopul său principal este de a scrie și citi NTAG® 413 ADN-ul și NTAG® 424 tag-uri ADN-ului, de exemplu, NXP NTAG® tip 4 Tag.

Aceste etichete sunt pe deplin conforme cu:

• ISO/IEC 14443, toate părțile de la 1 la 4, selecția fișierelor ISO/IEC 7816-4 și manipularea APDU și ținta pasivă conformă cu ISO/IEC18092
• UID de 7 octeți (conform ISO/IEC 14443 – 3)
• Nfc Forum Tag 4 Tip tehnice și NDEF structura de configurare a structurii de date

Cu toate acestea, principalul motiv pentru a alege etichetele ADN NTAG® 424 dintre toate tipurile de familii NTAG este suportul său avansat de securitate. Etichetele ADN NTAG® 424 oferă metode avansate de securitate, cum ar fi:

• Criptografia standard AES-128 pentru autentificare/mesagerie securizată sau operațiunea AES învelită de LRP pentru o rezistență și mai puternică la atacuri
• 3-trece autentificare reciprocă pentru a accesa fișierul de date protejate
• Mesaj NFC unic securizat (SUN)
• Nfc incrementală atinge Contor
• Comunicare simplă, CMAC și criptată (configurabilă)
• Semnătura de originalitate NXP bazată pe ECC
• Asamblarea pe cip a adreselor URL ale articolelor cu oglinzi ASCII flexibile.

În consecință, exemplul nostru software include funcțiile pentru toate protocoalele de securitate ADN NTAG® 424 și implementarea opțiunilor.

Documente API

Descărcare software

Prezentare generală a software-ului

Functii software:

• Obținerea și editarea setărilor de fișier
• Obțineți UID
• Setarea ID-ului aleator
• Modificarea cheii AES
• Citire/scriere liniară (ASCII & HEX)
• Mod de autentificare pe trei niveluri
• CITIRE/scriere SDM (mesaj dinamic securizat)
• Obțineți contorul de citire SDM
• Stocarea cheii AES în Reader
• Blocarea/deblocarea cititorului
• Opțiuni avansate de citire (specificați portul Reader COM, adresa IP, SN etc.)

Limbaje de programare disponibile:

• C (consolă)
• C# (GUI)

Sisteme de operare, platforme și medii acceptate:

• Cross-platform

Etichete, etichete, carduri acceptate:

• NXP NTAG® 21x (210, 213, 215, 216, Tag Tamper)
• NXP NTAG® 4xx ADN (413, 424)

Hardware recomandat:

• μFR Nano
• μFR Nano Online
• μFR Clasic
• μfr Clasic CS
• μFR Advance
• μfr XL

1. Nt4H Software – C consola – Reader Open

Download: ufr-examples-c-nt4h

NT4H este destinat pentru o NXP NTAG® noi tag-uri de manipulare serie. Această serie include NTAG® 413 ADN și NTAG ®424 ADN. ADN-ul NTAG® 424 este pe deplin compatibil cu NFC Forum Type 4 Tag IC. Acceptă operarea criptografică AES-128 și un nou mesaj Secure Unique NFC (SUN). NXP nu recomandă utilizarea etichetelor ADN NTAG® 413 pentru proiecte noi, deoarece ADN-ul NTAG® 424 disponibil oferă caracteristici de securitate mai bune.

Lansarea aplicației deschide o consolă cu o imprimare a meniului de pornire.
Dacă ați instalat driverele hardware corect, veți putea deschide portul cititorului selectând una dintre opțiunile disponibile:

• Opțiunea 1 – Portul Reader se deschide utilizând opțiunile implicite (detectare automată) (de obicei utilizate pentru un singur cititor USB atașat la gazdă)
• Opțiunea 2 – Portul Reader se deschide utilizând parametri configurabili manual: reader_type, port_name, port_interface și argument.

2. NT4H Software – Consola C – Meniul principal

Aici este simplu Reader Open vitrina modul. 
Selectarea opțiunii de meniu 1. va deschide portul cititorului și va stabili comunicarea cu dispozitivul. Când comunicarea este stabilită, consola afișează meniul principal cu toate funcțiile software listate. 

2.1 NT4H Software – C consolă – Obțineți setările fișierelor

Prima funcție, Obțineți setări fișier, afișează setările de fișier selectate. În funcție de eticheta pe care o utilizați, tastați 1 -2 pentru NTAG413 și 1-3 pentru NTAG 424.

NTAG413 are două fișiere de date standard:

• Numărul de fișier 1 se referă la fișierul Container de capacitate (32 de octeți),
• Numărul de fișier 2 se referă la fișierul NDEF (128 octeți).

NTAG424 are trei fișiere de date standard:

• Numărul de fișier 1 se referă la fișierul Container de capacitate (32 de octeți),
• Numărul de fișier 2 se referă la fișierul NDEF (256 octeți),
• Numărul de fișier 3 se referă la fișierul proprietar (128 octeți),
• Numărul de parametri returnați este variabil.

Dacă fișierul curent este un fișier de date standard cu mesagerie securizată AES, se aplică următoarele:

• Tip de fişier
• Mod de comunicare
• Drepturi de acces la fișiere.

Exemplu de dimensiune a fișierului:

• Numărul fișierului = 3 (fișier proprietar NTAG424)
• Starea modului de comunicare încifrată (0x03)
• Mesageria dinamică securizată este dezactivată
• Numărul cheie pentru citire este 2, numărul cheie pentru scriere este 3,
• Numărul cheie pentru citire/scriere este 3,
• Numărul cheie pentru modificarea setărilor fișierului este 0,
• Dimensiunea fișierului este de 128 de octeți.

Dacă fișierul curent este un fișier de date standard cu mesagerie dinamică securizată, acesta conține mai multe date.

Exemplu:

• numărul fișierului este 2 (fișier NDEF),
• Mesageria dinamică securizată este activată,
• accesul la citire și scriere este gratuit (0x0E-cheie);
• dimensiunea fișierului este de 256 octeți,
• Oglindirea UID este activată,
• Contorul de citire SDM este activat,
• Limita contorului de citire SDM este dezactivată,
• partea de date criptate a fișierului este activată,
• numărul cheie pentru SDM Meta Read este 2 (UID, contor de citire SDM, date PICC, MAC),
• Partea de date criptate a numărului cheii de fișier este 2.
• Sdm Reading Counter poate citi fără autentificare,
• Decalajul de date PICC (UID criptat și sdm Reading Counter) este 49,
• Decalajul de intrare MAC este 86,
• partea de date criptate a decalajului de fișier este 86,
• partea de date criptate din lungimea fișierului este 32,
• MAC Offset este 124.

2.2 NT4H Software – C consolă – Setați setările fișierului

Pentru a adăuga setările fișierului, selectați a doua opțiune de meniu. Datorită unui număr mare de parametri, există două funcții pentru setările parametrilor de fișier.

Fișier de date standard:

• Numărul de fișier 3 (fișier proprietar),
• modul curent de comunicare este încifrat,
• Modificarea valorii cheie este 0.

Noile setări sunt:

• Mod de comunicare simplu,
• Citeste cheie 2,
• Scrie cheie 3,
• Tasta de citire/scriere 3,
• Schimbați cheia 0,
• modul de autentificare a cheii furnizate.

Fișier de mesagerie dinamică securizată:

• numărul fișierului este 2,
• Mod de comunicare Câmpie,
• Tasta de citire este 14,
• Cheia de scriere este 14,
• Cheia de citire/scriere este 14,
• Modificarea valorii cheie este 0,
• Oglindirea UID este activată,
• Contorul de citire SDM este activat,
• Contorul de citire SDM este dezactivat,
• partea de date criptate a fișierului este activată,
• SDM Meta Read Cheie este 2,
• SDM File Read este 2,
• SDM Reading Counter cheie este 2,
• Criptate PICC date Offset 49,
• Mac date de intrare Offset 86,
• partea de date criptate Offset 86,
• MAC Offset 124.

2.3 NT4H Software – C consolă – Ia UID (NTAG 424 numai)

Dacă utilizați etichete NTAG® 424 cu modul de securitate de autentificare activat, opțiunea de meniu 3. va afișa eticheta UID.

Funcția returnează UID-ul cardului de 7 octeți. Este util dacă opțiunile id-ului aleator sunt activate. Este necesară autentificarea validă cu orice cheie de card.

2.4 NT4H Software – C consolă – Set UID aleatoare (NTAG® 424 numai)

NTAG® 424 ADN-ul permite securitatea tag-ul suplimentar de setarea UID aleatoare (opțiunea de meniu 4).
Funcția Setați UID aleatoare înlocuiește UID-ul unic de 7 octeți cu UID-ul aleatoriu de 4 octeți. În consecință, eticheta returnează un UID aleatoriu de 4 octeți la fiecare citire. Eticheta returnează acum un ID aleator de 4 octeți în loc de un ID unic de 7 octeți.
Această funcție necesită autentificarea Master Key (numărul 0).

Atenție: această operație este ireversibilă!

2.5 NT4H Software – C consolă – Schimbați cheia AES

Opțiunea de meniu 5 permite schimbarea cheii AES.
Această funcție necesită autentificarea Master Key (numărul 0).
Introduceți noua cheie AES tastând cei 16 octeți hexazecimali.
Dacă cheia care trebuie modificată nu este o cheie master, valoarea cheie anterioară este obligatorie.

Exemplu de modificare a cheii AES:

• Numărul cheie 4.
• 0x00000000000000000000000000000000 de valoare cheie master aplicație
• 0x00000000000000000000000000000000 de valori Old Key 4
• Noua cheie 4 valoare 0x11111111111111111111111111111111.

2.6 NT4H Software – C consolă – Linear Read

Funcția Linear Read include modul de citire simplu, macked și încifrat. De asemenea, autentificarea de citire a conținutului în modul cheie furnizat și modul cheie internă permite accesul la conținut dacă eticheta este protejată. În caz contrar, conținutul etichetei deblocate poate fi citit fără a introduce cheia (opțiunea: Fără autentificare). Consola va afișa conținutul care poate fi citit în modul de autentificare selectat ca hexazecimal și notația ASCI.

2.6.1 NT4H Software – C consolă – Linear Read

Funcția Linear Read include simplu, mac (Message Authentication Code) și modul de citire încifrat. De asemenea, autentificarea de citire a conținutului în modul Cheie furnizată și modul Cheie internă permite accesul la conținut dacă eticheta este protejată. În caz contrar, conținutul etichetei deblocate este accesibil fără a introduce cheia (opțiunea: Fără autentificare). Consola va afișa conținutul care poate fi citit în modul de autentificare selectat ca hexazecimal și notația ASCI.

Funcția citește datele înregistrate în fișiere. Parametrii necesari sunt:

• Numărul fișierului,
• Cheia de acces pentru citire sau citire/scriere,
• Modul de comunicare,
• Modul de autentificare (dacă tasta de citire este 14, selectați opțiunea Fără autentificare),
• Adresa de start (0 – adresa maximă),
• Lungimea datelor.

2.7 NT4H Software – C consolă – Linear Write

Ca și în cazul funcției Linear Read, funcția Linear Write permite trei moduri de comunicare și format hexazecimal sau ASCII și pentru scrierea de conținut. De asemenea, modul de autentificare selectat se aplică conținutului înregistrat. 

Funcția scrie date în fișier. Parametrii necesari sunt:

• Numărul fișierului,
• Cheia de acces pentru citire sau citire/scriere,
• Modul de comunicare,
• Modul de autentificare (dacă tasta de citire este 14, selectați opțiunea Fără autentificare ),
• Adresa de start (0 – adresa maximă),
• Introduceți datele în format ASCII sau hexazecimal.

2.8 NT4H Software – C consola – Secure Dynamic Message Read

Secure Dynamic Messaging (SDM) pe etichetele ADN NT4H permite caracteristica SUN. Se referă la textul (ASCII) din mesajul NDEF.
Pentru a aplica funcția Secure Dynamic Message Read, activați fișierul Secure Dynamic Message. De asemenea, setați accesul de citire la gratuit (tasta 14 – fără opțiunea de autentificare).

2.9 NT4H Software – C consola – Secure Dynamic Message Write

Ca și în cazul Citirii dinamice securizate a mesajelor, pentru funcția Secure Dynamic Message Write, activați fișierul Secure Dynamic Message. De asemenea, setați accesul de citire la gratuit (tasta 14 – fără opțiunea de autentificare).

2.10 NT4H Software – C consolă – Obțineți SDM Reading Counter

Contorul de citire a mesajelor dinamice securizate există numai dacă fișierul SDM este activat. Autentificarea este sau nu este necesară, în funcție de setarea de acces la contorul de citire SDM al fișierului.

2.11 NT4H Software – C consolă – Stocați cheia AES în cititor

Dispozitivul Reader poate stoca 16 taste AES cu valori index 0-15. Aceasta înseamnă că indicele cheie poate fi orice valoare între 0 și 15.

Exemplul arată cum se stochează cheia cu o valoare de 0 x 000000000000000000000000000000000000 în cititor la adresa 1.

Cheia AES stocată în cititor este deblocată în mod implicit. Puteți bloca cheia stocată cu orice parolă de 8 octeți.

Exemplu:
Parola este 12345678

În cazul în care cheia stocată este protejată prin parolă (blocată), trebuie să o deblocați furnizând parola de 8 octeți.

Exemplu:
Parola este 12345678

Acest manual prezintă exemplul software-ului în limbajul de programare C. Cu toate acestea, toate software-ul legate de codul sursă în alte limbaje de programare conține aceleași funcții. Acolo unde se poate realiza, a fost dezvoltat un GUI.
Vă rugăm să verificați depozitul nostru GitLab pentru exemple de cod sursă disponibile în alte limbaje de programare.

Acasă

PRODUSE HARDWARE

SDK SOFTWARE