XWiki

• Description
• Limitations
• Setup
  • OpenID Connect

Description

Use XWiki as a backend for Cristal.

Limitations

Currently, requires XWiki to have a specific extension installed in order for Cristal to access the pages. Refer to the Setup section for more information.

Setup

• Add jetty-ee10-servlets 12.0.12 to webapps/xwiki/WEB-INF/lib
• Edit webapps/xwiki/WEB-INF/web.xml and add the content below next to the Set CORS policy for fonts filter.

  <filter>
    <filter-name>cross-origin</filter-name>
    <filter-class>org.eclipse.jetty.ee10.servlets.CrossOriginFilter</filter-class>
    <init-param>
      <param-name>allowedOriginPatterns</param-name>
      <param-value>*</param-value>
    </init-param>
    <init-param>
      <param-name>allowedMethods</param-name>
      <param-value>GET,POST,OPTIONS,DELETE,PUT,HEAD</param-value>
    </init-param>
    <init-param>
      <param-name>allowedHeaders</param-name>
      <param-value>origin, content-type, accept, authorization</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>cross-origin</filter-name>
    <url-pattern>/rest/*</url-pattern>
    <url-pattern>/bin/*</url-pattern>
  </filter-mapping>

XWiki <16.7.0 You need to add jetty-servlets 10.0.20 instead of jetty-ee10-servlets, and use org.eclipse.jetty.servlets.CrossOriginFilter as the filter class.

OpenID Connect

For the authentication to work, XWiki needs to have the OIDC Provider extension installed.
Then, the authentication service must be set to Token based authenticator in the administration.