Virtnet.bond/extensions/Others/Authentik/COMO_VER_CONFIGURACION.md

📋 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:

{
  "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:

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