145 lines
3.9 KiB
Markdown
145 lines
3.9 KiB
Markdown
# 🔗 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:**
|
|
|
|
```bash
|
|
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
|