NFC-Tools/README.md

1.1 KiB

EZGG LAN NFC Tools

This repository contains the tooling around NFC readers/writers.

Currently supported NFC Device: ACR 1252U

Installation

Make sure you have the apt packages python3-dev and libpcsclite-dev installed before installing the dependencies from requirements.txt.

Configuration

The root path of the installation (next to NfcReaderService.py) needs to contain the hmac_key.txt. The correct key can be retrieved from sys admin.

Tools:

  • card_reader
    • Standalone: Reads single card and prints content
    • Library: API for extracting user ID from card
  • card_writer
    • Standalone: Takes user ID as console input, writes it securely to card
  • NfcReaderService
    • Standalone: Continuously reads cards and writes decrypted user ID as keyboard output

Intended usage

Start NfcReaderService on terminals where LAN team needs to verify guest identity, EZGG LAN manager then reads user ID from clipboard. NfcReaderService may be used as part of a systemd unit, to automate the startup process. See service file for additional info.

Run card_writer when preparing tickets.