Skip to content
Sherry Singh edited this page Jun 1, 2026 · 1 revision

SmartCard Guard Wiki

Turn any smart card, ATM card, or employee ID into a physical Linux workstation key.

Overview

SmartCard Guard continuously monitors a smart card reader and enforces workstation security based on card presence.

When the card is removed:

  • The workstation is locked automatically.
  • Access is continuously denied until a card is present again.

Features

  • Smart card presence detection
  • Automatic workstation lock
  • Continuous access enforcement
  • KDE Plasma support
  • Wayland compatible
  • Lightweight Bash implementation
  • Open Source

Requirements

  • Linux
  • pcscd
  • pcsc-tools
  • libnotify-bin

Installation

chmod +x install.sh
./install.sh

Uninstall

chmod +x uninstall.sh
./uninstall.sh

Tested Hardware

Laptop

  • Dell Latitude E7450

Smart Card Reader

  • Broadcom 5880 Contact SmartCard Reader

Operating System

  • Parrot OS
  • KDE Plasma
  • Wayland

Security Notice

SmartCard Guard does not access:

  • Card PIN
  • Banking information
  • Account numbers
  • Financial data

The smart card is only used as a physical presence token.

Roadmap

  • ATR whitelisting
  • GNOME support
  • XFCE support
  • Multi-card authorization
  • PAM integration
  • FIDO2 / YubiKey support
  • GUI configuration utility

Clone this wiki locally