Pruebas y resolución de problemas - Google, GitHub y Facebook
Probar la integración
Abre la pantalla de inicio de sesión en una ventana privada y comprueba que el botón de cada proveedor activado es visible. Inicia sesión con él en una cuenta de prueba, confirma que vuelves al panel con la sesión iniciada y - si la cuenta tiene activada la verificación en dos pasos - que el panel ha pedido el segundo factor. Prueba también el registro: una cuenta nueva creada a través de un proveedor que verifica direcciones debería tener acceso al panel de inmediato, sin pantalla de verificación por correo.
Problemas habituales
El botón de un proveedor no aparece en la pantalla de inicio de sesión
Un proveedor solo es visible cuando su interruptor está activado y tiene ambas claves OAuth configuradas en los ajustes de la plataforma. Una clave que falta y un proveedor desactivado dan exactamente el mismo resultado - ningún botón, ningún mensaje de error, porque desde el punto de vista de quien visita la página el proveedor simplemente no existe. Visitar directamente su dirección termina en 404, no en 403.
DockRay pide una contraseña tras intentar iniciar sesión con Facebook
Es un comportamiento intencionado, no un fallo. Facebook no garantiza un correo confirmado, así que DockRay nunca engancha un inicio de sesión de Facebook a una cuenta existente solo por el correo - de lo contrario, bastaría con crear allí un perfil con la dirección de otra persona para entrar en su cuenta. Quien tenga una cuenta existente con esa dirección debe iniciar sesión con contraseña (o con Google o GitHub, si los tiene vinculados) y solo después conectar de forma consciente el inicio de sesión de Facebook desde el panel, si esa opción está disponible.
El inicio de sesión falla con un error de falta de correo
Ocurre cuando el perfil del proveedor no tiene una dirección visible - por ejemplo, GitHub con el correo oculto en los ajustes de privacidad, o Facebook sin una dirección confirmada en el perfil. DockRay nunca crea una cuenta sin correo, porque esa cuenta no tendría forma de restablecer la contraseña ni de recibir notificaciones. La solución está del lado del proveedor: hay que mostrar o añadir una dirección en los ajustes de la cuenta allí.
La consola del proveedor indica que el Redirect URI no coincide
El Redirect URI introducido en la consola del proveedor debe coincidir exactamente con el que muestra el panel de DockRay en los ajustes de la plataforma. La causa más habitual del desajuste es una errata, la falta del esquema HTTPS o una dirección introducida para un entorno distinto de aquel desde el que realmente estás probando el inicio de sesión.
Una cuenta no inicia sesión a pesar de una autenticación correcta en el proveedor
El proveedor solo demuestra la identidad - el acceso lo decide el estado de la cuenta en DockRay. Un usuario desactivado no puede iniciar sesión por ninguna vía, ni siquiera a través de un proveedor que haya confirmado correctamente quién es.
Sigue sin funcionar
Repasa la lista de comprobación de falta de datos y, si no ayuda, escríbenos. Indica el nombre del proyecto, la versión de la integración y la hora aproximada de la prueba: acorta el camino a la respuesta.