Programming Guides › Programming Guide for C › Policy Management API › Policy Management API Data Structures › Sm_PolicyApi_ResponseAttr_t › Response Attribute Types

Response Attribute Types

The field pszValue contains one of the following response attribute types:

Note: The non-alphanumeric characters in the formats below are required characters.

• Static. A string that is part of a SiteMinder response. The string has the following format:

  variable-name=variable-value
  

  In the format example:

  • variable-name is the name for the name/value pair that this response attribute will return to the Web Agent.
  • variable-value is the static text that will be returned as the second half of the name/value pair.
• User Attribute. A string containing profile information from a user's entry in a user directory. The string has the following format:

  User-Attr-variable-name=<%userattr="user-attr-name"%>
  

  In the format example:

  • User-Attr-variable-name is the name for the name/value pair that this response attribute will return to the Web Agent.
  • user-attr-name is a user attribute that can be retrieved from an LDAP, WinNT, or ODBC user directory.
• DN Attribute. A string containing profile information from a directory object in an LDAP or ODBC user directory. The string has the following format:

  DN-Variable-Name=<#dn="DN-Spec" attr="DN-Attribute-Name"#>
  

  In the format example:

  • DN-Variable-Name is the name for the name/value pair that this response attribute will return to the Web Agent.
  • DN-Spec is the distinguished name of the user group from which you want to retrieve the user attribute.
  • DN-Attribute-Name is an attribute associated with an LDAP or ODBC directory object to which the user is related, such as a group or an organizational unit (OU).
• Active Response. An active expression associated with the Response Attribute. The expression is a string of variable definitions in the following format:

  Name=<@lib="LibName" func="FuncName" param="Param"@>
  

  In the format example:

  • Name is the name of the variable (with WebAgent-HTTP-Header-Variable response attributes) or cookie (with WebAgent-HTTP-Cookie-Variable response attributes) associated with the name/value pairs in the active expression.
  • LibName is the name of the shared library that supports the Active Response.
  • FuncName is the name of the actual function in the shared library that implements the Active Response.
  • Param is an optional list of parameters to be passed to the function in the shared library.

  Note: For information about configuring active expressions in responses, rules, or policies, see Policy Design.