Skip to content

Content Management

Aiosa edited this page Jul 16, 2020 · 2 revisions

By default, only Applet instances are displayed. You can switch between the displays in the upper right corner. There are three types:

  • Package: not an application, but rather an installer. Think of it as an installer you've downloaded to install the desired app. Only, it cannot be removed unless an active application (that belongs to this package) is present on the card.
  • Applet: an application installed from a package. It holds your data and can be selected by a host machine to communicate with. It has to have unique AID.
  • SD/ISD - Security Domain: also an applet, it is the manager that allows us to install other applets and so on.

Installation

You can install an applet from your computer (see "INSTALL APPLET from this PC" icon on "My Card" panel). Or, you can install any application from the store.

Custom applets

In case you're installing applet from your PC, not much features are included as we don't know about the applet much. The applet will be installed as-is, and the only checks performed are space requirements and the applet signature if provided: the installation dialog window asks for detached signature file. It is only GUI replacement of traditional GnuPG signature verification - the public key must be in your keyring.

Store applets

For information on store installations see Install applet from the Store.

Deletion

When you select an instance on "My Card" panel, you can uninstall it in the details window unless it is a security domain. The installation will fail in case you are deleting a package and its applet instance is present. When deleting an applet, the application may ask for permission if the applet stores information. In Simple use mode, applet deletion will delete the package too in case the removed applet is its only active instance.

Possible failures

The deletion may fail due to inconsistent AID naming or collisions. In that case, manually remove applet and then its package. You will not probably know which package to delete - in that case delete any package that might be it - it will not succeed if the package is important on the card. In other words: a package deletion is always safe.

Sending APDU

This is low API feature, it is basically sending a raw bytes (in hex string form) to the card. Do not use it unless it is explicitly required by the applet installed from the store (from the 'Use Guide' section) or unless you know what you're doing.