VICC(1)

📦
version 3.3 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

👑 VICC(1) 👑

okay so hi bestie 💖 you just opened the manual page for vicc, aka VICC(1), and ngl you're about to have a great time. it's a Virtual Smart Card emulator written in Python and it's giving main character energy fr fr.

🎀 NAME 🎀

vicc — a Virtual Smart Card emulator written in Python 💅

✨ SYNPSIS ✨

(not me spelling it that way — the original page really does, and I'm not about to rewrite canon 💀)

vicc [-h] [-t {iso7816,cryptoflex,ePass,nPA,relay,handler_test}] [-v]
[-f FILE] [-H HOSTNAME] [-P PORT] [-R] [--version] [--reader READER]
[--ef-cardaccess EF_CARDACCESS] [--ef-cardsecurity E_CARDSECURITY]
[--cvca CVCA] [--disable-ta-checks] [--ca-key CA_KEY] [-d DATASETFILE]
[--esign-cert ESIGN_CERT] [--esign-ca-cert ESIGN_CA_CERT]

🦋 DESCRIPTION 🦋

okay so picture this: Virtual Smart Card 0.8 🌈 — a smart card emulator written in Python. the emulator connects to the virtual smart card reader vpcd. and then smart card applications can access the Virtual Smart Card through the vpcd via PC/SC. that's the whole vibe. lowkey elegant, highkey useful 🫶

🌸 OPTIONS 🌸

general options (the essentials, the bare necessities 🧚)

  • -h, --help — show this help message and exit. the classic escape hatch 💖
  • -t {iso7816,cryptoflex,ePass,nPA,relay,handler_test}, --type {iso7816,cryptoflex,ePass,nPA,relay,handler_test} — which type of smart card to emulate (default: iso7816)
  • -v, --verbose — stack it up! use it several times to get more and more verbose 🗣️
  • -f FILE, --file FILE — load a saved smart card image
  • -H HOSTNAME, --hostname HOSTNAME — specify vpcd's host name, for when vicc shall connect to it (default: localhost)
  • -P PORT, --port PORT — port of connection establishment (default: 35963)
  • -R, --reversed — use reversed connection mode. vicc will wait for an incoming connection from vpcd (default: False)
  • --version — show program's version number and exit

relaying a local smart card options (--type=relay) 📡

  • --reader READER — number of the reader containing the card to be relayed (default: 0)

emulation of German identity card (--type=nPA) 🇩🇪

  • --ef-cardaccess EF_CARDACCESS — the card's EF.CardAccess (default: use file from first generation nPA)
  • --ef-cardsecurity EF_CARDSECURITY — the card's EF.CardSecurity (default: use file from first generation nPA)
  • --cvca CVCA — trust anchor for verifying certificates in TA (default: use libeac's trusted certificates)
  • --disable-ta-checks — disable checking the validity period of CV certificates (default: False)
  • --ca-key CA_KEY — the chip's private key for CA (default: randomly generated, invalidates signature of EF.CardSecurity)
⚠️ heads up bestie: the default here is a randomly generated key, and that invalidates the signature of EF.CardSecurity. not a drill 💀
  • -d DATASETFILE, --datasetfile DATASETFILE — Load the smartcard's data groups (DGs) from the specified dataset file. For DGs not in dataset file default values are used. The data groups in the data set file must have the following syntax:
Datagroupname=Datagroupvalue

For Example: GivenNames=GERTRUD. The following Dataset Elements may be used in the dataset file:

  • DocumentType
  • IssuingState
  • DateOfExpiry
  • GivenNames
  • FamilyNames
  • ReligiousArtisticName
  • AcademicTitle
  • DateOfBirth
  • PlaceOfBirth
  • Nationality
  • Sex
  • BirthName
  • Country
  • City
  • ZIP
  • Street
  • CommunityID
  • ResidencePermit1
  • ResidencePermit2
  • dg12
  • dg14
  • dg15
  • dg16
  • dg21
  • --esign-cert ESIGN_CERT — the card holder's certificate for QES
  • --esign-ca-cert ESIGN_CA_CERT — the CA's certificate for QES

Report bugs to <https://github.com/frankmorgner/vsmartcard/issues> 🐛✨ (please do, they wanna know)

📜 HISTORY 📜

June 2020, Man page originally compiled by Philippe Thierry (philou at debian dot org) 🫡

aaaand that's the whole page bestie 💖 this one's the VICC Man Page, part of VICC(1), compiled by Philippe Thierry, and it's from June 2020. go emulate something iconic, you've got this 👑🌸🦋

📦 where this page comes from