Username Login

Username authentication allows customers to register or log into your website or app without remembering their email addresses. Users can quickly access the platform by simply entering a Username and Password, offering a familiar, straightforward alternative to email-based login. This feature enhances the user experience by reducing cognitive load and providing a more direct path to access.

Configuration

Username Login allows users to authenticate using a unique username instead of an email address. Here's how to enable and configure it in your authentication settings:

By following the below steps, configure the Username Login.

Enable User Name Login

1. Navigate to the LoginRadius Admin console

2. Go to the Authentication Configuration

3. Under the Authentication Type section, locate the Username option and click on it. Next, you will be redirected to the Username Settings page.

4. Ensure the toggle next to Username is set to Enabled. This allows you to customize login behavior for usernames.

Username Configurations

• Signup Flow: Configure whether creating a username during registration is mandatory or optional as per your use case.

  • Mandatory: During registration, all users are required to create a unique username. This flow is ideal for platforms where usernames, such as gaming or social media platforms, are a core part of the user identity. It ensures that all users have a unique and consistent identifier.

  • Optional: Users can choose whether to create a username during registration. This option is suitable for platforms that prioritize flexibility, such as e-commerce or service-oriented platforms, where some users may prefer email-only registration without creating a username.

• Case-Sensitive Username

  • Enable this option if usernames should be case-sensitive (e.g., "JohnDoe" and "johndoe" are treated as different usernames).

  • Use-Case: This is ideal for platforms requiring strict user identification, such as developer tools or enterprise systems, where case distinction can prevent conflicts between similar usernames.

• Duplicate Email with Unique Username: Enable this setting to allow users to have multiple accounts with the same email address. However, the username for each account should be unique. This option is ideal for the business where:

  • Organizations with different roles use the same email.

  • Family or shared accounts where each member has a unique username.

  • Testing environments needing distinct accounts for multiple roles.

  • Multi-tenant systems where users from different organizations share an email.

  • Account merging enables consolidation of accounts while retaining the same email.

Integration Guide

This guide provides a comprehensive walkthrough for integrating a secure and seamless username-password authentication system into your application using LoginRadius. It covers backend integration via SDKs and libraries, front-end customization through REST APIs, and post-login management to enhance the user experience.

Checking Username Availability

Ensure a username is available before user registration to prevent duplication and streamline the onboarding process.

Integration via API

Auth Check UserName Availability Validate if a username is available using this API

Integration via JS SDK

Auth Login by Username availablity Validate if a username is available using the JS SDK.

User Registration

Register a new user with a unique username and password. The system securely stores credentials for authentication.

Integration via API

Auth registration by Username Register a user with their username, email and password.

Integration via JS SDK

Utilize the JS SDK function to login using username.

User Login

Authenticate users via username and password, initiating a session and returning a secure session token.

Integration via API

Auth Login by Username Authenticates a user using their username and password.

Integration via SDK Utilize the Prebuilt V2 JS login Interface to allow the users to log in via username

Note: Follow the Session Management document for managing the session after the login process

Reset Password

Integration via API
Reset Password by Username and OTP

Integration via V2.js Interface

Utilize the Prebuilt V2 JS login Interface

Changing Username

Integration via API Set or Change Username

Integration via JS SDK

Utilize the JS SDK function to change the username

You can use any SDKs provided by LoginRadius based on your requirements for SDK implementation. LoginRadius GitHub Repositories

Access tokens will be utilized for subsequent API requests to interact with authorized resources while maintaining the user’s authenticated session.

Customization Options

LoginRadius provides extensive customization options to meet your business requirements.

• Enforce password policies, such as minimum and maximum length, inclusion of special characters, or adherence to specific formats.

• Configure advanced rules to ensure enhanced security while maintaining user convenience.

• Enhance your application's user experience with LoginRadius-provided JavaScript hooks. These hooks trigger real-time UI updates or specific actions during user interactions, such as progress indicators or error messages.

• Utilize Hosted Pages for greater control and flexibility in designing login experiences to match your application’s look and feel.

Related Resources

• Customer Identity APIs

• LoginRadius SDKs

• Password Policy Configuration