Skip to main content

Authentication Node

The AuthenticationNode prompts the user to authenticate using Denmark’s Bank ID system. It displays a customizable message along with a login button (default label: "MitID"). When clicked, the user is redirected to the Bank ID provider in the same window. Upon successful authentication, the user is returned to the original interface and allowed to continue the conversation.

This node ensures the user’s identity is verified before proceeding in the flow.

Use Case​

Use the AuthenticationNode when:

  • You need to verify the user’s identity before showing sensitive data
  • Access to the next steps in the flow must be gated by authentication
  • You want to securely fetch or store personal details like SSN or name after login

This node is typically used early in flows that require validation of the user, such as initiating a claim, accessing policy details, or personalizing the flow.

UI Examples​

Node in TellUs

Behavior​

  • Blocking: The flow does not continue until the user has authenticated
  • Button-driven: User must click the login button to proceed to Bank ID
  • Redirect flow:
    • Opens the Bank ID interface in the same window
    • Returns to the original UI after login
  • Produces multiple outputs: User info, metadata, and timestamp of authentication
  • Stores data in output properties that can be referenced later in the flow using dot notation ([userAuth.name], [userAuth.ssn], etc.)

Node Metadata​

PropertyDescription
Node classAuthenticationNode
MessageType301
CanBeEditedFalse
CanBeProcessedOnceTrue
RequireUserResponseYes

Input Properties​

PropertyDescription
loginButtonDefines the label text shown on the authentication button. This is what the user clicks to initiate the login process.
  • Default Values:
      • En:MitID
defaultValidationMessage

The default error message shown when the input is invalid or missing. This is used if no custom validation message is provided.

  • Default Values:
      • En:Please log in
      • No:Vennligst logg inn
      • Dk:Venligst log ind
      • Fi:Kirjaudu sisään
      • Se:Vänligen logga in
sectionId

Groups this node visually under a specific section in TellUs. When multiple nodes share the same sectionId, they are displayed together under a shared header.

defaultValue

The initial value that is prefilled into the input field when the node is rendered. Useful for suggesting defaults or pre-populating known data.

isRequired

Determines whether the user must provide a value before continuing. If set to true, the form will not proceed without input.

  • Default Values:
      • En:true
  • Allowed Values:
      • true
      • false
isRequiredValidationMessage

The error message shown when a required field is left empty. This overrides the default validation message when isRequired is true.

  • Default Values:
      • En:Value is required
      • No:Verdi er påkrevd
      • Dk:Værdi er påkrævet
      • Fi:Arvo vaaditaan
      • Se:Värde krävs

Output Properties​

PropertyDescription
ssnThe authenticated user’s national identification number. Typically used for person-level lookups or backend validation.
nameThe user’s first name as provided by the authentication provider.
surnameThe user’s last name or family name.
nameSurnameTFull name in display-friendly format: typically "<first name> <last name>".
countryThe country code or name associated with the user’s identity. Useful in regional flows or for branching logic.
bankNameThe name of the bank or identity provider used during authentication (e.g., “Danske Bank”).
authTimestampThe date and time when the authentication was completed. Useful for logging or validation.
AuthorizedUserA serialized object or token representing the authenticated user (e.g., for internal APIs or advanced authorization checks).
usernameThe user’s login ID or username if provided by the identity system.
displayValueA formatted string meant to represent the user in summaries or UI (e.g., "John Doe from Denmark"). Often used in overview nodes or conditions.

Editor Example​

Try it in the Atlas Editor

This link opens a prebuilt flow using this node in context. You can inspect how it's configured, how it's connected, and how it behaves in a real editor environment.

Quick guide​

This guide will assist you in creating an authentication node in the Atlas Editor.

Go to atest.editor.atlas.ifext.biz​

1. Right-click anywhere​

Right-click anywhere in the editor.

Right-click anywhere

2. Click "Create new node"​

Navigate to the option "Create new node" and select it.

Click 'Create new node'

3. Choose "Authentication"​

Select the "Authentication" node.

Choose 'Authentication'

4. Fill user message​

Input a message for user to see.

Fill user message

5. Start node connection​

Start node connection.

Start node connection

6. Finish connection​

Finish the connection

Finish connection

7. Click "Save"​

Click on the "Save" button.

Click 'Save'

This guide covered the process of creating an authentication node in Atlas Editor