¿Cómo puedo solucionar errores de autenticación y autorización de OAuth al conectar una integración?
Los errores de autorización de OAuth ocurren cuando un proveedor externo no puede completar o aceptar la solicitud de autorización de una aplicación.
Estos errores pueden ocurrir durante la conexión inicial, al renovar el acceso o al realizar una operación que requiere permisos adicionales.
Errores comunes relacionados con OAuth
Acceso denegado
La solicitud de autorización fue rechazada, cancelada o bloqueada por las políticas del proveedor.
Ámbito no válido
La aplicación solicitó un permiso que es inválido, no es compatible o no está disponible para la cuenta externa.
Ámbito insuficiente
La autorización existente no incluye el permiso requerido para la operación solicitada.
Concesión no válida
Un código de autorización o token puede haber expirado, sido revocado, ser inválido o inaceptable para el proveedor.
Cliente no válido
El proveedor no pudo validar las credenciales o la configuración del cliente de la aplicación.
Desajuste de URI de redirección
La dirección de callback de autorización no coincide con la dirección registrada con el proveedor externo.
Aprobación del administrador requerida
El proveedor requiere que un administrador autorice el acceso solicitado.
Cómo solucionar errores de OAuth
Paso 1: Identificar el error.
Registra el mensaje exacto o el código de error que se muestra durante la autorización.
Paso 2: Confirmar la cuenta externa correcta.
Verifica que estés iniciando sesión en la cuenta u organización deseada.
Paso 3: Revisar los permisos solicitados.
Determina si la cuenta está autorizada para otorgar el acceso requerido.
Paso 4: Verificar restricciones del administrador.
Algunas organizaciones restringen el acceso a aplicaciones de terceros o requieren consentimiento administrativo.
Paso 5: Reiniciar el flujo de autorización.
Si la sesión de autorización ha expirado o se ha interrumpido, comienza el proceso de conexión nuevamente.
Paso 6: Verificar restricciones del navegador.
Asegúrate de que la página de autenticación del proveedor y el flujo de redirección puedan completarse.
Paso 7: Verificar la disponibilidad del servicio externo.
Una interrupción o incidente de autenticación puede interrumpir la autorización.
Paso 8: Reautorizar cuando sea apropiado.
Si las credenciales existentes han expirado o han sido revocadas, utiliza el procedimiento de conexión admitido para establecer una nueva autorización.
Paso 9: Probar la operación deseada.
Después de que la autorización tenga éxito, confirma que la funcionalidad requerida funcione.
¿Puedo solucionar un error de cliente no válido o de URI de redirección yo mismo?
Estos errores a menudo implican la configuración a nivel de aplicación en lugar de permisos individuales de usuario.
Si la conexión es gestionada por Polyosync y el problema persiste, contacta con Soporte.
Si estás configurando una integración personalizada, verifica la configuración de la aplicación registrada del proveedor.
¿Debo compartir un código de autorización de OAuth con Soporte?
No.
Los códigos de autorización, tokens de acceso, tokens de actualización, secretos de cliente y otras credenciales deben mantenerse confidenciales.
¿Qué información es útil para la solución de problemas?
Proporciona el nombre de la integración, el código de error, la marca de tiempo aproximada y el punto en el que falló la autorización.
Enfoque recomendado
Identifica si el problema se refiere al consentimiento del usuario, permisos del proveedor, autorización expirada o configuración de la aplicación antes de intentar cambios.