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