154fba12e0
* Updates all source documents with note on how to add source to login page * Updated the wording on the guide itself * Updated wording on notes * Fixes capitalization on header * Fixed broken links in google docs
54 lines
1.6 KiB
Markdown
54 lines
1.6 KiB
Markdown
---
|
|
title: Mailcow
|
|
support_level: community
|
|
---
|
|
|
|
Allows users to authenticate using their Mailcow credentials
|
|
|
|
## Preparation
|
|
|
|
The following placeholders are used in this guide:
|
|
|
|
- `authentik.company` is the FQDN of the authentik installation.
|
|
- `mailcow.company` is the FQDN of the mailcow installation.
|
|
|
|
## Mailcow
|
|
|
|
1. Log into mailcow as an admin and navigate to the OAuth2 Apps settings
|
|
|
|
|
|
|
|
2. Click "Add OAuth2 Client"
|
|
|
|
3. Insert the redirect URL: `https://authentik.company/source/oauth/callback/mailcow/`
|
|
|
|
|
|
|
|
4. Copy the **Client ID** and **Client secret** and _save it for later_
|
|
|
|
|
|
|
|
## authentik
|
|
|
|
5. Under _Directory -> Federation & Social login_ Click **Create > Mailcow OAuth Source**
|
|
|
|
|
|
|
|
6. **Name:** Choose a name (For the example I used Mailcow)
|
|
7. **Slug:** mailcow (You can choose a different slug, if you do you will need to update the Mailcow redirect URL and point it to the correct slug.)
|
|
8. **Consumer Key:** Client ID from step 4
|
|
9. **Consumer Secret:** Client Secret from step 4
|
|
10. **Authorization URL:** https://mailcow.company/oauth/authorize
|
|
11. **Access token URL:** https://mailcow.company/oauth/token
|
|
12. **Profile URL:** https://mailcow.company/oauth/profile
|
|
|
|
Here is an example of a complete authentik Mailcow OAuth Source
|
|
|
|
|
|
|
|
Save, and you now have Mailcow as a source.
|
|
|
|
:::note
|
|
For instructions on how to display the new source on the authentik login page, refer to the [Add sources to default login page documentation](../../index.md#add-sources-to-default-login-page).
|
|
:::
|