RSA BSAFE Cert-C

PKI_SENDER_INFO Struct Reference

PKI_SENDER_INFO

This includes the information needed to determine the identity of the sender and the method used to protect the integrity of the data exchanged between the PKI entities. Use PKI_SENDER_INFO with the C_SetPKIMsgSender() and C_GetPKIMsgSender() functions:

Getting sender information: When calling the C_GetPKIMsgSender() function, Cert-C uses internal objects and structures to fill in this structure. It is not necessary to create or allocate the internal objects or pointers before you pass this structure to the C_GetPKIMsgSender() function.

Setting sender information: Because of the large number of fields (and subfields of these fields) in this structure, it is likely that a number of fields will be optional for any given service provider. If the PKI_SENDER_INFO structure is not initialized with a prior call to the C_GetPKIMsgSender() function, then call T_memset before calling the C_SetPKIMsgSender() function, to ensure that all unused fields are initialized to zero (0).

Data Fields

senderId	A `PKI_ENTITY_ID` structure that identifies the sender of the PKI message. If this field is optional for a given service provider, set senderId.type to zero (`0`).
digestAlgorithmId	An `ALGORITHM_IDENTIFIER` structure that identifies the message digest algorithm under which the message data and authenticatedAttributes, if present, are digested. If this field is optional for a given service provider, set digestAlgorithmId.algorithmId to zero (`0`).
authenticatedAttributes	An `ATTRIBUTES_OBJ` object that contains a set of attributes that are protected under the signature of the signer. If this field is optional for a given service provider, set it to `(ATTRIBUTES_OBJ)0`.
signatureAlgorithmId	An `ALGORITHM_IDENTIFIER` structure that identifies the signature algorithm to use to encrypt the digest. If this field is optional for a given service provider, set signatureAlgorithmId.algorithmId to zero (`0`).
extraAttributes	An `ATTRIBUTES_OBJ` object that contains extra attributes needed to specify the identity of the signer, or protection information related to the message to be sent. If this field is optional for a given service provider, set it to `(ATTRIBUTES_OBJ)0`.

#include <pkimsg.h>

01137 typedef struct {
01138   PKI_ENTITY_ID        senderId;
01139   ALGORITHM_IDENTIFIER digestAlgorithmId;
01140   ATTRIBUTES_OBJ       authenticatedAttributes;
01141   ALGORITHM_IDENTIFIER signatureAlgorithmId;
01142   ATTRIBUTES_OBJ       extraAttributes;
01143 } PKI_SENDER_INFO;