Purpose-Based UI Rendering in eSignet
eSignet now supports dynamic UI rendering based on the purpose defined by the relying party (client) during client registration. This enhancement ensures that the user experience is tailored and context-aware across different workflows such as Login, Verify, or Link.
Why Purpose-Based Rendering?
Different service interactions require different messaging and UI contexts. For instance:
Login: Accessing a service using verified credentials.
Verify: Authenticating user identity to validate a claim.
Link: Associating a digital ID with another identity or account.
With this feature, eSignet dynamically adjusts the UI text and flow based on the configured purpose, providing users with a more intuitive and relevant experience.
How It Works
During client registration, the relying party defines the intended purpose for the authentication request. Based on this configuration, eSignet dynamically renders the login interface accordingly.
Configuration Parameters
purpose.type
String
Defines the purpose of the UI rendering. Acceptable values: verify, login, link, none
purpose.title
Object
(Optional) Custom title text displayed on the UI. Supports internationalization.
purpose.subTitle
Object
(Optional) Custom subtitle text shown below the title. Supports internationalization.
Valid Values for purpose.type
login – Default login interface
verify – Verification flow (e.g., claim validation)
link – Linking identity or accounts
none – No specific UI context; defaults to standard login behavior
Internationalization Support
The title and subTitle fields support language-specific values using locale keys. For example:
"purpose": {
"type": "login",
"title": { "eng": "Login using eSignet", "@none": "" },
"subTitle": { "eng": "Please choose the login option", "@none": "" }
}
Example OIDC Request Payload
"purpose": {
"type": "verify",
"title": {
"eng": "Verify your identity",
"@none": ""
},
"subTitle": {
"eng": "Authenticate using your preferred method",
"@none": ""
}
}
Summary
With purpose-based UI rendering, eSignet enables:
A personalized user experience for different authentication flows
Clear context provided via customizable titles and subtitles
Seamless integration using OIDC request payloads
This feature is especially valuable for deployments with multiple service touchpoints that require tailored messaging across workflows.
Last updated
Was this helpful?