org.apache.poi.poifs.crypt.cryptoapi

Class CryptoAPIEncryptor

java.lang.Object

org.apache.poi.poifs.crypt.Encryptor

org.apache.poi.poifs.crypt.cryptoapi.CryptoAPIEncryptor

All Implemented Interfaces:

Cloneable

public class CryptoAPIEncryptor
extends Encryptor
implements Cloneable

Method Summary

Modifier and Type	Method and Description
CryptoAPIEncryptor	clone()
void	confirmPassword(String password)
void	confirmPassword(String password, byte[] keySpec, byte[] keySalt, byte[] verifier, byte[] verifierSalt, byte[] integritySalt)
ChunkedCipherOutputStream	getDataStream(DirectoryNode dir) Return a output stream for encrypted data.
org.apache.poi.poifs.crypt.cryptoapi.CryptoAPIEncryptor.CryptoAPICipherOutputStream	getDataStream(OutputStream stream, int initialOffset)
Cipher	initCipherForBlock(Cipher cipher, int block) Initializes a cipher object for a given block index for encryption
void	setChunkSize(int chunkSize) Sets the chunk size of the data stream.
void	setSummaryEntries(DirectoryNode dir, String encryptedStream, POIFSFileSystem entries) Encrypt the Document-/SummaryInformation and other optionally streams.

Methods inherited from class org.apache.poi.poifs.crypt.Encryptor

getDataStream, getEncryptionInfo, getInstance, getSecretKey, setEncryptionInfo, setSecretKey

Methods inherited from class java.lang.Object

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

Method Detail

confirmPassword

public void confirmPassword(String password)

Specified by:

confirmPassword in class Encryptor

confirmPassword

public void confirmPassword(String password,
                            byte[] keySpec,
                            byte[] keySalt,
                            byte[] verifier,
                            byte[] verifierSalt,
                            byte[] integritySalt)

Specified by:

confirmPassword in class Encryptor

initCipherForBlock

public Cipher initCipherForBlock(Cipher cipher,
                                 int block)
                          throws GeneralSecurityException

Initializes a cipher object for a given block index for encryption

Parameters:

cipher - may be null, otherwise the given instance is reset to the new block index

block - the block index, e.g. the persist/slide id (hslf)

Returns:

a new cipher object, if cipher was null, otherwise the reinitialized cipher

Throws:

GeneralSecurityException - when the cipher can't be initialized

getDataStream

public ChunkedCipherOutputStream getDataStream(DirectoryNode dir)
                                        throws IOException

Description copied from class: Encryptor

Return a output stream for encrypted data.

Specified by:

getDataStream in class Encryptor

Parameters:

dir - the node to write to

Returns:

encrypted stream

Throws:

IOException

getDataStream

public org.apache.poi.poifs.crypt.cryptoapi.CryptoAPIEncryptor.CryptoAPICipherOutputStream getDataStream(OutputStream stream,
                                                                                                         int initialOffset)
                                                                                                  throws IOException,
                                                                                                         GeneralSecurityException

Overrides:

getDataStream in class Encryptor

Throws:

IOException

GeneralSecurityException

setSummaryEntries

public void setSummaryEntries(DirectoryNode dir,
                              String encryptedStream,
                              POIFSFileSystem entries)
                       throws IOException,
                              GeneralSecurityException

Encrypt the Document-/SummaryInformation and other optionally streams. Opposed to other crypto modes, cryptoapi is record based and can't be used to stream-encrypt a whole file

Throws:

IOException

GeneralSecurityException

See Also:

2.3.5.4 RC4 CryptoAPI Encrypted Summary Stream

setChunkSize

public void setChunkSize(int chunkSize)

Description copied from class: Encryptor

Sets the chunk size of the data stream. Needs to be set before the data stream is requested. When not set, the implementation uses method specific default values

Overrides:

setChunkSize in class Encryptor

Parameters:

chunkSize - the chunk size, i.e. the block size with the same encryption key

clone

public CryptoAPIEncryptor clone()
                         throws CloneNotSupportedException

Overrides:

clone in class Encryptor

Throws:

CloneNotSupportedException