5 1 0:Configuring Database-Based Authentication

From SEPsesam

Welcome to the latest SEP sesam documentation version 5.1.0 Apollon. For previous documentation version(s), check documentation archive.


SEP sesam provides different authentication methods that are mutually exclusive: policy-based authentication and database-based authentication which can be combined with Lightweight Directory Access Protocol (LDAP) or/and Active Directory. Only one method (policy-based or database-based authentication) can be active at a time. By default, policy-based authentication is active.

Activating database-based authentication has to be done via the GUI to set the superuser/admin password. Note that superuser has replaced the former admin role with SEP sesam version 5.0.0 Jaglion.
After restarting SEP sesam GUI Server and Client, the superuser/admin can configure default user access rights that are based on predefined user type. SEP sesam currently provides 5 user types. The following list shows the available user types and their corresponding rights.

  • Superuser (≥ Jaglion): The only user type with full control over the SEP sesam environment (previously Admin). This user type with superuser rights is automatically assigned to the Administrator and sesam users.
  • Administrator: Administrators can administer the SEP sesam system and access the GUI objects (except permission management) if not restricted by ACLs.
  • Operator: Operators can monitor the whole environment.
  • Backup (≥ Jaglion): Backup users can access the GUI objects granted by ACLs. They are allowed to start backups.
  • Restore: Restore users can access the GUI objects granted by ACLs. They are allowed to start restores.

Which GUI components are displayed depends on the user type. For details, see Available interface options according to user type.

Users can also authenticate with a signed certificate instead of a user password if database-based authentication is enabled. For step-by-step procedure, see Configuring Certificate-Based Authentication.

Activating database-based authentication in the GUI

  1. In the GUI, from the menu bar select Configuration ‐> Permission Management.
  2. Click Activate Authentication. Set up the password for the Administrator user; note that this is the only way to set the administrator's password.

  3. After activating the authentication mode and confirming your action, you have to restart SEP sesam GUI and SEP sesam Client for the changes to take effect.

  4. LDAP/AD authentication is enabled by default. For details on how to configure LDAP/AD authentication, see Configuring LDAP/AD Authentication.
  5. You have to log in to configure users and add them to the selected group. The following user types are available: Administrators, Operators, Backup users, and Restore users.
  6. You can create your own subgroups (e.g., SUB_ADMIN) to grant users more specific roles. Under the Groups tab, click Create New to configure a new subgroup. The Sub Group window opens.
  7. Specify a group name and from the drop-down list select the relevant role to be applied to the whole group: Administrator, Operator, Backup, or Restore. For more details, see User Roles and Permissions.

  8. Note
    If you want to use LDAP/AD, you have to use the external groups. Add the group from LDAP/AD and select the Based on group option to map to this particular SEP sesam group; see Configuring LDAP authentication in the GUI.
  9. Under the Users tab, click Create New to configure a new user. The Create User window opens.
  10. Enter a name (e.g., mustermann) and a password and assign the user to the relevant group, for example, RESTORE.

  11. A user can be a member of one or more groups. Under the Groups tab, double-click the relevant group and (de)select the users to assign them to or remove them from the respective group.

  12. Now you can configure ACLs (access control lists) to specify which users or groups are granted access to location (group of clients) or a specific client. You can also configure ACLs for backup tasks, media pools and schedules. For details, see Using Access Control Lists.
When activating database-based authentication via GUI, parameter authEnabled is changed to true in the sm.ini file. Setting the flag to false enables policy-based authentication and deactivates database-based authentication.

Resetting user password

To reset the password of another user, you must have superuser/admin privileges. SEP sesam generates a random password, which you send to the user. The user can then use the generated password to change their password and set a new one. The superuser/admin can reset the password in the GUI or in the command line by using the sm_cmd command.

Resetting a password in SEP sesam version 5.0.0 Jaglion is a two-step process: The superuser/admin has to reset the password in the command line by using the sm_cmd command and then use the newly generated password to be able to change the password in the Permission Management in GUI. For detailed procedure see Resetting user password in 5.0.0 Jaglion.

Resetting password in the GUI

To reset the password for a user in the GUI follow the procedure below:

  1. From the menu bar select Configuration ‐> Permission Management. The Permission Management window opens.
  2. Double-click the user for which you want to reset the password, or select the user and click Change.

  3. In the Change User window, click Reset Password.

  4. Click Yes to confirm the action.

  5. Copy the generated password and send it to the user. Then click OK to apply the changes.

Resetting password in the command line

To reset a user password, log in to SEP sesam Server console and enter the following command:

sm_cmd reset user <ID or name>

The output of the above command is shown in the example.

In this example, the user name is mustermann.

sm_cmd reset user mustermann
C:\Program Files\SEPsesam\bin\sesam>sm_cmd reset user mustermann

Changing the password

To change your own user password in the GUI follow the procedure below:

  1. From the menu bar select Configuration ‐> Change Password. The Change Password window opens.
  2. Enter your current password. Then enter your new password and repeat the new password to confirm the change.
  3. Click OK to apply the change.

Deactivating database-based authentication

  1. In the GUI, from the menu bar select Configuration ‐> Permission Management -> tab Activation.
  2. Click Deactivate Authentication.
  3. After deactivating the authentication mode and confirming your action, SEP sesam GUI will restart automatically. You have to restart SEP sesam Client manually for the changes to take effect.

Now policy-based authentication is enabled and the flag authEnabled is set to false in the sm.ini file.

See also

About Authentication and AuthorizationUser Roles and PermissionsConfiguring Certificate-Based AuthenticationConfiguring LDAP/AD AuthenticationUsing Access Control ListsConfiguring Policy-Based Authentication

Copyright © SEP AG 1999-2024. All rights reserved.
Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.