Retrieve an existing third party connector
Retrieve an existing third party connector based on its name
name
string
required |
-
200 The third party connector
application/json_idstring (Internal ID) requiredObject internal ID
typestring requiredValueaws
namestring requiredthrottleDurationstring requiredregionstring requiredrenewalPeriodstring | nulltimeoutstring | nullproxystring | nullcredentialsstring | nullName of the password credentials containing Access Key Id and Secret Access Key. If not defined, an account present in environment variables can be used.
resourceGroupNamestring | nullroleArnstring | nulltagKeystring | nulltagValuestring | null_idstring (Internal ID) requiredObject internal ID
typestring requiredValuef5client
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredbigIPHostnamestring requiredcredentialsstring requiredName of the password credentials containing the account to authenticate on F5
renewalPeriodstring | nulltimeoutstring | nullproxystring | nullmaxStoredCertificatePerHolderinteger | nullpartitionstring | nullsslParentstring | nullprefixstring | nullcipherGroupstring | nullversionstring | nulltlsInsecureboolean | nullAllow invalid server certificates when establishing the TLS connection. Use in production is not recommended.
_idstring (Internal ID) requiredObject internal ID
typestring requiredValuef5as3
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredhostnamestring requiredcredentialsstring requiredName of the password credentials containing the account to authenticate on F5
keyTypestring | null (Keytype)One of rsa-2048, rsa-3072, rsa-4096, rsa-8192, ec-secp256r1, ec-secp384r1, ec-secp521r1, ed-448, ed-25519, mldsa-44, mldsa-65, mldsa-87, slhdsa-sha2-128s, slhdsa-sha2-128f, slhdsa-sha2-192s, slhdsa-sha2-192f, slhdsa-sha2-256s, slhdsa-sha2-256f, slhdsa-sha2-128ssha256, slhdsa-sha2-128fsha256, slhdsa-sha2-192ssha512, slhdsa-sha2-192fsha512, slhdsa-sha2-256ssha512, slhdsa-sha2-256fsha512 or
+ renewalPeriodstring | nulltimeoutstring | nullproxystring | nullloginProviderstring | nulltlsInsecureboolean | nullAllow invalid server certificates when establishing the TLS connection. Use in production is not recommended.
_idstring (Internal ID) requiredObject internal ID
typestring requiredValueintune
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredtenantstring requiredcredentialsstring requiredName of the password credentials containing the App ID and Key to authenticate on Intune
legacyRevocationModeboolean requiredtimeoutstring | nullproxystring | nullintuneResourceUrlstring | nullosQueryStringstring | null_idstring (Internal ID) requiredObject internal ID
typestring requiredValuejamf
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredendpointstring requiredcredentialsstring requiredName of the password credentials containing the account to authenticate on JAMF
timeoutstring | nullproxystring | null_idstring (Internal ID) requiredObject internal ID
typestring requiredValuemsad
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredhostnamestring requiredcredentialsstring requiredName of the password credentials containing the DN and password to authenticate on Active Directory
baseDnstring requiredtimeoutstring | nullmaxStoredCertificatePerHolderinteger | nullproxystring | nullportinteger | nullfilterstring | nulltlsInsecureboolean | nullAllow invalid server certificates when establishing the TLS connection. Use in production is not recommended.
_idstring (Internal ID) requiredObject internal ID
typestring requiredValueintunepkcs
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredtenantstring requiredcredentialsstring requiredName of the password credentials containing the App ID and Key to authenticate on Intune PKCS
pubKeystring requiredkeyNamestring requiredrenewalPeriodstring | nulltimeoutstring | nullmaxStoredCertificatePerHolderinteger | nullproxystring | nullproviderNamestring | nullintendedPurposestring | nullsearchFilterstring | null_idstring (Internal ID) requiredObject internal ID
typestring requiredValueakv
namestring requiredthrottleDurationstring requiredthrottleParallelisminteger requiredtenantstring requiredcredentialsstring requiredName of the password credentials containing the App ID and Key to authenticate on AKV
vaultBaseUrlstring requiredrenewalPeriodstring | nulltimeoutstring | nullproxystring | nullprefixstring | null_idstring (Internal ID) requiredObject internal ID
typestring requiredValuegcm
namestring requiredthrottleDurationstring requiredprojectstring requiredlocationstring requiredcredentialsstring requiredName of the raw credentials containing User Account credentials.
renewalPeriodstring | nulltimeoutstring | nullproxystring | nulltagKeystring | nulltagValuestring | null_idstring (Internal ID) requiredObject internal ID
typestring requiredValueldappub
namestring requiredhostnamestring requiredbaseDnstring requireduserIdentifierAttributestring requiredEnumCN
MAIL
UID
certificateAttributestring requiredEnumCN
UID
SERIALNUMBER
SURNAME
GIVENNAME
T
UNSTRUCTUREDADDRESS
UNSTRUCTUREDNAME
E
OU
ORGANIZATIONIDENTIFIER
PSEUDONYM
UNIQUEIDENTIFIER
STREET
ST
L
O
C
DESCRIPTION
DC
RFC822NAME
DNSNAME
URI
IPADDRESS
OTHERNAME_UPN
OTHERNAME_GUID
REGISTERED_ID
throttleDurationstring requiredcredentialsstring requiredName of the password credentials containing login DN and password.
portinteger | nullfilterstring | nullcertAttrstring | nullfollowReferralsboolean | nullthrottleParallelismintegertimeoutstring | nullproxystring | nullmaxStoredCertificatePerHolderinteger | nulltlsInsecureboolean | nullAllow invalid server certificates when establishing the TLS connection. Use in production is not recommended.
-
401 Unauthorized request
application/problem+jsonerrorstring requiredThe error code of the problem
ValueSEC-AUTH-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected Error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected Error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-002
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid credentials or principal does not exist
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid credentials or principal does not exist
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-003
messagestring requiredA short, human-readable summary of the problem type
ValueCertificate is not trusted
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueCertificate is not trusted
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-004
messagestring requiredA short, human-readable summary of the problem type
ValueCertificate is expired
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueCertificate is expired
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-005
messagestring requiredA short, human-readable summary of the problem type
ValueCertificate is revoked
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueCertificate is revoked
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-006
messagestring requiredA short, human-readable summary of the problem type
ValuePrincipal not authenticated
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValuePrincipal not authenticated
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-007
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid Identity Provider
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid Identity Provider
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-008
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid redirect path
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid redirect path
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-009
messagestring requiredA short, human-readable summary of the problem type
ValuePrincipal not authenticated or authentication expired
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValuePrincipal not authenticated or authentication expired
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
-
403 Forbidden action
application/problem+jsonerrorstring requiredThe error code of the problem
ValueSEC-PERM-001
messagestring requiredA short, human-readable summary of the problem type
ValueInsufficient privileges
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInsufficient privileges
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueLIC-002
messagestring requiredA short, human-readable summary of the problem type
ValueInvalid License
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueInvalid License
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueLIC-004
messagestring requiredA short, human-readable summary of the problem type
ValueExpired License
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueExpired License
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
-
404 Not Found
application/problem+jsonerrorstring requiredThe error code of the problem
ValueTHIRDPARTY-CONNECTOR-003
messagestring requiredA short, human-readable summary of the problem type
ValueThird party Connector not found
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueThird party Connector not found
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
-
500 Internal Server error
application/problem+jsonerrorstring requiredThe error code of the problem
ValueTHIRDPARTY-CONNECTOR-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected Error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected Error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueSEC-AUTH-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected Error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected Error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807
errorstring requiredThe error code of the problem
ValueLIC-001
messagestring requiredA short, human-readable summary of the problem type
ValueUnexpected error
titlestring requiredA short, human-readable summary of the problem type. In compliance with RFC7807
ValueUnexpected error
detailstring | nullA human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807