Pular para o conteúdo principal

Integração

Configurações de integração​

A seção de Integração é usada para habilitar as configurações de LDAP, habilitar as configurações de SSO, adicionar plugins, integrar o seu espaço de trabalho com serviços de terceiros e ajustar as configurações de SMTP. Você também pode verificar ou configurar as configurações do Serviço de Documentos.

Configurações de LDAP​

Ao usar o ONLYOFFICE Apps, a primeira coisa que você precisa fazer é criar contas para todos os funcionários da sua empresa. Mas se o número for superior a 50 pessoas, o processo de criação de novos usuários no espaço de trabalho levará muito tempo. A opção de Configurações de LDAP permite importar os usuários e grupos necessários de um Servidor LDAP (por exemplo, OpenLDAP Server ou Microsoft Active Directory) para o seu espaço de trabalho, literalmente, em alguns minutos. Os usuários recém-criados, por sua vez, não precisam memorizar novas senhas e logins, pois eles entrarão no espaço de trabalho usando suas credenciais armazenadas no seu Servidor LDAP.

Na versão SaaS, este é um recurso Pago (disponível apenas para o plano pago Business).

Preencha os campos obrigatórios e clique em Salvar.

Configurações de LDAP - Página principal

Para mais informações detalhadas sobre cada campo e valores correspondentes, consulte as instruções a seguir.

Configurações de single sign-on​

A seção de Single Sign-on permite habilitar/desabilitar a autenticação de terceiros usando SAML, proporcionando assim aos usuários uma maneira mais rápida, fácil e segura de acessar o espaço de trabalho.

Na versão SaaS, este é um recurso Pago (disponível apenas para o plano pago Business).

Geralmente, a tecnologia de Single Sign-on permite que os usuários façam login apenas uma vez e, em seguida, tenham acesso a vários aplicativos/serviços autorizados (ou seja, integrados com um Provedor de Identidade) sem precisar inserir suas credenciais cada vez que acessam um aplicativo diferente.

Habilitando a autenticação SSO

Para saber mais sobre como configurar o SSO, leia este artigo.

Plugins​

Adicione plugins para estender o seu espaço de trabalho com recursos extras.

Existem dois tipos de plugins: os do sistema, que desenvolvemos nós mesmos, e os personalizados. Você pode fazer upload de um plugin personalizado nesta página se essa opção estiver habilitada na configuração.

Na versão SaaS, existem algumas restrições:

  • O plugin pode ser carregado no formato zip e deve ter a seguinte estrutura:

    - config.json
    - plugin.js
    - assets
      - image1
      - ...
      - imageN

  • O tamanho máximo do próprio arquivo compactado e de cada arquivo é limitado a 5 MB;

  • O número máximo de imagens é 10;

  • A lista de formatos de imagem é limitada aos seguintes: .jpg, .jpeg, .png, .svg.

Atualmente, os seguintes plugins do sistema estão disponíveis: draw.io, pdf-converter, speech-to-text, markdown, zip-archives, image-editor, codemirror.

Na versão do servidor, você pode remover plugins do sistema, se a configuração e as definições permitirem.

As versões incompatíveis dos plugins são destacadas em vermelho. Ao passar o mouse sobre uma versão desatualizada do plugin ou ao carregar um novo plugin personalizado, você será solicitado a atualizar o plugin para uma versão compatível.

Ferramentas de desenvolvedor

observação

Ao carregar a mesma versão de um plugin que já está instalado, um aviso sobre possível armazenamento em cache é exibido. Certifique-se de limpar o cache do plugin ou incrementar o número da versão para que suas alterações entrem em vigor.

Aviso de plugins

Para mais detalhes sobre o SDK de plugins, consulte api.onlyoffice.com

Integração de serviços de terceiros​

Use chaves de autorização para conectar seu espaço de trabalho com serviços de terceiros: Amazon AWS S3, Apple, Box.com, DropBox, Facebook, Google Cloud Storage, LinkedIn, Nextcloud, OneDrive, Telegram, X, Rackspace Cloud Storage, WeChat, Zoom.

Na versão SaaS, alguns serviços estão disponíveis apenas para o plano pago Business (Amazon AWS S3, Google Cloud Storage, Rackspace Cloud Storage).

  • Conecte sua conta Apple, FB, LinkedIn, Nextcloud, X, WeChat, Zoom para fazer login rapidamente no seu espaço de trabalho. Na versão em nuvem, os parâmetros das chaves de autorização para esses serviços são configurados automaticamente. A integração com o Zoom está atualmente disponível apenas na versão do servidor;
  • Conecte seu espaço de trabalho com Box, Dropbox, OneDrive para usar a conta conectada como um recurso de terceiros ao criar backups. Na versão em nuvem, os parâmetros das chaves de autorização para esses serviços são configurados automaticamente;
  • Conecte o Amazon AWS S3, Google Cloud Storage, Rackspace Cloud Storage para usar o armazenamento em nuvem conectado como um armazenamento de terceiros ao criar backups;
  • Conecte o serviço Telegram para receber notificações do espaço de trabalho via Telegram.

Para mais detalhes sobre a integração de serviços de terceiros, consulte nossas instruções.

