Previous Topic: Sm_PolicyApi_SAMLSPAssertionConsumerService_tNext Topic: Sm_PolicyApi_Scheme_t

Programming Guides › Programming Guide for C › Policy Management API Guidance › Policy Management API Data Structures › Sm_PolicyApi_SAMLSPAttr_t

Sm_PolicyApi_SAMLSPAttr_t

Defines an attribute of a principal for a particular SAML 2.0 Service Provider.

Syntax

typedef struct Sm_PolicyApi_SAMLSPAttr_s
{
   int iStructId;
   Sm_PolicyApi_SAMLSPAttrNameFormat_t nAttrNameFormat;
   char pszValue[BFSIZE];
   bool bEncrypted;
   struct Sm_PolicyApi_SAMLSPAttr_s* next;
   Sm_PolicyApi_SAMLSPAttrMode_t  nMode;
} Sm_PolicyApi_SAMLSPAttr_t;

Field

Description

iStructId

SAML attribute structure ID, defined in Sm_PolicyApi_Structs_t.

nAttrNameFormat

The format of the attribute name, as defined by the SAML 2.0 standard.

pszValue

The attribute's name and value, in one of these formats:

  • Static attributes:
    variableName=value
  • User attributes:
    variableName=<%userattr="AttrName"%>
  • DN attributes:
    variablName=<#dn="DNSpec"
                    attr="AttrName"#>

To allow SiteMinder to retrieve DN attributes from a nested group, begin DNSpec with an exclamation mark ( ! ). For example:
dn="!ou=People,o=security.com"

bEncrypted

Specifies whether the attribute is encrypted.

next

Pointer to the next attribute structure.

nMode

One of the three following uses of an attribute:

  • Sm_PolicyApi_SAMLSP_SSO_Only = 0
  • Sm_PolicyApi_SAMLSP_Atribute_Only = 1
  • Sm_PolicyApi_SAMLSP_Both = 2