/v1/api/ssoIntegrations (POST) - BlueCat DNS Edge

DNS Edge API Guide

BlueCat DNS Edge

Creates a new SSO integration configuration.

Request: POST https://api-<DNS.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 DNS Edge UI to create the SSO integration.

Successful response

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 - Invalid access token
  • INTERNAL SERVER ERROR - Unexpected error