64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# Extensión Authentik SSO - Forclus.NET para Paymenter
|
|
|
|
Esta extensión permite la integración completa con Authentik para la autenticación SSO (Single Sign-On) en Paymenter.
|
|
|
|
## Características
|
|
|
|
- Autenticación SSO con Authentik
|
|
- Creación automática de usuarios (opcional)
|
|
- Soporte para usuarios existentes únicamente (opcional)
|
|
- Configuración flexible a través de la interfaz de administración
|
|
- Prueba de configuración integrada
|
|
- Soporte multiidioma (francés/inglés/español)
|
|
- **Modificación automática de la vista de login al activar la extensión**
|
|
|
|
## Instalación
|
|
|
|
1. Descarga la extensión en la carpeta `extensions/Others/Authentik/`
|
|
2. Ve a la administración de Paymenter > Extensiones
|
|
3. Instala la extensión "Authentik SSO - Forclus.NET"
|
|
4. **Activa la extensión** (la vista de login se modifica automáticamente)
|
|
5. Configura los parámetros en la administración
|
|
|
|
## Configuración
|
|
|
|
### Parámetros requeridos
|
|
|
|
- **Client ID**: El ID de cliente de tu aplicación OAuth2 en Authentik
|
|
- **Client Secret**: El secreto de cliente de tu aplicación OAuth2 en Authentik
|
|
- **Base URL**: La URL base de tu instancia Authentik (ej: https://authentik.tudominio.com)
|
|
|
|
### Parámetros opcionales
|
|
|
|
- **Auto-crear usuarios**: Crear automáticamente usuarios de Authentik en Paymenter
|
|
- **Requerir usuario existente**: Solo los usuarios ya existentes en Paymenter pueden iniciar sesión
|
|
- **Forzar solo Authentik**: Ocultar el formulario de inicio de sesión normal y forzar el uso de Authentik
|
|
|
|
## Configuración de Authentik
|
|
|
|
1. Crea una aplicación OAuth2/OpenID en Authentik
|
|
2. Configura las URLs de redirección:
|
|
- URL de autorización: `https://tu-paymenter.com/oauth/authentik`
|
|
- URL de callback: `https://tu-paymenter.com/oauth/authentik/callback`
|
|
3. Activa los scopes: `openid`, `email`, `profile`
|
|
4. Copia el Client ID y el Client Secret en la configuración de la extensión
|
|
|
|
## Uso
|
|
|
|
Una vez configurada, la extensión añadirá un botón "Iniciar sesión con Authentik" en la página de inicio de sesión de Paymenter.
|
|
|
|
### Modo Solo Authentik
|
|
|
|
Si activas la opción "Forzar solo Authentik", la página de inicio de sesión normal se ocultará y solo los usuarios podrán iniciar sesión via Authentik. Esta opción es ideal para entornos empresariales donde quieres forzar el uso del SSO.
|
|
|
|
## Características Técnicas
|
|
|
|
- **Modificación automática**: La vista de login se modifica automáticamente al activar la extensión
|
|
- **Backup automático**: Se crea un backup de la vista original antes de modificarla
|
|
- **Restauración automática**: La vista se restaura automáticamente al desactivar la extensión
|
|
- **Sin bucles de redirección**: La lógica está optimizada para evitar bucles de redirección
|
|
|
|
## Soporte
|
|
|
|
Para cualquier pregunta o problema, consulta la documentación de Authentik o contacta el soporte de Paymenter.
|