freenet.crypt

Class AEADInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

freenet.crypt.AEADInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class AEADInputStream
extends java.io.FilterInputStream

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
AEADInputStream(java.io.InputStream is, byte[] key, org.bouncycastle.crypto.BlockCipher hashCipher, org.bouncycastle.crypto.BlockCipher mainCipher) Create a decrypting, authenticating InputStream.

Method Summary

Modifier and Type	Method and Description
int	available()
void	close()
static AEADInputStream	createAES(java.io.InputStream is, byte[] key)
int	getIVSize()
void	mark(int readlimit)
boolean	markSupported()
int	read()
int	read(byte[] buf)
int	read(byte[] buf, int offset, int length)
void	reset()
long	skip(long n)

Methods inherited from class java.lang.Object

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

Constructor Detail

AEADInputStream

public AEADInputStream(java.io.InputStream is,
                       byte[] key,
                       org.bouncycastle.crypto.BlockCipher hashCipher,
                       org.bouncycastle.crypto.BlockCipher mainCipher)
                throws java.io.IOException

Create a decrypting, authenticating InputStream. IMPORTANT: We only authenticate when closing the stream, so do NOT use Closer.close() etc and swallow IOException's on close(), as that's what we will throw if authentication fails. We will read the nonce from the stream; it functions similarly to an IV.

Parameters:

is - The underlying InputStream.

key - The encryption key.

nonce - The nonce. This serves the function of an IV. As a nonce, this MUST be unique. We will write it to the stream so the other side can pick it up, like an IV.

mainCipher - The BlockCipher for encrypting data. E.g. AES; not a block mode. This will be used for encrypting a fairly large amount of data so could be any of the 3 BC AES impl's.

hashCipher - The BlockCipher for the final hash. E.g. AES, not a block mode. This will not be used very much so should be e.g. an AESLightEngine.

Throws:

java.io.IOException

Method Detail

getIVSize

public final int getIVSize()

read

public int read()
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

read

public int read(byte[] buf)
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

read

public int read(byte[] buf,
                int offset,
                int length)
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

available

public int available()
              throws java.io.IOException

Overrides:

available in class java.io.FilterInputStream

Throws:

java.io.IOException

skip

public long skip(long n)
          throws java.io.IOException

Overrides:

skip in class java.io.FilterInputStream

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.FilterInputStream

Throws:

java.io.IOException

markSupported

public boolean markSupported()

Overrides:

markSupported in class java.io.FilterInputStream

mark

public void mark(int readlimit)

Overrides:

mark in class java.io.FilterInputStream

reset

public void reset()
           throws java.io.IOException

Overrides:

reset in class java.io.FilterInputStream

Throws:

java.io.IOException

createAES

public static AEADInputStream createAES(java.io.InputStream is,
                                        byte[] key)
                                 throws java.io.IOException

Throws:

java.io.IOException