org.cryptimeleon.craco.enc.sym.streaming.aes

Class StreamingGCMAES

java.lang.Object

org.cryptimeleon.craco.enc.sym.streaming.aes.StreamingGCMAES

All Implemented Interfaces:

EncryptionScheme, StreamingEncryptionScheme, org.cryptimeleon.math.serialization.annotations.RepresentationRestorer, org.cryptimeleon.math.serialization.Representable, org.cryptimeleon.math.serialization.StandaloneRepresentable

public class StreamingGCMAES
extends java.lang.Object

An implementation of AES with GCM as the mode of operation.

For difference between this and StreamingGCMAESPacketMode, see the latter's documentation.

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	initialVector

Constructor Summary

Constructors

Constructor and Description
StreamingGCMAES()
StreamingGCMAES(int keyLength)
StreamingGCMAES(org.cryptimeleon.math.serialization.Representation repr)

Method Summary

Modifier and Type	Method and Description
java.io.OutputStream	createDecryptor(java.io.OutputStream out, DecryptionKey privateKey) Returns an OutputStream that decrypts any bytes written to it and writes the resulting plaintext to out.
java.io.OutputStream	createEncryptor(java.io.OutputStream out, EncryptionKey publicKey) Returns an OutputStream that encrypts any bytes written to it and writes the resulting ciphertext to out.
PlainText	decrypt(CipherText cipherText, DecryptionKey privateKey) Decrypts the given cipher text using the given decryption key.
java.io.InputStream	decrypt(java.io.InputStream in, DecryptionKey privateKey) Returns an InputStream containing the plaintext obtained by decrypting the content of in.
void	decrypt(java.io.InputStream cipherTextIn, java.io.OutputStream plainTextOut, DecryptionKey privateKey) Reads and decrypts a ciphertext from cipherTextIn and writes the resulting plaintext bytes to plainTextOut.
java.io.InputStream	encrypt(java.io.InputStream in, EncryptionKey publicKey) Returns an InputStream containing the ciphertext obtained by encrypting the content of in.
void	encrypt(java.io.InputStream plainTextIn, java.io.OutputStream cipherTextOut, EncryptionKey publicKey) Reads and encrypts the bytes from plainTextIn and writes the ciphertext to cipherTextOut.
CipherText	encrypt(PlainText plainText, EncryptionKey publicKey) Encrypts the given plain text using the given encryption key.
boolean	equals(java.lang.Object obj)
SymmetricKey	generateSymmetricKey() Generates a symmetric key, which is a random key with a specified length.
org.cryptimeleon.math.serialization.Representation	getRepresentation()
int	hashCode()
void	initCipher(javax.crypto.Cipher cipher, ByteArrayImplementation symmetricKey, int mode)
CipherText	restoreCipherText(org.cryptimeleon.math.serialization.Representation repr) Restores the ciphertext corresponding to the given representation.
DecryptionKey	restoreDecryptionKey(org.cryptimeleon.math.serialization.Representation repr) Restores the decryption key corresponding to the given representation.
EncryptionKey	restoreEncryptionKey(org.cryptimeleon.math.serialization.Representation repr) Restores the encryption key corresponding to the given representation.
PlainText	restorePlainText(org.cryptimeleon.math.serialization.Representation repr) Restores the plaintext corresponding to the given representation.
protected static ByteArrayImplementation	updateKeyToLength(ByteArrayImplementation symmetricKey, int symmetricKeyLength)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.cryptimeleon.craco.enc.EncryptionScheme

decrypt, encrypt, restoreFromRepresentation

Field Detail

initialVector

protected byte[] initialVector

Constructor Detail

StreamingGCMAES

public StreamingGCMAES()

StreamingGCMAES

public StreamingGCMAES(int keyLength)

StreamingGCMAES

public StreamingGCMAES(org.cryptimeleon.math.serialization.Representation repr)

Method Detail

initCipher

public void initCipher(javax.crypto.Cipher cipher,
                       ByteArrayImplementation symmetricKey,
                       int mode)
                throws java.security.InvalidAlgorithmParameterException,
                       java.security.InvalidKeyException

Throws:

java.security.InvalidAlgorithmParameterException

java.security.InvalidKeyException

encrypt

public java.io.InputStream encrypt(java.io.InputStream in,
                                   EncryptionKey publicKey)
                            throws java.io.IOException

Description copied from interface: StreamingEncryptionScheme

Returns an InputStream containing the ciphertext obtained by encrypting the content of in.

Note that calling this may already cause some bytes to be read from in.

Specified by:

encrypt in interface StreamingEncryptionScheme

Parameters:

in - stream containing the bytes to encrypt

publicKey - the key to encrypt with

Returns:

a stream containing the encrypted bytes.

Throws:

java.io.IOException

decrypt

public java.io.InputStream decrypt(java.io.InputStream in,
                                   DecryptionKey privateKey)
                            throws java.io.IOException

Description copied from interface: StreamingEncryptionScheme

Returns an InputStream containing the plaintext obtained by decrypting the content of in.

Note that calling this may already cause some bytes to be read from in.

Specified by:

decrypt in interface StreamingEncryptionScheme

Parameters:

in - in stream containing the bytes to decrypt

