PHP SDM - NTAG DNA 424 Implementation

PHP implementation for NTAG DNA 424 Secure Dynamic Messaging (SDM).

Features

• NTAG DNA 424 SDM message decryption
• CMAC validation
• AES encryption/decryption
• PICC data parsing
• SUN message handling

Requirements

• PHP 8.3 or higher

Installation

composer require kduma/php-sdm

Usage

use KDuma\SDM\SDM;

// Initialize with your keys
$sdm = new SDM(
    encKey: 'your_encryption_key',
    macKey: 'your_mac_key'
);

// Decrypt SDM message
$result = $sdm->decrypt($encData, $encFileData, $cmac);

// Validate CMAC
$isValid = $sdm->validate($data, $cmac);

Development

Install dependencies

composer install

Run tests

composer test

Run static analysis

composer phpstan

Fix code style

composer cs-fix

Structure

src/
├── Cipher/          # Cryptographic operations
│   ├── CipherInterface.php
│   └── AESCipher.php
├── Exceptions/      # Custom exceptions
│   ├── SDMException.php
│   ├── DecryptionException.php
│   └── ValidationException.php
├── PICC/           # PICC data structures
│   └── PICCData.php
├── SUN/            # SUN message handling
│   └── SUNMessage.php
├── SDMInterface.php
└── SDM.php

License

MIT License. See LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.