Checks

Checks — Options

The Checks — Options panel is where you control the settings for injecting checks into your application. You enable or disable check injection, define annotation processing, and select the runtime Java environment for the application.

Enable Check Injection

Enables or disables the feature. Injection is used to add Tamper Checks, Debug Checks, Root Checks and Shelf Life expiration to the application.

Honor Annotations

Should PreEmptive Check annotation references in the code be honored or ignored? Annotations in the code are merged with check settings to determine the full list of checks.

Strip Annotations

Should PreEmptive Check annotation references be removed from the input classes?

Java Environment

This selects the runtime environment of your application and determines which Check implementations and Shelf Life implementation jar will be used.

Checks — Debug

The Type column shows the type of Check or Response.
The Description column describes the locations in the code, the methods and classes, where the Check or Response will be injected.
The Properties column shows the settings for that particular Check or Response. The tooltips expand to show more details about the locations or properties.

Checks — Root

The Type column shows the type of Check or Response.
The Description column describes the locations in the code, the methods and classes, where the Check or Response will be injected.
The Properties column shows the settings for that particular Check or Response. The tooltips expand to show more details about the locations or properties.

Root Response

Checks — Shelf Life

The Checks — Shelf Life panel is where you configure ShelfLifeChecks in your application. DashO uses this information to create an expiration token that is placed inside your code to enforce the expiration policy. The Check is injected based on the locations configured on this screen or where a @ShelfLifeCheck code annotation is used.

The Type column shows the type of Check.
The Description column describes the locations in the code, the methods and classes, where the Checks will be injected.
The Properties column shows the settings for that particular Check. The tooltips expand to show more details about the locations or properties.

Defaults

The information defined here is used for all individual Checks, unless the Check(s) overrides these defaults. It is also used to define properties to be added to the generated tokens.

Key File

Enter the location of the Shelf Life key file you received from PreEmptive Solutions. This file authorizes you to add Shelf Life Checks to your application.

Expiration Date

Your application can be configured to expire on an explicit date or a certain number of days after a dynamically determined start date. Dates are always in MM/DD/YYYY format regardless of the local convention.

Warning Date

Your application can be configured to issue expiration warnings starting on either an explicit date or a certain number of days before it is due to expire. Dates are always in MM/DD/YYYY format regardless of the local convention.

Properties

You can add arbitrary properties to the expiration token that can be retrieved by your application. To use this feature you need to supply a user defined action to the ShelfLifeCheck – this action method is passed the expiration token where you will be able to retrieve these properties. Note that both the property name and values can contain DashO property references.

Note:
The information supplied on this panel can be overridden or supplemented by a ShelfLifeCheck or a @ShelfLifeCheck code annotation.

Shelf Life Check

Configures a ShelfLifeCheck to be injected in the selected Locations. The Shelf Life Check has all the standard fields except Response and adds six additional fields:

Checks — Tamper

The Type column shows the type of Check or Response.
The Description column describes the locations in the code, the methods and classes, where the Check or Response will be injected.
The Properties column shows the settings for that particular Check or Response. The tooltips expand to show more details about the locations or properties.

Tamper Check

Configures a TamperCheck to be injected in the selected Locations. The Tamper Check has all the standard fields and adds four additional fields:

Keystore - The URL to the key store; defaults to .keystore in the user's home directory. May reference DashO properties.

Keystore Type - The type of the key store; defaults to the type specified by the JVM running DashO (e.g. JKS or PKCS12).
May reference DashO properties.

Keystore Password - The password for the key store. The user interface stores this in an encoded form but the value can be in plain text. May reference DashO properties.

Alias - The alias used to store the private key in the key store. May reference DashO properties.

Note: If these four fields are left blank, the key store and alias information from the Output-Signing page will be used.