RSA BSAFE Micro Edition Suite

Streamlined security for mobile and embedded devices

Search  Print

R_CM_ATTR Reference

This structure is used to store PKCS #9 authenticated and unauthenciated 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.
    Samples:

    cm_sign_sm.c.

    #include <r_cm.h>

    struct r_cm_attr_st
    {
        R_CM_INDEX entity_index;
    
        R_CM_INDEX attr_index;
    
        R_CM_ATTR_SECURITY security;
    
        unsigned char *oid;
    
        unsigned int oid_len;
    
        int data_type;
    
        unsigned char *data;
    
        unsigned int data_len;
    };
    

    Data Fields

    R_CM_INDEX entity_index
     The index to the entity holding attributes - for example, signer or recipient.

    R_CM_INDEX attr_index
     The index of the attribute in the list in the entity.

    R_CM_ATTR_SECURITY security
     Indicates the security type of the attribute. More...

    unsigned char* oid
     The Object Identifier (OID) value that identifies the attribute.

    unsigned int oid_len
     The length of the identifying Object Identifier (OID) value.

    int data_type
     The type of the data.

    unsigned char* data
     The attribute data.

    unsigned int data_len
     The length of the attribute data.


    Field Documentation

    R_CM_ATTR_SECURITY security
     

    Indicates the security type of the attribute. See Attribute Security for valid values.


    Copyright (c) 1999-2005 RSA Security Inc. All rights reserved. 072-001001-2100-001-000 - 2.1