Home

GlobalPlatformPro  

  from javacard.pro

Load and manage applets on compatible JavaCards from command line or from your Java project with a Do What I Mean approach (testimonials).

Provides an easy to use and high level interface that most of the time JustWorks^(TM), is flexible and 100% open source!

Tip

Building JavaCard applets is equally pleasing with ant-javacard

Important

Due to SPAM and malicious activity, wiki editing is open to collaborators only. Please suggest changes in discussions.

Jump to ...

• Download
• Usage
• Supported cards
• Contact & support
• Similar projects
• About & legal

List / install / delete applets

Please consult the help output for options that are not described here

• List applets (this and following commands open the secure channel and thus can brick your card with wrong keys!):

   gp -list # or gp -l
  

  How to interpret the output:

  • All AID-s of on-card objects are listed, starting with Issuer Security Domain (ISD)
  • Object's type, lifecycle state and privileges are listed below the AID line
  • Applications have type App and a state (like SELECTABLE) and privileges (like Default selected)
  • Executable Modules (type ExM, representing Java packages) are listed together with applets in them (which can be initiated with --create)
  • Security Domains have type SeD

• Delete current default applet's package and all instances:

   gp -delete -default
  

• Delete package D27600012401 and all applets from it:

   gp -delete D27600012401
  

• Install applet.cap as default applet (with AID information from the CAP):

   gp -install applet.cap -default
  

• Install applet.cap (with AID information from the CAP):

   gp -install applet.cap
  

• Unistall applet.cap (with AID information from the CAP):

   gp -uninstall applet.cap
  

• Force installation of applet.cap, deleting anything that's necessary, with AID information from the CAP:

   gp -f -install applet.cap
  

• Create new instance of applet D2760001240102000000000000000000 from package D27600012401 with AID D2760001240102000000000272950000:

   gp -package D27600012401 -applet D2760001240102000000000000000000 -create D2760001240102000000000272950000
  

• Same as previous, but takes the package/applet AID-s from CAP file and makes the new instance default selected:

   gp -cap OpenPGPApplet.cap -create D2760001240102000000000272950000 -default
  

About

The promise of GlobalPlatformPro is similar to OpenSSL:

Why buy a smart card software kit as a black box when you can get an open one for free?

In regard to GlobalPlatform, the goal is to make simple operations like installing and removing applets and locking the card with new keys as easy as next-next-done - you don't have to know the whole Global Platform specification by heart for that or buy a piece of proprietary software for a few hundred euros! For all those features that are not described in the GlobalPlatform specification that actually make your card work... you still have to use those proprietary commands, but GlobalPlatformPro toolkit's flexibility (and its license) should allow you to do that as well.

License

• LGPL 3.0 for derived code and MIT/LGPL3 for original code.

Legal disclaimer

The casual: trademarks to their owners, copyrights to authors, software patents to hell, legal letters to /dev/null PGP key 0x307E3452. Everything is provided AS-IS AND THERE IS A CONSTANT RISK OF DEATH FROM SUDDEN LIGHTNING. Writing in all caps made it look like serious, didn't it?