> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Configurando o ClickHouse para usar LDAP para autenticação e mapeamento de funções > Descreve como configurar o ClickHouse para usar LDAP para autenticação e mapeamento de funções Esta página não se aplica ao [ClickHouse Cloud](https://clickhouse.com/cloud). O recurso documentado aqui não está disponível nos serviços do ClickHouse Cloud. Consulte o guia [Compatibilidade com Cloud](/pt-BR/products/cloud/guides/cloud-compatibility) do ClickHouse para mais informações. O ClickHouse pode ser configurado para usar LDAP na autenticação de usuários de banco de dados do ClickHouse. Este guia apresenta um exemplo simples de integração do ClickHouse com um sistema LDAP para autenticação em um diretório disponível publicamente. ## Configure as definições de conexão LDAP no ClickHouse 1. Teste a conexão com este servidor LDAP público: ```bash theme={null} $ ldapsearch -x -b dc=example,dc=com -H ldap://ldap.forumsys.com ``` A resposta será semelhante a esta: ```response theme={null} # LDIF estendido # # LDAPv3 # base with scope subtree # filter: (objectclass=*) # requesting: ALL # # example.com dn: dc=example,dc=com objectClass: top objectClass: dcObject objectClass: organization o: example.com dc: example ... ``` 2. Edite o arquivo `config.xml` e adicione o seguinte para configurar o LDAP: ```xml theme={null} ldap.forumsys.com 389 uid={user_name},dc=example,dc=com no never ``` As tags `` são um rótulo arbitrário usado para identificar um servidor LDAP específico. Estas são as configurações básicas usadas acima: | Parâmetro | Descrição | Exemplo | | ------------------ | ----------------------------------------- | ----------------------------------- | | host | hostname ou IP do servidor LDAP | ldap.forumsys.com | | port | porta do diretório no servidor LDAP | 389 | | bind\_dn | caminho de modelo para os usuários | `uid={user_name},dc=example,dc=com` | | enable\_tls | se deve usar LDAP seguro | no | | tls\_require\_cert | se deve exigir certificado para a conexão | never | Neste exemplo, como o servidor público usa a porta 389 e não usa uma porta segura, desativamos o TLS para fins de demonstração. Consulte a [página da documentação de LDAP](/pt-BR/concepts/features/security/external-authenticators/ldap) para mais detalhes sobre as configurações de LDAP. 3. Adicione a seção `` à seção `` para configurar o mapeamento de roles do usuário. Esta seção define quando um usuário é autenticado e qual role ele receberá. Neste exemplo básico, qualquer usuário autenticado via LDAP receberá a `scientists_role`, que será definida em uma etapa posterior no ClickHouse. A seção deve ficar semelhante a esta: ```xml theme={null} users.xml /var/lib/clickhouse/access/ test_ldap_server dc=example,dc=com (&(objectClass=groupOfUniqueNames)(uniqueMember={bind_dn})) cn ``` Estas são as configurações básicas usadas acima: | Parâmetro | Descrição | Exemplo | | -------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | server | rótulo definido na seção ldap\_servers anterior | test\_ldap\_server | | roles | nome das roles definidas no ClickHouse para as quais os usuários serão mapeados | scientists\_role | | base\_dn | caminho base para iniciar a busca pelos grupos do usuário | dc=example,dc=com | | search\_filter | filtro de busca LDAP para identificar os grupos a serem selecionados no mapeamento de usuários | `(&(objectClass=groupOfUniqueNames)(uniqueMember={bind_dn}))` | | attribute | nome do atributo cujo valor deve ser retornado | cn | 4. Reinicie o servidor ClickHouse para aplicar as configurações. ## Configure roles e permissões do banco de dados ClickHouse Os procedimentos desta seção presumem que o SQL Access Control and Account Management no ClickHouse esteja habilitado. Para habilitá-lo, consulte o [guia SQL Users and Roles](/pt-BR/concepts/features/security/access-rights). 1. Crie uma role no ClickHouse com o mesmo nome usado na seção de mapeamento de roles do arquivo `config.xml` ```sql theme={null} CREATE ROLE scientists_role; ``` 2. Conceda os privilégios necessários à role. A instrução a seguir concede privilégios de admin a qualquer usuário que consiga se autenticar via LDAP: ```sql theme={null} GRANT ALL ON *.* TO scientists_role; ``` ## Teste a configuração do LDAP 1. Faça login usando o clickhouse client ```bash theme={null} $ clickhouse-client --user einstein --password password ClickHouse client version 22.2.2.1. Connecting to localhost:9000 as user einstein. Connected to ClickHouse server version 22.2.2 revision 54455. chnode1 :) ``` Use o comando `ldapsearch` na etapa 1 para ver todos os usuários disponíveis no diretório; para todos eles, a senha é `password` 2. Verifique se o usuário foi mapeado corretamente para a função `scientists_role` e se tem permissões de Admin ```sql theme={null} SHOW DATABASES ``` ```response theme={null} Query id: 93b785ff-1482-4eda-95b0-b2d68b2c5e0f ┌─name───────────────┐ │ INFORMATION_SCHEMA │ │ db1_mysql │ │ db2 │ │ db3 │ │ db4_mysql │ │ db5_merge │ │ default │ │ information_schema │ │ system │ └────────────────────┘ 9 rows in set. Elapsed: 0.004 sec. ```
## Resumo
Este artigo apresentou o básico da configuração do ClickHouse para autenticar em um servidor LDAP e também para mapear uma função. Também há opções para configurar usuários individuais no ClickHouse e fazer com que esses usuários sejam autenticados pelo LDAP, sem configurar o mapeamento automático de funções. O módulo LDAP também pode ser usado para se conectar ao Active Directory.