com.cryptshare.api

Interface IProtectionService

All Known Implementing Classes:

AesProtectionService, DpApiProtectionService

public interface IProtectionService

A service that provides the ability to protect and unprotect data. The protected outcome cannot be unprotected without certain knowledge or priviledge, depending on the implementation.

Method Summary

Modifier and Type	Method and Description
byte[]	protect(byte[] bytesToProtect) Protects the given content in an appropriate way so that uprotection is only possible with a specific knowledge or priviledge, depending on the implementation.
byte[]	unprotect(byte[] protectedBytes) Removes the protection from the given protected content.

Method Detail

protect

byte[] protect(byte[] bytesToProtect)
        throws ClientException

Protects the given content in an appropriate way so that uprotection is only possible with a specific knowledge or priviledge, depending on the implementation. This method is deterministic, meaning that the same content always produces the same protected outcome.

Parameters:

bytesToProtect - The content to protect.

Returns:

The protected content, which may vary in size, compared to the original content.

Throws:

ClientException - If the protection fails.

unprotect

byte[] unprotect(byte[] protectedBytes)
          throws ClientException

Removes the protection from the given protected content. This is only possible with a specific knowledge or privilege, depending on the implementation.

Parameters:

protectedBytes - The content to unprotect.

Returns:

The unprotected content.

Throws:

ClientException - If the unprotection fails.