Auth - Space Identity Create
Type identifier:
auth:space-identity:createCategory: Auth Operations
Description
The Auth - Space Identity Create node creates a new Space Identity within a Space, allowing users to authenticate and access the Space's Experiences. It assigns a role to the Space Identity, determining the user's permissions.
Input Handles
Handle | Type | Description |
|---|---|---|
| control | Triggers Space Identity creation. |
|
| (Optional) Display name for the Space Identity. |
|
| (Shown only when a JWT strategy is selected; required) The value of the strategy's client ID claim that resolves to this Space Identity. 1 to 500 characters. |
Output Handles
Handle | Type | Description |
|---|---|---|
| string | The ID of the created Space Identity. |
| control | Triggered when the Space Identity is created. |
| control | Triggered when creation fails. |
Configuration Options
Option | Type | Default | Description |
|---|---|---|---|
Authentication Strategy |
| required | The authentication strategy. |
Space Role |
| required | Role to assign to the new Space Identity. |
Authentication Strategy
Selects which authentication strategy configuration to use:
- Defines Space Identity cohort to add to
- For a JWT strategy (see Authenticate Requests with a JWT), the
claimValueinput is required. A token carrying that claim value authenticates as this Space Identity. A claim value maps to one Space Identity per strategy; creating a second Space Identity with the same value triggerserror.
Role Assignment
Assigns a Space role to the Space Identity:
- Determines access permissions
- Controls Experience visibility
- Affects data access rules
Behaviour
- Receives
triggerwith display name (and, for JWT strategies, claim value) - Creates the Space Identity (for JWT strategies, with its claim value)
- Assigns specified role
- Returns the created Space Identity
Identity Properties
Created Space Identity includes:
- Unique ID
- Display name
- Assigned role
- Creation timestamp
- Authentication strategy reference
Examples
User Registration
Flow:
- Flow - Trigger: Registration form submission
- Validate input data
- Auth - Space Identity Create: Create the Space Identity
- Auth - Magic Link Generate: Create verification link
- Integration - SMTP: Send welcome email
Configuration:
- Authentication Strategy: (Magic Link strategy)
- Space Role: (member role)
Invite User
Flow:
- Admin triggers invite
- Auth - Space Identity Create: Create invited user
- Auth - Magic Link Generate: Create login link
- Integration - SMTP: Send invitation email
Assign Different Roles
Configuration varies by use case:
- New customer: "customer" role
- Team member: "member" role
- Administrator: "admin" role