#if !BESTHTTP_DISABLE_ALTERNATE_SSL && (!UNITY_WEBGL || UNITY_EDITOR) #pragma warning disable using System; using BestHTTP.SecureProtocol.Org.BouncyCastle.Crypto.Parameters; namespace BestHTTP.SecureProtocol.Org.BouncyCastle.Crypto.Modes { /// /// A cipher mode that includes authenticated encryption with a streaming mode and optional /// associated data. /// /// /// Implementations of this interface may operate in a packet mode (where all input data is /// buffered and processed during the call to DoFinal, or in a streaming mode (where output /// data is incrementally produced with each call to ProcessByte or ProcessBytes. This is /// important to consider during decryption: in a streaming mode, unauthenticated plaintext /// data may be output prior to the call to DoFinal that results in an authentication failure. /// The higher level protocol utilising this cipher must ensure the plaintext data is handled /// appropriately until the end of data is reached and the entire ciphertext is authenticated. /// /// public interface IAeadCipher { /// The name of the algorithm this cipher implements. string AlgorithmName { get; } /// Initialise the cipher. /// Parameter can either be an AeadParameters or a ParametersWithIV object. /// Initialise for encryption if true, for decryption if false. /// The key or other data required by the cipher. void Init(bool forEncryption, ICipherParameters parameters); /// Add a single byte to the associated data check. /// If the implementation supports it, this will be an online operation and will not retain the associated data. /// The byte to be processed. void ProcessAadByte(byte input); /// Add a sequence of bytes to the associated data check. /// If the implementation supports it, this will be an online operation and will not retain the associated data. /// The input byte array. /// The offset into the input array where the data to be processed starts. /// The number of bytes to be processed. void ProcessAadBytes(byte[] inBytes, int inOff, int len); /** * Encrypt/decrypt a single byte. * * @param input the byte to be processed. * @param outBytes the output buffer the processed byte goes into. * @param outOff the offset into the output byte array the processed data starts at. * @return the number of bytes written to out. * @exception DataLengthException if the output buffer is too small. */ int ProcessByte(byte input, byte[] outBytes, int outOff); /** * Process a block of bytes from in putting the result into out. * * @param inBytes the input byte array. * @param inOff the offset into the in array where the data to be processed starts. * @param len the number of bytes to be processed. * @param outBytes the output buffer the processed bytes go into. * @param outOff the offset into the output byte array the processed data starts at. * @return the number of bytes written to out. * @exception DataLengthException if the output buffer is too small. */ int ProcessBytes(byte[] inBytes, int inOff, int len, byte[] outBytes, int outOff); /** * Finish the operation either appending or verifying the MAC at the end of the data. * * @param outBytes space for any resulting output data. * @param outOff offset into out to start copying the data at. * @return number of bytes written into out. * @throws InvalidOperationException if the cipher is in an inappropriate state. * @throws InvalidCipherTextException if the MAC fails to match. */ int DoFinal(byte[] outBytes, int outOff); /** * Return the value of the MAC associated with the last stream processed. * * @return MAC for plaintext data. */ byte[] GetMac(); /** * Return the size of the output buffer required for a ProcessBytes * an input of len bytes. * * @param len the length of the input. * @return the space required to accommodate a call to ProcessBytes * with len bytes of input. */ int GetUpdateOutputSize(int len); /** * Return the size of the output buffer required for a ProcessBytes plus a * DoFinal with an input of len bytes. * * @param len the length of the input. * @return the space required to accommodate a call to ProcessBytes and DoFinal * with len bytes of input. */ int GetOutputSize(int len); /// /// Reset the cipher to the same state as it was after the last init (if there was one). /// void Reset(); } } #pragma warning restore #endif