# 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.