Creates a new SSO integration configuration.
Request: POST https://api-<BlueCat.edge.url>/v1/api/ssoIntegrations
Authorization: Bearer authentication token
Content-Type: application/JSON
{
"name": "<connection_name>",
"type": "SAML",
"description": "<description>",
"signInUrl": "<sign_in_endpoint>",
"signingCertificate": "<idp_signing_certificate_x509>",
"userIdAttribute": "<user_id_attribute_in_saml>",
"protocolBinding": "<HTTP-Redirect | HTTP-POST>",
"active": true | false
}
The signingCertificate must be base64 encoded in full, including
the -----BEGIN CERTIFICATE-----
and -----END
CERTIFICATE-----
fields.
The signInUrl must be an HTTPS endpoint.
Attention: BlueCat strongly recommends using the BlueCat Edge UI to create the SSO
integration.
Successful response
201 CREATED
Headers: Location:v1/api/ssoIntegrations/{id}
Possible error codes:
- BAD REQUEST - Incorrectly formatted request or when the user tries to create a second SAML integration
- UNAUTHORIZED - Missing or invalid token
- FORBIDDEN - You are not authorized to perform this action
- INTERNAL SERVER ERROR - Unexpected error