RSA BSAFE Micro Edition Suite

Streamlined security for mobile and embedded devices
Search  Print

Structures

This section details the cryptographic message structures used to maintain data and methods for the cryptographic messages module.

Data Structures

 R_CM_ATTR
 This structure is used to store PKCS #9 authenticated and unauthenciated attributes. More...


Typedefs

typedef struct r_cm_ctx_st R_CM_CTX
 The cryptographic message context structure. More...

typedef struct r_cm_st R_CM
 The cryptographic message structure. More...

typedef struct r_cm_method_st R_CM_METHOD
 The cryptographic messages module method table. More...

typedef int R_CM_CTX_INFO
 Indicates the type of the information identifiers of the cryptographic message context. More...

typedef int R_CM_TYPE
 Indicates the type of the cryptographic message type. More...

typedef int R_CM_INFO
 Indicates the type of the information identifiers of the cryptographic message. More...

typedef int R_CM_ATTR_SECURITY
 Indicates the type of the security type of an attribute. More...

typedef int R_CM_ENCODING
 Indicates the type of the encoding identifiers of the cryptographic message. More...

typedef int R_CM_INDEX
 Indicates the type of the index. More...

typedef struct r_cm_attr_st R_CM_ATTR
 The attributes structure. More...

Typedef Documentation

typedef struct r_cm_st R_CM
 

The cryptographic message structure. This opaque structure is created via R_CM_new(). It is used to provide both methods and states for R_CM messaging operations. It can be freed via R_CM_free() when no longer required. A separate R_CM structure is required for each cryptographic message that is created/decoded.

This structure provides access to:

  • The cryptographic message context.
  • The type of the cryptographic message.
    See Types for valid values.
  • The type of the content enclosed in the cryptographic message.
    See Types for valid values.
  • The details of the entities who have signed/received the message.
  • The message data.
  • The cryptographic message method table.

    • typedef struct r_cm_attr_st R_CM_ATTR
     

    The attributes structure. This structure is used to store PKCS #9 authenticated and unauthenticated attributes. The attributes structure can be added/retrieved to/from signed cryptographic messages via calls to R_CM_signer_set_attribute() and R_CM_signer_get_attribute() respectively.

    This structure provides access to:

  • The R_CM index of the entity whose attributes are being accessed (read only).
  • The index of the attribute in the entity's attributes list (read only).
  • The security level of the attribute. See Attribute Security for valid values.
  • The object identifier (OID) value identifying the attribute type.
  • The length of the object identifier data.
  • The ASN.1 data type of the attribute (for example, octet string).
  • The binary attribute data.
  • The length of the attribute data.

    • typedef int R_CM_ATTR_SECURITY
     

    Indicates the type of the security type of an attribute. See Attribute Security for more information.

    typedef struct r_cm_ctx_st R_CM_CTX
     

    The cryptographic message context structure. This opaque structure is created via R_CM_CTX_new(). It is required to create a cryptographic messages module instance and can be freed via R_CM_CTX_free() when no longer required. During initialization the context may also create both certificate and cryptographic contexts. This action is not guaranteed since the contexts may not be required during subsequent operations (for example, generation of PKCS #7 data messages).

    This structure provides access to:

  • The library context.
  • The type of the cryptographic message context.
    See Types for valid values.
  • The cryptographic context if available.
  • The certificate context if available.
  • The cryptographic message context method table.

    • typedef int R_CM_CTX_INFO
     

    Indicates the type of the information identifiers of the cryptographic message context. See Context Information Identifiers for more information.

    typedef int R_CM_ENCODING
     

    Indicates the type of the encoding identifiers of the cryptographic message. See Encoding Formats for more information.

    typedef int R_CM_INDEX
     

    Indicates the type of the index. See Index Identifiers for more information.