com.gemalto.idp.mobile.securestorage

Interface SecureStorageManager

public interface SecureStorageManager

SecureStorageManager is used to create/retrieve/destroy PropertyStorage objects. PropertyStorage

Since:

4.0

Method Summary

Modifier and Type	Method and Description
void	destroyPropertyStorage(String identifier) Destroy a storage and all properties in the storage will be wiped.
PropertyStorage	getPropertyStorage(String identifier) Get Secret Storage with the given identifier and default settings.
PropertyStorage	getPropertyStorage(String identifier, DeviceFingerprintSource dfs) Get Secret Storage with the given identifier and default settings.
boolean	hasPropertyStorage(String identifier) Check if the property storage of given identifier exists.

Method Detail

getPropertyStorage

PropertyStorage getPropertyStorage(String identifier,
                                   DeviceFingerprintSource dfs)
                            throws IdpSecureStorageException

Get Secret Storage with the given identifier and default settings. If this storage has not been created before, the actual database file will be created when property is written to it for the first time, that is when PropertyStorage.writeProperty(byte[], com.gemalto.idp.mobile.core.util.SecureByteArray, boolean) is called. If this storage already exists, it returns a reference to it. The method PropertyStorage.open() simply opens the existing storage.

The storage is protected with a password that is managed by password manager as well as the device fingerprint.

Parameters:

identifier - the unique identifier of the storage.

dfs - the fingerprint sources to be used

Returns:

the storage object.

Throws:

IdpSecureStorageException - thrown when storage operation failed.

Since:

4.0.10

getPropertyStorage

PropertyStorage getPropertyStorage(String identifier)
                            throws IdpSecureStorageException

Get Secret Storage with the given identifier and default settings. If this storage has not been created before, the actual database file will be created when property is written to it for the first time, that is when PropertyStorage.writeProperty(byte[], com.gemalto.idp.mobile.core.util.SecureByteArray, boolean) is called. If this storage already exists, it returns a reference to it. The method PropertyStorage.open() simply opens the existing storage.

The storage is protected with a password that is managed by password manager as well as the device fingerprint. The default settings uses all device fingerprint sources.

Parameters:

identifier - the unique identifier of the storage.

Returns:

the storage object.

Throws:

IdpSecureStorageException - thrown when storage operation failed.

Since:

4.0

hasPropertyStorage

boolean hasPropertyStorage(String identifier)
                    throws IdpSecureStorageException

Check if the property storage of given identifier exists.

Parameters:

identifier - the unique identifier of the storage.

Returns:

true if the property exists.

Throws:

IdpSecureStorageException - thrown when storage operation failed.

Since:

4.0

destroyPropertyStorage

void destroyPropertyStorage(String identifier)
                     throws IdpSecureStorageException

Destroy a storage and all properties in the storage will be wiped.

Parameters:

identifier - the unique identifier of the storage.

Throws:

IdpSecureStorageException - thrown when storage operation failed.

Since:

4.0