XWiki

• Description
• Limitations
• Setup
  • OpenID Connect

Description

Use XWiki as a backend for Cristal.

Limitations

Currently, requires XWiki to have the XWiki Experimental APIs for Cristal Wiki Prototype extension installed on XWiki in order for Cristal to access the pages.

Setup

• Install the XWiki Experimental APIs for Cristal Wiki Prototype extension
• Install the Markdown Syntax 1.2 extension
• Add jetty-servlets 10.0.20 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.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>

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.