Files
vsmartcard/virtualsmartcard
oepen 555f996509 -Remove references to indices from index.rst
-Add some meta information to virtualsmartcard docs
-Add link to cyberflex-shell


git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@582 96b47cad-a561-4643-ad3b-153ac7d7599c
2011-10-27 11:51:39 +00:00
..
2011-09-17 20:42:51 +00:00
2009-08-22 08:01:54 +00:00
2009-08-22 08:01:54 +00:00
2010-05-08 20:58:58 +00:00
2010-05-08 20:58:58 +00:00

******************************
Virtual Smartcard Architecture
******************************

* Authors:
    * Frank Morgner <morgner@informatik.hu-berlin.de>
    * Dominik Oepen <oepen@informatik.hu-berlin.de>
* License: GPL version 3
* Tested Platforms: Linux 2.6 (Debian, Ubuntu, Om 2008)

Welcome to virtualsmartcard. The purpose of virtualsmartcard is to emulate a
smart card and make it accessible through PCSC. Currently the virtual smart
card supports almost all commands of ISO-7816 including secure messaging.
Besides a plain ISO-7816 smart card it is also possible to emulate a German
ePass (only basic access control) and a rudimentary Cryptoflex smart card. The
virtual smart card can be accessed through the virtual smart card reader which
is a driver for pcscd of PCSC-Lite.

By default the virtual smart card communicates with the virtual smart card
reader through a socket on localhost port 35963. The file utils.py was taken
from `Henryk Plötz's cyberflex-shell <https://github.com/henryk/cyberflex-shell/>`_.


Installation
------------
::

    autoconf -vsi
    ./configure
    make
    make install


Running virtualsmartcard
------------------------

First you need to make sure that pcscd loads the virtual smart card driver. You
might run ``update-reader.conf`` to update pcscd's configuration file. Then
``pcscd -f -d`` should say something like
readerfactory.c:1024:RFInitializeReader() Attempting startup of Virtual PCD 00 00 using /usr/lib/pcsc/drivers/serial/libvpcd.so

Now you can run ``vicc`` which connects to the virtual reader. The
command ``vicc --help`` gives an overview about the command line
options.

You should now be able to access the virtual smart card through the system's
PC/SC API. You can use the opensc-explorer or pcsc_scan to test that.


Question
---------

For questions, please use http://sourceforge.net/projects/vsmartcard/support