Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Specifies the key derivation function that the ECDiffieHellmanCng class will use to convert secret agreements into key material.
Namespace: System.Security.Cryptography
Assembly: System.Security (in System.Security.dll)
Syntax
'Declaration
Public Enumeration ECDiffieHellmanKeyDerivationFunction
public enum ECDiffieHellmanKeyDerivationFunction
public enum class ECDiffieHellmanKeyDerivationFunction
type ECDiffieHellmanKeyDerivationFunction
public enum ECDiffieHellmanKeyDerivationFunction
Members
| Member name | Description | |
|---|---|---|
| Hash | A hash algorithm is used to generate key material. The HashAlgorithm property specifies the name of the algorithm to use. If the algorithm name is not specified, SHA256 is used as the default algorithm.
You can also specify the SecretPrepend and SecretAppend properties, but they are not required. The amount of key material that is generated is equivalent to the size of the hash value for the specified algorithm. |
|
| Hmac | A Hash-based Message Authentication Code (HMAC) algorithm is used to generate key material. The HmacKey property specifies the key to use. Either this property must be set or the UseSecretAgreementAsHmacKey property must be set to true; otherwise, a CryptographicException is thrown when you use Hmac. If both properties are set, the secret agreement is used as the HMAC key.
You can also specify the SecretPrepend and SecretAppend properties, but they are not required. The amount of key material that is generated is equivalent to the size of the HMAC value. |
|
| Tls | The Transport Layer Security (TLS) protocol is used to generate key material. The Seed and Label properties must be set; otherwise, a CryptographicException is thrown when you use Tls.
This value generates 160 bits of key material. |
|
| None | No algorithm specified. |
Remarks
The ECDiffieHellmanKeyDerivationFunction enumeration defines the type of algorithm that will be used to transform a raw secret agreement into key material. The secret agreement is the value that is generated from a private key and the other party’s public key, as part of the key exchange. It is the seed value for the key material that is generated by the DeriveKeyMaterial method.
The KeyDerivationFunction property uses this enumeration to get the key derivation function for the ECDiffieHellmanCng class.