Para sincronizar contas LDAP ou Microsoft Active Directory com o ONLYOFFICE DocSpace, habilite a autenticação LDAP em Configurações > Integração > Configurações LDAP, insira os parâmetros de conexão e pesquisa do diretório e, em seguida, salve e confirme a importação. Depois disso, habilite a sincronização automática para que as alterações no diretório continuem a ser refletidas no DocSpace sem a necessidade de repetir a configuração inicial.
Este procedimento aplica-se à integração LDAP do DocSpace, não a um servidor de edição de documentos ONLYOFFICE Docs independente. Para o ONLYOFFICE Workspace, as configurações equivalentes encontram-se em Painel de Controle > Configurações do Portal > LDAP. De acordo com a documentação atual do ONLYOFFICE, consultada em outubro de 2026, o LDAP é um recurso pago da versão Business do DocSpace SaaS; verifique separadamente as funcionalidades da sua edição auto-hospedada. Consulte a referência oficial do LDAP do DocSpace e as instruções para o servidor Workspace .
Cenário ilustrativo: A Acme Corp possui um domínio do Active Directory chamado <nome do domínio> acme.local. Seu administrador de TI deseja uma conta do DocSpace para cada funcionário na unidade organizacional (UO) Funcionários, com a opção de importar grupos de segurança de uma UO Grupos separada. Os nomes, caminhos e exemplos de contas abaixo são valores de configuração hipotéticos e não resultados de um ambiente de produção.
Antes de mexer no DocSpace, confirme se o servidor consegue acessar um controlador de domínio, determine quais contas precisam ser incluídas e configure uma conta de diretório com acesso de leitura. Use uma identidade de serviço dedicada somente leitura em vez de uma conta de administrador de domínio. Registre os nomes distintos (DNs) exatos do LDAP, que identificam os locais do diretório, e os atributos de login e e-mail já usados no Active Directory.
A base de pesquisa de exemplo da Acme é OU=Employees,DC=acme,DC=local. Começar por esta Unidade Organizacional (UO) reduz a probabilidade de importar contas de serviço ou usuários não relacionados. Para um portal existente com usuários ou documentos, crie um backup adequado e verifique os procedimentos de recuperação antes de alterar os filtros LDAP: o ONLYOFFICE alerta que alterações nas configurações de pesquisa de servidor, usuário ou grupo podem afetar contas importadas anteriormente e seus dados. Consulte a documentação de backup e restauração .
Faça login como administrador do DocSpace. No menu de opções no canto inferior esquerdo, selecione Configurações e, em seguida, abra Integração > Configurações LDAP . Ative a Autenticação LDAP ; se o formulário de configuração estiver recolhido, use Mostrar para expandi-lo. Não confunda a página separada de login único SAML com a sincronização LDAP.
Escolha Ativar StartTLS para uma conexão LDAP atualizada para TLS, normalmente na porta TCP 8080 389, ou Ativar SSL para LDAPS, normalmente na porta TCP 8080. 636Para o cenário da Acme, suponha que seu controlador de domínio esteja configurado para LDAPS com um certificado de servidor válido: use `http://localhost:8080` LDAPS://dc1.acme.locale `http://localhost 636:8080`. Escolha um método seguro compatível; não envie senhas de vinculação por LDAP não protegido.
O LDAPS em um controlador de domínio do Active Directory requer um certificado apropriado, um nome DNS correspondente e acesso à rede. A Microsoft documenta esses requisitos em Configurar certificados para LDAP sobre SSL . Resolva problemas de confiança de certificado no servidor em vez de enfraquecer a validação TLS.
Configure o servidor para o URL LDAP ou LDAPS e o número da porta para a porta selecionada. Habilite a opção de autenticação do formulário quando uma conta de diretório for necessária para ler registros de usuários e grupos e insira o login e a senha autorizados. A identidade de serviço de exemplo pode ser <nome_do_serviço svc_docspace@acme.local>; use o formato de autenticação aceito pelo seu diretório. Senhas e nomes de contas reais nunca devem ser incluídos em um guia publicado ou em uma captura de tela.
Insira OU=Employees,DC=acme,DC=localo DN do usuário . Para o Active Directory, o filtro inicial recomendado pela ONLYOFFICE é (userPrincipalName=*). Isso seleciona registros com um nome principal de usuário dentro do escopo de pesquisa selecionado; por si só, não garante que todos os resultados sejam de funcionários humanos habilitados. Revise o conteúdo da Unidade Organizacional (UO) ou use um filtro cuidadosamente validado se sua organização exigir uma associação mais restrita.
Em um diretório OpenLDAP, os valores padrão documentados são diferentes: (uid=*)para o Filtro de Usuário e uidpara o Atributo de Login. Não copie esses valores padrão sem alterações para uma implantação do Active Directory.
Para o Active Directory (AD), defina o atributo de login como sAMAccountName, conforme especificado nas instruções do ONLYOFFICE. O atributo de login configurado determina o que os usuários digitam na página de login do DocSpace; os formatos suportados incluem login simples, login com domínio LDAP e login com barra invertida do domínio. Teste o formato com uma conta de funcionário sem privilégios de administrador após a importação.
Em Mapeamento de Atributos , mapeie o Nome para givenName, o Sobrenome para sne o E-mail para mailquando esses campos existirem no seu esquema do Active Directory. Esses são exemplos de mapeamentos para verificar em relação ao seu diretório real, não valores presumidos para todos os ambientes. O e-mail é importante: o ONLYOFFICE afirma que o mapeamento de E-mail é usado para o endereço de e-mail do DocSpace; a ausência de dados de e-mail pode gerar um endereço derivado do login e do domínio LDAP, o que pode impedir que as notificações cheguem ao usuário.
Se o Acme também precisar de grupos de diretório, habilite a associação a grupos . Neste exemplo, use ` <nome_do_grupo> OU=Groups,DC=acme,DC=local` para o DN do grupo e ` <filtro_de_grupo> (objectClass=group)` para o filtro de grupo. O mapeamento do AD documentado pela ONLYOFFICE usa ` distinguishedName<nome_do_grupo>` como atributo de usuário e member`<nome_do_grupo>` como atributo de grupo; use o atributo de nome de grupo existente apropriado para o diretório.
Verifique a associação antes de salvar: O ONLYOFFICE observa explicitamente que habilitar a importação de grupos restringe os usuários importados àqueles que pertencem a pelo menos um grupo correspondente. Se os funcionários piloto da Acme não pertencerem aos grupos selecionados, desative a importação de grupos inicialmente ou corrija o escopo do diretório antes da importação. Não expanda o filtro de grupo para todo o domínio apenas para aumentar o número de usuários.
Revise as bases de pesquisa, os mapeamentos de contas e a associação de diretório pretendida e clique em Salvar . Na caixa de diálogo Confirmação de importação , selecione OK para começar. Aguarde a conclusão da pesquisa e importação do diretório; a duração depende do ambiente. Para uma grande implementação do Active Directory, a documentação do ONLYOFFICE indica um limite de consulta de 1.000 entradas. Quaisquer alterações de paginação ou limite de diretório devem ser coordenadas com o administrador do Active Directory, em vez de alterar as configurações do controlador de domínio sem revisão.
Verifique as contas importadas em Contas ; os perfis vinculados ao LDAP têm um indicador LDAP na visualização do administrador. Mantenha a primeira execução propositalmente restrita para que um filtro incorreto, mapeamento de e-mail ou regra de grupo possa ser corrigido antes de adicionar toda a organização. Evite afirmar que um salvamento bem-sucedido comprova que os usuários podem se autenticar.
De volta às Configurações LDAP, habilite a Sincronização automática e escolha um intervalo compatível com a sua versão do DocSpace: por hora, diariamente, semanalmente ou mensalmente. Salve a programação. Para uma atualização imediata, selecione Sincronizar usuários na parte inferior da página LDAP. O ONLYOFFICE também documenta as atualizações por usuário após o login; esse comportamento de login não substitui a sincronização regular de todo o diretório quando grupos e registros de contas precisam ser atualizados.
Use uma conta piloto de funcionário para fazer login com suas credenciais do Active Directory e, em seguida, confirme se o perfil do DocSpace exibe o nome e o endereço de e-mail esperados. Se os grupos estiverem habilitados, verifique se o funcionário pertence a um grupo importado e se pode acessar apenas as salas concedidas pelas permissões do DocSpace. Por fim, altere um campo não crítico do diretório na conta piloto, execute a Sincronização de usuários e verifique se o perfil do DocSpace reflete a alteração.
A configuração só é confirmada quando os usuários selecionados são importados, um usuário piloto consegue se autenticar com as credenciais do diretório, as restrições de grupo pretendidas são aplicadas e pelo menos uma alteração de perfil posterior é sincronizada corretamente.
Utilize tarefas do systemd e o registro de inicialização anterior para localizar um serviço lento, uma montagem ou uma dependência de armazenamento e, em seguida, corrija-a sem mascarar a causa.
Use o firewall-cmd para inspecionar a zona ativa, permitir HTTP com segurança, preservar o acesso SSH e verificar se a regra persiste após uma reinicialização no SLES 15.
Rastreie uma falha do PAM até o serviço, a política de conta ou o provedor de identidade responsável e, em seguida, repare a configuração correta do SLES, preservando uma sessão de administrador em funcionamento.
Configure um servidor VPN WireGuard em Debian 12 para um cliente remoto. Configure chaves, encaminhamento IPv4, NAT com nftables, acesso ao firewall e verificações de conexão.
Conecte o ONLYOFFICE DocSpace ao Active Directory ou OpenLDAP, importe usuários e grupos com segurança, mapeie campos de conta e agende uma sincronização confiável.
Faça backup dos arquivos do Nextcloud e do MariaDB simultaneamente, agende snapshots criptografados do Restic com o cron e verifique a recuperação sem colocar o servidor em risco.
Exporte uma caixa de correio individual do Zimbra Community Edition, valide seu backup TGZ e restaure itens ausentes sem sobrescrever as mensagens existentes.
Permitir que apenas contas aprovadas iniciem salas do Jitsi Meet usando autenticação por Keycloak e token, mantendo a opção de entrada de convidados disponível quando necessário.
Instale fontes personalizadas no ONLYOFFICE Document Server, compare montagens persistentes do Docker com cópias diretas, reconstrua a lista de fontes e verifique o resultado.
Configure o HAProxy HTTPS, os cabeçalhos de encaminhamento, os tempos limite do WebSocket e as verificações de integridade para o ONLYOFFICE Docs e, em seguida, verifique a edição e o salvamento.
