-
Type: Task
-
Status: Resolved
-
Priority: Major
-
Resolution: Fixed
-
Affects Version/s: None
-
Fix Version/s: WEBUI-0.8.0, 8.10
-
Component/s: Login Page
-
Upgrade notes:
-
Sprint:nxFG 8.3.6, nxFG 8.4.1, nxfit 8.4.3, nxfit 8.4.4
-
Story Points:3
Principle
We now have an "agnostic" login page inside the nuxeo-server distribution.
It handles form authentication and redirection logic depending on the UI package(s) installed:
- No packages: redirect to home.html.
- nuxeo-jsf-ui: redirect to the JSF UI (nxstartup.faces).
- nuxeo-web-ui: redirect to the new Web UI (ui/).
- nuxeo-jsf-ui and nuxeo-web-ui: redirect to the new Web UI (ui/). This behavior can be overridden to force redirection to the JSF UI, see below.
Implementation
To achieve this we mostly needed to:
- Move the login related resources from bundles embedded in the nuxeo-jsf-ui package to the nuxeo-platform-web-common bundle included in the nuxeo-server distribution.
- Make login.jsp post to a StartupPageServlet handling the startup page logic, so action="nxstartup.faces" became action="startup".
Note that the workaround for NXP-20013 was removed.
The startup page logic is configured by the "loginScreen" extension point, to which each UI package contributes:
nuxeo-jsf-ui:
<extension target="org.nuxeo.ecm.platform.ui.web.auth.service.PluggableAuthenticationService" point="loginScreen"> <loginScreenConfig> <startupPages> <startupPage id="jsf" priority="10"> <path>nxstartup.faces</path> </startupPage> </startupPages> </loginScreenConfig> </extension>
nuxeo-web-ui
<extension target="org.nuxeo.ecm.platform.ui.web.auth.service.PluggableAuthenticationService" point="loginScreen"> <loginScreenConfig> <startupPages> <startupPage id="web" priority="100"> <path>ui/</path> </startupPage> </startupPages> </loginScreenConfig> </extension>
The startupPage contribution with the highest priority wins, so "web" by default.
This can be overridden by:
<extension target="org.nuxeo.ecm.platform.ui.web.auth.service.PluggableAuthenticationService" point="loginScreen"> <loginScreenConfig> <startupPages> <startupPage id="jsf" order="1000" /> </startupPages> </loginScreenConfig> </extension>
If there are no startupPage contributions Nuxeo redirects to the static page home.html.
See related documentation: https://doc.nuxeo.com/x/Y4rjAQ.
- depends on
-
NXP-20013 Fix redirect after wizard on server distribution without any package
- Resolved
- is required by
-
NXP-20359 Reuse common login page in DuoFactorsAuthenticator
- Open
-
NXP-19790 Integration tests for Nuxeo Server
- Resolved
-
NXP-20225 Make a new login screen compliant with Nuxeo Mobile, the new Web UI, Drive, etc.
- Resolved
-
NXP-20919 Make JSF UI the default UI for 8.10
- Resolved
-
NXP-22200 Landing page when leaving WebUI
- Resolved