Skip to main content

Start an IDP authentication intent​

Start a new authentication intent on configured identity provider (IDP) for external login, registration or linking.

Request Body required
    idpId string required

    Possible values: non-empty and <= 200 characters

    ID of an existing identity provider (IDP).

    urls object
    successUrl string required

    Possible values: non-empty and <= 200 characters

    URL to which the user will be redirected after a successful login.

    failureUrl string required

    Possible values: non-empty and <= 200 characters

    URL to which the user will be redirected after a failed login.

    ldap object
    username string required

    Possible values: non-empty and <= 200 characters

    Username used to login through LDAP.

    password string required

    Possible values: non-empty and <= 200 characters

    Password used to login through LDAP.

Responses

IDP intent successfully started

Schema
    details object
    sequence uint64

    on read: the sequence of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    changeDate date-time

    on read: the timestamp of the last event reduced by the projection

    on manipulation: the timestamp of the event(s) added by the manipulation

    resourceOwner resource_owner is the organization or instance_id an object belongs to
    authUrl string

    The authentication URL to which the client should redirect.

    idpIntent object

    The Start Intent directly succeeded and returned the IDP Intent. Further information can be retrieved by using the retrieve identity provider intent request.

    idpIntentId string

    ID of the identity provider (IDP) intent.

    idpIntentToken string

    Token of the identity provider (IDP) intent.

    userId string

    If the user was already federated and linked to a ZITADEL user, it's id will be returned.

    postForm byte

    The HTML form with the embedded POST call information to render and execute.

Loading...