Sm_PolicyApi_AddAttributeToSAMLSP()
The function defines a SAML 2.0 attribute for the Service Provider.
casso127
The function defines a SAML 2.0 attribute for the Service Provider.
A SAML 2.0 attribute contains information about a principal who tries to access a resource on the Service Provider. For example, the DN of the principal user.
The defined attribute is included in an AttributeStatement for all SAML 2.0 assertions that are produced for the Service Provider.
Type
SAML 2.0 Configuration function, domain scope.
Syntax
int SM_EXTERN Sm_PolicyApi_AddAttributeToSAMLSP (void*pHandle,const Sm_PolicyApi_SAMLSPAttr_t*pstructSAMLSPAttr,const char*pszSAMLSPOid);
Parameter | I/O | Description |
pHandle
| I | A pointer to an internal Policy Management API data structure. The structure holds information about the administrator session and the client session. |
pstructSAMLSPAttr
| I | A pointer to a completely filled-in attribute structure. |
pszSAMLSPOid
| I | A null-terminated string containing the object identifier of an existing Service Provider. |
Returns
- Sm_PolicyApi_SuccessThe attribute was added successfully
- Sm_PolicyApi_FailureThe attribute was not added successfully
- Sm_PolicyApi_InvalidHandleNo valid initialization before this call
- Sm_PolicyApi_NoSessionNo valid administrator session
- Sm_PolicyApi_NoPrivilegeThe administrator does not have the permission to add an attribute to a SAML Service Provider.
- Sm_PolicyApi_DuplicateAttributeAn attribute already exists with the same Name and NameFormat.