privateKey - the key to decrypt with.

Returns:

a stream containing the decrypted bytes.

Throws:

java.io.IOException

updateKeyToLength

protected static ByteArrayImplementation updateKeyToLength(ByteArrayImplementation symmetricKey,
                                                           int symmetricKeyLength)

createEncryptor

public java.io.OutputStream createEncryptor(java.io.OutputStream out,
                                            EncryptionKey publicKey)
                                     throws java.io.IOException

Description copied from interface: StreamingEncryptionScheme

Returns an OutputStream that encrypts any bytes written to it and writes the resulting ciphertext to out.

Note that calling this may already cause some bytes to be written to out.

Specified by:

createEncryptor in interface StreamingEncryptionScheme

Parameters:

out - the stream to write the ciphertext to.

publicKey - the key to encrypt with.

Returns:

a stream that encrypts any input and writes the ciphertext to out.

Throws:

java.io.IOException

createDecryptor

public java.io.OutputStream createDecryptor(java.io.OutputStream out,
                                            DecryptionKey privateKey)
                                     throws java.io.IOException

Description copied from interface: StreamingEncryptionScheme

Returns an OutputStream that decrypts any bytes written to it and writes the resulting plaintext to out.

Note that calling this may already cause some bytes to be written to out.

Specified by:

createDecryptor in interface StreamingEncryptionScheme

Parameters:

out - the stream to write the plaintext to.

privateKey - the key to decrypt with.

Returns:

a stream that decrypts any input and writes the plaintext to out.

Throws:

java.io.IOException

encrypt

public void encrypt(java.io.InputStream plainTextIn,
                    java.io.OutputStream cipherTextOut,
                    EncryptionKey publicKey)
             throws java.io.IOException

Description copied from interface: StreamingEncryptionScheme

Reads and encrypts the bytes from plainTextIn and writes the ciphertext to cipherTextOut.

Specified by:

encrypt in interface StreamingEncryptionScheme

Throws:

java.io.IOException - if any of the streams throw an exception while reading/writing bytes.

decrypt

public void decrypt(java.io.InputStream cipherTextIn,
                    java.io.OutputStream plainTextOut,
                    DecryptionKey privateKey)
             throws java.io.IOException

Description copied from interface: StreamingEncryptionScheme

Reads and decrypts a ciphertext from cipherTextIn and writes the resulting plaintext bytes to plainTextOut.

Specified by:

decrypt in interface StreamingEncryptionScheme

Throws:

java.io.IOException - if any of the streams throw an exception while reading/writing bytes.

encrypt

public CipherText encrypt(PlainText plainText,
                          EncryptionKey publicKey)

Description copied from interface: EncryptionScheme

Encrypts the given plain text using the given encryption key.

Specified by:

encrypt in interface EncryptionScheme

Parameters:

plainText - the plaintext to encrypt

publicKey - the key to use for encryption

Returns:

the resulting ciphertext

decrypt

public PlainText decrypt(CipherText cipherText,
                         DecryptionKey privateKey)

Description copied from interface: EncryptionScheme

Decrypts the given cipher text using the given decryption key.

Specified by:

decrypt in interface EncryptionScheme

Parameters:

cipherText - the ciphertext to decrypt

privateKey - the key to use for decryption

Returns:

the resulting plaintext

generateSymmetricKey

public SymmetricKey generateSymmetricKey()

Generates a symmetric key, which is a random key with a specified length. The key is represented in a byte array.

Returns:

the representable symmetric key

restoreCipherText

public CipherText restoreCipherText(org.cryptimeleon.math.serialization.Representation repr)

Description copied from interface: EncryptionScheme

Restores the ciphertext corresponding to the given representation.

Specified by:

restoreCipherText in interface EncryptionScheme

Parameters:

repr - the representation to restore the ciphertext from

Returns:

the ciphertext corresponding to the given representation

restoreDecryptionKey

public DecryptionKey restoreDecryptionKey(org.cryptimeleon.math.serialization.Representation repr)

Description copied from interface: EncryptionScheme

Restores the decryption key corresponding to the given representation.

Specified by:

restoreDecryptionKey in interface EncryptionScheme

Parameters:

repr - the representation to restore the decryption key from

Returns:

the decryption key corresponding to the given representation

restoreEncryptionKey

public EncryptionKey restoreEncryptionKey(org.cryptimeleon.math.serialization.Representation repr)

Description copied from interface: EncryptionScheme

Restores the encryption key corresponding to the given representation.

Specified by:

restoreEncryptionKey in interface EncryptionScheme

Parameters:

repr - the representation to restore the encryption key from

Returns:

the encryption corresponding to the given representation

restorePlainText

public PlainText restorePlainText(org.cryptimeleon.math.serialization.Representation repr)

Description copied from interface: EncryptionScheme

Restores the plaintext corresponding to the given representation.

Specified by:

restorePlainText in interface EncryptionScheme

Parameters:

repr - the representation to restore the plaintext from

Returns:

the plaintext corresponding to the given representation

getRepresentation

public org.cryptimeleon.math.serialization.Representation getRepresentation()

Specified by:

getRepresentation in interface org.cryptimeleon.math.serialization.Representable

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object