59 lines
2.5 KiB
Markdown
59 lines
2.5 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)
|
|
- **Desarrollado por ForclusNET**
|
|
|
|
## 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
|
|
- **Personalización del botón** : Texto, imagen y colores personalizables
|
|
- **URL de callback** : Se muestra automáticamente para facilitar la configuración
|
|
|
|
## 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 ID de cliente y el secreto 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.
|
|
|
|
## Soporte
|
|
|
|
Para cualquier pregunta o problema, consulta la documentación de Authentik o contacta el soporte de Paymenter.
|