habsi/authentik
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
19c5b28cb2510ce6205d08bd9f9ffecadb7df4a8
authentik/website/docs/users-sources/sources/social-logins/mailcow/index.md
Dewi Roberts 154fba12e0 website/docs: add login page source note to all source docs (#14667) 
* 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
2025-05-27 12:31:23 -05:00

1.6 KiB
Raw Blame History

title, support_level
title support_level
Mailcow 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

OAuth2 Apps menu

  1. Click "Add OAuth2 Client"

  2. Insert the redirect URL: https://authentik.company/source/oauth/callback/mailcow/

Add OAuth2 Client

  1. Copy the Client ID and Client secret and save it for later

ClientID and Secret

authentik

  1. Under Directory -> Federation & Social login Click Create > Mailcow OAuth Source

Mailcow OAuth Source

  1. Name: Choose a name (For the example I used Mailcow)
  2. 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.)
  3. Consumer Key: Client ID from step 4
  4. Consumer Secret: Client Secret from step 4
  5. Authorization URL: https://mailcow.company/oauth/authorize
  6. Access token URL: https://mailcow.company/oauth/token
  7. 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. :::