codelibs · marevol · Sep 10, 2026 · Sep 10, 2026
diff --git a/de/15.9/admin/general-guide.rst b/de/15.9/admin/general-guide.rst
@@ -96,10 +96,10 @@ SSO-Typ
 Gibt den Typ der Einmalanmeldung (Single Sign-On) an.
 
 - **Keine**: SSO nicht verwenden
-- **OpenID Connect**: OpenID Connect verwenden
-- **SAML**: SAML verwenden
-- **SPNEGO**: SPNEGO verwenden
-- **Entra ID**: Microsoft Entra ID verwenden
+- **OpenID Connect**: OpenID Connect verwenden (erfordert das Plugin ``fess-sso-oidc``)
+- **SAML**: SAML verwenden (erfordert das Plugin ``fess-sso-saml``)
+- **SPNEGO**: SPNEGO verwenden (erfordert das Plugin ``fess-sso-spnego``)
+- **Entra ID**: Microsoft Entra ID verwenden (erfordert das Plugin ``fess-sso-entraid``)
 
 Crawler
 -------

diff --git a/de/15.9/config/sso-entraid.rst b/de/15.9/config/sso-entraid.rst
@@ -8,6 +8,14 @@ SSO-Konfiguration mit Entra ID
 |Fess| unterstützt Single Sign-On (SSO)-Authentifizierung mit Microsoft Entra ID (ehemals Azure AD).
 Durch die Verwendung der Entra ID-Authentifizierung können Benutzerinformationen und Gruppeninformationen aus Ihrer Microsoft 365-Umgebung mit der rollenbasierten Suche von |Fess| integriert werden.
 
+.. note::
+   Die Unterstützung für die Entra ID-Authentifizierung kommt aus dem Plugin
+   ``fess-sso-entraid``, das nicht Teil der Distribution ist. Installieren Sie es über die
+   Seite **System > Plugin** in der Administrationsoberfläche oder mit
+   ``bin/fess-setup install plugin fess-sso-entraid``.
+   Bis dahin wird eine Anfrage an ``/sso/`` mit ``sso.type=entraid`` (oder dem alten ``aad``)
+   nur zur Anmeldeseite zurückgeleitet.
+
 Wie die Entra ID-Authentifizierung funktioniert
 -----------------------------------------------
 

diff --git a/de/15.9/config/sso-oidc.rst b/de/15.9/config/sso-oidc.rst
@@ -9,6 +9,15 @@ SSO-Konfiguration mit OpenID Connect
 OpenID Connect ist ein Authentifizierungsprotokoll, das auf OAuth 2.0 aufbaut und ID-Token (JWT) für die Benutzerauthentifizierung verwendet.
 Durch die Verwendung von OpenID Connect können Benutzerinformationen, die von einem OpenID Provider (OP) authentifiziert wurden, mit |Fess| integriert werden.
 
+.. note::
+   Die Unterstützung für die OpenID Connect Authentifizierung kommt aus dem Plugin
+   ``fess-sso-oidc``, das nicht Teil der Distribution ist. Installieren Sie es über die Seite
+   **System > Plugin** in der Administrationsoberfläche oder mit
+   ``bin/fess-setup install plugin fess-sso-oidc``. Das Plugin heißt ``fess-sso-oidc``, während
+   der Wert von ``sso.type`` weiterhin ``oic`` lautet.
+   Bis dahin wird eine Anfrage an ``/sso/`` mit ``sso.type=oic`` nur zur Anmeldeseite
+   zurückgeleitet.
+
 Funktionsweise der OpenID Connect Authentifizierung
 ----------------------------------------------------
 

diff --git a/de/15.9/config/sso-saml.rst b/de/15.9/config/sso-saml.rst
@@ -8,6 +8,13 @@ SAML-Authentifizierung SSO-Einrichtung
 |Fess| unterstützt Single Sign-On (SSO) Authentifizierung mit SAML (Security Assertion Markup Language) 2.0.
 Durch die Verwendung von SAML-Authentifizierung können Benutzerinformationen, die von einem IdP (Identity Provider) authentifiziert wurden, mit |Fess| integriert werden. In Kombination mit rollenbasierter Suche ermöglicht dies die Anzeige von Suchergebnissen basierend auf Benutzerberechtigungen.
 
