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

🔗 Información sobre la URL de Callback

📋 ¿Qué es la URL de Callback?

La URL de Callback es una URL fija que debe configurarse exactamente igual en Authentik y en Paymenter. Es la URL a la que Authentik redirige al usuario después de completar la autenticación.

🔒 ¿Por qué es de Solo Lectura?

La URL de Callback NO debe modificarse porque:

1. Es una URL fija que debe coincidir exactamente con la configuración de Authentik
2. Cambiarla rompería la autenticación
3. Es generada automáticamente basada en tu dominio de Paymenter
4. Debe ser consistente entre Authentik y Paymenter

📍 Dónde Ver la URL de Callback

En el Panel de Administración:

1. Ve a Extensiones > Authentik SSO
2. Busca el campo "URL de Callback (Solo lectura)"
3. Copia la URL que se muestra (ej: https://tu-dominio.com/oauth/authentik/callback)

Ejemplo de URL de Callback:

https://paymenter.tudominio.com/oauth/authentik/callback

⚙️ Cómo Configurar en Authentik

Paso 1: Crear la Aplicación en Authentik

1. Inicia sesión en tu instancia de Authentik
2. Ve a Applications > Create
3. Selecciona "OAuth2/OpenID Provider"

Paso 2: Configurar las URLs

En la configuración de la aplicación:

1. Authorization URL:

   https://tu-dominio.com/oauth/authentik
   

2. Callback URL (copia exacta del panel de Paymenter):

   https://tu-dominio.com/oauth/authentik/callback
   

Paso 3: Configurar los Scopes

Asegúrate de activar estos scopes:

• ✅ openid
• ✅ email
• ✅ profile

Paso 4: Copiar las Credenciales

1. Copia el Client ID
2. Copia el Client Secret
3. Pega estos valores en la configuración de Paymenter

🔧 Configuración Completa

En Authentik:

Application Name: Paymenter SSO
Authorization URL: https://tu-dominio.com/oauth/authentik
Callback URL: https://tu-dominio.com/oauth/authentik/callback
Scopes: openid, email, profile

En Paymenter:

Client ID: [copiado de Authentik]
Client Secret: [copiado de Authentik]
Base URL: https://authentik.tudominio.com
Callback URL: https://tu-dominio.com/oauth/authentik/callback (solo lectura)

🚨 Errores Comunes

Error: "Invalid redirect_uri"

• Causa: La URL de Callback no coincide exactamente
• Solución: Verifica que la URL sea idéntica en Authentik y Paymenter

Error: "Callback URL not configured"

• Causa: No se configuró la URL de Callback en Authentik
• Solución: Añade la URL de Callback en la configuración de Authentik

Error: "Domain mismatch"

• Causa: El dominio en la URL no coincide con tu dominio real
• Solución: Verifica que uses el dominio correcto (con o sin www)

📝 Notas Importantes

1. La URL debe usar HTTPS en producción
2. No debe tener espacios ni caracteres especiales
3. Debe ser accesible desde internet
4. No debe terminar con una barra diagonal (/)
5. Debe coincidir exactamente entre Authentik y Paymenter

🧪 Verificar la Configuración

Prueba Manual:

1. Ve a la página de login de Paymenter
2. Haz clic en "Iniciar sesión con Authentik"
3. Verifica que te redirige a Authentik
4. Completa el login en Authentik
5. Verifica que regresas a Paymenter correctamente

Script de Prueba:

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

🔄 Actualización de la URL

Si cambias tu dominio:

1. Actualiza la configuración en Authentik
2. La URL en Paymenter se actualizará automáticamente
3. Reinicia la aplicación si es necesario

📞 Soporte

Si tienes problemas con la URL de Callback:

1. Verifica la configuración en Authentik
2. Revisa los logs de Laravel
3. Consulta la documentación de Authentik
4. Contacta el soporte de ForclusNET