LDAP / Active Directory é uma solução de autenticação empresarial desenvolvida pela Microsoft.
¶ Configuração
- Na Área de Administração do seu wiki, clique em Autenticação na navegação à esquerda.
- Clique em LDAP / Active Directory.
- Insira a URL do LDAP onde o servidor LDAP pode ser alcançado.
- Insira o nome distinto em Admin Bind DN da conta usada para vinculação.
- Insira a senha em Admin Bind Credentials para a conta especificada acima.
- Insira a base DN para pesquisar usuários, no campo Search Base.
- Insira a consulta para corresponder um usuário com o nome de usuário/email inserido no campo Search Filter. O valor DEVE incluir a tag
{{username}}. Por exemplo, se o nome de usuário estiver armazenado no campouid, a consulta seria(uid={{username}}). A tag{{username}}será interpolada em tempo de execução ao realizar a pesquisa (a configuração padrão do Active Directory deve ser(sAMAccountName={{username}})). - Se um certificado TLS precisar ser fornecido ao servidor LDAP, habilite a opção Use TLS e insira o caminho absoluto para o arquivo de certificado no campo TLS Certificate Path.
- Caso os campos do seu diretório sejam diferentes dos utilizados pelo Wiki.js, você pode especificar um mapeamento para cada um usando os seguintes campos:
- Unique ID Field Mapping
- Email Field Mapping
- Display Name Field Mapping
- Avatar Picture Field Mapping
- Habilite a opção Self-registration. (a menos que você planeje autorizar usuários manualmente)
- Selecione o grupo ao qual novos usuários devem ser atribuídos quando fizerem login pela primeira vez.
- Certifique-se de que a caixa de seleção ao lado de LDAP / Active Directory na lista de estratégias esteja marcada. O texto agora deve dizer que a estratégia está ativa.
- Clique em Aplicar no canto superior direito da página para salvar e aplicar a configuração.
¶ Testar Sua Configuração
Salvar sua configuração LDAP não realiza uma conexão com o seu servidor LDAP. Você precisa realizar um login real para estabelecer uma conexão.
Para fazer isso, abra uma janela anônima no seu navegador e tente fazer login no seu wiki com um usuário do seu diretório.
¶ Solução de Problemas
Se você encontrar erros ao tentar fazer login, pode habilitar uma flag de depuração LDAP para relatar mensagens de erro internas do LDAP no console (ou nos logs do docker).
Na Área de Administração, clique em Ferramentas de Desenvolvedor na barra lateral, depois em Flags. Habilite a flag LDAP Debug.
Ao usar docker, digite o comando
docker logs wikipara visualizar os logs (supondo um contêiner chamadowiki).