+.. note::
+   Die Unterstützung für die SAML-Authentifizierung kommt aus dem Plugin ``fess-sso-saml``,
+   das nicht Teil der Distribution ist. Installieren Sie es über die Seite **System > Plugin**
+   in der Administrationsoberfläche oder mit ``bin/fess-setup install plugin fess-sso-saml``.
+   Bis dahin wird eine Anfrage an ``/sso/`` mit ``sso.type=saml`` nur zur Anmeldeseite
+   zurückgeleitet.
+
 Funktionsweise der SAML-Authentifizierung
 -----------------------------------------
 

diff --git a/de/15.9/config/sso-spnego.rst b/de/15.9/config/sso-spnego.rst
@@ -8,6 +8,14 @@ SSO-Konfiguration mit Windows-integrierter Authentifizierung
 |Fess| unterstützt Single Sign-On (SSO)-Authentifizierung mit Windows-integrierter Authentifizierung (SPNEGO/Kerberos).
 Durch die Verwendung der Windows-integrierten Authentifizierung können Benutzer, die an einem Windows-Domänencomputer angemeldet sind, ohne zusätzliche Anmeldevorgänge auf |Fess| zugreifen.
 
+.. note::
+   Die Unterstützung für die Windows-integrierte Authentifizierung kommt aus dem Plugin
+   ``fess-sso-spnego``, das nicht Teil der Distribution ist. Installieren Sie es über die Seite
+   **System > Plugin** in der Administrationsoberfläche oder mit
+   ``bin/fess-setup install plugin fess-sso-spnego``.
+   Bis dahin wird eine Anfrage an ``/sso/`` mit ``sso.type=spnego`` nur zur Anmeldeseite
+   zurückgeleitet.
+
 Wie die Windows-integrierte Authentifizierung funktioniert
 ----------------------------------------------------------
 

diff --git a/de/15.9/install/upgrade.rst b/de/15.9/install/upgrade.rst
@@ -470,7 +470,7 @@ Bei Major-Version-Upgrades wird die Neuerstellung des Index empfohlen.
 Upgrade von 15.8 auf 15.9
 =========================
 
-Wenn Sie von 15.8 aktualisieren, sind die folgenden sieben Änderungen nicht abwärtskompatibel.
+Wenn Sie von 15.8 aktualisieren, sind die folgenden acht Änderungen nicht abwärtskompatibel.
 
 Entfernung des eingebetteten OpenSearch
 ---------------------------------------
@@ -567,6 +567,36 @@ und ein vorhandenes ``crawler.file.protocols`` wird durch das Upgrade ebenfalls
 
 Ohne Amazon S3 oder S3-kompatible Speicher wie MinIO ist nichts zu tun.
 
+Die SSO-Authentifizierung wird als Plugins ausgeliefert
+-------------------------------------------------------
+
+Keiner der vier SSO-Authentifikatoren ist mehr Teil der Distribution; jeder Wert von
+``sso.type`` kommt jetzt aus einem eigenen Plugin, das auch die benötigte
+Identitätsbibliothek mitbringt: ``saml`` aus ``fess-sso-saml``, ``spnego`` aus
+``fess-sso-spnego``, ``entraid`` (und das alte ``aad``) aus ``fess-sso-entraid`` und ``oic``
+aus ``fess-sso-oidc``. Beachten Sie das letzte Paar: das Plugin heißt ``fess-sso-oidc``,
+während der Wert von ``sso.type`` weiterhin ``oic`` lautet; das ist die einzige Stelle, an der
+sich beide unterscheiden. Installieren Sie das benötigte Plugin über die Seite
+**System > Plugin** in der Administrationsoberfläche oder mit dem folgenden Befehl.
+
+::
+
+    $ bin/fess-setup install plugin fess-sso-saml
+
+Ihre Einstellungen bleiben erhalten, weil ``sso.type`` und die Schlüssel ``saml.*``,
+``spnego.*``, ``entraid.*``, ``aad.*`` und ``oic.*`` in ``WEB-INF/conf/system.properties``
+liegen. Auch „System" → „Allgemein" auf der Verwaltungsseite bietet weiterhin alle vier Typen
+an und zeigt weiterhin deren Einstellungen, weil ein Plugin keine JSP bereitstellen kann; auf
+dieser Seite weist also nichts auf ein fehlendes Plugin hin.
+
+Bis das Plugin installiert ist, wird eine Anfrage an ``/sso/`` zur Anmeldeseite
+zurückgeleitet, die den fehlgeschlagenen SSO-Login meldet, und niemand kann sich über SSO
+anmelden. 15.9 protokolliert in ``fess.log`` eine Warnung mit dem Namen der gesuchten
+Komponente und des Plugins, das sie bereitstellt, wo bis 15.8 auf keiner Log-Ebene etwas
+ausgegeben wurde.
+
+Ohne SSO ist nichts zu tun, also wenn ``sso.type`` den Wert ``none`` hat oder nicht gesetzt ist.
+
 Die eingebaute Skript-Engine wechselt von Groovy zu JavaScript
 --------------------------------------------------------------
 

