Saltar al contenido principal

Conexiones OAuth

Algunos conectores inician sesión en el otro sistema con OAuth 2.0 en lugar de un token pegado. MonoPbx guarda una conexión OAuth por cada conector instalado, la renueva antes de que venza y le avisa cuando debe iniciar sesión de nuevo.

Administra las conexiones en Admin > Conexiones > Integraciones (/admin/integrations). Ver el estado requiere integrations:read. Conectar, Reconectar y Desconectar requieren integrations:write.

Conectar​

  1. Instale el conector en Integraciones y complete sus ajustes.
  2. Pulse Conectar. El navegador va al otro sistema para iniciar sesión.
  3. Autorice el acceso. El navegador regresa a /admin/integrations/oauth/callback y el estado muestra Conectado, con la hora hasta la que el token es válido.

El inicio de sesión usa el flujo de código de autorización con PKCE (S256). Un inicio de sesión pendiente es válido por diez minutos y funciona una sola vez. Un inicio de sesión que venció, que ya se usó o que pertenece a otra empresa se rechaza: pulse Conectar de nuevo.

El botón Conectar se muestra solo para los conectores que tienen un proveedor OAuth en su PBX. El operador registra MonoPbx como app en cada sistema y la incluye en el archivo de proveedores indicado por MPBX_INTEGRATIONS_OAUTH_FILE; la dirección de redirección que debe registrar es https://<su PBX>/admin/integrations/oauth/callback.

Estado​

EstadoSignificado
Sin conectarSin inicio de sesión.
ConectadoLos tokens funcionan.
Inicia sesión de nuevoEl otro sistema rechazó definitivamente renovar los tokens (por ejemplo invalid_grant, invalid_client o una respuesta 401). Pulse Reconectar.

MonoPbx renueva el token de acceso unos cinco minutos antes de que venza (como máximo la mitad de su duración) y conserva un token de actualización que el otro sistema rote. Un fallo temporal conserva el token anterior y se reintenta después de 1, 2, 4 minutos y así sucesivamente, hasta una hora. Un rechazo permanente establece Inicia sesión de nuevo y genera el evento integration.needs_reconnect, que puede recibir en el WebSocket de eventos y en los webhooks.

Desconectar y quitar​

Desconectar pide al otro sistema que revoque los tokens y luego los elimina de MonoPbx. La integración deja de funcionar hasta que vuelva a conectarla. Si no se puede contactar al otro sistema, los tokens se eliminan de todos modos en MonoPbx y la revocación se intenta en la medida de lo posible. Desinstalar la integración hace lo mismo.

Los tokens se sellan con la clave de su empresa. Ninguna pantalla ni respuesta de la API devuelve uno, y ninguno se escribe en un registro.

API​

LlamadaPermiso
GET /api/v1/integrations/installs/{id}/oauth: si el conector inicia sesión con OAuth aquí, y sus conexionesintegrations:read
POST /api/v1/integrations/installs/{id}/oauth/start: la dirección que se abreintegrations:write
POST /api/v1/integrations/oauth/callback: termina el inicio de sesión con state y codeintegrations:write
DELETE /api/v1/integrations/installs/{id}/oauth/{connection_id}: desconectaintegrations:write

Límites​

  • La consola muestra e inicia la conexión de la empresa.
  • Las direcciones de inicio de sesión de un proveedor son fijas por conector, así que un conector cuyas direcciones dependen de la cuenta (Kommo, Bitrix24) funciona para una cuenta por PBX. Vea Kommo, Bitrix24 y Odoo.
  • Jira, la sincronización de calendarios y las plantillas de CRM conservan su propio inicio de sesión.