docs: Add Wiki.js integration docs (#610)
* docs(wikijs): Add Wiki.js integration docs * docs(wikijs): Add to sidebar.
This commit is contained in:
parent
3319547a0e
commit
e9d95b1311
Binary file not shown.
After Width: | Height: | Size: 62 KiB |
Binary file not shown.
After Width: | Height: | Size: 188 KiB |
|
@ -0,0 +1,72 @@
|
||||||
|
---
|
||||||
|
title: Wiki.js
|
||||||
|
---
|
||||||
|
|
||||||
|
## What is Wiki.js
|
||||||
|
|
||||||
|
From https://en.wikipedia.org/wiki/Wiki.js
|
||||||
|
|
||||||
|
:::note
|
||||||
|
Wiki.js is a wiki engine running on Node.js and written in JavaScript. It is free software released under the Affero GNU General Public License. It is available as a self-hosted solution or using "single-click" install on the DigitalOcean and AWS marketplace.
|
||||||
|
:::
|
||||||
|
|
||||||
|
:::note
|
||||||
|
This is based on authentik 2021.3 and Wiki.js 2.5. Instructions may differ between versions.
|
||||||
|
:::
|
||||||
|
|
||||||
|
## Preparation
|
||||||
|
|
||||||
|
The following placeholders will be used:
|
||||||
|
|
||||||
|
- `wiki.company` is the FQDN of Wiki.js.
|
||||||
|
- `authentik.company` is the FQDN of authentik.
|
||||||
|
|
||||||
|
### Step 1
|
||||||
|
|
||||||
|
In Wiki.js, navigate to the _Authentication_ section in the _Administration_ interface.
|
||||||
|
|
||||||
|
Add a _Generic OpenID Connect / OAuth2_ strategy and note the _Callback URL / Redirect URI_ in the _Configuration Reference_ section at the bottom.
|
||||||
|
|
||||||
|
### Step 2
|
||||||
|
|
||||||
|
In authentik, under _Providers_, create an _OAuth2/OpenID Provider_ with these settings:
|
||||||
|
|
||||||
|
- Client Type: Confidential
|
||||||
|
- JWT Algorithm: RS256
|
||||||
|
- Redirect URI: The _Callback URL / Redirect URI_ you noted from the previous step.
|
||||||
|
- Scopes: Default OAUth mappings for: OpenID, email, profile.
|
||||||
|
- RSA Key: Choose a certificate.
|
||||||
|
- Sub Mode: Based on username.
|
||||||
|
|
||||||
|
Note the _client ID_ and _client secret_, then save the provider. If you need to retrieve these values, you can do so by editing the provider.
|
||||||
|
|
||||||
|
![](./authentik_provider.png)
|
||||||
|
|
||||||
|
### Step 3
|
||||||
|
|
||||||
|
In Wiki.js, configure the authentication strategy with these settings:
|
||||||
|
|
||||||
|
- Client ID: Client ID from the authentik provider.
|
||||||
|
- Client Secret: Client Secret from the authentik provider.
|
||||||
|
- Authorization Endpoint URL: https://authentik.company/application/o/authorize/
|
||||||
|
- Token Endpoint URL: https://authentik.company/application/o/token/
|
||||||
|
- User Info Endpont URL: https://authentik.company/application/o/userinfo/
|
||||||
|
- Issuer: https://authentik.company/application/o/wikijs/
|
||||||
|
- Logout URL: https://authentik.company/application/o/wikijs/end-session/
|
||||||
|
- Allow self-registration: Enabled
|
||||||
|
- Assign to group: The group to which new users logging in from authentik should be assigned.
|
||||||
|
|
||||||
|
![](./wiki-js_strategy.png)
|
||||||
|
|
||||||
|
:::note
|
||||||
|
You do not have to enable "Allow self-registration" and select a group to which new users should be assigned, but if you don't you will have to manually provision users in Wiki.js and ensure that their usernames match the username they have in authentik.
|
||||||
|
:::
|
||||||
|
|
||||||
|
### Step 5
|
||||||
|
|
||||||
|
In authentik, create an application which uses this provider. Optionally apply access restrictions to the application using policy bindings.
|
||||||
|
|
||||||
|
Set the Launch URL to the _Callback URL / Redirect URI_ without the `/callback` at the end, as shown below. This will skip Wiki.js' login prompt and log you in directly.
|
||||||
|
|
||||||
|
![](./authentik_application.png)
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 217 KiB |
|
@ -123,6 +123,7 @@ module.exports = {
|
||||||
"integrations/services/ubuntu-landscape/index",
|
"integrations/services/ubuntu-landscape/index",
|
||||||
"integrations/services/veeam-enterprise-manager/index",
|
"integrations/services/veeam-enterprise-manager/index",
|
||||||
"integrations/services/vmware-vcenter/index",
|
"integrations/services/vmware-vcenter/index",
|
||||||
|
"integrations/services/wiki-js/index",
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
],
|
],
|
||||||
|
|
Reference in New Issue