Build Custom Identity Flows
Identity Orchestration lets you visually compose and deploy identity flows (registration, login, MFA, account recovery) using a node-based canvas. Each node represents a discrete step; you connect them to define the exact user experience your application needs.
Scope of this section: Use Cases covers the four most common flow patterns. Each entry explains which nodes are involved, how they connect, and what you can configure. The Node Reference section provides deep technical details per node including output edges and error codes.
Core Concepts
Every workflow is a directed graph with a single entry point and one or more terminal nodes (Success / Failure). The runtime traverses the graph, executing each node and following the output edge determined by that node's result.
| Concept | Description |
|---|---|
| Node | Atomic unit of work: e.g., Auth verifies a password, Web Page renders a UI screen. |
| Output Edge | Named exit path from a node. Most nodes emit true, false, and per-error-code edges. You wire each to the next node. |
| Session | Mutable key-value store that persists across nodes within a single workflow execution. Nodes read and write identity data here. |
| Web Page Node | Container node that groups UI-collecting child nodes (Email, Password, Form…) into a single rendered screen. |
| IO Script | Custom JavaScript (Node.js runtime) executed by the Script node. Accesses lrObject for identity CRUD and hook for session data. |
| Template | Pre-built workflow JSON you can import as a starting point, then customise. |
Quick Start
The fastest path: import a template, adjust the Web Page node labels, set your redirect URLs, and publish.
- In the Admin Console, navigate to Platform Config → Authentication → Workflows.
- Click New Workflow → From Template and select a starting template (e.g. Email Login).
- Click any node to open its property panel on the right.
- Set the Redirect URL on the Success and Failure final nodes.
- Click Update. The workflow is now saved and ready to use for your App Key.
- Click Preview to test the workflow end-to-end before or after saving.
What's in This Section
| Section | What you'll find |
|---|---|
| Building Flows from Scratch | Node selection guide: which node to use for each operation, how Web Page and child nodes work, and common anti-patterns |
| Templates | Ready-made workflow configurations with node-by-node walkthroughs |
| Use Cases | End-to-end guides for common patterns: session limits, step-up auth, SCA, OIDC/OAuth integration |
| Node Reference | Detailed specs: properties, output edges, and error codes per node |
| Workflow Editor & Styles | How to use the visual editor: shortcuts, connecting nodes, validation, and branding settings |
| Deploy | Track version history, debug execution, and roll back to any prior snapshot |
| Scripts | Write custom JavaScript with the lrObject and hook APIs |