diff --git a/en/15.9/admin/general-guide.rst b/en/15.9/admin/general-guide.rst
@@ -96,10 +96,10 @@ SSO Type
 Specifies the single sign-on type.
 
 - **None**: Do not use SSO
-- **OpenID Connect**: Use OpenID Connect
-- **SAML**: Use SAML
-- **SPNEGO**: Use SPNEGO
-- **Entra ID**: Use Microsoft Entra ID
+- **OpenID Connect**: Use OpenID Connect (requires the ``fess-sso-oidc`` plugin)
+- **SAML**: Use SAML (requires the ``fess-sso-saml`` plugin)
+- **SPNEGO**: Use SPNEGO (requires the ``fess-sso-spnego`` plugin)
+- **Entra ID**: Use Microsoft Entra ID (requires the ``fess-sso-entraid`` plugin)
 
 Crawler
 -------

diff --git a/en/15.9/config/sso-entraid.rst b/en/15.9/config/sso-entraid.rst
@@ -8,6 +8,13 @@ Overview
 |Fess| supports Single Sign-On (SSO) authentication using Microsoft Entra ID (formerly Azure AD).
 By using Entra ID authentication, you can integrate user information and group information from your Microsoft 365 environment with |Fess| role-based search.
 
+.. note::
+   Entra ID authentication comes from the ``fess-sso-entraid`` plugin, which is not part of the
+   distribution. Install it from the System > Plugin page in the administration screen, or with
+   ``bin/fess-setup install plugin fess-sso-entraid``.
+   Until it is installed, ``sso.type=entraid`` (or the legacy ``aad``) only redirects every
+   request to ``/sso/`` back to the login page.
+
 How Entra ID Authentication Works
 ---------------------------------
 

diff --git a/en/15.9/config/sso-oidc.rst b/en/15.9/config/sso-oidc.rst
@@ -9,6 +9,14 @@ Overview
 OpenID Connect is an authentication protocol built on top of OAuth 2.0 that uses ID Tokens (JWT) for user authentication.
 By using OpenID Connect authentication, user information authenticated by an OpenID Provider (OP) can be integrated with |Fess|.
 
+.. note::
+   OpenID Connect authentication comes from the ``fess-sso-oidc`` plugin, which is not part of
+   the distribution. Install it from the System > Plugin page in the administration screen, or
+   with ``bin/fess-setup install plugin fess-sso-oidc``. The plugin is named ``fess-sso-oidc``
+   while the ``sso.type`` value stays ``oic``.
+   Until it is installed, ``sso.type=oic`` only redirects every request to ``/sso/`` back to the
+   login page.
+
 How OpenID Connect Authentication Works
 ---------------------------------------
 

diff --git a/en/15.9/config/sso-saml.rst b/en/15.9/config/sso-saml.rst
@@ -8,6 +8,13 @@ Overview
 |Fess| supports Single Sign-On (SSO) authentication using SAML (Security Assertion Markup Language) 2.0.
 By using SAML authentication, user information authenticated by an IdP (Identity Provider) can be integrated with |Fess|, enabling role-based search results based on user permissions when combined with role-based search.
 
