--- schema_version: "1" id: 3ae5727e5641b693287898cac31731a92b22630d7a543a270830e22bda0d0f70 title: Configurar o OAuth para conexões do Snowflake no Tableau Server collection: tableau version: next locale: pt-br portal_url: https://docs.salesforce.com/tableau/next/pt-br/server-linux/config_oauth_snowflake.md canonical_url: https://help.tableau.com/v0.0/server-linux/pt-br/config_oauth_snowflake.htm source_site: help.tableau.com content_type: documentation content_hash: 6406dbc2af87e618616cd5517407967a2735246bbe12b1194a9a88b41e2a3b7c description: Configure OAuth for Snowflake connections on Tableau Server using TSM or per site. --- [Pular para o conteúdo principal](#main-content) # Configurar o OAuth para conexões do Snowflake no Tableau Server Há várias maneiras de configurar o OAuth para conexões do Snowflake, dependendo da versão do Tableau Server que você está usando e de quantos sites você está atualizando. Este tópico aborda a configuração de cada opção disponível. - Para todas as versões do Tableau até a versão 2024.1, inclusive, o conector Tableau Snowflake usa, por padrão, um proxy OAuth hospedado na AWS (GALOP), que usa um ID de cliente e um segredo comuns. Você pode configurar opcionalmente o Tableau Server para usar um novo serviço OAuth executado no mesmo local da instância do Tableau. Isso requer o fornecimento de seu próprio ID de cliente e segredo, conhecido como OAuth personalizado, e pode ser configurado usando as instruções abaixo. - A partir de 2024.2, o proxy GALOP será descontinuado e as instruções abaixo para configurar o OAuth personalizado serão **obrigatório**, pois agora usará o serviço OAuth local para autenticação. - Para Tableau Desktop e Tableau Cloud versões 2024.3 e posteriores, você pode configurar um IdP de terceiros (OAuth externo) para o Snowflake. Para obter mais informações, consulte [OAuth externo para Snowflake](https://help.tableau.com/v0.0/server-linux/pt-br/snowflake_oauth_idp.htm). Os benefícios fornecidos pelo OAuth personalizado incluem: - Segurança aprimorada - Você pode usar o OAuth em ambientes isolados que não conseguem se conectar ao OAuth Proxy (GALOP). - Você não precisa listar com segurança os endereços IP do GALOP para executar o fluxo OAuth em VPCs AWS PrivateLink ou Azure Private Link. ## Etapa 1: configurar e registrar o cliente OAuth com Snowflake Para usar uma configuração do OAuth personalizado no Tableau Server, você deve primeiro configurar e registrar seu cliente OAuth e obter um ID de cliente e um segredo de cliente no Snowflake. Para o Tableau Server versões 2024.2 e posteriores, esta etapa é necessária, independentemente da opção de configuração usada. Para registrar um cliente personalizado OAuth com Snowflake, siga o etapas descritas em [Configurar o Snowflake OAuth para clientes personalizados](https://docs.snowflake.com/en/user-guide/oauth-custom.html#configure-snowflake-oauth-for-custom-clients). Após registrar seu cliente OAuth no Snowflake usando as etapas do artigo do Snowflake vinculado acima, você usará os seguintes parâmetros do Snowflake para configurar o Tableau Server: - URL da instância da conta - ID do cliente - Segredo do cliente - URL de redirecionamento **Observação**: o URL de redirecionamento é o mesmo quando inserido no Snowflake e no Tableau. O formato é: https://.com/auth/add\_oauth\_token ## Etapa 2: configurar o Tableau Server para usar o OAuth para Snowflake ### Opção 1: configurar OAuth para conexões Snowflake usando TSM Recomendamos usar esta opção quando precisar atualizar vários sites do Tableau Server de uma vez. **Observação**: esta opção de configuração não está disponível para o uso em Tableau Cloud. 1. (Versões 2024.1 e anteriores) No computador do Tableau Server, execute o seguinte comando para ativar o serviço Snowflake OAuth: `tsm configuration set -k native_api.enable_snowflake_privatelink_on_server -v true` **Observação:** para versões 2024.2 e mais recentes, pule a etapa 1, independentemente de uma conexão privada Snowflake estar sendo usada ou não. 2. Copie, cole e personalize o seguinte comando em um editor de texto: `tsm configuration set -k oauth.snowflake.clients -v " [{\"oauth.snowflake.instance_url\":\"https://account.snowflakecomputing.com\", \"oauth.snowflake.client_id\":\"client_id_string\", \"oauth.snowflake.client_secret\":\"client_secret_string\", \"oauth.snowflake.redirect_uri\":\"http://your_server_url.com/auth/add_oauth_token\" }]"` A chave `oauth.snowflake.clients`obtém uma matriz de pares de chaves. Cada elemento no par de chaves deve estar entre aspas duplas. As aspas duplas devem ter `\"`. Para especificar várias URLs de instância de conta, separe cada cliente OAuth adicional entre chaves ({}) com uma vírgula (,), como neste exemplo: `tsm configuration set -k oauth.snowflake.clients -v " [{\"oauth.snowflake.instance_url\":\"https://account.snowflakecomputing.com\",\"oauth.snowflake.client_id\":\"client_id_string1\",\"oauth.snowflake.client_secret\":\"client_secret_string1\",\"oauth.snowflake.redirect_uri\":\"http://your_server_url.com/auth/add_oauth_token\" },{\"oauth.snowflake.instance_url\":\"https://account2.snowflakecomputing.com\",\"oauth.snowflake.client_id\":\"client_id_string2\",\"oauth.snowflake.client_secret\":\"client_secret_string2\",\"oauth.snowflake.redirect_uri\":\"http://your_server_url.com/auth/add_oauth_token\" }]"` Substitua os valores de cada chave: - URL da instância da conta: `oauth.snowflake.instance_url` - ID do cliente: `oauth.snowflake.client_id` - Segredo do cliente: `oauth.snowflake.client_secret` - URL de redirecionamento: `oauth.snowflake.redirect_uri` **Observação**: antes de executar o comando, verifique cuidadosamente a sintaxe. O TSM não validará essa entrada. Copie o comando na CLI do TSM e execute-o. 3. Insira o comando a seguir para aplicar as alterações: `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/v0.0/server-linux/pt-br/cli_pending-changes.htm#pending-changes-apply). ### Opção 2: configurar OAuth para conexões Snowflake por site **Observação**: esta opção também está disponível para Tableau Cloud começando com a versão 2024.2. Você pode configurar um cliente Snowflake OAuth personalizado no nível do site usando a interface do usuário do Tableau Server. Considere configurar um cliente OAuth personalizado no nível do site para: 1. Substituir um cliente OAuth se configurado para o servidor 2. Habilitar suporte para conexão segura com dados que exigem clientes OAuth exclusivos. Quando um cliente OAuth personalizado é configurado, a configuração no nível do site tem precedência sobre qualquer configuração em todo o servidor e todas as credenciais OAuth adicionadas recentemente usam o cliente OAuth no nível do site por padrão. Nenhuma reinicialização do Tableau Server é necessária para que as configurações do OAuth personalizado no nível do site entrem em vigor. **Importante:** as credenciais OAuth existentes estabelecidas antes da configuração do cliente OAuth personalizado podem ser usadas temporariamente, mas os administradores e os usuários do Tableau Server devem atualizar suas credenciais salvas para ajudar a garantir o acesso ininterrupto aos dados. #### Etapa 1: preparar a ID do cliente OAuth, a chave secreta do cliente e a URL de redirecionamento Antes de configurar o cliente OAuth personalizado, você precisa das informações listadas abaixo. Depois de preparar essas informações, você pode registrar o cliente OAuth personalizado para o site. Para obter mais informações, consulte a seção **Etapa 1: configurar e registrar o cliente OAuth com Snowflake**, acima. - **URL da instância da conta** - **ID do cliente OAuth e segredo do cliente:** primeiro registre o cliente OAuth com o provedor de dados (conector) para recuperar a ID do cliente e o segredo gerado para o Tableau Server. - **URL de redirecionamento:** observe a URL de redirecionamento correto. Você precisará disso durante o processo de registro na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server** abaixo. https://.com/auth/add\_oauth\_token #### Etapa 2: adicionar o cliente OAuth ao site do Tableau Server Siga o procedimento descrito abaixo para registrar o cliente OAuth personalizado no site. 1. (Versões 2024.1 e anteriores) No computador do Tableau Server, execute estes dois comandos para habilitar o serviço Snowflake OAuth: `tsm configuration set -k native_api.enable_snowflake_privatelink_on_server -v true` `tsm pending-changes apply` **Observação:** para versões 2024.2 e mais recentes, pule a etapa 1, independentemente de uma conexão privada Snowflake estar sendo usada ou não. 2. Entre no site do Tableau Server usando suas credenciais de administrador acesse a página de Configurações. 3. No Registro de clientes OAuth, clique no botão Adicionar cliente OAuth. 4. Insira as informações necessárias, incluindo as informações da **Etapa 1** acima: 1. Para Tipo de conexão, selecione o conector, cujo cliente OAuth personalizado você deseja configurar. 2. URL da instância OAuth é necessária se vários clientes OAuth estiverem sendo registrados. Caso contrário, é opcional. 3. Para ID do cliente, Segredo do cliente e URL de redirecionamento, insira as informações que você preparou na **Etapa 1** acima. 4. Clique no botão Adicionar cliente OAuth para concluir o processo de registro. ![](/tableau/next/pt-br/server-linux/pt-br/Img/oauth_custom.png) 5. Clique no botão Salvar na parte inferior ou superior da página Configurações para salvar as alterações. #### Etapa 3: validar e atualizar as credenciais salvas Para ajudar a garantir o acesso ininterrupto aos dados, você (e os usuários do site) deve excluir as credenciais salvas anteriormente e adicioná-las novamente para usar o cliente OAuth personalizado para o site. 1. Navegue até a página Minhas configurações da conta. 2. Em Credenciais salvas para fontes de dados, faça o seguinte: 1. Clique em Excluir ao lado das credenciais salvas existentes para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server** acima. 2. Ao lado do nome do conector, clique em Adicionar e siga as instruções para 1) se conectar ao cliente OAuth personalizado que você configurou na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server** acima e 2) salvar as credenciais mais recentes. #### Etapa 4: notificar os usuários para atualizarem as credenciais salvas Certifique-se de notificar os usuários do seu site para atualizar suas credenciais salvas para o conector, cujo cliente OAuth personalizado você configurou na **Etapa 2: adicionar o cliente OAuth ao site do Tableau Server**. Os usuários do site podem usar o procedimento descrito em [Atualizar credenciais salvas](https://help.tableau.com/v0.0/server-linux/pt-br/manage_stored_credentials.htm#oauth_update_credentials) para atualizar as credenciais salvas.