Default Admin User

Manage the default admin user credentials and access settings.

During installation, Connectware creates a default administrator user to ensure immediate system access. This user is named admin and has the connectware-admin role assigned to provide comprehensive permissions.

Admin User Parameters

The following auth-server environment variables are available for configuring the admin user. Parameters differ between Kubernetes and Docker deployments.

Admin User Parameters (Kubernetes)

Parameter
Description
Default value

global.userManagement.adminUser.initialPassword

Sets the initial password for the admin user. Must be a Base64-encoded string.

admin

global.userManagement.adminUser.enabled

Enables/disables the admin user. Accepts a boolean value (true or false).

true

Changing the Default Admin User Password

The initial admin user password is admin (Base64-encoded). We strongly recommend to change the initial admin user password after the first login.

You can change the password via the global.userManagement.adminUser.initialPassword Helm value (Kubernetes) or the CYBUS_INITIAL_ADMIN_USER_PASSWORD environment variable (Docker).

Changing the Default Admin User Password (Kubernetes)

  1. Open the values.yaml file.

  2. Set the global.userManagement.adminUser.initialPassword Helm value to a password of your choice. Make sure to encode the password in Base64 format.

global:
    userManagement:
        adminUser:
            initialPassword: 'U2VjdXJlUGFzc3dvcmQxMjM='
  1. Upgrade your Helm chart to apply the Helm configuration changes. For more information, see Applying Helm configuration changes.

helm upgrade -n <namespace> <installation-name> -f values.yaml
  1. Try logging in with the old admin user credentials to verify your configuration. You should receive a "wrong password" error.

Disabling the Default Admin User

You can disable the default admin user after creating custom users that have admin permissions.

If the global.userManagement.adminUser.initialPassword Helm value (Kubernetes) or the CYBUS_ADMIN_USER_ENABLED environment variable (Docker) is not set, or if it has a value other than false, the default admin user is enabled and can log in with suitable credentials.

Disabling the Default Admin User (Kubernetes)

  1. Open the values.yaml file.

  2. Set the global.userManagement.adminUser.enabled Helm value to false.

global:
    userManagement:
        adminUser:
            enabled: 'false'
  1. Upgrade your Helm chart to apply the Helm configuration changes. For more information, see Applying Helm configuration changes.

helm upgrade -n <namespace> <installation-name> -f values.yaml
  1. Try logging in with the admin user credentials to verify that the account has been disabled. You should receive a "wrong password" error.

Last updated

Was this helpful?