####

* Before OpenProject project members are able to access, link to and create wiki pages in XWiki, an administrator has to set up the integration. This is a one-time operation per wiki instance.

* There is a new entry in the administration settings, at _Administration → Begin of the insertionWikis →End of the insertion Wiki providers_

* This will display all existing integrations with wiki providers.

* Begin of the insertionThere is an additional menu item _Administration → Wikis → Internal wiki_End of the insertion Begin of the deletion By default it has only the internal Wiki.End of the deletion

* The internal Wiki can be enabled/disabled on the instance and is enabled by default.

* Administrators can click on the **\+ Wiki provider** button and select "XWiki" to be taken to the Begin of the insertion"**NewEnd of the insertion Begin of the deletion "NewEnd of the deletion XWiki Begin of the insertionprovider**"End of the insertion Begin of the deletion instance"End of the deletion page where they can begin configuring the integration.

* Setting up an XWiki-OpenProject integration involves two main steps on the OpenProject side, through which the users are guided step-by-step:

* In _General information_, the admin user gives the XWiki instance to which they're connecting a Begin of the insertionname,End of the insertion Begin of the deletion name andEnd of the deletion a host Begin of the insertionURL and the Authentication method.End of the insertion Begin of the deletion URL.End of the deletion

* In _OAuth Begin of the insertionconfiguration_,End of the insertion Begin of the deletion applications_,End of the deletion there is an exchange of OAuth client IDs and secrets between the two applications.

* OpenProject will generate its own values that the user will have to paste into the OpenProject Begin of the insertionextensionEnd of the insertion Begin of the deletion integrationEnd of the deletion setup flow in XWiki.

* Begin of the insertion~~XWikiEnd of the insertion Begin of the deletion XWikiEnd of the deletion will, in turn, also generate a client ID and secret that the user will be asked to enter on this Begin of the insertionpage.~~

* The XWiki client ID, secret and redirect URL are also generated in OpenProject for the user to copy them into the OpenProject extension in XWikiEnd of the insertion Begin of the deletion page.End of the deletion

* In _My account / Access tokens_ the current user can revoke/delete each access token that was granted to each XWiki instance. Begin of the deletion


####

#### **Visuals**

**Please refer to the Figma mockups:**

* **Integration setup:** [https://www.figma.com/design/m0Aj4o5upRvD2kdSB7mMQT/XWiki-Integration?node-id=214-6909](https://www.figma.com/design/m0Aj4o5upRvD2kdSB7mMQT/XWiki-Integration?node-id=214-6909)End of the deletion

* Begin of the insertionA health check canEnd of the insertion Begin of the deletion **Health checks:** toEnd of the deletion be Begin of the insertionperformed after the setup, which signals a working state or provides clues about any issues.End of the insertion Begin of the deletion updatedEnd of the deletion