Saltar al contenido principal

Integración

Configuración de integración​

La sección de Integración se utiliza para habilitar la configuración de LDAP, habilitar la configuración de SSO, añadir plugins, integrar tu espacio de trabajo con servicios de terceros y ajustar la configuración de SMTP. También puedes comprobar o configurar los ajustes del Servicio de Documentos.

Configuración de LDAP​

Al usar ONLYOFFICE Apps, lo primero que necesitas hacer es crear cuentas para todos los empleados de tu empresa. Pero si son más de 50 personas, el proceso de creación de nuevos usuarios del espacio de trabajo tomará mucho tiempo. La opción de Configuración de LDAP te permite importar los usuarios y grupos necesarios desde un Servidor LDAP (por ejemplo, OpenLDAP Server o Microsoft Active Directory) a tu espacio de trabajo, literalmente, en varios minutos. Los usuarios recién creados, a su vez, no necesitan memorizar nuevas contraseñas e inicios de sesión porque iniciarán sesión en el espacio de trabajo usando sus credenciales almacenadas en tu Servidor LDAP.

En la versión SaaS, esta es una función de pago (disponible solo para el plan Business de pago).

Rellena los campos requeridos y haz clic en Guardar.

Configuración de LDAP - Página principal

Para obtener información más detallada sobre cada campo y los valores correspondientes, consulta las siguientes instrucciones.

Configuración de inicio de sesión único​

La sección de Inicio de Sesión Único te permite habilitar/deshabilitar la autenticación de terceros usando SAML, proporcionando así a los usuarios una forma más rápida, fácil y segura de acceder al espacio de trabajo.

En la versión SaaS, esta es una función de pago (disponible solo para el plan Business de pago).

Generalmente, la tecnología de Inicio de Sesión Único permite a los usuarios iniciar sesión solo una vez y luego obtener acceso a múltiples aplicaciones/servicios autorizados (es decir, integrados con un Proveedor de Identidad) sin tener que ingresar sus credenciales cada vez que acceden a una aplicación diferente.

Habilitar la autenticación SSO

Para obtener más información sobre cómo configurar SSO, lee este artículo.

Extensiones​

Añade plugins para extender tu espacio de trabajo con características adicionales.

Existen dos tipos de plugins: los del sistema, que desarrollamos nosotros mismos, y los personalizados. Puedes cargar un plugin personalizado en esta página si esta opción está habilitada en la configuración.

En la versión SaaS, existen algunas restricciones:

  • El plugin puede cargarse en formato zip y debe tener la siguiente estructura:

    - config.json
    - plugin.js
    - assets
    - image1
    - ...
    - imageN
  • El tamaño máximo del archivo y de cada archivo está limitado a 5 MB.

  • El número máximo de imágenes es 10.

  • La lista de formatos de imagen está limitada a los siguientes: .jpg, .jpeg, .png, .svg.

Actualmente, los siguientes plugins del sistema están disponibles: draw.io, pdf-converter, speech-to-text, markdown, zip-archives, image-editor, codemirror.

En la versión del servidor, puedes eliminar plugins del sistema, si la configuración y los ajustes lo permiten.

Las versiones incompatibles de plugins se resaltan en rojo. Al pasar el cursor sobre una versión de plugin desactualizada o al cargar un nuevo plugin personalizado, se te pedirá que actualices el plugin a una versión compatible.

Herramientas de desarrollo

nota

Al cargar la misma versión de un plugin que ya está instalado, se muestra una advertencia sobre un posible almacenamiento en caché. Asegúrate de borrar la caché del plugin o de incrementar el número de versión para que tus cambios surtan efecto.

Advertencia de plugins

Para más detalles sobre el SDK de plugins, consulta api.onlyoffice.com

Integración con servicios de terceros​

Utiliza claves de autorización para conectar tu espacio de trabajo con servicios de terceros: Amazon AWS S3, Apple, Box.com, DropBox, Facebook, Google Cloud Storage, LinkedIn, Nextcloud, OneDrive, Telegram, X, Rackspace Cloud Storage, WeChat, Zoom.

En la versión SaaS, algunos servicios están disponibles solo para el plan Business de pago (Amazon AWS S3, Google Cloud Storage, Rackspace Cloud Storage).

  • Conecta tu cuenta de Apple, FB, LinkedIn, Nextcloud, X, WeChat, Zoom para iniciar sesión rápidamente en tu espacio de trabajo. En la versión en la nube, los parámetros de las claves de autorización para estos servicios se configuran automáticamente. La integración con Zoom está actualmente disponible solo en la versión del servidor.
  • Conecta tu espacio de trabajo con Box, Dropbox, OneDrive para usar la cuenta conectada como un recurso de terceros al crear copias de seguridad. En la versión en la nube, los parámetros de las claves de autorización para estos servicios se configuran automáticamente.
  • Conecta el servicio Amazon AWS S3, Google Cloud Storage, Rackspace Cloud Storage para usar el almacenamiento en la nube conectado como un almacenamiento de terceros al crear copias de seguridad.
  • Conecta el servicio de Telegram para recibir notificaciones del espacio de trabajo a través de Telegram.

Para más detalles sobre la integración con servicios de terceros, consulta nuestras instrucciones.

