Get SAML Authenticator

All the listed privileges are required -

Privileges	Description
GLOBAL_CONFIG_VIEW	Caller should have permission to this privilege, to perform this operation.

Request

URI

GET

https://{api_host}//localhost/rest/config/v1/saml-authenticators/{id}

COPY

Path Parameters

string

Required

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

Returns SAMLAuthenticatorInfo of type(s) */*

{
    "administrator_url": "https://vidm.example.com/saas/api/1.0/GET/admindata",
    "authenticator_type": "DYNAMIC",
    "certificate": "-----BEGIN CERTIFICATE-----\nMIID8DCCAtigAwIBAgIFFVeQUwEwDQY...-----END CERTIFICATE-----",
    "certificate_type": "PEM",
    "description": "Dynamic Saml Authenticator",
    "id": "42e47f15-aad0-221a-b231-ea4a3a134ec9",
    "label": "vidm.example.com",
    "metadata_url": "https://vidm.example.com/saas/api/1.0/GET/metadata/idp.xml",
    "password_mode": "REMOVE",
    "static_metadata": "<md:EntityDescriptor xmlns:..</md:EntityDescriptor>",
    "trigger_mode": "DISABLED"
}

string

administrator_url

Optional

The administrator URL for the SAML authenticator.

string

authenticator_type

Optional

The type of SAML authenticator.

STATIC: Static SAML Authenticator, which contains SAML metadata.
DYNAMIC: Dynamic SAML Authenticator fetches metadata dynamically using a provided URL.

Possible values are : STATIC, DYNAMIC,

string

certificate

Optional

SAML Authenticator certificate.

string

certificate_type

Optional

Type of Certificate.

PEM: PEM encoded certificate type
UNKNOWN: Unknown certificate type

Possible values are : PEM, UNKNOWN,

string

description

Optional

The description of this SAML authenticator.

string

Optional

Unique ID representing this SAML Authenticator.

string

label

Optional

The label for this SAML authenticator.

string

metadata_url

Optional

The metadata URL of the SAML Authenticator.

string

password_mode

Optional

Indicates how password present in SAML assertion is handled if True SSO is triggered.

REMOVE: Remove any passwords.
PASSTHRU: Pass through any passwords.
ERROR: Error if there is a password.

Possible values are : REMOVE, PASSTHRU, ERROR,

string

static_metadata

Optional

The static metadata of a SAML authenticator which contains an entity id, signing keys, and encryption keys for processing SAML authentication.

string

trigger_mode

Optional

Indicates how True SSO is triggered on sessions using this authenticator.

DISABLED: Do not use True SSO.
ENABLE_IF_NO_PASSWORD: If no password is supplied, use a valid (domain matching) connector if it exists.
REQUIRE_IF_NO_PASSWORD: If no password is supplied, use and require a valid (domain matching) connector.
ENABLE_ALWAYS: Regardless of a password, use a valid (domain matching) connector if it exists.
REQUIRE_ALWAYS: Regardless of a password, use and require a valid (domain matching) connector.