Ajustando as configurações de integração

Configurações de SMTP​

A subseção de Configurações de SMTP permite configurar seu espaço de trabalho para que as notificações por e-mail sejam enviadas usando seu próprio servidor SMTP. Para fazer isso:

  • No campo Host, especifique o nome de domínio do servidor SMTP que você usa;

  • No campo Porta, especifique o número da porta SMTP. Recomenda-se usar a porta 587 ou 25;

  • Ative o interruptor de Autenticação se o servidor SMTP exigir autenticação;

  • Nos campos Login do Host e Senha do Host, especifique o login e a senha que você usa para acessar o servidor SMTP;

  • Marque a caixa Autenticação via NTLM para poder fazer login usando SaslMechanismNtlm;

  • No campo Nome de Exibição do Remetente, especifique o nome do remetente que será exibido no campo De:;

  • No campo Endereço de E-mail do Remetente, especifique o endereço de e-mail do remetente;

  • Marque a caixa Habilitar SSL para habilitar conexões criptografadas;

  • Clique no botão Salvar. Para descartar suas alterações e voltar ao servidor padrão, clique no botão Configurações padrão.

    observação

    Para verificar se as configurações especificadas estão corretas, clique no botão Enviar E-mail de Teste. Se as configurações estiverem corretas, você receberá a Mensagem de Teste SMTP no endereço de e-mail especificado no seu perfil de usuário.

Ajustando as configurações de SMTP

Configurações do serviço de documentos​

A subseção Serviço de Documentos exibe as configurações do serviço ONLYOFFICE Docs usado para editar e converter arquivos para o formato OfficeOpen XML. Na versão SaaS, ela mostra o serviço que o seu espaço de trabalho usa por padrão. Na versão de servidor, você pode conectar aqui o seu próprio ONLYOFFICE Docs. Para fazer isso:

observação

Para executar o mecanismo de edição do ONLYOFFICE na nuvem e conectá-lo à sua própria plataforma, use o Docs Connect.

  1. Vá para as Configurações do espaço de trabalho e selecione a seção Integração > Serviço de Documentos;

  2. Preencha o campo Endereço do Serviço de Edição de Documentos. Especifique o endereço URL onde o ONLYOFFICE Docs está instalado. Se você instalar o ONLYOFFICE Docs em uma porta personalizada, deverá especificar a porta, por exemplo: http://127.0.0.1:8081/

    Importante

    O endereço do ONLYOFFICE Docs deve ser acessível a partir do ONLYOFFICE Apps, assim como o endereço do ONLYOFFICE Apps deve ser acessível a partir do ONLYOFFICE Docs.

  3. Você pode marcar a opção Desativar verificação de certificado (inseguro) para desativar a verificação do certificado e permitir que o espaço de trabalho estabeleça conexão com o ONLYOFFICE Docs se você estiver usando um certificado autoassinado para o seu ONLYOFFICE Docs (caso contrário, o espaço de trabalho não validará um certificado autoassinado e não permitirá a conexão com/de ONLYOFFICE Docs). Esta é uma solução insegura, e recomendamos fortemente que você substitua o certificado por um emitido por alguma CA;

  4. Preencha o campo Chave secreta especificando o segredo usado para assinar os dados. Você pode deixá-lo vazio para desativar esta configuração.

    observação

    A partir do ONLYOFFICE Docs v7.2, o JWT está habilitado por padrão e a chave secreta é gerada automaticamente. Você também precisa especificar os parâmetros JWT no arquivo de configuração do ONLYOFFICE Apps. Para mais detalhes, veja este artigo.

    Conectando o ONLYOFFICE Docs

  5. Clique no link Mostrar ao lado da seção Configurações avançadas do servidor;

  6. Preencha o campo Cabeçalho de autorização. Você pode deixá-lo vazio para usar o cabeçalho padrão;

  7. Se a configuração da sua rede não permitir solicitações entre o ONLYOFFICE Apps instalado e o ONLYOFFICE Docs usando os endereços públicos, especifique endereços para solicitações internas nos campos correspondentes:

    • Preencha o campo Endereço do Serviço de Documentos para solicitações internas do espaço de trabalho. Especifique o endereço usado para acessar o ONLYOFFICE Docs a partir do ONLYOFFICE Apps;
    • Preencha o campo Endereço do espaço de trabalho para solicitações internas do Serviço de Documentos. Especifique o endereço usado para acessar o ONLYOFFICE Apps a partir do ONLYOFFICE Docs.

    Se suas instalações do ONLYOFFICE Docs/ONLYOFFICE Apps não estiverem configuradas para https, por favor, certifique-se de especificar http nos endereços.

  8. Salve as configurações clicando no botão Salvar. Para descartar suas alterações e voltar às configurações que o espaço de trabalho usa por padrão, clique no botão Configurações padrão.

Importante

Se você conectou editores externos instalados em outra máquina, por favor, duplique o arquivo de licença que você carregou no espaço de trabalho nesta máquina externa com o Docs também.

Por exemplo, na máquina com a versão Docker do Docs, o caminho padrão é /var/www/onlyoffice/Data/license.lic Você pode consultar este artigo para descobrir os caminhos para outros sistemas operacionais.