Logon

From Commander4j
Revision as of 12:09, 1 April 2026 by Dgarratt (talk | contribs) (Updated by push_wiki.py)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The Logon screen is presented when Commander4j starts in Desktop mode. It requires a valid username and password before access to any part of the application is granted.

Credentials

Usernames and passwords are stored in the Commander4j database (table `SYS_USERS`), not in the operating system. Each database instance has its own independent set of user accounts. If you connect to a different database host, you will need credentials valid for that database.

For the default credentials on a fresh installation, see Default Username & Password.

Login Process

The system performs the following checks in order when a login is attempted:

  1. Account exists — the username must exist in the database.
  2. Account enabled — accounts can be disabled by an administrator. A disabled account cannot log in.
  3. Account locked — accounts are locked automatically after exceeding the maximum number of failed password attempts (configurable via System Keys). Locked accounts can be set to unlock automatically after a specified number of minutes, or may require an administrator to unlock them manually via the Users screen.
  4. Account expiry — if the account has an expiry date set and that date has passed, login is refused.
  5. Password correct — the entered password is validated. Each failed attempt increments the bad attempt counter.
  6. Password expiry — if the password expiry feature is enabled and the password has not been changed within the configured number of days, the user is prompted to change it.
  7. Password change required — if an administrator has set this flag, the user must choose a new password before proceeding.

First Login

On a fresh installation, the system will prompt you to change the default password immediately after your first successful login.

Windows Authentication

Commander4j pre-populates the username field with the currently logged-in Windows username. If your Commander4j user ID matches your Windows username, you may only need to enter your password.

Changing Your Password

The logon screen includes a Change Password option. Ticking this before logging in will prompt for a password change immediately after a successful login, even if the system has not required it.

Passwords can also be changed at any time through the web scanner interface (c4j_web_react) if you are a shop-floor user without desktop access.

Account Recovery

If your account is locked, contact your Commander4j administrator. They can unlock the account via the Users screen. If auto-unlock is configured, the account will unlock automatically after the configured number of minutes without administrator intervention.

See also: Users, Default Username & Password, System Keys, Groups, Permissions