Advanced Identity Cloud

Set Success Details node

The Set Success Details node adds additional details to the JSON response on successful authentication. You can add either or both of the following:

  • Success details: Lets you add static key:value fields to the JSON response.

  • Session properties: Lets you add key:value fields to the JSON response, where value corresponds to the value of the specified session property.

You can’t override the tokenId, successUrl, and realm fields returned in the JSON response by default.

Compatibility

Product Compatible?

Advanced Identity Cloud

Yes 1

PingAM (self-managed)

Yes

Ping Identity Platform (self-managed)

Yes

1 Currently available only in the rapid release channel.

Inputs

None. This node doesn’t read shared state data.

Dependencies

Ensure the user can successfully authenticate and get a session.

If the noSession parameter is used during authentication, this node has no effect.

Configuration

Property Usage

Success Details

The success details to add:

  • To add a static field:

    1. Click Add in the Success Details modal.

    2. Enter the field name to display in the Key field and the corresponding value to display in the Value field.

      The value can be a simple text string, a boolean value, or a JSON formatted value. The value is formatted appropriately when output in the JSON response.

      For example:

      Key Value Output

      example

      this is a test value

      "example": "this is a test value"

      boolean

      true

      "boolean": true

      field

      "nested": "nested value"

      "field": {
         "nested": "nested value"
      }
    3. Click Done.

  • To edit a field:

    1. Click the Pencil icon ().

    2. Update the Key and Value as when adding fields.

  • To remove a field, click the Delete icon ().

When finished, click Save to keep your settings.

Session Properties

The session properties to add.

You can find a list of the default session properties in Session properties.

  • To add a session property:

    1. Click Add in the Session Properties modal.

    2. Enter the field name to display in the Key field and the session property name in the Value field.

    3. Click Done.

  • To edit a property:

    1. Click the Pencil icon ().

    2. Update the Key and Value as when adding properties.

  • To remove a property, click the Delete icon ().

When finished, click Save to keep your settings.

Outputs

This node doesn’t change the shared state.

Outcomes

Single outcome path: when the journey completes successfully, this node adds the additional configured details to the JSON response.

Errors

This node doesn’t log messages of its own.

Examples

This example uses the Set Success Details node to add the following additional details to the JSON response:

  • A static authMethod:password field.

  • A universalId session property, which returns the corresponding value from the session when the user authenticates.

set success details journey
  • The Page node containing the Platform Username node and Platform Password node prompts for credentials.

  • The Data Store Decision node validates the username-password credentials.

  • The Increment Login Count node updates the number of successful authentications in the user profile.

  • The Set Success Details node adds the additional configured details to the JSON response upon successful authentication. This example uses the following configuration:

    Success Details

    Key: authMethod

    Value: password

    Session Properties

    Key: universalId

    Value: sun.am.UniversalIdentifier

When the user authenticates successfully using this journey, the JSON response includes the additional details you configured. For example:

{
    "tokenId": "AQIC5wM…​TU3OQ*",
    "successUrl": "/enduser/?realm=/alpha",
    "realm": "/alpha",
    "universalId": "id=demo,ou=user,o=alpha,ou=services,ou=am-config",
    "authMethod": "password"
}
Copyright © 2010-2024 ForgeRock, all rights reserved.