-
Notifications
You must be signed in to change notification settings - Fork 2
Home
Welcome to the official documentation for ntag424-macos. This wiki serves as the central hub for guidance on interacting with NTAG 424 DNA NFC tags natively within the macOS environment.
Whether you are building secure authentication protocols, managing cryptographic keys, or implementing Secure Dynamic Messaging (SDM), these pages are designed to help you integrate efficiently and securely.
The NTAG 424 DNA chip offers advanced security features, primarily AES-128 cryptographic operations and dynamic URL generation, which are essential for anti-counterfeiting, secure access, and verifiable physical-to-digital interactions.
Interfacing with these specific hardware features on macOS often requires navigating complex APDU commands and smart card frameworks. This project abstracts that complexity, providing a streamlined, robust toolset for reading, writing, and authenticating these tags on Mac systems.
To help you navigate the repository, the documentation will be structured into the following key areas. (You can create these pages as you build out the wiki by clicking 'New Page' in the sidebar).
- Prerequisites: Supported macOS versions (Apple Silicon/Intel), required software dependencies, and compatible hardware (e.g., ACR122U or other PC/SC compliant smart card readers).
- Installation: Step-by-step instructions for installing the tools or building the project from source.
- Understanding NTAG 424 DNA: A brief primer on the chip's file system, application directories, and standard features.
- Secure Dynamic Messaging (SDM): An overview of how dynamic MACs and encrypted payloads are generated and verified.
- Key Management: Best practices for securely handling and storing your AES keys during development and deployment on macOS.
- Basic Operations: Commands for standard initialisation, reading the UID, and formatting standard NDEF records.
- Advanced Operations: Detailed instructions for authenticating with the tag, rotating keys, and configuring SDM parameters.
- Integration Examples: Code snippets and architectural patterns to help you integrate the toolset into wider applications.
- Common Errors: A diagnostic guide to common APDU failure codes and connection timeouts.
- Hardware Quirks: Known limitations or specific configurations required for various third-party NFC readers.
If you encounter bugs, hardware compatibility issues, or have feature requests, please use the Issues tab in the main repository.
Security Note: If you discover a vulnerability or a flaw in how cryptography is handled within this project, please do not open a public issue. Refer to the SECURITY.md file in the root of the repository for our responsible disclosure and safe harbour policy.