Back to articles
DevOps & Systems

Building a Centralized SSO System for All Self-Hosted Applications with Authentik

This guide provides a detailed walkthrough for building a centralized Single Sign-On (SSO) system for all self-hosted applications using Authentik, a powerful open-source...

DPTCloud Engineering4 min read
Building a Centralized SSO System for All Self-Hosted Applications with Authentik

This guide provides a detailed walkthrough for building a centralized Single Sign-On (SSO) system for all self-hosted applications using Authentik, a powerful open-source authentication platform that supports OIDC, SAML, and modern authentication protocols. With Authentik, you can manage access centrally, integrate with applications like Nextcloud, Portainer, and other self-hosted services, and enhance security while reducing the burden of managing scattered accounts. The guide covers installation, configuration, application integration, and operational verification.

Overview of Authentik and SSO

Authentik is an open-source authentication platform developed by the authentik team, supporting standard protocols such as OIDC, SAML, and OAuth 2.0. It enables you to build a centralized Single Sign-On (SSO) system for all self-hosted applications, eliminating the need to manage individual accounts. With features like multi-factor authentication (MFA), token-based authentication, and high customization, Authentik is ideal for DevOps environments requiring high security and centralized access control. Key features include user and group management, access permissions, and integration with systems like LDAP, Active Directory, or cloud services.

Requirements and Installing Authentik

To deploy Authentik, you need a server capable of running Docker. You can use NVMe Cloud VPS for Docker, Nginx & Databases to efficiently host the platform. Follow these basic installation steps:

1. Install Docker and Docker Compose if not already installed:

sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl enable docker
sudo systemctl start docker

2. Create a directory and download the configuration file:

mkdir -p /opt/authentik
cd /opt/authentik
curl -o docker-compose.yml https://raw.githubusercontent.com/goauthentik/authentik/master/docker-compose.yml

3. Start Authentik:

docker-compose up -d

After running, Authentik will start and you can access the admin interface at https://your-domain.com. Ensure you have configured DNS and SSL (preferably with Let's Encrypt) to secure access.

Integrating Self-Hosted Applications

Authentik supports integration with many self-hosted applications via OIDC or SAML. Below is an example integration with Nextcloud:

1. In Authentik, create an "Application" using the OIDC type.

2. Install Nextcloud and configure it to use OIDC. In the config/config.php file, add:

'auth.oidc' => [
    'enabled' => true,
    'client_id' => 'your-client-id',
    'client_secret' => 'your-client-secret',
    'auth_url' => 'https://your-domain.com/api/v3/auth/oidc/authorize',
    'token_url' => 'https://your-domain.com/api/v3/auth/oidc/token',
    'userinfo_url' => 'https://your-domain.com/api/v3/auth/oidc/userinfo',
    'scope' => 'openid profile email',
],

3. Configure other applications similarly, using the appropriate protocols. Authentik supports integration with services like Portainer, Grafana, and other common self-hosted applications.

Testing and Troubleshooting

To verify SSO functionality, try logging into an integrated application. If login fails, check the following:

  • Ensure Authentik is running: docker-compose ps
  • Check logs: docker-compose logs authentik
  • Verify callback URLs in the application are correctly configured.
  • In Authentik, check "Applications" and "Providers" to confirm correct setup.

For SSL-related issues, use openssl s_client -connect your-domain.com:443 to validate the certificate. For more detailed configuration guidance, refer to the official Authentik documentation.

References

For more information on Authentik, see:

DPTCloud Tier III Infrastructure

Recommended NVMe Cloud VPS Plans to Deploy This Setup

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02

VPS-2E

94.600 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Recommended

VPS-3E

170.500 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Recommended

VPS-05

457.600 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478