Website Download Support
 

Discuss this help topic in SecureBlackbox Forum

TElCustomCryptoProviderManager.GetSuitableProvider

TElCustomCryptoProviderManager     See also     

Filter: C#  VB.NET  Pascal  C++  PHP  Java  

Selects an appropriate crypto provider.

Declaration

[C#]
    TElCustomCryptoProvider GetSuitableProvider(int Operation, int Algorithm, int Mode, TElCustomCryptoKey Key, TElCPParameters Params);
    TElCustomCryptoProvider GetSuitableProvider(int Operation, byte[] AlgOID, byte[] AlgParams, int Mode, TElCustomCryptoKey Key, TElCPParameters Params);
    TElCustomCryptoProvider GetSuitableProvider(int Algorithm, int Mode);
    TElCustomCryptoProvider GetSuitableProvider(byte[] AlgOID, byte[] AlgParams, int Mode);

[VB.NET]
    Function GetSuitableProvider(ByVal Operation As Integer, ByVal Algorithm As Integer, ByVal Mode As Integer, ByVal Key As TElCustomCryptoKey, ByVal Params As TElCPParameters) As TElCustomCryptoProvider
    Function GetSuitableProvider(ByVal Operation As Integer, ByVal AlgOID As Byte(), ByVal AlgParams As Byte(), ByVal Mode As Integer, ByVal Key As TElCustomCryptoKey, ByVal Params As TElCPParameters) As TElCustomCryptoProvider
    Function GetSuitableProvider(ByVal Algorithm As Integer, ByVal Mode As Integer) As TElCustomCryptoProvider
    Function GetSuitableProvider(ByVal AlgOID As Byte(), ByVal AlgParams As Byte(), ByVal Mode As Integer) As TElCustomCryptoProvider

[Pascal]
    function GetSuitableProvider(Operation: integer; Algorithm: integer; Mode: integer; Key: TElCustomCryptoKey; Params: TElRelativeDistinguishedName): TElCustomCryptoProvider;
    function GetSuitableProvider(Operation: integer; AlgOID, AlgParams: ByteArray; Mode: integer; Key: TElCustomCryptoKey; Params: TElRelativeDistinguishedName): TElCustomCryptoProvider;
    function GetSuitableProvider(Algorithm: integer; Mode: integer): TElCustomCryptoProvider;
    function GetSuitableProvider(AlgOID, AlgParams: ByteArray; Mode: integer): TElCustomCryptoProvider;

[C++]
    TElCustomCryptoProviderHandle GetSuitableProvider(int32_t Operation, int32_t Algorithm, int32_t Mode, TElCustomCryptoKey &Key, TElRelativeDistinguishedName &Params);
    TElCustomCryptoProviderHandle GetSuitableProvider(int32_t Operation, int32_t Algorithm, int32_t Mode, TElCustomCryptoKey *Key, TElRelativeDistinguishedName *Params);
    TElCustomCryptoProviderHandle GetSuitableProvider(int32_t Operation, const std::vector<uint8_t> &AlgOID, const std::vector<uint8_t> &AlgParams, int32_t Mode, TElCustomCryptoKey &Key, TElRelativeDistinguishedName &Params);
    TElCustomCryptoProviderHandle GetSuitableProvider(int32_t Operation, const std::vector<uint8_t> &AlgOID, const std::vector<uint8_t> &AlgParams, int32_t Mode, TElCustomCryptoKey *Key, TElRelativeDistinguishedName *Params);
    TElCustomCryptoProviderHandle GetSuitableProvider(int32_t Algorithm, int32_t Mode);
    TElCustomCryptoProviderHandle GetSuitableProvider(const std::vector<uint8_t> &AlgOID, const std::vector<uint8_t> &AlgParams, int32_t Mode);

[PHP]
    TElCustomCryptoProvider GetSuitableProvider(integer $Operation, integer $Algorithm, integer $Mode, TElCustomCryptoKey $Key, TElRelativeDistinguishedName $Params)
    TElCustomCryptoProvider GetSuitableProvider(integer $Operation, array of byte|string|NULL $AlgOID, array of byte|string|NULL $AlgParams, integer $Mode, TElCustomCryptoKey $Key, TElRelativeDistinguishedName $Params)
    TElCustomCryptoProvider GetSuitableProvider(integer $Algorithm, integer $Mode)
    TElCustomCryptoProvider GetSuitableProvider(array of byte|string|NULL $AlgOID, array of byte|string|NULL $AlgParams, integer $Mode)

[Java]
    TElCustomCryptoProvider getSuitableProvider(int Operation, byte[] AlgOID, byte[] AlgParams, int Mode, TElCustomCryptoKey Key, TElCPParameters Params);
    TElCustomCryptoProvider getSuitableProvider(int Operation, int Algorithm, int Mode, TElCustomCryptoKey Key, TElCPParameters Params);
    TElCustomCryptoProvider getSuitableProvider(byte[] AlgOID, byte[] AlgParams, int Mode);
    TElCustomCryptoProvider getSuitableProvider(int Algorithm, int Mode);

Parameters

  • Operation - defines operation type
  • Algorithm - specifies the algorithm which must be used
  • AlgOID - algorithm OID
  • AlgParams - algorithm parameters
  • Mode - specifies symmetric encryption mode
  • Key - contains necessary key
  • Params - additional crypto provider parameters

Possible operations:

[.NET] [Pascal] [C++] Value Description
SB_OPTYPE_NONE 0 (0x000) No operation
SB_OPTYPE_ENCRYPT 1 (0x001) Encrypt
SB_OPTYPE_DECRYPT 2 (0x002) Decrypt
SB_OPTYPE_SIGN 3 (0x003) Sign
SB_OPTYPE_SIGN_DETACHED 4 (0x004) Produce detached signature
SB_OPTYPE_VERIFY 5 (0x005) Verify
SB_OPTYPE_VERIFY_DETACHED 6 (0x006) Verify detached signature
SB_OPTYPE_HASH 7 (0x007) Calculate hash
SB_OPTYPE_KEY_GENERATE 8 (0x008) Generate key
SB_OPTYPE_KEY_DECRYPT 9 (0x009) Decrypt key
SB_OPTYPE_RANDOM 10 (0x00A) Generate random number
SB_OPTYPE_KEY_CREATE 11 (0x00B) Create key
SB_OPTYPE_KEYSTORAGE_CREATE 12 (0x00C) Create keystorage

Symmetric algorithms:

Definition Value Description
SB_ALGORITHM_CNT_RC4 0x7001 Specifies RC4 algorithm
SB_ALGORITHM_CNT_DES 0x7002 Specifies DES algorithm
SB_ALGORITHM_CNT_3DES 0x7003 Specifies 3DES algorithm
SB_ALGORITHM_CNT_RC2 0x7004 Specifies RC2 algorithm
SB_ALGORITHM_CNT_AES128 0x7005 Specifies AES algorithm with a 128-bit key
SB_ALGORITHM_CNT_AES192 0x7006 Specifies AES algorithm with a 192-bit key
SB_ALGORITHM_CNT_AES256 0x7007 Specifies AES algorithm with a 256-bit key
SB_ALGORITHM_CNT_IDENTITY 0x700A Specifies NO encryption. The data is returned as original.
SB_ALGORITHM_CNT_BLOWFISH 0x7010 Specifies Blowfish algorithm
SB_ALGORITHM_CNT_TWOFISH 0x7011 Specifies Twofish algorithm
SB_ALGORITHM_CNT_CAMELLIA 0x7012 Specifies Camellia algorithm
SB_ALGORITHM_CNT_CAST128 0x7013 Specifies CAST algorithm
SB_ALGORITHM_CNT_IDEA 0x7014 Specifies IDEA algorithm
SB_ALGORITHM_CNT_SERPENT 0x7015 Specifies Serpent algorithm
SB_ALGORITHM_CNT_TWOFISH128 0x7016 Specifies Twofish algorithm with a 128-bit key
SB_ALGORITHM_CNT_TWOFISH192 0x7017 Specifies Twofish algorithm with a 192-bit key
SB_ALGORITHM_CNT_TWOFISH256 0x7018 Specifies Twofish algorithm with a 256-bit key
SB_ALGORITHM_CNT_CAMELLIA128 0x7019 Specifies Camellia algorithm with a 128-bit key
SB_ALGORITHM_CNT_CAMELLIA192 0x701A Specifies Camellia algorithm with a 192-bit key
SB_ALGORITHM_CNT_CAMELLIA256 0x701B Specifies Camellia algorithm with a 256-bit key
SB_ALGORITHM_CNT_SERPENT128 0x701C Specifies Serpent algorithm with a 128-bit key
SB_ALGORITHM_CNT_SERPENT192 0x701D Specifies Serpent algorithm with a 192-bit key
SB_ALGORITHM_CNT_SERPENT256 0x701E Specifies Serpent algorithm with a 256-bit key
SB_ALGORITHM_CNT_SEED 0x7020 Specifies SEED algorithm
SB_ALGORITHM_CNT_RABBIT 0x7021 Specifies Rabbit algorithm
SB_ALGORITHM_CNT_SYMMETRIC 0x7022 A general value for a symmetric algorithm
SB_ALGORITHM_CNT_GOST_28147_1989 0x7023 GOST 28147-89 algorithm
SB_ALGORITHM_AEAD_CHACHA20_POLY1305 0x7501 ChaCha20-Poly1305
SB_ALGORITHM_AEAD_AES128_GCM 0x7502 AEAD_AES_128_GCM algorithm as defined in RFC 5116
SB_ALGORITHM_AEAD_AES192_GCM 0x7503 AEAD_AES_192_GCM
SB_ALGORITHM_AEAD_AES256_GCM 0x7504 AEAD_AES256_GCM algorithm as defined in RFC 5116
SB_ALGORITHM_AEAD_AES128_CCM 0x7505 AEAD_AES128_CCM algorithm as defined in RFC 5116
SB_ALGORITHM_AEAD_AES192_CCM 0x7506 AEAD_AES192_CCM
SB_ALGORITHM_AEAD_AES256_CCM 0x7507 AEAD_AES256_CCM algorithm as defined in RFC 5116

Public key algorithms:

[.NET] [Pascal] [C++] Value
SB_ALGORITHM_PK_RSA 29697 (0x7401)
SB_ALGORITHM_PK_DSA 29698 (0x7402)
SB_ALGORITHM_PK_ELGAMAL 29699 (0x7403)
SB_ALGORITHM_PK_GOST_R3410_1994 29700 (0x7404)
SB_ALGORITHM_PK_EC 29701 (0x7405)
SB_ALGORITHM_PK_ECDSA 29702 (0x7406)
SB_ALGORITHM_PK_DH 29703 (0x7407)
SB_ALGORITHM_PK_SRP 29704 (0x7408)
SB_ALGORITHM_PK_ECDH 29705 (0x7409)
SB_ALGORITHM_PK_GOST_R3410_2001 29706 (0x740A)

Password-based encryption algorithms:

Definition Value
SB_ALGORITHM_PBE_SHA1_RC4_128 0x7201
SB_ALGORITHM_PBE_SHA1_RC4_40 0x7202
SB_ALGORITHM_PBE_SHA1_3DES 0x7203
SB_ALGORITHM_PBE_SHA1_RC2_128 0x7204
SB_ALGORITHM_PBE_SHA1_RC2_40 0x7205

Hash algorithms:

Definition Value
SB_ALGORITHM_DGST_FIRST SB_ALGORITHM_DGST_SHA1 (0x7101)
SB_ALGORITHM_DGST_SHA1 0x7101
SB_ALGORITHM_DGST_MD5 0x7102
SB_ALGORITHM_DGST_MD2 0x7103
SB_ALGORITHM_DGST_SHA256 0x7104
SB_ALGORITHM_DGST_SHA384 0x7105
SB_ALGORITHM_DGST_SHA512 0x7106
SB_ALGORITHM_DGST_SHA224 0x7107
SB_ALGORITHM_DGST_MD4 0x7108
SB_ALGORITHM_DGST_RIPEMD160 0x7109
SB_ALGORITHM_DGST_CRC32 0x710A
SB_ALGORITHM_DGST_SSL3 0x710B
SB_ALGORITHM_DGST_GOST_R3411_1994 0x710C
SB_ALGORITHM_DGST_WHIRLPOOL 0x710D
SB_ALGORITHM_DGST_POLY1305 0x710E
SB_ALGORITHM_DGST_SHA3_224 0x710F
SB_ALGORITHM_DGST_SHA3_256 0x7112
SB_ALGORITHM_DGST_SHA3_384 0x7112
SB_ALGORITHM_DGST_SHA3_512 0x7111
SB_ALGORITHM_DGST_BLAKE2S_128 0x7113
SB_ALGORITHM_DGST_BLAKE2S_160 0x7114
SB_ALGORITHM_DGST_BLAKE2S_224 0x7115
SB_ALGORITHM_DGST_BLAKE2S_256 0x7116
SB_ALGORITHM_DGST_BLAKE2B_160 0x7117
SB_ALGORITHM_DGST_BLAKE2B_256 0x7118
SB_ALGORITHM_DGST_BLAKE2B_384 0x7119
SB_ALGORITHM_DGST_BLAKE2B_512 0x711A
SB_ALGORITHM_DGST_SHAKE_128 0x711B
SB_ALGORITHM_DGST_SHAKE_256 0x711C
SB_ALGORITHM_DGST_SHAKE_128_LEN 0x711D
SB_ALGORITHM_DGST_SHAKE_256_LEN 0x711E
SB_ALGORITHM_DGST_LAST SB_ALGORITHM_DGST_SHAKE_256_LEN (0x711E)

MAC algorithms:

[.NET] [Pascal] [C++] Value Description
SB_ALGORITHM_MAC_BASE 29440 (0x7300) …
SB_ALGORITHM_MAC_HMACSHA1 29441 (0x7301) HMAC with SHA-1 digest
SB_ALGORITHM_MAC_HMACSHA224 29442 (0x7302) HMAC with SHA-224 digest
SB_ALGORITHM_MAC_HMACSHA256 29443 (0x7303) HMAC with SHA-256 digest
SB_ALGORITHM_MAC_HMACSHA384 29444 (0x7304) HMAC with SHA-384 digest
SB_ALGORITHM_MAC_HMACSHA512 29445 (0x7305) HMAC with SHA-512 digest
SB_ALGORITHM_MAC_HMACMD5 29446 (0x7306) HMAC with MD5 digest
SB_ALGORITHM_MAC_HMACRIPEMD 29447 (0x7307) HMAC with RIPEMD digest
SB_ALGORITHM_HMAC 29448 (0x7308) A special value for all MAC algorithms
SB_ALGORITHM_UMAC32 29456 (0x7310) 32 bit UMAC
SB_ALGORITHM_UMAC64 29457 (0x7311) 64 bit UMAC
SB_ALGORITHM_UMAC96 29458 (0x7312) 96 bit UMAC
SB_ALGORITHM_UMAC128 29459 (0x7313) 128 bit UMAC
SB_ALGORITHM_MAC_GOST_28147_1989 29460 (0x7314) GOST 28147-89
SB_ALGORITHM_HMAC_GOST_R3411_1994 29461 (0x7315) GOST R3411-94
SB_ALGORITHM_UNKNOWN 32767 (0x7FFF) Unknown algorithm

Encryption modes:

Definition Value Description
SB_SYMENC_MODE_DEFAULT 0 (0x000) Default encryption mode
SB_SYMENC_MODE_BLOCK 1 (0x001) Block mode
SB_SYMENC_MODE_CBC 2 (0x002) CBC mode
SB_SYMENC_MODE_CFB8 3 (0x003) CF8 mode
SB_SYMENC_MODE_CTR 4 (0x004) CTR mode
SB_SYMENC_MODE_ECB 5 (0x005) ECB mode
SB_SYMENC_MODE_CCM 6 (0x006) ECB mode
SB_SYMENC_MODE_GCM 7 (0x007) ECB mode

Return value

    Chosen crypto provider.

Description

    Use this method to select a crypto provider, which is appropriate for your purposes.

See also:     CryptoProviders     IsAlgorithmSupported     IsOperationSupported    

Discuss this help topic in SecureBlackbox Forum

Copyright (c) 2018, /n software, inc.