Skip to content

OpenProject is the leading open source project management software for product, project and portfolio management. A powerful Jira alternative with agile planning, issue tracking, roadmaps, Gantt charts, time tracking, collaboration features, and more. Available on premises or in the cloud. ⭐ Star us on GitHub

[#67029] SSO as separate authentication settings tab https://communi… (#20153)

Maya Berdygylyjova4ddc7baaa056
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/README.md b/docs/system-admin-guide/authentication/login-registration-settings/README.md
index bcce29e0b9f..f64fe212c55 100644
--- a/docs/system-admin-guide/authentication/login-registration-settings/README.md
+++ b/docs/system-admin-guide/authentication/login-registration-settings/README.md
@@ -9,9 +9,11 @@ keywords: authentication settings, login settings, registration settings, OpenPr
To adapt general system **login and registration settings** in OpenProject, navigate to *Administration -> Authentication* and choose -> *Login and registration*.
-Here you can adapt various settings related to login and registration in OpenProject, grouped under three tabs:
+Here you can adapt various settings related to login and registration in OpenProject, grouped under four tabs:
-- Login and SSO
+- Login
+
+- Single Sign-On (SSO)
- Registration
@@ -19,30 +21,41 @@ Here you can adapt various settings related to login and registration in OpenPro
![Login and registration settings in OpenProject administration](openproject_system_admin_guide_authentication_settings_login_and_registration.png)
-## Login and SSO settings
+## Login settings
-Under the *Login and SSO* tab you can adjust following settings:
+Under the *Login* tab you can adjust following settings:
-1. Select a **direct login SSO provider**. If this option is active, login requests will be redirected to the configured Omniauth provider. This will disable the login dropdown and sign-in page.
+1. Enable or disable the **autologin option**. This allows a user to remain logged in, even if they leave the site. If this option is activated, the “Stay signed in” option will appear on the login screen to be selected.
-> [!NOTE]
-> Unless you also disable password logins, with this option enabled, users can still log in internally by visiting internal login page, for example `https://yourinstancename.openproject.com/login/internal` login page.
+2. Activate the **session expiration option**.
-2. Enable or disable the **autologin option**. This allows a user to remain logged in, even if they leave the site. If this option is activated, the “Stay signed in” option will appear on the login screen to be selected.
+3. Set the **duration for inactivity time**, after which a session will expire. Note that any value below 5 will be treated as disabling the session expiry setting.
-3. Activate the **session expiration option**.
+4. Define whether **user login, name, and mail address** should be logged for all requests.
-4. Set the **duration for inactivity time**, after which a session will expire. Note that any value below 5 will be treated as disabling the session expiry setting.
+5. Define a path to **redirect users to after their first login**. If left empty, users are redirected to the homepage to see the onboarding tour.
-5. Define whether **user login, name, and mail address** should be logged for all requests.
+6. Set a **default path to redirect users to after login** (only if the login link is not a back link, i.e. `www.example.openproject.com/login`). If left empty, users are redirected to the homepage.
-6. Define a path to **redirect users to after their first login**. If left empty, users are redirected to the homepage to see the onboarding tour.
+ Do not forget to **save** your changes.
-7. Set a **default path to redirect users to after login** (only if the login link is not a back link, i.e. `www.example.openproject.com/login`). If left empty, users are redirected to the homepage.
+![Login tab under login and registration settings in OpenProject system administration](openproject_system_admin_guide_authentication_settings_login_tab.png)
- Do not forget to **save** your changes.
+## Single Sign-On (SSO) settings
+
+Under the *Single Sign-On (SSO)* tab you can adjust following settings:
+
+1. Select a **direct login SSO provider**. If this option is active, login requests will be redirected to the configured Omniauth provider. This will disable the login dropdown and sign-in page.
-![Login and SSO tab under login and registration settings in OpenProject system administration](openproject_system_admin_guide_authentication_settings_login_sso_tab.png)
+> [!NOTE]
+> Unless you also disable password logins, with this option enabled, users can still log in internally by visiting internal login page, for example `https://yourinstancename.openproject.com/login/internal` login page.
+
+2. Allow **remapping of existing users**. If enabled, this option allows any configured identity provider to authenticate existing users based on their email address, even if those users have never previously signed in with that provider. This feature is particularly useful when migrating your OpenProject instance to a new SSO provider.
+
+> [!IMPORTANT]
+> It is **not recommended** when using an identity provider that is not trusted by all users in your instance, as this may introduce security risks.
+
+![SSO tab under login and registration settings in OpenProject system administration](openproject_system_admin_guide_authentication_settings_sso_tab.png)
## Registration settings
@@ -59,11 +72,11 @@ Under the *Registration* tab you can adjust following settings:
> [!WARNING]
> Administrators have no moderation control over this activation process if this method is selected.
-
+
b) **Manual account activation** - users can register on their own. However, an administrator (or a user with the global permission to create or manage users) needs to activate them.
-
+
c) **Automatic account activation** - users can register on their own. Their accounts are immediately active without further action.
-
+
> [!WARNING]
> Administrators have no moderation control over this activation process if this method is selected.
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_and_registration.png b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_and_registration.png
index de15998a2fc..545901606ab 100644
Binary files a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_and_registration.png and b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_and_registration.png differ
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_sso_tab.png b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_sso_tab.png
deleted file mode 100644
index 7407df0619f..00000000000
Binary files a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_sso_tab.png and /dev/null differ
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_tab.png b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_tab.png
new file mode 100644
index 00000000000..b94a628074c
Binary files /dev/null and b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_login_tab.png differ
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_password_tab.png b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_password_tab.png
index 7638cb45120..4dffcd2f573 100644
Binary files a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_password_tab.png and b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_password_tab.png differ
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_registration_tab.png b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_registration_tab.png
index 4898ad4bc6e..2533d0cdd95 100644
Binary files a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_registration_tab.png and b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_registration_tab.png differ
diff --git a/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_sso_tab.png b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_sso_tab.png
new file mode 100644
index 00000000000..bc2de35d832
Binary files /dev/null and b/docs/system-admin-guide/authentication/login-registration-settings/openproject_system_admin_guide_authentication_settings_sso_tab.png differ
diff --git a/docs/system-admin-guide/authentication/openproject_system_guide_authentication_settings.png b/docs/system-admin-guide/authentication/openproject_system_guide_authentication_settings.png
index 228ac290289..c2bbf2660b3 100644
Binary files a/docs/system-admin-guide/authentication/openproject_system_guide_authentication_settings.png and b/docs/system-admin-guide/authentication/openproject_system_guide_authentication_settings.png differ