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.
We strongly recommend to change the initial admin user password after the first login.
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)
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).
If you have configured custom password rules, make sure that the new admin user password complies with your password rules.
Changing the Default Admin User Password (Kubernetes)
Open the
values.yaml
file.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='
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
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
Before disabling the default admin user, ensure you have created at least one other user with full administrative permissions. Otherwise, you may lose administrative access to your Connectware installation.
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)
Open the
values.yaml
file.Set the
global.userManagement.adminUser.enabled
Helm value tofalse
.
global:
userManagement:
adminUser:
enabled: 'false'
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
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?