Ajustar la configuración de integración

Configuración de SMTP​

La subsección de Configuración de SMTP te permite configurar tu espacio de trabajo para que las notificaciones por correo electrónico se envíen utilizando tu propio servidor SMTP. Para ello,

  • En el campo Host, especifica el nombre de dominio del servidor SMTP que utilizas.

  • En el campo Puerto, especifica el número de puerto SMTP. Se recomienda usar el puerto 587 o 25.

  • Activa el interruptor de Autenticación si el servidor SMTP requiere autenticación.

  • En los campos Inicio de sesión del host y Contraseña del host, especifica el inicio de sesión y la contraseña que utilizas para acceder al servidor SMTP.

  • Marca la casilla Autenticación vía NTLM para poder iniciar sesión usando SaslMechanismNtlm.

  • En el campo Nombre de visualización del remitente, especifica el nombre del remitente que se mostrará en el campo De:.

  • En el campo Dirección de correo electrónico del remitente, especifica la dirección de correo electrónico del remitente.

  • Marca la casilla Habilitar SSL para habilitar conexiones encriptadas.

  • Haz clic en el botón Guardar. Para descartar tus cambios y volver al servidor predeterminado, haz clic en el botón Configuración predeterminada.

    nota

    Para verificar si la configuración especificada es correcta, haz clic en el botón Enviar correo de prueba. Si la configuración es correcta, recibirás el Mensaje de prueba SMTP en la dirección de correo electrónico especificada en tu perfil de usuario.

Ajustar la configuración de SMTP

Configuración del Servicio de Documentos​

La subsección Servicio de Documentos muestra la configuración del servicio ONLYOFFICE Docs utilizado para editar y convertir archivos al formato OfficeOpen XML. En la versión SaaS, muestra el servicio que tu espacio de trabajo utiliza de forma predeterminada. En la versión del servidor, puedes conectar aquí tu propio ONLYOFFICE Docs. Para hacerlo:

nota

Para ejecutar el motor de edición de ONLYOFFICE en la nube y conectarlo a tu propia plataforma en su lugar, utiliza Docs Connect.

  1. Ve a Configuración del espacio de trabajo y selecciona la sección Integración > Servicio de Documentos.

  2. Rellena el campo Dirección del Servicio de Edición de Documentos. Especifica la dirección URL donde está instalado ONLYOFFICE Docs. Si instalas ONLYOFFICE Docs en un puerto personalizado, debes especificar el puerto, por ejemplo: http://127.0.0.1:8081/

    Importante

    La dirección de ONLYOFFICE Docs debe ser accesible desde ONLYOFFICE Apps, así como la dirección de ONLYOFFICE Apps debe ser accesible desde ONLYOFFICE Docs.

  3. Puedes marcar la opción Desactivar verificación de certificado (inseguro) para desactivar la verificación del certificado y permitir que el espacio de trabajo establezca conexión con ONLYOFFICE Docs si estás utilizando un certificado autofirmado para tu ONLYOFFICE Docs (de lo contrario, el espacio de trabajo no validará un certificado autofirmado y no permitirá la conexión hacia/desde ONLYOFFICE Docs). Esta es una solución insegura, y recomendamos encarecidamente que reemplaces el certificado por uno emitido por una CA.

  4. Rellena el campo Clave secreta especificando el secreto utilizado para firmar los datos. Puedes dejarlo vacío para desactivar esta configuración.

    nota

    A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. También necesitas especificar los parámetros JWT en el archivo de configuración de ONLYOFFICE Apps. Para más detalles, consulta este artículo.

    Conectar ONLYOFFICE Docs

  5. Haz clic en el enlace Mostrar junto a la sección Configuración avanzada del servidor.

  6. Rellena el campo Encabezado de autorización. Puedes dejarlo vacío para usar el encabezado predeterminado.

  7. Si tu configuración de red no permite solicitudes entre ONLYOFFICE Apps instalado y ONLYOFFICE Docs utilizando las direcciones públicas, especifica direcciones para solicitudes internas en los campos correspondientes:

    • Rellena el campo Dirección del Servicio de Documentos para solicitudes internas desde el espacio de trabajo. Especifica la dirección que se utiliza para acceder a ONLYOFFICE Docs desde ONLYOFFICE Apps.
    • Rellena el campo Dirección del espacio de trabajo para solicitudes internas desde el Servicio de Documentos. Especifica la dirección que se utiliza para acceder a ONLYOFFICE Apps desde ONLYOFFICE Docs.

    Si tus instalaciones de ONLYOFFICE Docs/ONLYOFFICE Apps no están configuradas con https, por favor, asegúrate de especificar http en las direcciones.

  8. Guarda la configuración haciendo clic en el botón Guardar. Para descartar tus cambios y volver a la configuración que el espacio de trabajo utiliza de forma predeterminada, haz clic en el botón Configuración predeterminada.

Importante

Si conectaste editores externos instalados en otra máquina, por favor duplica el archivo de licencia que subiste al espacio de trabajo en esta máquina externa con Docs también.

Por ejemplo, en la máquina con la versión Docker de Docs, la ruta predeterminada es /var/www/onlyoffice/Data/license.lic Puedes consultar este artículo para encontrar rutas para otros sistemas operativos.