********************************************************
Title    : MuscleCard Cryptoflex PlugIn
Authors  : David Corcoran    <corcoran@linuxnet.com>
           Piotr Gorak       <piotr.gorak@tpg.pl>
Requires : pcsc-lite-1.1.1 or higher
LICENSE  : See file LICENSE
********************************************************

Installation:
./configure
make; make install
./installBundle

Mac OS X users:
Use Project Builder to open the project under the pbx directory.
Build it and then install the bundle into /usr/local/pcsc/services.
 
If your token is unrecognized, try to use the bundleTool.
Remove all cards from any reader and make sure pcsc is running.
 
/usr/local/bin/bundleTool
 
bundleTool will edit the configuration information for your driver
and add support for the card which you will place into the reader.
You must be priveledged to do this as it will access
/usr/local/pcsc/services

Details:

A bundle directory will be placed under /usr/local/pcsc/services
This directory will contain everything about your plug-in.  The bundle 
looks like the following:

myBundle.bundle/Contents
                      Info.plist       - XML file of attributes like ATR, 
                                         Name
	              [Linux]/myBundle - Shared Library


This package works as a plug-in for the MuscleCard Framework
and provides card support through the MuscleCard API's.

IMPORTANT:

In order to use this package you must personalize the Cryptoflex card with 
some directories, files, etc.  MuscleTool provides the capability to 
format the Cryptoflex card.  To format run muscleTool.

MuscleCard Shell - type help for help
 
muscle > tokens
   1.    SchlumbergerSema Cryptoflex
 
muscle > format 1
Would you like to:
        1. Use the default factory key: 2C15E526E93E8A19
        2. Use the MUSCLE default key : 4D7573636C653030
        3. Enter your own transport key
 
Choose (1-3): 1
 
How much object memory would you like to allocate ?
Example: 7096 (7k) : 11000
 
********************* WARNING ! *********************
You are about to destroy all data on this token.
*****************************************************
 
Are you sure you want to continue ? (1-YES, 2-NO):1

Formatting token [*******] : Success


WARNING:  BE SURE TO USE THE CORRECT TRANSPORT KEY OR YOU MAY BLOCK YOUR CARD.  
          WHEN IN DOUBT, ASK


**************************************************************************

Fully Supported Features:
Create, Delete, List, Read, Write of Files (including ReadLarge ...)
ChangePIN, VerifyPIN, UnblockPIN
GetStatus, GetChallenge
ListKeys

Partially Supported Features:
ListPINs - Lists 2 pins (0, 1) - only 2 pins are currently supported.
GenerateKeyPair - only generates 1024 bit RSA keypairs in CRT format.
ImportKey - allows the import of a 1024 bit RSA CRT/Public key and a DES key.
ComputeCrypt - Works with 1024 bit RSA keys
ExportKey - Export of public key
LogoutAll

Not supported:
CreatePIN - not even started
ExternalAuthenticate - not even started

**************************************************************************
David Corcoran <corcoran@linuxnet.com>
