Registration Hosted Page

Hosted page Registration Trustdesk 4.x

Overview

The cidaas registration hosted page enables new users to create accounts and configure their login methods. Before implementing your registration page, consider these key design questions to ensure a smooth onboarding experience.

What identifiers can users register with?Email address, mobile number, username (User ID), or a combination.

What user information is required?Which fields are mandatory during registration and what else to collect.

Can users register with existing identities?Whether to enable social login or enterprise SSO via known identity providers.

Configuration

Configure the registration page in this order so you don't have to jump between sections:

1

Apply Registration Scope

Add the cidaas:register scope to your app.

2

Define fields (Field Setup)

Create the field definitions you want to collect.

3

Configure the User Setup

Allowed/required fields, identifiers, and communication-medium verification — then assign it to your app.

4

Password Policy

Enforce strong passwords.

5

Groups & Roles Restriction

Restrict who can register.

Apply Registration Scope

To configure the registration page for your app, add the cidaas:register scope to the application.

1

Sign in

Sign in to Trustdesk.

2

Open Applications

Navigate to Integrations → Applications.

3

Open the app

Open the application you want to configure.

4

Assign scope

Assign the cidaas:register scope to the application.

Developer Perspective

You can also manage scopes via API.

API	Description	Link
Register scope	Create or update a scope and add it to resource protection where necessary.	View API

Registration Fields & User Setup

User Setup

Registration fields, identifiers, and communication-medium verification are all part of a reusable User Setup configuration, which you assign to your application. For the complete reference (with screenshots), see the User Setup guide and the Field Setup guide.

Prerequisite

Before showing the registration page, verify the user doesn't already exist in cidaas using the check user exists API. If the user already exists, redirect them to the login page.

1. Define fields (Field Setup)

Field definitions come first. In Trustdesk, go to User Setup → Field Setup and click + Create field to add a field (field key, type, scopes, permissions, and locale settings). For the full walkthrough with screenshots, see the Field Setup guide.

2. Configure the User Setup

A User Setup selects which of those fields appear during registration and how the account is verified, then it is assigned to your application.

1

Open the User Setup

In Trustdesk, go to User Setup → User Setup and open (or create) the one for your application.

2

Fields

Set the Allowed fields and Required fields for the registration page.

3

Allow Login With

Choose the identifiers users can register and log in with (email, mobile number, username).

4

Communication verification

Set the Communication Medium Verification (see the options below).

5

Save & assign

Save, then assign the User Setup to your app under Integrations → Applications → User Setup.

For all User Setup options and behaviors, see the User Setup guide.

Developer Perspective

API	Description	Link
Get registration fields	Get all registration fields configured for your app.	View API
Get app details	Get the allowed and required fields configured for your app.	View API
Get all registration fields	Return all registration fields available for your instance.	View API
Save app details	Save your changes.	View API

Password Policy

Password policies enforce rules for strong password creation. In Trustdesk, create policies under Settings → Password policy, then assign one to your application through its Verification Options profile (password_policy_ref) — the profile is linked to the app via verification_options_id. For details, see the Password Policy guide and Verification Options.

Developer Perspective

API	Description	Link
Get list of password policy	Get the password policies you can use.	View API
Configure password policy	Configure the desired password policy.	View API
Upsert password policy	Update or insert the desired password policy.	View API

Groups and Roles Restriction

Group and role restrictions control who can register for your application. In Trustdesk, create a filter under Permission Setup → User Group Verification Filter, then open your application under Integrations → Applications → Authentication Setup and select it under Group Verification Filter. For details, see Group Role Restrictions.

Developer Perspective

API	Description	Link to API
Check user group restrictions	Validate user group restrictions.	View API
Get all group verification requests	Read all Group Verification Requests.	View API
Create new group verification request	Create a Group Verification Request (user access filter).	View API
Get group verification request by id	Get a Group Verification Request by ID.	View API
Update group verification request by id	Update a Group Verification Request by ID.	View API
Delete group verification request by id	Delete a Group Verification Request by ID.	View API
Verify user group restrictions	Verify user group access by request ID and user sub.	View API

Explore Related Topics

Successful Password Change Page

The confirmation screen shown after a password change.

Theming Hosted Pages

Customize colors, typography, and visual identity.

Initiate Verification Hosted Page

Kick off email, mobile, or IVR verification after registration.

Related Pages

Login Page

Often presented first; if the user doesn't exist, they may register.

Progressive Registration

Collect further information and consents after initial registration.

Need Support?

Please contact us directly on our support page or reach out to cidaas support at [email protected].