UBIK Credentials Service
Contents
Credentials Self-Service Portal
Starting with UBIK 5.2, UBIK provides a Credentials Self-Service Portal that allows users to initialize or reset their own password.
Instead of an administrator defining and distributing passwords, UBIK can generate a secure link that is provided to the user. The user opens the link in a browser and defines the password directly in the Credentials Self-Service Portal.
Overview
The Credentials Self-Service functionality supports two main use cases:
- Password initialization for newly created users
- Password reset for existing users
Both workflows use a temporary, user-specific link that opens the Credentials Self-Service Portal.
The portal communicates with UBIK to set the new password. After the password has been successfully set, the user can authenticate with the new credentials.
Prerequisites
The feature requires the UBIK Credential Service, which is included in the UBIK 5.2 release package.
The service must be:
- installed,
- configured,
- reachable by the users who receive credential links, and
- configured in UBIK Studio using the Credential Portal URL database setting.
The Credential Service can be hosted according to the requirements of the target environment. Both HTTP and HTTPS are supported.
For productive environments, HTTPS is strongly recommended.
UBIK Configuration
The URL of the Credential Service must be configured in:
Database Settings > Credential Portal URL
After the Credential Portal URL has been configured, additional Credential actions become available for Login objects in UBIK Studio.
The corresponding actions can be accessed via:
Login > Start Actions > Credential
The available workflows are:
- Initialize credentials
- Reset credentials
Initial Password Setup
A new UBIK user can be created without assigning an initial password.
To let the user define the password:
- Create the Login in UBIK Studio.
- Start the Credential action for initializing the credentials.
- UBIK generates a user-specific URL and copies it to the clipboard.
- Send this URL to the user, for example by e-mail or Microsoft Teams.
- The user opens the URL in a browser.
- The Credentials Self-Service Portal asks the user to enter and confirm a new password.
- The portal validates the password against the configured password policy.
- After confirmation, the new password is stored in UBIK.
- The user can authenticate using the newly defined password.
While initialization is pending, the Login is in the corresponding initialization state and cannot be used for authentication.
Password Reset
The same mechanism can be used when an existing user needs to reset the password.
- Select the Login in UBIK Studio.
- Start the Credential password-reset action.
- UBIK generates a new password-reset URL.
- Send the generated URL to the user.
- The Login is put into the password-reset state and can no longer authenticate using the previous password.
- The user opens the link and specifies a new password.
- After the new password has been set successfully, the Login can authenticate again.
This prevents continued use of the previous credentials while a password reset is pending.
Login States
The Credentials Self-Service functionality introduces/uses Login states to control whether authentication is currently allowed.
Typical states include:
| State | Description |
|---|---|
| Enabled | The Login is active and can authenticate using its configured password. |
| Initializing | Initial credential setup is pending. Authentication is blocked until the user has defined a password. |
| Resetting | A password reset is pending. Authentication is blocked until a new password has been defined. |
| Blocked / Disabled | Authentication for the Login is disabled. |
An administrator can still manage the Login and its status directly in UBIK Studio.
Security
The Credentials Self-Service functionality includes several security mechanisms.
Single-use credential links
Credential links contain a token allowing the respective user to perform the requested credential operation.
The token is single-use. Once the password has successfully been set, the same link cannot be used again.
Authentication blocked during credential changes
When password initialization or reset is started, the corresponding Login is put into a state in which authentication is blocked.
Consequently, the previous credentials cannot continue to be used while the credential operation is pending.
Secure Password Storage
Passwords are not stored in a reversible form.
Password storage uses a random salt. Consequently, two users choosing the same password will still have different password representations in the database.
The stored representation cannot be used to retrieve the original password.
Protection against brute-force attacks
Password verification deliberately introduces a processing delay.
This limits the rate at which authentication attempts can be performed and makes automated brute-force attacks more difficult.
Typical New-User Workflow
A recommended workflow for onboarding a new user is:
Login created without password
↓
Administrator creates credential invitation
↓
Login enters initialization state
↓
Invitation link is sent to the user
↓
User opens the Credentials Self-Service Portal
↓
User defines a password
↓
Password policy is validated
↓
Password is stored securely
↓
Invitation token becomes invalid
↓
Login is enabled for authentication
This workflow avoids the need for an administrator to create, know, or communicate an initial user password.
Typical Password-Reset Workflow
Login is enabled
↓
Administrator starts password reset
↓
Login enters resetting state
↓
Previous credentials can no longer authenticate
↓
Reset link is sent to the user
↓
User defines a new password
↓
Reset token becomes invalid
↓
Login can authenticate with the new password
Administration
The self-service workflow does not remove the administrator's ability to manage Login objects directly.
Administrators can still:
- change the Login status,
- enable or disable a Login,
- assign a password directly, or
- trigger credential initialization or password reset.
The Credentials Self-Service Portal therefore provides an additional secure workflow for delegating password creation to the user without removing the existing administrative functionality.
Summary
The UBIK Credentials Self-Service Portal provides a secure mechanism for password initialization and password reset.
Its main benefits are:
- Users define their own passwords.
- Administrators do not need to distribute initial passwords.
- New users can be created without an initial password.
- Existing credentials are disabled while a reset is pending.
- Credential links are single-use.
- Password complexity can be configured centrally.
- Passwords are stored using salted, non-reversible representations.
- Authentication includes protection against high-frequency brute-force attempts.
- The portal can be visually customized for the respective environment.