+.. note::
+   SAML authentication comes from the ``fess-sso-saml`` plugin, which is not part of the
+   distribution. Install it from the System > Plugin page in the administration screen, or with
+   ``bin/fess-setup install plugin fess-sso-saml``.
+   Until it is installed, ``sso.type=saml`` only redirects every request to ``/sso/`` back to
+   the login page.
+
 How SAML Authentication Works
 -----------------------------
 

diff --git a/en/15.9/config/sso-spnego.rst b/en/15.9/config/sso-spnego.rst
@@ -8,6 +8,13 @@ Overview
 |Fess| supports Single Sign-On (SSO) authentication using Windows Integrated Authentication (SPNEGO/Kerberos).
 By using Windows Integrated Authentication, users who are logged into a Windows domain-joined computer can access |Fess| without additional login operations.
 
+.. note::
+   Windows Integrated Authentication comes from the ``fess-sso-spnego`` plugin, which is not
+   part of the distribution. Install it from the System > Plugin page in the administration
+   screen, or with ``bin/fess-setup install plugin fess-sso-spnego``.
+   Until it is installed, ``sso.type=spnego`` only redirects every request to ``/sso/`` back to
+   the login page.
+
 How Windows Integrated Authentication Works
 -------------------------------------------
 

diff --git a/en/15.9/install/upgrade.rst b/en/15.9/install/upgrade.rst
@@ -465,7 +465,7 @@ For major version upgrades, it is recommended to recreate the index.
 Upgrading from 15.8 to 15.9
 ===========================
 
-If you are upgrading from 15.8, the following seven changes are not backward compatible.
+If you are upgrading from 15.8, the following eight changes are not backward compatible.
 
 Removal of the embedded OpenSearch
 ----------------------------------
@@ -555,6 +555,33 @@ existing ``crawler.file.protocols`` is not replaced by the upgrade either.
 
 Nothing is needed if you do not use Amazon S3 or S3-compatible storage such as MinIO.
 
+SSO Authentication Moved to Plugins
+-----------------------------------
+
+None of the four SSO authenticators is part of the distribution any more. Each ``sso.type``
+value now comes from its own plugin, which carries the identity library it needs: ``saml`` from
+``fess-sso-saml``, ``spnego`` from ``fess-sso-spnego``, ``entraid`` (and the legacy ``aad``)
+from ``fess-sso-entraid``, and ``oic`` from ``fess-sso-oidc``. Note the last pair: the plugin is
+named ``fess-sso-oidc`` while the ``sso.type`` value stays ``oic``, the one place where the two
+differ. Install the one you use from the System > Plugin page in the administration screen, or
+with the command below.
+
+::
+
+    $ bin/fess-setup install plugin fess-sso-saml
+
+Your settings are kept, because ``sso.type`` and the ``saml.*``, ``spnego.*``, ``entraid.*``,
+``aad.*`` and ``oic.*`` keys live in ``WEB-INF/conf/system.properties``. "System" → "General" in
+the admin UI also still offers all four types and still shows their settings, because a plugin
+cannot supply a JSP, so nothing on that screen reports a missing plugin.
+
+Until the plugin is installed, a request to ``/sso/`` is redirected back to the login page,
+which reports that the SSO login failed, and no one can log in through SSO. 15.9 records a
+warning in ``fess.log`` naming the component it looked for and the plugin that provides it,
+where up to 15.8 nothing was logged at any level.
+
+Nothing is needed if you do not use SSO, that is if ``sso.type`` is ``none`` or unset.
+
 The Built-in Script Engine Changed from Groovy to JavaScript
 ------------------------------------------------------------
 

diff --git a/es/15.9/admin/general-guide.rst b/es/15.9/admin/general-guide.rst
@@ -96,10 +96,10 @@ Tipo de SSO
 Especifica el tipo de inicio de sesión único (Single Sign-On).
 
 - **Ninguno**: No usar SSO
-- **OpenID Connect**: Usar OpenID Connect
-- **SAML**: Usar SAML
-- **SPNEGO**: Usar SPNEGO
-- **Entra ID**: Usar Microsoft Entra ID
+- **OpenID Connect**: Usar OpenID Connect (requiere el plugin ``fess-sso-oidc``)
+- **SAML**: Usar SAML (requiere el plugin ``fess-sso-saml``)
+- **SPNEGO**: Usar SPNEGO (requiere el plugin ``fess-sso-spnego``)
+- **Entra ID**: Usar Microsoft Entra ID (requiere el plugin ``fess-sso-entraid``)
 
 Rastreador
 ----------

