/// <summary>
/// Initializes a new instance of the CkTlsKdfParams class.
/// </summary>
/// <param name="prfMechanism">Hash mechanism used in the TLS 1.2 PRF construct or CKM_TLS_PRF to use with the TLS 1.0 and 1.1 PRF construct (CKM)</param>
/// <param name="label">Label for this key derivation</param>
/// <param name="randomInfo">Random data for the key derivation</param>
/// <param name="contextData">Context data for this key derivation</param>
public CkTlsKdfParams(NativeULong prfMechanism, byte[] label, CkSsl3RandomData randomInfo, byte[] contextData)
{
_lowLevelStruct.Label = IntPtr.Zero;
_lowLevelStruct.LabelLength = 0;
_lowLevelStruct.ContextData = IntPtr.Zero;
_lowLevelStruct.ContextDataLength = 0;
if (randomInfo == null)
{
throw new ArgumentNullException("randomInfo");
}
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
_lowLevelStruct.PrfMechanism = prfMechanism;
if (label != null)
{
_lowLevelStruct.Label = UnmanagedMemory.Allocate(label.Length);
UnmanagedMemory.Write(_lowLevelStruct.Label, label);
_lowLevelStruct.LabelLength = NativeLongUtils.ConvertFromInt32(label.Length);
}
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
if (contextData != null)
{
_lowLevelStruct.ContextData = UnmanagedMemory.Allocate(contextData.Length);
UnmanagedMemory.Write(_lowLevelStruct.ContextData, contextData);
_lowLevelStruct.ContextDataLength = NativeLongUtils.ConvertFromInt32(contextData.Length);
}
}
/// <summary>
/// Disposes object
/// </summary>
/// <param name="disposing">Flag indicating whether managed resources should be disposed</param>
protected virtual void Dispose(bool disposing)
{
if (!this._disposed)
{
if (disposing)
{
// Dispose managed objects
if (_returnedKeyMaterialLeftInstance == false)
{
if (_returnedKeyMaterial != null)
{
_returnedKeyMaterial.Dispose();
_returnedKeyMaterial = null;
}
}
// Release the reference to randomInfo so GC knows this object doesn't need it anymore
_randomInfo = null;
}
// Dispose unmanaged objects
UnmanagedMemory.Free(ref _lowLevelStruct.ReturnedKeyMaterial);
_disposed = true;
}
}
/// <summary>
/// Initializes a new instance of the CkSsl3KeyMatParams class.
/// </summary>
/// <param name='macSizeInBits'>The length (in bits) of the MACing keys agreed upon during the protocol handshake phase</param>
/// <param name='keySizeInBits'>The length (in bits) of the secret keys agreed upon during the protocol handshake phase</param>
/// <param name='ivSizeInBits'>The length (in bits) of the IV agreed upon during the protocol handshake phase or if no IV is required, the length should be set to 0</param>
/// <param name='isExport'>Flag indicating whether the keys have to be derived for an export version of the protocol</param>
/// <param name='randomInfo'>Client's and server's random data information</param>
public CkSsl3KeyMatParams(uint macSizeInBits, uint keySizeInBits, uint ivSizeInBits, bool isExport, CkSsl3RandomData randomInfo)
{
if (randomInfo == null)
{
throw new ArgumentNullException("randomInfo");
}
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
if (ivSizeInBits % 8 != 0)
{
throw new ArgumentException("Value has to be a multiple of 8", "ivSizeInBits");
}
// GC will not free ReturnedKeyMaterial while this object exists
_returnedKeyMaterial = new CkSsl3KeyMatOut(ivSizeInBits / 8);
_lowLevelStruct.MacSizeInBits = macSizeInBits;
_lowLevelStruct.KeySizeInBits = keySizeInBits;
_lowLevelStruct.IVSizeInBits = ivSizeInBits;
_lowLevelStruct.IsExport = isExport;
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
// Abrakadabra :)
_lowLevelStruct.ReturnedKeyMaterial = UnmanagedMemory.Allocate(UnmanagedMemory.SizeOf(typeof(CK_SSL3_KEY_MAT_OUT)));
UnmanagedMemory.Write(_lowLevelStruct.ReturnedKeyMaterial, _returnedKeyMaterial._lowLevelStruct);
}
/// <summary>
/// Initializes a new instance of the CkTls12KeyMatParams class.
/// </summary>
/// <param name="macSizeInBits">The length (in bits) of the MACing keys agreed upon during the protocol handshake phase</param>
/// <param name="keySizeInBits">The length (in bits) of the secret keys agreed upon during the protocol handshake phase</param>
/// <param name="ivSizeInBits">The length (in bits) of the IV agreed upon during the protocol handshake phase</param>
/// <param name="isExport">Flag which must be set to false because export cipher suites must not be used in TLS 1.1 and later</param>
/// <param name="randomInfo">Client's and server's random data information</param>
/// <param name="prfHashMechanism">Base hash used in the underlying TLS1.2 PRF operation used to derive the master key (CKM)</param>
public CkTls12KeyMatParams(NativeULong macSizeInBits, NativeULong keySizeInBits, NativeULong ivSizeInBits, bool isExport, CkSsl3RandomData randomInfo, NativeULong prfHashMechanism)
{
if (randomInfo == null)
{
throw new ArgumentNullException("randomInfo");
}
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
// GC will not free ReturnedKeyMaterial while this object exists
_returnedKeyMaterial = new CkSsl3KeyMatOut(ivSizeInBits / 8);
_lowLevelStruct.MacSizeInBits = macSizeInBits;
_lowLevelStruct.KeySizeInBits = keySizeInBits;
_lowLevelStruct.IVSizeInBits = ivSizeInBits;
_lowLevelStruct.IsExport = isExport;
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
// Abrakadabra :)
_lowLevelStruct.ReturnedKeyMaterial = UnmanagedMemory.Allocate(UnmanagedMemory.SizeOf(typeof(CK_SSL3_KEY_MAT_OUT)));
UnmanagedMemory.Write(_lowLevelStruct.ReturnedKeyMaterial, _returnedKeyMaterial._lowLevelStruct);
_lowLevelStruct.PrfHashMechanism = prfHashMechanism;
}
/// <summary>
/// Initializes a new instance of the CkSsl3MasterKeyDeriveParams class.
/// </summary>
/// <param name='randomInfo'>Client's and server's random data information</param>
/// <param name='dh'>Set to false for CKM_SSL3_MASTER_KEY_DERIVE mechanism and to true for CKM_SSL3_MASTER_KEY_DERIVE_DH mechanism</param>
public CkSsl3MasterKeyDeriveParams(CkSsl3RandomData randomInfo, bool dh)
{
if (randomInfo == null)
throw new ArgumentNullException("randomInfo");
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
_lowLevelStruct.Version = (dh) ? IntPtr.Zero : UnmanagedMemory.Allocate(UnmanagedMemory.SizeOf(typeof(CK_VERSION)));
}
/// <summary>
/// Initializes a new instance of the CkSsl3MasterKeyDeriveParams class.
/// </summary>
/// <param name='randomInfo'>Client's and server's random data information</param>
/// <param name='dh'>Set to false for CKM_SSL3_MASTER_KEY_DERIVE mechanism and to true for CKM_SSL3_MASTER_KEY_DERIVE_DH mechanism</param>
public CkSsl3MasterKeyDeriveParams(CkSsl3RandomData randomInfo, bool dh)
{
if (randomInfo == null)
{
throw new ArgumentNullException("randomInfo");
}
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
_lowLevelStruct.Version = (dh) ? IntPtr.Zero : UnmanagedMemory.Allocate(UnmanagedMemory.SizeOf(typeof(CK_VERSION)));
}
/// <summary>
/// Initializes a new instance of the CkTls12MasterKeyDeriveParams class.
/// </summary>
/// <param name="randomInfo">Client's and server's random data information</param>
/// <param name="prfHashMechanism">Base hash used in the underlying TLS 1.2 PRF operation used to derive the master key (CKM)</param>
public CkTls12MasterKeyDeriveParams(CkSsl3RandomData randomInfo, NativeULong prfHashMechanism)
{
if (randomInfo == null)
{
throw new ArgumentNullException("randomInfo");
}
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
_lowLevelStruct.Version = UnmanagedMemory.Allocate(UnmanagedMemory.SizeOf(typeof(CK_VERSION)));
_lowLevelStruct.PrfHashMechanism = prfHashMechanism;
}
/// <summary>
/// Disposes object
/// </summary>
/// <param name="disposing">Flag indicating whether managed resources should be disposed</param>
protected virtual void Dispose(bool disposing)
{
if (!this._disposed)
{
if (disposing)
{
// Dispose managed objects
// Release the reference to randomInfo so GC knows this object doesn't need it anymore
_randomInfo = null;
}
// Dispose unmanaged objects
UnmanagedMemory.Free(ref _lowLevelStruct.Version);
_disposed = true;
}
}
/// <summary>
/// Initializes a new instance of the CkSsl3KeyMatParams class.
/// </summary>
/// <param name='macSizeInBits'>The length (in bits) of the MACing keys agreed upon during the protocol handshake phase</param>
/// <param name='keySizeInBits'>The length (in bits) of the secret keys agreed upon during the protocol handshake phase</param>
/// <param name='ivSizeInBits'>The length (in bits) of the IV agreed upon during the protocol handshake phase or if no IV is required, the length should be set to 0</param>
/// <param name='isExport'>Flag indicating whether the keys have to be derived for an export version of the protocol</param>
/// <param name='randomInfo'>Client's and server's random data information</param>
public CkSsl3KeyMatParams(uint macSizeInBits, uint keySizeInBits, uint ivSizeInBits, bool isExport, CkSsl3RandomData randomInfo)
{
if (randomInfo == null)
throw new ArgumentNullException("randomInfo");
// Keep reference to randomInfo so GC will not free it while this object exists
_randomInfo = randomInfo;
if (ivSizeInBits % 8 != 0)
throw new ArgumentException("Value has to be a multiple of 8", "ivSizeInBits");
// GC will not free ReturnedKeyMaterial while this object exists
_returnedKeyMaterial = new CkSsl3KeyMatOut(ivSizeInBits / 8);
_lowLevelStruct.MacSizeInBits = macSizeInBits;
_lowLevelStruct.KeySizeInBits = keySizeInBits;
_lowLevelStruct.IVSizeInBits = ivSizeInBits;
_lowLevelStruct.IsExport = isExport;
_lowLevelStruct.RandomInfo = (CK_SSL3_RANDOM_DATA)_randomInfo.ToMarshalableStructure();
// Abrakadabra :)
_lowLevelStruct.ReturnedKeyMaterial = UnmanagedMemory.Allocate(UnmanagedMemory.SizeOf(typeof(CK_SSL3_KEY_MAT_OUT)));
UnmanagedMemory.Write(_lowLevelStruct.ReturnedKeyMaterial, _returnedKeyMaterial._lowLevelStruct);
}