Files
Virtnet.bond/extensions/Others/Authentik/README.md
2025-11-30 11:57:22 +01:00

2.5 KiB

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.