Socotra
API ReferenceConfiguration and Development API

Identity Providers API

ActionEndpoint
Fetch an Identity ProviderGET/auth/identity/instances/{name}
Fetch All Identity ProvidersGET/auth/identity/instances
Add a SAML Identity ProviderPOST/auth/identity/saml
Add an OIDC Identity ProviderPOST/auth/identity/oidc
Create an Identity ProviderPOST/auth/identity
Delete an Identity ProviderDELETE/auth/identity/instances/{name}

Fetch an Identity Provider

Fetch an Identity ProviderfetchIdentityProviderByName
GET/auth/identity/instances/{name}

Parameters

NameInTypeRequiredDescription
namepathstringYes
Security Group:identity
Permissions:
read,custom

Fetch All Identity Providers

Fetch All Identity ProvidersfetchIdentityProviders
GET/auth/identity/instances
Security Group:identity
Permissions:
read,custom

Add a SAML Identity Provider

Add a SAML Identity ProvideraddSAMLIdentityProvider
POST/auth/identity/saml
Security Group:identity
Permissions:
add,custom
SAMLIdentityProviderCreateRequest

Required properties

PropertyTypeDescription
displayNamestring
idstring
singleSignOnServiceUrlstring

Add an OIDC Identity Provider

Add an OIDC Identity ProvideraddOIDCIdentityProvider
POST/auth/identity/oidc
Security Group:identity
Permissions:
add,custom
OIDCIdentityProviderCreateRequest

Required properties

PropertyTypeDescription
displayNamestring
clientIdstring
clientSecretstring
idstring
importConfigUrlstring

Create an Identity Provider

Create an Identity ProvidercreateIdentityProviderDeprecated
POST/auth/identity
Security Group:identity
Permissions:
add,custom
IdentityProviderResponse

Required properties

PropertyTypeDescription
displayNamestring
acsUrlstring
callbackUrlstring
entityIdstring
idstring
singleSignOnServiceUrlstring
typestring

Delete an Identity Provider

Delete an Identity ProviderdeleteIdentityServerInstance
DELETE/auth/identity/instances/{name}

Parameters

NameInTypeRequiredDescription
namepathstringYes
Response:void
Security Group:identity
Permissions:
delete,custom

On this page