152 lines
5.2 KiB
Markdown
152 lines
5.2 KiB
Markdown
# 📋 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
|