Skip to main content

List SAML Federation credentials for a user

GET 
/nevisidm/api/core/v1/:clientExtId/users/:userExtId/saml-credentials

Since: 8.2511.0

Required permission(s): AccessControl.CredentialView or SelfAdmin Role

Returns a paginated list of all SAML Federation credentials belonging to the specified user.

Results can be filtered using additional query parameters. Supported filter parameters are: extId, subjectNameId, subjectNameIdFormat, issuerNameId, issuerNameIdFormat, and stateName. Each filter performs an exact match. Unknown filter parameters cause a 422 error.

Pagination is controlled via the continuationToken and limit parameters.

A self-admin path is available: when the authenticated principal is the same user, their own credentials are returned without requiring the AccessControl.CredentialView function right.

Request​

Path Parameters

    clientExtId stringrequired

    External ID of the client.

    Example: client-123
    userExtId stringrequired

    External ID of the user.

    Example: user-123

Query Parameters

    continuationToken string

    Pagination continuation token from a previous response.

    limit int32

    Default value: 0

    Maximum number of SAML Federation credentials to return.

    Example: 100
    allParams objectrequired

    Additional filter parameters (e.g. extId, stateName, subjectNameId, subjectNameIdFormat, issuerNameId, issuerNameIdFormat).

Responses​

SAML Federation credentials retrieved successfully

Schema
    items object[]
  • Array [
    • created string

    Creation date of the entity.

    lastModified string

    Date when the entity was last modified.

    version int32

    Version used for optimistic locking.

    extId string

    The external ID of the credential.

    userExtId string

    The external ID of the user to whom the credential belongs.

    policyExtId string

    External ID of the associated security policy.

    stateName string

    Possible values: [initial, active, tmp-locked, fail-locked, reset-code, admin-changed, disabled, archived]

    The state of the credential. Available values: initial, active, tmp-locked, fail-locked, reset-code, admin-changed, disabled, archived.

    stateChangeReason string

    Reason for the last state change of the password.

    stateChangeDetail string

    Reason detail for the last state change of the password.

    lastSuccessfulLoginDate string

    Timestamp of last successful login.

    successfulLoginCount int32

    Counts successful logins with this credential since last initialization or reset.

    lastFailedLoginDate string

    Date of last non-technical login failure, for example, wrong password.

    failedLoginCount int32

    Counts non-technical login failures since the last successful login, initialization or reset.

    modificationComment string

    Textual comment regarding the last modification.

    type string

    Possible values: [Password, Certificate, SecurID User Mapping, Ticket Authorization, Safeword User Mapping, OTP Card, Temporary Strong Password, Generic Credential, Kerberos, mTan, Vasco, PUK, URL Ticket, DevicePassword, MobileSignature, SAML Federation, Security Questions, Context Password, OATH, FIDO UAF Authenticator, Recovery Code, FIDO2 Authenticator]

    Type of credential.

    validity object

    Describes the validity period of the password.

    from string

    Start date of the entity's validity in ISO format.

    to string

    End date of the entity's validity in ISO format.

    subjectNameId string

    Identifies the subject of the SAML assertion (generally the user to be authenticated).

    subjectNameIdFormat string

    The format of the subject's NameID. Aligns expectations between the identity provider and the service provider on how the subject is identified.

    issuerNameId string

    Identifies the issuer of the SAML assertion (the Identity Provider).

    issuerNameIdFormat string

    The format of the issuer's NameID. Aligns expectations between the identity provider and the service provider on how the issuer is identified.

    credentialValue string

    Hashed identification value with optional message digest algorithm prefix. SSHA is alias for SHA-1 and SSHA256 is alias for SHA-256 algorithms.

  • ]
    • _pagination object
    continuationToken string

    The continuation token for fetching the next page of results generated from creation date and external id of the last entity

    limit int32

    The maximum number of results returned in a single page

    totalResult int64

    The total number of results available, only supported for selected endpoints, if returnTotalResultCount query-parameter is true

    _classifications object
    property name* string[]
  • Array [

    • string

  • ]
Loading...
Last updated on