com.crypteron

Interface CipherObject

public interface CipherObject

CipherObject allows direct sealing (encrypting) and unsealing (decryption) of regular objects (POJOs). Behind the scenes the entire key management, encryption and tamper protection systems are automatically engaged.

Method Summary

Modifier and Type	Method and Description
static <T> T	seal(T plainObject) Seal an object's secured properties.
static <T> T	seal(T plainObject, String securityPartition, String asRole) Seal an object's secured properties.
static <T> T	unseal(T encObj) Unseals an object's secured properties.
static <T> T	unseal(T encObj, String securityPartition, String asRole) Unseals an object's secured properties.

Method Detail

seal

static <T> T seal(T plainObject,
                  String securityPartition,
                  String asRole)

Seal an object's secured properties. The specific properties that are sealed are based upon which properties have been decorated with the @Secure annotation. The resulting encrypted object can then be sent to any storage or transport safely. Sealing involves key management, encryption and tamper protection.

Parameters:

plainObject - A standard object (POJO) with properties in cleartext

securityPartition - Specifies the security partition this object should be sealed for

asRole - Specifies the role that should be sealing this object

Returns:

A standard object (POJO) with all or some of its properties sealed

seal

static <T> T seal(T plainObject)

Seal an object's secured properties. The specific properties that are sealed are based upon which properties have been decorated with the Secure attribute. The resulting encrypted object can then be sent to any storage or transport safely. Sealing involves key management, encryption and tamper protection.

The default security partition and role will be used.

Parameters:

plainObject - A standard object (POJO) with properties in cleartext

Returns:

A standard object (POJO) with all or some of its properties sealed

unseal

static <T> T unseal(T encObj,
                    String securityPartition,
                    String asRole)

Unseals an object's secured properties. The specific properties that are unsealed are based upon which properties have been decorated with the Secure attribute. Unsealing involves key management, decryption and tamper protection checks.

Parameters:

encObj - A standard object (POJO) with its secure properties encrypted

securityPartition - Specifies the security partition this object should be unsealed for

asRole - Specifies the role that should be unsealing this object

Returns:

A standard object (POJO) with properties in cleartext

unseal

static <T> T unseal(T encObj)

Unseals an object's secured properties. The specific properties that are unsealed are based upon which properties have been decorated with the Secure attribute. Unsealing involves key management, decryption and tamper protection checks.

The default security partition and role will be used.

Parameters:

encObj - A standard object (POJO) with its secure properties encrypted

Returns:

A standard object (POJO) with properties in cleartext