Vereins-IT/NFC-Tools
Vereins-IT/NFC-Tools
7
0
Fork 0
Code Pull Requests Activity
Tooling around NFC readers/writers for EZGG LAN
9 Commits 2 Branches 0 Tags 41 KiB
Python 100%
main
Go to file
David Rodenkirchen c416eb8cef Update README.md
2026-04-02 09:00:59 +00:00
.gitignore add gitignore 2026-02-26 08:18:14 +01:00
card_reader.py initial commit 2026-02-26 08:18:45 +01:00
card_writer.py initial commit 2026-02-26 08:18:45 +01:00
hmac_key.example.txt initial commit 2026-02-26 08:18:45 +01:00
main.py finalize reader service 2026-04-02 08:55:41 +02:00
nfc-reader.service Update nfc-reader.service 2026-04-02 08:57:04 +00:00
NfcReaderService.py finalize reader service 2026-04-02 08:55:41 +02:00
README.md Update README.md 2026-04-02 09:00:59 +00:00
requirements.txt Update requirements.txt 2026-04-02 06:59:10 +00:00
secret.py initial commit 2026-02-26 08:18:45 +01:00

README.md

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.