Sm_PolicyApi_AddAssertionConsumerServiceToSAMLSP
The function adds a new indexed endpoint, which includes an index, binding, and an Assertion Consumer Service URL, to the Service Provider.
casso126
The function adds a new indexed endpoint, which includes an index, binding, and an Assertion Consumer Service URL, to the Service Provider.
Note:
An existing indexed endpoint reference cannot be modified.Type
Federation function
Syntax
int SM_EXTERN Sm_PolicyApi_AddAssertionConsumerServiceToSAMLSP (void*pSessionHandle,const Sm_PolicyApi_SAMLSPAssertionConsumerService_t*pstructSAMLSPAssertionConsumerService,const char*pszSAMLSPOid);
Parameter | I/O | Description |
pSessionHandle
| I | A pointer to an internal Policy Management API data structure. The structure holds information about the administrator session and the client session. |
pstructSAMLSPAssertion
ConsumerService
| I | A pointer to an Assertion Consumer Service structure. |
pszSAMLSPOid
| I | A pointer to a string containing the OID of the Service Provider. |
Returns
- Sm_PolicyApi_SuccessThe Assertion Consumer Service was added successfully
- Sm_PolicyApi_FailureThe Assertion Consumer Service was not added successfully
- Sm_PolicyApi_ACSDuplicateIndexAn Assertion Consumer Service that is assigned to the Service Provider with the same index value
- 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 Assertion Consumer Service
Remarks
The following fields of the Sm_PolicyApi_SAMLSPAssertionConsumerService_t structure are evaluated:
- The value of the index is a unique positive integer, less than 65535
- The Assertion Consumer URL starts with http:// or https://
- The binding is either HTTP-Post or HTTP_Artifact