CryptographyProviders Class

Namespace: Yubico.YubiKey.Cryptography Assembly: Yubico.YubiKey.dll

This class contains properties that specify cryptographic providers.

C#
public static class CryptographyProviders : Object
Inheritance System.Object CryptographyProviders

Remarks

During the course of operations, the SDK will need to perform cryptographic operations, such as random number generation, HMAC, Triple-DES encryption, and so on. Any SDK operation that needs crypto will get it from this class.

The properties in this class are delegates. They are functions that can build objects that will perform the required crypto. The reason these properties are methods that build objects, rather than objects themselves, is because the crypto classes implement IDisposable. In order to avoid the complex problem of ownership of an object that will be disposed once it goes out of scope, the SDK will create a new object each time one is needed. This new object will be in scope only for the duration of its use in the SDK, and will be disposed immediately when the SDK is done with it.

This class will return default implementations, but can be replaced. That is, if you do nothing, the SDK will use default C# cryptography. If you want the SDK to use your own implementations, you can do so. See the User's Manual entry on alternate crypto implementations for a detailed description of replacing the defaults. Generally, you will simply need to set the appropriate property with a new function.

Most applications will not replace the defaults, but for those that want the SDK to use a hardware RNG, hardware accelerator, or any other specific implementation for whatever reason, it is possible.

Properties

Name Description
AesCreator

This property is a delegate (function pointer). The method loaded will return an instance of AES.
AesGcmPrimitivesCreator

This property is a delegate (function pointer). This method will return an instance of IAesGcmPrimitives.
CmacPrimitivesCreator

This property is a delegate (function pointer). This method will return an instance of ICmacPrimitives, built to use the specified algorithm.
DesCreator

This property is a delegate (function pointer). The method loaded will return an instance of DES.
EcdhPrimitivesCreator

This property is a delegate (function pointer). This method will return an instance of IEcdhPrimitives.
HmacCreator

This property is a delegate (function pointer). This method will return an instance of HMAC.
RngCreator

This property is a delegate (function pointer). The method loaded will return an instance of RandomNumberGenerator.
Sha1Creator

This property is a delegate (function pointer). The method loaded will return an instance of SHA1.
Sha256Creator

This property is a delegate (function pointer). The method loaded will return an instance of SHA256.
Sha384Creator

This property is a delegate (function pointer). The method loaded will return an instance of SHA384.
Sha512Creator

This property is a delegate (function pointer). The method loaded will return an instance of SHA512.
TripleDesCreator

This property is a delegate (function pointer). The method loaded will return an instance of TripleDES.