diff --git a/es/15.9/config/sso-entraid.rst b/es/15.9/config/sso-entraid.rst
@@ -8,6 +8,13 @@ Descripción general
 |Fess| soporta autenticación Single Sign-On (SSO) utilizando Microsoft Entra ID (anteriormente Azure AD).
 Al utilizar la autenticación de Entra ID, puede integrar la información de usuario y la información de grupo de su entorno Microsoft 365 con la búsqueda basada en roles de |Fess|.
 
+.. note::
+   La compatibilidad con la autenticación de Entra ID proviene del plugin ``fess-sso-entraid``,
+   que no forma parte de la distribución. Instálelo desde la página **Sistema > Plugin** de la
+   pantalla de administración o con ``bin/fess-setup install plugin fess-sso-entraid``.
+   Hasta entonces, con ``sso.type=entraid`` (o el antiguo ``aad``) toda petición a ``/sso/``
+   solo se redirige de vuelta a la página de inicio de sesión.
+
 Cómo funciona la autenticación de Entra ID
 ------------------------------------------
 

diff --git a/es/15.9/config/sso-oidc.rst b/es/15.9/config/sso-oidc.rst
@@ -9,6 +9,14 @@ Descripción general
 OpenID Connect es un protocolo de autenticación basado en OAuth 2.0 que utiliza ID Tokens (JWT) para la autenticación de usuarios.
 Al utilizar autenticación OpenID Connect, la información del usuario autenticada por un OpenID Provider (OP) puede integrarse con |Fess|.
 
+.. note::
+   La compatibilidad con la autenticación OpenID Connect proviene del plugin ``fess-sso-oidc``,
+   que no forma parte de la distribución. Instálelo desde la página **Sistema > Plugin** de la
+   pantalla de administración o con ``bin/fess-setup install plugin fess-sso-oidc``. El plugin
+   se llama ``fess-sso-oidc`` mientras que el valor de ``sso.type`` sigue siendo ``oic``.
+   Hasta entonces, con ``sso.type=oic`` toda petición a ``/sso/`` solo se redirige de vuelta a
+   la página de inicio de sesión.
+
 Cómo funciona la autenticación OpenID Connect
 ----------------------------------------------
 

diff --git a/es/15.9/config/sso-saml.rst b/es/15.9/config/sso-saml.rst
@@ -8,6 +8,13 @@ Descripción general
 |Fess| soporta autenticación Single Sign-On (SSO) utilizando SAML (Security Assertion Markup Language) 2.0.
 Al utilizar autenticación SAML, la información del usuario autenticada por un IdP (Identity Provider) puede integrarse con |Fess|, permitiendo mostrar resultados de búsqueda basados en los permisos del usuario cuando se combina con la búsqueda basada en roles.
 
+.. note::
+   La compatibilidad con la autenticación SAML proviene del plugin ``fess-sso-saml``, que no
+   forma parte de la distribución. Instálelo desde la página **Sistema > Plugin** de la
+   pantalla de administración o con ``bin/fess-setup install plugin fess-sso-saml``.
+   Hasta entonces, con ``sso.type=saml`` toda petición a ``/sso/`` solo se redirige de vuelta a
+   la página de inicio de sesión.
+
 Cómo funciona la autenticación SAML
 -----------------------------------
 

diff --git a/es/15.9/config/sso-spnego.rst b/es/15.9/config/sso-spnego.rst
@@ -8,6 +8,14 @@ Descripción general
 |Fess| soporta autenticación Single Sign-On (SSO) utilizando Autenticación Integrada de Windows (SPNEGO/Kerberos).
 Al utilizar la Autenticación Integrada de Windows, los usuarios que han iniciado sesión en una computadora unida al dominio Windows pueden acceder a |Fess| sin operaciones de inicio de sesión adicionales.
 
