TrustCore SDK NanoCert API reference  version 7.0
PKCS12PrivacyModeConfig Struct Reference

Configuration information for PKCS 12 privacy (encryption) operations. More...

Data Fields

ubyte4 numPubKeyStream
 Number of elements in the ppCSDestPubKeyStream CStream array. More...
 
const ubyte * pEncryptionAlgoOID
 For public key privacy, encryption to apply. More...
 
ubyte4 pkcs12EncryptionType
 For password privacy, encryption to apply; default = PCKS8_EncryptionType_pkcs12_sha_rc2_40. More...
 
CStream ** ppCSDestPubKeyStream
 Pointer to array of CStream objects containing the public key(s). More...
 
const ubyte * pPrivacyPassword
 Password for the privacy (encryption) mode; if it is NULL/0, the password from Integrity password mode is used. More...
 
ubyte4 privacyPasswordLen
 Length, in bytes, of the password referenced by pPrivacyPassword. More...
 

Detailed Description

Configuration information for PKCS 12 privacy (encryption) operations.

For password privacy, use the following members:

  • pPrivacyPassword
  • privacyPasswordLen
  • pkcs12EncryptionType
Note
If password integrity mode is enabled and the pPrivacyPassword member of the PKCS12PrivacyModeConfig structure is not set, the password entered for password integrity mode (by the pIntegrityPswd parameter within PKCS12_EncryptPFXPdu) is used.

For public key privacy, use the following members:

  • pEncryptionAlgoOID
  • ppCSDestPubKeyStream
  • numPubKeyStream

Field Documentation

◆ numPubKeyStream

ubyte4 PKCS12PrivacyModeConfig::numPubKeyStream

Number of elements in the ppCSDestPubKeyStream CStream array.

◆ pEncryptionAlgoOID

const ubyte* PKCS12PrivacyModeConfig::pEncryptionAlgoOID

For public key privacy, encryption to apply; any of the following preconfigured OID arrays from src/asn1/oiddefs.h:

  • desCBC_OID
  • desEDE3CBC_OID
  • aes128CBC_OID
  • aes192CBC_OID
  • aes256CBC_OID

◆ pkcs12EncryptionType

ubyte4 PKCS12PrivacyModeConfig::pkcs12EncryptionType

(default = \ PCKS8_EncryptionType_pkcs12_sha_rc2_40) For password privacy, encryption to apply. Any of the following PKCS8EncryptionType enum values from pkcs_key.h:

  • PCKS8_EncryptionType_pkcs12_sha_2des
  • PCKS8_EncryptionType_pkcs12_sha_3des
  • PCKS8_EncryptionType_pkcs12_sha_rc2_40
  • PCKS8_EncryptionType_pkcs12_sha_rc2_128
  • PCKS8_EncryptionType_pkcs12_sha_rc4_40
  • PCKS8_EncryptionType_pkcs12_sha_rc4_128

◆ ppCSDestPubKeyStream

CStream** PKCS12PrivacyModeConfig::ppCSDestPubKeyStream

Pointer to array of CStream objects containing the public key(s).

◆ pPrivacyPassword

const ubyte* PKCS12PrivacyModeConfig::pPrivacyPassword

Password for the privacy (encryption) mode; if it is NULL/0, the password from Integrity password mode is used.

◆ privacyPasswordLen

ubyte4 PKCS12PrivacyModeConfig::privacyPasswordLen

Length, in bytes, of the password referenced by pPrivacyPassword.


The documentation for this struct was generated from the following file: