From 37db4ba13694571256df82cd8179f02e364ec41e Mon Sep 17 00:00:00 2001 From: Martin Paljak Date: Fri, 24 Jan 2014 11:45:48 +0000 Subject: [PATCH] Update README.md --- README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 44 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 909b1ba3..3a5538d8 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,48 @@ -OpenKMS notice -============== -This code is based on GPJ, Global Platform for SmartCardIO -Java SDK library, available from http://gpj.sourceforge.net, -adapted for use in OpenKMS. +GlobalPlatform for OpenKMS +========================== +Load and manage applets with GlobalPlatform compatible JavaCards +### Usage +Command line samples assume default test keys of ```40..4F```. If you need custom keys, specify them with any or all of the following options: ```-keyid``` ```-keyver``` ```-enc``` ```-mac``` ```-kek``` (you need to know the details or ask your card provider). Some cards require key diversification with ```-emv``` or ```-visa2``` (you should be notified if that's the case). -It is licensed under LGPL 3.0 + * Show some basic information about a card (failsafe): -Credits: + java -jar openkms-globalplatform.jar -info + + * List applets: + + java -jar openkms-globalplatform.jar -list + + * Delete current default applet: + + java -jar openkms-globalplatform.jar -delete -default + + * Install applet.cap as default applet (with information from the CAP): + + java -jar openkms-globalplatform.jar -load applet.cap -install -default + + * Show APDU-s sent to the card: + + add ```-debug``` to your command + + * Don't use MAC on commands (plain GlobalPlatform commands): + add ```-mode clr``` to your command (not supported on all cards) + + +### Contact + + * martin@martinpaljak.net + * .. or file an issue on Github + +### History + +The ancestor of this code is GPJ (Global Platform for SmartCardIO) +available from http://gpj.sourceforge.net. + +### License + + * [LGPL 3.0](http://www.gnu.org/licenses/lgpl-3.0.html) + +### Credits (from GPJ): * Wojciech Mostowski , * Francois Kooman * Martijn Oostdijk @@ -15,6 +51,4 @@ Credits: * Dusan Kovacevic -- -OpenKMS - open source key management - -http://openkms.org +OpenKMS - open source key management - [openkms.org](http://openkms.org)