com.cryptshare.api

Class DpApiProtectionService

java.lang.Object

com.cryptshare.api.DpApiProtectionService

All Implemented Interfaces:

IProtectionService

public class DpApiProtectionService
extends java.lang.Object
implements IProtectionService

Implementation of IProtectionService that uses the Windows DPAPI to protect data on either user oder machine scope.

Constructor Summary

Constructors

Constructor and Description
DpApiProtectionService(ProtectionScope protectionScope) Constructor to create an instance with a certain protection scope.

Method Summary

Modifier and Type	Method and Description
ProtectionScope	getProtectionScope() Returns the protection scope that is used to protect the data.
byte[]	protect(byte[] bytesToProtect) Protects the given content, using Windows DPAPI.
byte[]	unprotect(byte[] protectedBytes) Unprotects the given content, using Windows DPAPI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DpApiProtectionService

public DpApiProtectionService(ProtectionScope protectionScope)

Constructor to create an instance with a certain protection scope.

Parameters:

protectionScope - machine or user scope

Method Detail

protect

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

Protects the given content, using Windows DPAPI.

Specified by:

protect in interface IProtectionService

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

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

Unprotects the given content, using Windows DPAPI.

Specified by:

unprotect in interface IProtectionService

Parameters:

protectedBytes - The content to unprotect.

Returns:

The unprotected content.

Throws:

ClientException - If the unprotection fails.

getProtectionScope

public ProtectionScope getProtectionScope()

Returns the protection scope that is used to protect the data.

Returns:

A ProtectionScope.