Configurar o logon do Azure Databricks no Tableau Server

Artigo
08/07/2024

Este artigo descreve como configurar o logon do Azure Databricks no Tableau Server. Depois de concluir essa configuração única como administrador da conta do Azure Databricks, os usuários poderão se conectar a partir do Tableau Server usando a autenticação SSO.

As etapas neste artigo não são necessárias para o Tableau Desktop e o Tableau Cloud, que são habilitados como aplicativos OAuth em sua conta do Azure Databricks por padrão.

Este artigo é específico para a criação personalizada do aplicativo OAuth do Tableau Server. Para obter as etapas genéricas de criação de aplicativo OAuth personalizado, confira o seguinte:

Habilitar aplicativos OAuth personalizados usando a CLI

Antes de começar

Antes de configurar o logon do Azure Databricks no Tableau Server:

Você precisa ser um administrador da conta do Azure Databricks.
Instale a CLI do Databricks e configure a autenticação entre a CLI do Databricks e sua conta do Databricks.

Você também deve atender aos seguintes requisitos do Tableau:

Você tem uma instalação do Tableau Server com uma das seguintes versões:
- 2021.4.13 ou superior
- 2022.1.9 ou superior
- 2022.3.1 ou superior
Você é um administrador do Tableau Server.

Adicionar o Tableau Server como um aplicativo OAuth

Para adicionar o Tableau Server como um aplicativo OAuth à sua conta do Azure Databricks, faça o seguinte:

Localize a ID da conta.
Localize o URL do Tableau Server.
Execute o comando a seguir:
```
databricks account custom-app-integration create --confidential --json '{"name":"<name>", "redirect_urls":["<redirect-url>"], "scopes":["all-apis", "offline_access", "openid", "profile", "email"]}'
```
- Substitua <name> por um nome para seu aplicativo OAuth personalizado.
- Para <redirect-url>, acrescente /auth/add_oauth_token ao URL do Tableau Server. Por exemplo, https://example.tableauserver.com/auth/add_oauth_token.
Para obter mais informações sobre valores com suporte, confira POST /api/2.0/accounts/{account_id}/oauth2/custom-app-integrations na referência da API REST.

Uma ID do cliente e um segredo do cliente são gerados e a seguinte saída é retornada:
```
{"integration_id":"<integration-id>","client_id":"<client-id>","client_secret":"<client-secret>"}
```
Observação

A habilitação de um aplicativo OAuth pode levar 30 minutos para ser processada.
Armazene com segurança o segredo do cliente.

Importante

Você não poderá recuperar o segredo do cliente mais tarde.

Configurar o OAuth no Tableau Server

Para configurar o OAuth no Tableau Server, faça o seguinte:

Entre no Tableau Server como administrador do servidor.
Na barra lateral, clique em Configurações>Registro do cliente OAuth>Adicionar cliente OAuth.
Para Tipo de conexão, selecione Databricks.
Para a ID do cliente, insira a ID do cliente que foi gerada em Adicionar Tableau Server como um aplicativo OAuth.
Para o Segredo do cliente, insira o segredo do cliente que foi gerado em Adicionar Tableau Server como um aplicativo OAuth.
Para URL de redirecionamento, insira o URL de redirecionamento de Adicionar Tableau Server como um aplicativo OAuth.
Clique em Adicionar cliente OAuth.

Solucionar problemas de configuração do OAuth

Esta seção descreve como resolver problemas comuns com a configuração do OAuth.

Erro 404 do seu IdP

Problema: você vê um erro 404 ao tentar se autenticar no Tableau Server.

Causa: o OAuth está configurado incorretamente.

Solução: certifique-se de que você configurou corretamente o OAuth.

Próximas etapas

Agora os usuários podem usar o SSO para se autenticar no Azure Databricks a partir do Tableau Server. Consulte Conectar o Tableau ao Azure Databricks.

Compartilhar via