7.4 Managing applets

Before applets can be issued to devices, you must enter their details into MyID. You can do this using the Manage Applet workflow.

Note: You must obtain values for Load File AID and Executable AID from the vendor or developer of the applet: these are mandatory fields within MyID. You may also need values for Application AID and Application Privileges: these are not mandatory fields within MyID but may be needed for the applet to function correctly.

There may be some restrictions on the applets that can be issued. For example, the capacity of the devices you are using affects the size of applet that can be written to them. For further information, see the vendor’s own documentation.

7.4.1 Add an applet

To add an applet to the list of those available for issue within MyID:

  1. From the Applets category, select the Manage Applet workflow.

    You can also launch this workflow from the Configuration Settings section of the More category in the MyID Operator Client. See the Using Configuration Settings workflows section in the MyID Operator Client guide for details.

  2. Click New to create a new applet record.

    There are three read-only fields on this page, which are populated when the record is saved:

    • Memory Requirements initially displays Unset. It will show the size of the file referenced in File to upload in bytes.
    • Created Date is the date that details of this applet are added to MyID.
    • Issued Date is the date that the latest version of this applet is added to MyID – the first date that it could be issued.
  3. In Applet Name and Applet Description, enter information that will allow you to identify this applet when editing, updating, or selecting it for inclusion in a credential profile.

  4. Indicate whether the applet is to be enabled.

    • Select Enabled to enable this applet – it is included in the list of applets for selection for a credential profile and when updating a card.
    • Leave Enabled clear to prevent the applet being issued.
  5. Enter the Version of this applet.
  6. Indicate whether this applet can be removed from a card when it is canceled by selecting or clearing Removable.
  7. Enter the name of the Vendor of this applet.

  8. Select the File to upload. Click Browse and navigate to the applet. Select the appropriate file and click Open.

    Note: The applet file is expected to be in IJC format.

  9. Enter the Load File AID and Executable AID exactly as provided.
  10. If provided, enter values for the Application AID and the Application Privileges.

  11. Select the appropriate Transport key from the list if required:

    • If the applet file uploaded is unencrypted, do not select a Transport key.
    • If the supplied applet file is encrypted, select the appropriate Transport key (required for the applet to be decrypted) from the list. This Transport key must have been previously entered in the Key Manager workflow.
  12. Click Save.

7.4.2 Edit an applet

This option allows you to correct any mistakes you made when entering information but does not allow you to upload a new file.

If you want to make changes to an entry for an existing version of an applet:

  1. From the Applets category, select the Manage Applet workflow.

    You can also launch this workflow from the Configuration Settings section of the More category in the MyID Operator Client. See the Using Configuration Settings workflows section in the MyID Operator Client guide for details.

  2. Select the applet record you want to change and click Edit.

  3. Make all necessary changes.

    You can change all of the information you entered when the record was created (see section 7.4.1, Add an applet).

  4. Click Save.

7.4.3 Upgrade an applet

This option allows you to make a later version of an applet available for issue and to specify whether credential profiles and cards using the earlier version should be updated.

If you want to upgrade to a later version of an applet:

  1. From the Applets category, select the Manage Applet workflow.

    You can also launch this workflow from the Configuration Settings section of the More category in the MyID Operator Client. See the Using Configuration Settings workflows section in the MyID Operator Client guide for details.

  2. Select the applet record you want to change and click Upgrade.
  3. Enter the new version number for the applet.
  4. Click Browse and navigate to the applet. Select the appropriate file and click Open.

  5. Select:

    • Disable old version to disable previous versions of this applet.
    • Update credential profiles to automatically update any credential profiles using this applet to issue the new version.
    • Update credentials to create a job that updates any credentials that are currently using this applet to use the new version.
  6. Click Save.