Authenticate User node

The Authenticate User node authenticates a user by performing a bind operation on IO with the supplied username and password. A successful bind confirms the validity of the credentials and allows the flow to continue.

This node is available in: Authentication, Admin, Self Service, API, Consent, Library, Custom, User Defined

The set of available options may depend on the flow category or type in which the node is used.

User binding configurations

This section allows you to configure how the user is bound to the session.

Username

You can bind the user either by username or by a specific attribute. In both cases, the corresponding value must be specified (can use a variable from the form node, e.g. {{form.username}} and {{form.password}}).

An additional Ignore case option is available to perform the binding without considering letter case differences.

Password

Configure the password, including an optional flag to verify password expiration. When this option is enabled, you can specify a TTL (in seconds) to define the validity period.

Attributes to retrieve from the user store

Select which user attributes should be retrieved from the user after the binding process, using the multi-select field listing the attributes exposed by the user store.

User identify rule

The User Identity Rule is the condition used to match the user retrieved by the node with the user stored in the current user session.

See Common Configurations — User Identify Rule for full details and attribute manipulation functions.

Save in session

The Save in Session option is used to persist data within the IO user session. The Session Attribute Mapping section allows mapping IO attributes to specific values. Multiple mappings can be defined; they are stored in the IO user session at the end of the flow.

Rules are defined as: IO attribute : value retrieved from the node

Example: username: uid

See Common Configurations — Save in Session for details.

Save in the flow store

Attributes generated or retrieved from the node can be saved into a variable and reused by other nodes in the flow by referencing them as {{variable.attribute}}.

See Common Configurations — Save in the Flow Store for details.

Default output node

• Success
• Wrong Credentials
• User Pending
• User Locked
• User not found
• Password expired
• Failure

JSON metadata

{
    "name": "auth_v2",
    "active": true,
    "bundleName": "am-users-nodes",
    "bundleVersion": "1.0",
    "category": "user_management",
    "deprecated": false,
    "displayName": [{
            "lang": "en",
            "value": "Authenticate User"
        }, {
            "lang": "it",
            "value": "Authenticate User"
        }
    ],
    "nodeName": "AuthV2",
    "index": 2,
    "inputs": [{
            "name": "Input"
        }
    ],
    "outputs": [{
            "name": "Success",
            "level": "success"
        }, {
            "name": "WrongCredentials",
            "level": "warning"
        }, {
            "name": "UserPending",
            "level": "warning"
        }, {
            "name": "UserLocked",
            "level": "warning"
        }, {
            "name": "UserNotFound",
            "level": "warning"
        }, {
            "name": "PasswordExpired",
            "level": "warning"
        }, {
            "name": "Failure",
            "level": "error"
        }
    ]
}