Programming Guides › Programming Guide for C › Policy Management API › Function Declarations for the Policy Management API › Sm_PolicyApi_AddAssertionConsumerServiceToSAMLSP

Sm_PolicyApi_AddAssertionConsumerServiceToSAMLSP

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 Security Services function

Syntax

int SM_EXTERN Sm_PolicyApi_AddAssertionConsumerServiceToSAMLSP (
   void*                               pSessionHandle,
   const Sm_PolicyApi_SAMLSPAssertionConsumerService_t* 
                pstructSAMLSPAssertionConsumerService,
   const char*                         pszSAMLSPOid
);

Returns

• Sm_PolicyApi_Success. The Assertion Consumer Service was added successfully.
• Sm_PolicyApi_Failure - The Assertion Consumer Service was not added successfully.
• Sm_PolicyApi_ACSDuplicateIndex - There is already an Assertion Consumer Service assigned to thei Service Provider with the same index value.
• Sm_PolicyApi_InvalidHandle - There was no valid initialization prior to this call.
• Sm_PolicyApi_NoSession - There is no valid administrator session.
• Sm_PolicyApi_NoPrivilege - The administrator does not have the privilege 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.