Authentication settings

To adapt general system authentication settings, navigate to Administration -> Authentication and choose -> Settings.

You can adapt the following under the authentication settings:

General authentication settings

  1. Select if the authentication is required to access OpenProject. For versions 13.1 and higher of OpenProject, this setting will be checked by default

    Important note: If you un-tick this box your OpenProject instance will be visible to the general public without logging in. The visibility of individual projects depends on this setting.

  2. Select an option for self-registration. Self-registration can either be disabled, or it can be allowed with the following criteria:

    a) Account activation by email means the user receives an email and needs to confirm the activation.

    b) Manual account activation means that a system administrator needs to manually activate the newly registered user.

    c) Automatic account activation means that a newly registered user will automatically be active.

    Note: By default, self-registration is only applied to internal users (logging in with username and password). If you have an identity provider such as LDAP, SAML or OpenID Connect, use the respective settings in their configuration to control which users are applicable for automatic user creation.

  3. Define if the email address should be used as login name.

  4. Define after how many days the activation email sent to new users will expire. Afterwards, you will have the possibility to re-send the activation email via the user settings.


You can define a footer for your registration emails under -> Administration -> Authentication -> Settings.

  1. Choose for which language you want to define the registration footer.
  2. Enter a text for the registration footer.


Configure password settings

You can change various settings to configure password preferences in OpenProject.

  1. Define the minimum password length.
  2. Define the password strength and select what character classes are a mandatory part of the password.
  3. Define the minimum number of required character classes.
  4. Define the number of days, after which a password change should be enforced.
  5. Define the number of the most recently used passwords that a user should not be allowed to reuse.
  6. Activate the Forgot your password. This way a user will be able to reset the own password via email.


Other authentication settings

There can be defined a number of other authentication settings.

  1. Define the number of failed login attempts, after which a user will be temporarily blocked.
  2. Define the duration of the time, for which the user will be blocked after failed login attempts.
  3. Enable or disable the autologin option. This allows a user to remain logged in, even if he/she leaves the site. If this option is activated, the “Stay signed in” option will appear on the login screen to be selected.
  4. Activate the session expiration option. If you select this option, an additional field will open, where you will be able to define the inactivity time duration before the session expiry.
  5. Define to log user login, name, and mail address for all requests.
  6. Enable REST web service. This setting allows users to access the OpenProject API using an API token created from the users “My account” page.
  7. Do not forget to save your changes.