+.. note::
+   La compatibilidad con la Autenticación Integrada de Windows proviene del plugin
+   ``fess-sso-spnego``, que no forma parte de la distribución. Instálelo desde la página
+   **Sistema > Plugin** de la pantalla de administración o con
+   ``bin/fess-setup install plugin fess-sso-spnego``.
+   Hasta entonces, con ``sso.type=spnego`` toda petición a ``/sso/`` solo se redirige de vuelta
+   a la página de inicio de sesión.
+
 Cómo funciona la Autenticación Integrada de Windows
 ----------------------------------------------------
 

diff --git a/es/15.9/install/upgrade.rst b/es/15.9/install/upgrade.rst
@@ -470,7 +470,7 @@ Para actualizaciones de versión principal, se recomienda recrear el índice.
 Actualización de 15.8 a 15.9
 ============================
 
-Si actualiza desde 15.8, los siete cambios siguientes no son retrocompatibles.
+Si actualiza desde 15.8, los ocho cambios siguientes no son retrocompatibles.
 
 Eliminación del OpenSearch integrado
 ------------------------------------
@@ -569,6 +569,36 @@ valores ``storage.*`` se conservan, porque están en ``WEB-INF/conf/system.prope
 
 Si no utiliza Amazon S3 ni almacenamiento compatible con S3 como MinIO, no hay nada que hacer.
 
+La autenticación SSO pasa a plugins
+-----------------------------------
+
+Ninguno de los cuatro autenticadores SSO forma parte ya de la distribución; cada valor de
+``sso.type`` proviene ahora de su propio plugin, que incluye la biblioteca de identidad que
+necesita: ``saml`` de ``fess-sso-saml``, ``spnego`` de ``fess-sso-spnego``, ``entraid`` (y el
+antiguo ``aad``) de ``fess-sso-entraid`` y ``oic`` de ``fess-sso-oidc``. Fíjese en el último
+par: el plugin se llama ``fess-sso-oidc`` mientras que el valor de ``sso.type`` sigue siendo
+``oic``, el único lugar en el que ambos difieren. Instale el que utilice desde la página
+**Sistema > Plugin** de la pantalla de administración o con la orden siguiente.
+
+::
+
+    $ bin/fess-setup install plugin fess-sso-saml
+
+Sus valores de configuración se conservan, porque ``sso.type`` y las claves ``saml.*``,
+``spnego.*``, ``entraid.*``, ``aad.*`` y ``oic.*`` están en
+``WEB-INF/conf/system.properties``. Además, "Sistema" → "General" de la pantalla de
+administración sigue ofreciendo los cuatro tipos y sigue mostrando sus ajustes, porque un
+plugin no puede proporcionar un JSP, así que nada en esa pantalla indica que falte un plugin.
+
+Hasta que se instala el plugin, una petición a ``/sso/`` se redirige de vuelta a la página de
+inicio de sesión, que informa de que el inicio de sesión SSO ha fallado, y nadie puede iniciar
+sesión mediante SSO. 15.9 registra en ``fess.log`` una advertencia con el nombre del componente
+que ha buscado y el del plugin que lo proporciona, donde hasta 15.8 no se registraba nada en
+ningún nivel.
+
+Si no utiliza SSO, es decir, si ``sso.type`` es ``none`` o no está definido, no hay nada que
+hacer.
+
 El motor de scripting integrado pasa de Groovy a JavaScript
 -----------------------------------------------------------
 

diff --git a/fr/15.9/admin/general-guide.rst b/fr/15.9/admin/general-guide.rst
@@ -96,10 +96,10 @@ Type de SSO
 Spécifie le type d'authentification unique (Single Sign-On).
 
 - **Aucun** : Ne pas utiliser le SSO
-- **OpenID Connect** : Utiliser OpenID Connect
-- **SAML** : Utiliser SAML
-- **SPNEGO** : Utiliser SPNEGO
-- **Entra ID** : Utiliser Microsoft Entra ID
+- **OpenID Connect** : Utiliser OpenID Connect (nécessite le plugin ``fess-sso-oidc``)
+- **SAML** : Utiliser SAML (nécessite le plugin ``fess-sso-saml``)
+- **SPNEGO** : Utiliser SPNEGO (nécessite le plugin ``fess-sso-spnego``)
+- **Entra ID** : Utiliser Microsoft Entra ID (nécessite le plugin ``fess-sso-entraid``)
 
 Robot d'exploration
 -------------------