e9064509fe
* Feat: Add Mailcow oauth source * Feat: Add mailcow icon * Run make * Feat: Add tests * Fix: Remainder from discord test * Docs: Add mailcow oauth source docs * Docs: add mailcow source to menu * Fix: Mailcow provider type in test * Fix: Formatting * Fix: Doc file name
1.5 KiB
1.5 KiB
title |
---|
Mailcow |
Allows users to authenticate using their Mailcow credentials
Preparation
The following placeholders will be used:
authentik.company
is the FQDN of the authentik install.mailcow.company
is the FQDN of the mailcow install.
Mailcow
- Log into mailcow as an admin and navigate to the OAuth2 Apps settings
-
Click "Add OAuth2 Client"
-
Insert the redirect URL:
https://authentik.company/source/oauth/callback/mailcow
- Copy the Client ID and Client secret and save it for later
Authentik
- Under Directory -> Federation & Social login Click Create > Mailcow OAuth Source
- Name: Choose a name (For the example I used Mailcow)
- 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.)
- Consumer Key: Client ID from step 4
- Consumer Secret: Client Secret from step 4
- Authorization URL: https://mailcow.company/oauth/authorize
- Access token URL: https://mailcow.company/oauth/token
- 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 more details on how-to have the new source display on the Login Page see here. :::