JKS

class JKS(api)

Bases: _ApplicationBase

create(name, device, description=None, contacts=None, approvers=None, application_credential=None, port=None, private_key_location=None, slot_number=None, java_vendor=None, protection_type=None, softcard_identifier=None, keytool_path=None, version=None, store_type=None, keystore_path=None, keystore_credential=None, private_key_credential=None, create=None, replace_existing=None, certificate_alias=None, reuse_alias=None, owner=None, owner_permissions=None, group=None, group_permissions=None, attributes=None, get_if_already_exists=True)
Parameters

  • name (str) – Name of the application object.

  • device (Union[config.Object, str]) – Config Object or Distinguished Name (DN) of the device object.

  • description (str) – Description for the application object.

  • contacts (List[Union[ident.Identity, str]]) – List of Identity Object or Prefixed Name as contacts for the application object.

  • approvers (List[Union[ident.Identity, str]]) – List of Identity Object or Prefixed Name as approvers for the application object.

  • application_credential (Union[config.Object, str]) – Config Object or Distinguished Name (DN) of the application credential.

  • port (int) – Connection port.

  • private_key_location (str) – Remote generation setting.

  • slot_number (int) – Slot number.

  • java_vendor (str) – Java vendor.

  • protection_type (str) – Remote generation protection type.

  • softcard_identifier (str) – Softcard identifier.

  • keytool_path (str) – Keytool path.

  • version (str) – Java version.

  • store_type (str) – Store type.

  • keystore_path (str) – Key store path.

  • keystore_credential (Union[config.Object, str]) – Config Object or Distinguished Name (DN) of the key store credential.

  • private_key_credential (Union[config.Object, str]) – Config Object or Distinguished Name (DN) of the private key credential.

  • create (bool) – Create store.

  • replace_existing (bool) – Replace existing store.

  • certificate_alias (str) – Certificate alias.

  • reuse_alias (bool) – Reuse certificate alias.

  • owner (str) – File user owner.

  • owner_permissions (str) – File permissions assigned to the user owner.

  • group (str) – File group owner.

  • group_permissions (str) – File permissions assigned to the group owner.

  • attributes (dict) – Additional attributes pertaining to the application object.

  • get_if_already_exists (bool) – If the objects already exists, just return it as is.

Returns

Config Object of the application.

delete(application)

Deletes an application object.

Parameters

application (Union[Object, str]) – Config Object or Distinguished Name (DN) of the application object.

disable(application)

Disables all processing and provisioning of the application.

Parameters

application (Union[Object, str]) – Config Object or Distinguished Name (DN) of the application object.

enable(application)

Enables all processing and provisioning of the application.

Parameters

application (Union[Object, str]) – Config Object or Distinguished Name (DN) of the application object.

get(application_dn, raise_error_if_not_exists=True)
Parameters
Returns

Config Object of the application

get_associated_certificate(application)
Parameters

application (Union[Object, str]) – Config Object or Distinguished Name (DN) of the application object.

Returns

Config Object of the certificate object associated to the application object.

get_stage(application)
Parameters

application (Union[Object, str]) – Config Object or Distinguished Name (DN) of the application object.

Returns

The current stage if it exists. Otherwise, returns None.

Return type

int

get_status(application)
Parameters

application (Union[Object, str]) – Config Object or Distinguished Name (DN) of the application object.

Returns

The current processing status of the application object or None if a status does not exist.

Return type

str

wait_for_installation_to_complete(application, timeout=60)

Waits for the application object’s “Last Pushed On” attribute to be a date greater than or equal to the “Last Renewed On” date on the associated certificate. If the certificate has not been recently renewed and is simply being associated to the certificate, either clear the “Last Pushed On” date from the application object or use pytpp.pytpp.features.certificate.Certificate.associate_application() with push_to_new=True.

Parameters