/v1/api/ssoIntegrations (POST) - BlueCat Edge - Service Point v3.x.x

BlueCat Edge API Guide

Locale
English
Product name
BlueCat Edge
Version
Service Point v3.x.x

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