--- schema_version: "1" id: e61a2fd563b0450366d0600569a9e02da919d21233c9501c18f1a50ec45c9b6c title: Ativar delegação do Kerberos para conectores JDBC collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/server/kerberos_delegation_jdbc.md canonical_url: https://help.tableau.com/current/server/pt-br/kerberos_delegation_jdbc.htm source_site: help.tableau.com content_type: documentation content_hash: 261a9e2d804a5028c84473db9e8ff5760c6011123a399b4bf1df3bd2123f9cf8 description: Enable Kerberos delegation for JDBC connectors in Tableau Server. --- [Pular para o conteúdo principal](#main-content) # Ativar delegação do Kerberos para conectores JDBC A partir da versão 2020.2, o Tableau Server é compatível com a delegação do Kerberos para conectores JDBC. A delegação do Kerberos permite que o Tableau Server use as credenciais do Kerberos do visualizador de uma pasta de trabalho ou exibição para executar uma consulta a pedido do visualizador. Essa opção é útil nas seguintes situações: - É preciso saber quem está acessando os dados (o nome do visualizador será exibido nos logs de acesso da fonte de dados). - Sua fonte de dados apresenta segurança em nível de linha, na qual usuários diferentes têm acesso a linhas diferentes. ## Fontes de dados compatíveis O Tableau é compatível com a autenticação RunAs do JDBC Kerberos com as seguintes fontes de dados: - Oracle - PostgreSQL Se você estiver configurando a delegação com uma fonte de dados Oracle que usa um conector JDBC, siga o procedimento neste tópico. Como alternativa, se o conector executado no Tableau Server usar um driver nativo, siga o procedimento no tópico de ajuda, [Habilitar a Delegação do Kerberos](https://help.tableau.com/current/server/pt-br/kerberos_delegation.htm). ## Requisitos A delegação do Kerberos exige o Active Directory. - O armazenamento de informações do Tableau Server deve ser configurado para usar LDAP - Active Directory. - O MIT KDC não é compatível. **Observação**: você não precisa ativar a conta Run As para atuar como sistema operacional. ## Processo de configuração Esta seção fornece um exemplo do processo para habilitar a delegação do Kerberos. 1. O Tableau Server precisará de um ticket de serviço do Kerberos para delegar em nome do usuário que está iniciando a chamada para o banco de dados. Crie uma conta de domínio que será usada para delegar ao banco de dados fornecido. Essa conta é chamada de conta de serviço Run As. Neste tópico, o usuário de exemplo configurado como a conta Run As é `tabsrv@EXAMPLE.COM`. A conta deve ser configurada para delegação no Active Directory: 1. Em um Servidor Windows conectado ao domínio do usuário, abra Usuários e computadores do Active Directory. 2. Na página **Propriedades** da conta de serviço Run As, clique na guia **Delegação** e selecione **Confiar neste usuário para a delegação apenas em serviços específicos** e **Usar qualquer protocolo de autenticação**. 2. Crie um arquivo keytab para a conta de serviço Run As. O exemplo a seguir usa a ferramenta ktab fornecida com o JDK. É possível baixar a ferramenta no [AdoptOpenJDK](https://adoptopenjdk.net/). Ao usar o ktab para criar o keytab, use um principal de logon no formato UPN (por exemplo, `service@EXAMPLE.COM`) e não um nome principal de serviço (por exemplo, `HTTP/service.example.com@EXAMPLE.COM`). Além disso, é possível gerar keytabs com o utilitário ktpass. Nesse caso, você pode usar qualquer estilo de nome principal. /bin/ktab -k E:/tmp/tabsrv.keytab -a tabsrv@EXAMPLE.COM O Tableau Server usará a conta de serviço Run As e o keytab associado para autenticar e fazer uma conexão direta com o banco de dados. 3. Copie o keytab no diretório de dados do Tableau Server e verifique se a conta de serviço Run As pode acessar e ler o arquivo keytab. Por padrão, o diretório de registro do Tableau Server encontra-se em `C:\ProgramData\Tableau`. Se estiver executando o Tableau Server em uma implantação distribuída, realize essa etapa em cada nó no cluster. 4. Crie um arquivo krb5.conf e instale em `C:\Windows` em todos os nós do Tableau Server. Se você já implantou um arquivo krb5.ini nos computadores da empresa, copie esse arquivo e use-o no Tableau Server. Para obter mais informações, consulte o tópico de Documentação do MIT Kerberos, [krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html). Para alterar a localização do arquivo de configuração Kerberos, execute o seguinte comando TSM: tsm configuration set -k native\_api.kerberos\_config\_path --force-keys -v "C:\\temp\\krb5.ini" O exemplo a seguir mostra um arquivo krb5.conf. O Suporte do Tableau não pode ajudar na criação do krb5.conf. \[libdefaults\] forwardable = true default\_realm = EXAMPLE.COM default\_tkt\_enctypes = rc4-hmac default\_tgs\_enctypes = rc4-hmac \[realms\] EXAMPLE.COM = { kdc = kdc.example.com admin\_server = kdc.example.com } \[domain\_realm\] .example.com = EXAMPLE.COM example.com = EXAMPLE.COM 5. Execute os seguintes comandos do TSM para habilitar a delegação do Kerberos, defina a conta de serviço da delegação e associe o arquivo keytab à conta de serviço: tsm configuration set -k wgserver.delegation.enabled -v true tsm configuration set -k native\_api.datasource\_impersonation\_runas\_principal -v tabsrv@EXAMPLE.COM tsm configuration set -k native\_api.datasource\_impersonation\_runas\_keytab\_path -v kerberos.keytab tsm configuration set -k native\_api.protocol\_transition\_a\_d\_short\_domain -v false tsm configuration set -k native\_api.protocol\_transition\_uppercase\_realm -v true Em alguns casos, o TSM pode retornar um erro mencionando o `--force-keys`. Caso tenha recebido esse erro, execute o comando novamente com o parâmetro `--force-keys` anexado ao argumento. 6. Execute o seguinte comando do TSM para aplicar as alterações ao Tableau Server: `tsm pending-changes apply` Se as alterações pendentes exigirem uma reinicialização do servidor, o comando `pending-changes apply` exibirá um prompt para que você saiba que ocorrerá uma reinicialização. Esse prompt será exibido mesmo que o servidor esteja parado, porém, nesse caso, não há reinicialização. Cancele o prompt com a opção `--ignore-prompt`, mas isso não altera o comportamento de reinicialização. Se as alterações não exigirem uma reinicialização, elas serão aplicadas sem um prompt. Para obter mais informações, consulte [tsm pending-changes apply](https://help.tableau.com/current/server/pt-br/cli_pending-changes.htm#pending-changes-apply).