Parse Saml Service Provider Metadata

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadataXml": "aSDinaTvuI8gbWludGxpZnk="
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata"

payload = { "metadataXml": "aSDinaTvuI8gbWludGxpZnk=" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({metadataXml: 'aSDinaTvuI8gbWludGxpZnk='})
};

fetch('https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'metadataXml' => 'aSDinaTvuI8gbWludGxpZnk='
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata"

	payload := strings.NewReader("{\n  \"metadataXml\": \"aSDinaTvuI8gbWludGxpZnk=\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"metadataXml\": \"aSDinaTvuI8gbWludGxpZnk=\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"metadataXml\": \"aSDinaTvuI8gbWludGxpZnk=\"\n}"

response = http.request(request)
puts response.read_body

{
  "config": {
    "acsUrls": [
      "<string>"
    ],
    "spEntityId": "<string>",
    "attributeMappings": [
      {
        "name": "<string>",
        "userAttributeMappingId": "<string>",
        "friendlyName": "<string>"
      }
    ],
    "encryptAssertions": true,
    "requireSignedAuthnRequests": true,
    "signAssertions": true,
    "signResponses": true,
    "spEncryptionCertificate": "aSDinaTvuI8gbWludGxpZnk=",
    "spSigningCertificates": [
      "aSDinaTvuI8gbWludGxpZnk="
    ]
  },
  "findings": [
    {
      "reason": "<string>"
    }
  ]
}

SSO

Parse Saml Service Provider Metadata

ParseSAMLServiceProviderMetadata parses one uploaded SAML service-provider metadata document and returns the SAML configuration it implies, without creating or changing anything. The document is not stored. Use it to preview an SP’s capabilities before creating a SAML application; edit the returned configuration before passing it to Create. Only upload or paste a customer-supplied document — C1 does not fetch metadata URLs.

POST

api

sso

applications

saml

parse-sp-metadata

Parse Saml Service Provider Metadata

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "metadataXml": "aSDinaTvuI8gbWludGxpZnk="
}
'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata"

payload = { "metadataXml": "aSDinaTvuI8gbWludGxpZnk=" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({metadataXml: 'aSDinaTvuI8gbWludGxpZnk='})
};

fetch('https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'metadataXml' => 'aSDinaTvuI8gbWludGxpZnk='
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata"

	payload := strings.NewReader("{\n  \"metadataXml\": \"aSDinaTvuI8gbWludGxpZnk=\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"metadataXml\": \"aSDinaTvuI8gbWludGxpZnk=\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/sso/applications/saml/parse-sp-metadata")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"metadataXml\": \"aSDinaTvuI8gbWludGxpZnk=\"\n}"

response = http.request(request)
puts response.read_body

{
  "config": {
    "acsUrls": [
      "<string>"
    ],
    "spEntityId": "<string>",
    "attributeMappings": [
      {
        "name": "<string>",
        "userAttributeMappingId": "<string>",
        "friendlyName": "<string>"
      }
    ],
    "encryptAssertions": true,
    "requireSignedAuthnRequests": true,
    "signAssertions": true,
    "signResponses": true,
    "spEncryptionCertificate": "aSDinaTvuI8gbWludGxpZnk=",
    "spSigningCertificates": [
      "aSDinaTvuI8gbWludGxpZnk="
    ]
  },
  "findings": [
    {
      "reason": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization

string

header

required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

SSOApplicationServiceParseSAMLServiceProviderMetadataRequest carries one SAML service-provider metadata document to parse.

metadataXml

file

required

The SP metadata XML document, exactly as downloaded or exported from the service provider. Maximum 1 MiB. The document is parsed, never stored.

Response

200 - application/json

SSOApplicationServiceParseSAMLServiceProviderMetadataResponse returns the SAML configuration derived from one metadata document and every finding the parser raised about it.

config

Sso Application Saml Config · object | null

SSOApplicationSAMLConfig is the SAML-specific sign-in configuration.

Show child attributes

findings

Saml Metadata Finding · object[] | null

Everything the parser noticed about the document, including requirements it could not map into the configuration.

Show child attributes

⌘I

Welcome

Endpoints

Parse Saml Service Provider Metadata

Authorizations

Body

Response