ProductsSupportPartnersDocumentation

SAML IDPs

List

get

Retrieve information about one or multiple SAML IDP configurations.

Query parameters
SiteIdinteger · int32Optional

Site ID from which to retrieve the SAML IDP configurations (optional).

NamestringOptional

The name of the SAML IDP configuration for which to retrieve the information. This must be the actual SAML IDP configuration name used in the RAS connections.

Responses
200
Success
application/json; api-version=1.0
get
GET /api/SAMLIDP HTTP/1.1
Host: 
Accept: */*

[
  {
    "id": 1,
    "adminCreate": "text",
    "adminLastMod": "text",
    "timeCreate": "2025-07-08T08:29:10.635Z",
    "timeLastMod": "2025-07-08T08:29:10.635Z",
    "enabled": true,
    "name": "text",
    "siteId": 1,
    "description": "text",
    "themeId": 1,
    "idpEntityID": "text",
    "idpCertificate": "text",
    "logonURL": "text",
    "logoutURL": "text",
    "allowUnencryptedAssertion": true,
    "host": "text",
    "spEntityID": "text",
    "spReplyURL": "text",
    "spLogonURL": "text",
    "spLogoutURL": "text",
    "spCertificate": "text",
    "attributes": {
      "userPrincipalName": {
        "enabled": true,
        "samlAttribute": "text",
        "adAttribute": "text"
      },
      "immutableID": {
        "enabled": true,
        "samlAttribute": "text",
        "adAttribute": "text"
      },
      "sid": {
        "enabled": true,
        "samlAttribute": "text",
        "adAttribute": "text"
      },
      "sAMAccountName": {
        "enabled": true,
        "samlAttribute": "text",
        "adAttribute": "text"
      },
      "custom": {
        "enabled": true,
        "samlAttribute": "text",
        "adAttribute": "text"
      }
    }
  }
]

Create

post

Create a new SAML IDP configuration.

Body

Create a new SAMLIDP

hoststring | nullableRequired

Host name of gateway This specified gateway will receive the calls for SP URLs.

namestring | nullableRequired

The name of the target SAMLIDP. This must be the actual SAMLIDP name used in the RAS farm.

siteIdinteger · int32Optional

Site ID in which to create the specified SAMLIDP. If the parameter is omitted, the site ID of the Licensing Server will be used.

enabledboolean | nullableOptional

Enable or disable the SAMLIDP upon creation. If the parameter is omitted, the SAMLIDP is initialised as Disabled.

descriptionstring | nullableOptional

A user-defined SAMLIDP description.

themeIdinteger · int32 | nullableOptional

Use SAMLIDP with a theme

Responses
201
Created
application/json; api-version=1.0
post
POST /api/SAMLIDP HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 88

{
  "host": "text",
  "name": "text",
  "siteId": 1,
  "enabled": true,
  "description": "text",
  "themeId": 1
}
{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-07-08T08:29:10.635Z",
  "timeLastMod": "2025-07-08T08:29:10.635Z",
  "enabled": true,
  "name": "text",
  "siteId": 1,
  "description": "text",
  "themeId": 1,
  "idpEntityID": "text",
  "idpCertificate": "text",
  "logonURL": "text",
  "logoutURL": "text",
  "allowUnencryptedAssertion": true,
  "host": "text",
  "spEntityID": "text",
  "spReplyURL": "text",
  "spLogonURL": "text",
  "spLogoutURL": "text",
  "spCertificate": "text",
  "attributes": {
    "userPrincipalName": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "immutableID": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "sid": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "sAMAccountName": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "custom": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    }
  }
}

Get

get

Retrieve information about a particular SAML IDP configuration by ID.

Path parameters
idinteger · int32Required

The ID of a SAML IDP configuration for which to retrieve the information.

Responses
200
Success
application/json; api-version=1.0
get
GET /api/SAMLIDP/{id} HTTP/1.1
Host: 
Accept: */*

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-07-08T08:29:10.635Z",
  "timeLastMod": "2025-07-08T08:29:10.635Z",
  "enabled": true,
  "name": "text",
  "siteId": 1,
  "description": "text",
  "themeId": 1,
  "idpEntityID": "text",
  "idpCertificate": "text",
  "logonURL": "text",
  "logoutURL": "text",
  "allowUnencryptedAssertion": true,
  "host": "text",
  "spEntityID": "text",
  "spReplyURL": "text",
  "spLogonURL": "text",
  "spLogoutURL": "text",
  "spCertificate": "text",
  "attributes": {
    "userPrincipalName": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "immutableID": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "sid": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "sAMAccountName": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    },
    "custom": {
      "enabled": true,
      "samlAttribute": "text",
      "adAttribute": "text"
    }
  }
}

Update

put

Modify properties of a SAML IDP configuration.

Path parameters
idinteger · int32Required

The ID of the SAML IDP configuration to modify.

Body

Update a SAMLIDP settings

enabledboolean | nullableOptional

Enable or disable the specified SAMLIDP in a site.

namestring | nullableOptional

The new name of the target SAMLIDP.

descriptionstring | nullableOptional

A user-defined SAMLIDP description.

themeIdinteger · int32 | nullableOptional

Specifies the SAMLIDP theme

idpEntityIDstring | nullableOptional

The IDP entity ID

idpCertificatestring | nullableOptional

The IDP certificate

logonURLstring | nullableOptional

The logon URL

logoutURLstring | nullableOptional

The logout URL

allowUnencryptedAssertionboolean | nullableOptional

Allow unencrypted assertion

hoststring | nullableOptional

Host name of gateway This specified gateway will receive the calls for SP URLs.

spCertificatestring | nullableOptional

Specifies the service provider certificate

attributeTypestring · enumOptional

SAML Attributes

Possible values:
attributeEnabledboolean | nullableOptional

Enable or disable an attribute of a specified SAMLIDP

attributeSAMLstring | nullableOptional

Specifies the SAMLIDP attribute.

attributeADstring | nullableOptional

Specifies the AD attribute.

Responses
204
No Content
put
PUT /api/SAMLIDP/{id} HTTP/1.1
Host: 
Content-Type: application/json; api-version=1.0
Accept: */*
Content-Length: 387

{
  "enabled": true,
  "name": "text",
  "description": "text",
  "themeId": 1,
  "idpEntityID": "text",
  "idpCertificate": "text",
  "logonURL": "text",
  "logoutURL": "text",
  "allowUnencryptedAssertion": true,
  "host": "text",
  "spCertificate": "text",
  "attributeType": [
    "0 = UserPrincipalName",
    "1 = ImmutableID",
    "2 = SID",
    "3 = sAMAccountName",
    "4 = Custom"
  ],
  "attributeEnabled": true,
  "attributeSAML": "text",
  "attributeAD": "text"
}
No content

Delete

delete

Remove a SAML IDP configuration from a site.

Path parameters
idinteger · int32Required

The ID of a SAML IDP configuration to remove from the site.

Responses
204
No Content
delete
DELETE /api/SAMLIDP/{id} HTTP/1.1
Host: 
Accept: */*

No content
PreviousVersionStatusNextDuplicate

Was this helpful?