Class TlsBlockCipher
- Namespace
- Org.BouncyCastle.Tls.Crypto.Impl
- Assembly
- BouncyCastle.Cryptography.dll
A generic TLS 1.0-1.2 block cipher. This can be used for AES or 3DES for example.
public class TlsBlockCipher : TlsCipher, TlsCipherExt- Inheritance
-
TlsBlockCipher
- Implements
- Inherited Members
Constructors
TlsBlockCipher(TlsCryptoParameters, TlsBlockCipherImpl, TlsBlockCipherImpl, TlsHmac, TlsHmac, int)
public TlsBlockCipher(TlsCryptoParameters cryptoParams, TlsBlockCipherImpl encryptCipher, TlsBlockCipherImpl decryptCipher, TlsHmac clientMac, TlsHmac serverMac, int cipherKeySize)Parameters
cryptoParamsTlsCryptoParametersencryptCipherTlsBlockCipherImpldecryptCipherTlsBlockCipherImplclientMacTlsHmacserverMacTlsHmaccipherKeySizeint
Exceptions
Fields
m_acceptExtraPadding
protected readonly bool m_acceptExtraPaddingField Value
m_cryptoParams
protected readonly TlsCryptoParameters m_cryptoParamsField Value
m_decryptCipher
protected readonly TlsBlockCipherImpl m_decryptCipherField Value
m_decryptConnectionID
protected readonly byte[] m_decryptConnectionIDField Value
- byte[]
m_decryptUseInnerPlaintext
protected readonly bool m_decryptUseInnerPlaintextField Value
m_encryptCipher
protected readonly TlsBlockCipherImpl m_encryptCipherField Value
m_encryptConnectionID
protected readonly byte[] m_encryptConnectionIDField Value
- byte[]
m_encryptThenMac
protected readonly bool m_encryptThenMacField Value
m_encryptUseInnerPlaintext
protected readonly bool m_encryptUseInnerPlaintextField Value
m_randomData
protected readonly byte[] m_randomDataField Value
- byte[]
m_readMac
protected readonly TlsSuiteHmac m_readMacField Value
m_useExplicitIV
protected readonly bool m_useExplicitIVField Value
m_useExtraPadding
protected readonly bool m_useExtraPaddingField Value
m_writeMac
protected readonly TlsSuiteHmac m_writeMacField Value
Properties
UsesOpaqueRecordType
public virtual bool UsesOpaqueRecordType { get; }Property Value
Methods
CheckPaddingConstantTime(byte[], int, int, int, int)
protected virtual int CheckPaddingConstantTime(byte[] buf, int off, int len, int blockSize, int macSize)Parameters
Returns
ChooseExtraPadBlocks(int)
protected virtual int ChooseExtraPadBlocks(int max)Parameters
maxint
Returns
DecodeCiphertext(long, short, ProtocolVersion, byte[], int, int)
Decode the passed in ciphertext using the current bulk cipher.
public virtual TlsDecodeResult DecodeCiphertext(long seqNo, short recordType, ProtocolVersion recordVersion, byte[] ciphertext, int offset, int len)Parameters
seqNolongsequence number of the message represented by ciphertext.
recordTypeshortcontent type used in the record for this message.
recordVersionProtocolVersionProtocolVersion used for the record.
ciphertextbyte[]array holding input ciphertext to the cipher.
offsetintoffset into input array the ciphertext starts at.
lenintlength of the ciphertext in the array.
Returns
- TlsDecodeResult
A TlsDecodeResult containing the result of decoding.
Exceptions
EncodePlaintext(long, short, ProtocolVersion, int, byte[], int, int)
Encode the passed in plaintext using the current bulk cipher.
public virtual TlsEncodeResult EncodePlaintext(long seqNo, short contentType, ProtocolVersion recordVersion, int headerAllocation, byte[] plaintext, int offset, int len)Parameters
seqNolongsequence number of the message represented by plaintext.
contentTypeshortcontent type of the message represented by plaintext.
recordVersionProtocolVersionProtocolVersion used for the record.
headerAllocationintextra bytes to allocate at start of returned byte array.
plaintextbyte[]array holding input plaintext to the cipher.
offsetintoffset into input array the plaintext starts at.
lenintlength of the plaintext in the array.
Returns
- TlsEncodeResult
A TlsEncodeResult containing the result of encoding (after 'headerAllocation' unused bytes).
Exceptions
EncodePlaintext(long, short, ProtocolVersion, int, ReadOnlySpan<byte>)
public virtual TlsEncodeResult EncodePlaintext(long seqNo, short contentType, ProtocolVersion recordVersion, int headerAllocation, ReadOnlySpan<byte> plaintext)Parameters
seqNolongcontentTypeshortrecordVersionProtocolVersionheaderAllocationintplaintextReadOnlySpan<byte>
Returns
GetCiphertextDecodeLimit(int)
Return the maximum input size for a ciphertext given a maximum output size for the plaintext of plaintextLimit bytes.
public virtual int GetCiphertextDecodeLimit(int plaintextLimit)Parameters
plaintextLimitintthe maximum output size for the plaintext.
Returns
- int
the maximum input size of the ciphertext for plaintextlimit bytes of output.
GetCiphertextEncodeLimit(int, int)
Return the maximum output size for a ciphertext given an actual input plaintext size of plaintextLength bytes and a maximum input plaintext size of plaintextLimit bytes.
public virtual int GetCiphertextEncodeLimit(int plaintextLength, int plaintextLimit)Parameters
plaintextLengthintthe actual input size for the plaintext.
plaintextLimitintthe maximum input size for the plaintext.
Returns
- int
the maximum output size of the ciphertext for plaintextlimit bytes of input.
GetCiphertextLength(int, int, int, int)
protected virtual int GetCiphertextLength(int blockSize, int macSize, int maxPadding, int plaintextLength)Parameters
Returns
GetPlaintextDecodeLimit(int)
public virtual int GetPlaintextDecodeLimit(int ciphertextLimit)Parameters
ciphertextLimitint
Returns
GetPlaintextEncodeLimit(int)
public virtual int GetPlaintextEncodeLimit(int ciphertextLimit)Parameters
ciphertextLimitint
Returns
GetPlaintextLength(int, int, int)
protected virtual int GetPlaintextLength(int blockSize, int macSize, int ciphertextLength)Parameters
Returns
GetPlaintextLimit(int)
Return the maximum size for the plaintext given ciphertextlimit bytes of ciphertext.
public virtual int GetPlaintextLimit(int ciphertextLimit)Parameters
ciphertextLimitintthe maximum number of bytes of ciphertext.
Returns
- int
the maximum size of the plaintext for ciphertextlimit bytes of input.
RekeyDecoder()
public virtual void RekeyDecoder()Exceptions
RekeyEncoder()
public virtual void RekeyEncoder()