website/docs: add onlyoffice docs

closes #1820

Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>

website/docs/integrations/services/onlyoffice/index.md

@@ -0,0 +1,50 @@
+---
+title: OnlyOffice
+---
+
+## What is OnlyOffice
+
+From https://en.wikipedia.org/wiki/OnlyOffice
+
+:::note
+OnlyOffice, stylized as ONLYOFFICE, is a free software office suite developed by Ascensio System SIA, a company headquartered in Riga, Latvia. It features online document editors, platform for document management, corporate communication, mail and project management tools
+:::
+
+:::note
+This is based on authentik 2021.10.4 and OnlyOffice 11.5.4.1582. Instructions may differ between versions.
+:::
+
+## Preparation
+
+The following placeholders will be used:
+
+- `authentik.company` is the FQDN of authentik.
+- `onlyoffice.company` is the FQDN of the OnlyOffice instance.
+
+Open your OnlyOffice instance, navigate to the settings by clicking the cog-icon in the navbar, then click on *Control Panel* on the sidebar.
+
+In the new tab, click on *SSO* in the sidebar.
+
+Click the *Enable Single Sign-on Authentication* checkbox to enable SSO.
+
+Scroll down to *ONLYOFFICE SP Metadata*, and copy the *SP Entity ID (link to metadata XML)* URL. Open this URL in a new tab, and download the XML file.
+
+## authentik Setup
+
+Create an application in authentik, and create a SAML Provider by using *SAML Provider from Metadata*. Give the provider a name, and upload the XML file you've downloaded in the previous step.
+
+Edit the resulting Provider, and ensure *Signing Certificate* is set to any certificate.
+
+Navigate on the *Metadata* tab on the Provider page, and click *Copy download URL*.
+
+## OnlyOffice Setup
+
+Navigate back to your OnlyOffice Control panel, and paste the URL into *Load metadata from XML to fill the required fields automatically*, and click the upload button next to the input field.
+
+Under *Attribute Mapping*, set the following values
+
+- *First Name*: `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`
+- *Last Name*: `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`
+- *Email*: `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress`
+
+Click save and a new SSO button will appear on the OnlyOffice login page.

website/sidebars.js

@@ -102,6 +102,7 @@ module.exports = {
                         "integrations/services/matrix-synapse/index",
                         "integrations/services/minio/index",
                         "integrations/services/nextcloud/index",
+                        "integrations/services/onlyoffice/index",
                         "integrations/services/opnsense/index",
                         "integrations/services/portainer/index",
                         "integrations/services/proxmox-ve/index",