# 📋 Cómo Ver la Configuración de la Extensión Authentik SSO - Forclus.NET

## 🎯 Dónde Encontrar la Configuración

### 1. **Panel de Administración de Paymenter**

1. **Inicia sesión** en tu panel de administración de Paymenter
2. **Ve a la sección "Extensiones"** (normalmente en el menú lateral)
3. **Busca "Authentik SSO - Forclus.NET"** en la lista de extensiones
4. **Haz clic en "Configurar"** o "Settings"

### 2. **Campos de Configuración Disponibles**

#### **Parámetros Requeridos:**

- ✅ **Authentik SSO Enabled** - Activar/desactivar la extensión
- ✅ **Client ID** - ID de cliente de tu aplicación OAuth2 en Authentik
- ✅ **Client Secret** - Secreto de cliente de tu aplicación OAuth2 en Authentik
- ✅ **Base URL** - URL base de tu instancia Authentik

#### **Parámetros Opcionales:**

- ✅ **Auto-crear usuarios** - Crear automáticamente usuarios de Authentik
- ✅ **Requerir usuario existente** - Solo usuarios ya existentes en Paymenter
- ✅ **Forzar solo Authentik** - Ocultar formulario de login normal

#### **Personalización del Botón:**

- ✅ **Texto del botón** - Texto personalizado para el botón
- ✅ **Imagen del botón** - URL de la imagen del botón
- ✅ **Texto alternativo de la imagen** - Para accesibilidad
- ✅ **Color de fondo del botón** - Color en formato hexadecimal
- ✅ **Color del texto del botón** - Color en formato hexadecimal

#### **Información del Sistema:**

- 🔒 **URL de Callback (Solo lectura)** - URL que debes configurar en Authentik

## 📝 Cómo Ver las Descripciones

### **En el Panel de Administración:**

1. **Hover sobre los campos** - Al pasar el mouse sobre cada campo, verás una descripción
2. **Iconos de ayuda** - Algunos campos tienen iconos de información (ℹ️)
3. **Tooltips** - Las descripciones aparecen como tooltips al hacer hover

### **Ejemplo de Descripciones:**

- **Client ID**: "El ID de cliente de tu aplicación OAuth2 en Authentik"
- **Base URL**: "URL base de tu instancia Authentik (ej: https://authentik.tudominio.com)"
- **Auto-crear usuarios**: "Crear automáticamente usuarios de Authentik en Paymenter"
- **Forzar solo Authentik**: "Ocultar el formulario de inicio de sesión normal y forzar el uso de Authentik"
- **URL de Callback**: "URL que debes configurar en Authentik como Callback URL. Esta URL es fija y no se puede modificar."

## 🔧 Configuración Paso a Paso

### **Paso 1: Activar la Extensión**

1. Ve a **Extensiones > Authentik SSO - Forclus.NET**
2. **Activa** la extensión (checkbox "Authentik SSO Enabled")
3. **Guarda** la configuración

### **Paso 2: Configurar Authentik**

1. **Copia la URL de Callback** que se muestra (es de solo lectura)
2. **Ve a tu instancia de Authentik**
3. **Crea una aplicación OAuth2/OpenID**
4. **Configura las URLs**:
   - Authorization URL: `https://tu-paymenter.com/oauth/authentik`
   - Callback URL: `https://tu-paymenter.com/oauth/authentik/callback` (la que copiaste)

### **Paso 3: Configurar Paymenter**

1. **Copia el Client ID** de Authentik
2. **Copia el Client Secret** de Authentik
3. **Pega los valores** en los campos correspondientes
4. **Configura la Base URL** de tu instancia Authentik
5. **Guarda** la configuración

### **Paso 4: Personalizar (Opcional)**

1. **Configura el texto del botón** (ej: "Acceso Corporativo")
2. **Añade una imagen** (URL de tu logo)
3. **Personaliza los colores** del botón
4. **Guarda** los cambios

## 🎨 Personalización del Botón

### **Ejemplo de Configuración Completa:**

```json
{
  "button_text": "Acceso Corporativo",
  "button_image": "https://tu-servidor.com/logo.png",
  "button_image_alt": "Logo de la empresa",
  "button_bg_color": "#1E40AF",
  "button_text_color": "#FFFFFF"
}
```

### **Colores Recomendados:**

- **Azul Corporativo**: `#1E40AF` (fondo) + `#FFFFFF` (texto)
- **Verde Corporativo**: `#047857` (fondo) + `#FFFFFF` (texto)
- **Gris Corporativo**: `#374151` (fondo) + `#FFFFFF` (texto)

## 🧪 Probar la Configuración

### **Script de Prueba:**

```bash
cd /var/www/paymenter
php extensions/Others/Authentik/test_extension.php
```

### **Verificación Manual:**

1. **Ve a la página de login** de Paymenter
2. **Verifica que aparece el botón** de Authentik
3. **Haz clic en el botón** para probar la redirección
4. **Completa el login** en Authentik
5. **Verifica que regresas** a Paymenter correctamente

## 🆘 Solución de Problemas

### **Si no ves las descripciones:**

- **Actualiza la página** del navegador
- **Verifica que la extensión esté activada**
- **Revisa la consola del navegador** para errores

### **Si el Callback URL no funciona:**

- **Verifica que la URL sea exacta** (sin espacios, con https://)
- **Asegúrate de que tu dominio** sea accesible desde internet
- **Verifica que el puerto** sea correcto (443 para HTTPS)

### **Si no aparece el botón:**

- **Verifica que la extensión esté activada**
- **Revisa que todos los campos requeridos** estén configurados
- **Limpia la caché** del navegador

## 📞 Soporte

Si tienes problemas:

1. **Revisa los logs** de Laravel: `storage/logs/laravel.log`
2. **Ejecuta el script de prueba** para verificar la configuración
3. **Consulta la documentación** de Authentik
4. **Contacta el soporte** de ForclusNET