---
schema_version: "1"
id: 896dc4c295ed846abc37ad7f2394b8d235a55ad08ba5146ee4c32ee2fb1050aa
title: Configurar SAML com AD FS
collection: tableau
version: next
locale: pt-br
portal_url: https://docs.salesforce.com/tableau/next/pt-br/online/saml_config_adfs.md
canonical_url: https://help.tableau.com/v0.0/online/pt-br/saml_config_adfs.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 72bdbe59325bbc3d888b430e0990629b5b6603ac988c6de07e594d42fbb32874
description: Configure AD FS as a SAML identity provider for Tableau Cloud or TCM.
---
[Pular para o conteúdo principal](#main-content)

# Configurar SAML com AD FS

Você pode configurar o Active Directory Federation Services (AD FS) como um provedor de identidade de SAML e adicionar o Tableau Cloud ou Tableau Cloud Manager (TCM) aos aplicativos de logon único suportados. Ao integrar o AD FS com o SAML e o Tableau Cloud ou TCM, seus usuários poderão fazer logon no Tableau Cloud ou TCM usando suas credenciais de rede padrão.

**Observações:** 

- Essas etapas refletem um aplicativo de terceiros e estão sujeitas a alteração sem o nosso conhecimento. Se as etapas descritas aqui não corresponderem às telas que você visualiza na sua conta do IdP, use as [Etapas de configuração do SAML](https://help.tableau.com/current/online/pt-br/saml_config_site.htm#SAML), em conjunto com a documentação do IdP.
- A partir de fevereiro de 2022, a autenticação multifator (MFA) por meio do seu provedor de identidade SSO (IdP) SAML é um requisito do Tableau.
- As etapas de configuração no IdP podem estar em uma ordem diferente daquela que você vê no Tableau.

## Pré-requisitos

Antes de configurar o Tableau Cloud ou TCM e o SAML com o AD FS, seu ambiente deve ter o seguinte:

- Um servidor que executa Microsoft Windows Server 2008 R2 (ou posterior) com AD FS 2.0 (ou posterior) e IIS instalados.
- Recomenda-se que você proteja o seu servidor AD FS (por exemplo, utilizando um proxy reverso). Quando o seu servidor AD FS puder ser acessado fora do firewall, o Tableau poderá redirecionar os usuários à página de logon hospedada pelo AD FS.
- para o Tableau Cloud, uma conta de administrador de site que usa o Tableau com autenticação MFA. Se o logon único do SAML falhar, você ainda pode fazer logon no Tableau Cloud como um administrador do site.
- Para o TCM, uma conta de administrador de Nuvem que usa o Tableau com autenticação MFA. Se o logon único do SAML falhar, você ainda pode fazer logon no TCM.

## Etapa 1: Introdução

No Tableau Cloud, faça o seguinte:

1. Entre no site Tableau Cloud como um administrador de site e selecione Configurações > Autenticação.
2. Na guia Autenticação, clique no botão Nova configuração, selecione SAML no menu suspenso Autenticação e insira um nome para a configuração.
    
    ![Captura de tela das configurações de autenticação do site do Tableau Cloud – nova página de configuração](/tableau/next/pt-br/online/pt-br/Img/saml_config_site3.png)
    
    **Observação:** As configurações criadas antes de janeiro de 2025 (Tableau 2024.3) não podem ser renomeadas.

Como alternativa, no TCM, faça o seguinte:

1. Entre no TCM como um administrador de nuvem e selecione Configurações > Autenticação.
2. Selecione a caixa de seleção Habilitar um método de autenticação adicional e SAML no menu suspenso Autenticação.
3. Clique na seta suspensa Configuração (obrigatório).

No AD FS, faça o seguinte:

O procedimento abaixo exporta metadados do AD FS para os quais você importará Tableau Cloud ou TCM. Verifique também se os metadados estão configurados e codificados corretamente para o Tableau e verifique outros requisitos do AD FS para a sua configuração SAML.

1. Exporte os metadados de AD FS Federation para um arquivo XML e, em seguida, baixe o arquivo em **https://_<adfs server name>_/federationmetadata/2007-06/FederationMetadata.xml**.
2. Abra o arquivo de metadados em um editor de texto como Sublime Text ou Notepad++ e verifique se ele está corretamente codificado como UTF-8 sem BOM.
    
    Se o arquivo mostrar algum outro tipo de codificação, salve-o no editor de texto com a codificação correta.
3. Verifique se o AD FS está usando a autenticação com base em formulários. Os logons são realizados em uma janela do navegador, então você precisa que o AD FS tenha esse tipo de autenticação como padrão.
    
    Edite **c:\\inetpub\\adfs\\ls\\web.config**, pesquise pela marca **,** e mova a linha, de modo que ela apareça em primeiro na lista. Salve o arquivo para que o IIS possa recarregá-lo automaticamente.
    
    **Observação:** se você não visualizar o arquivo **c:\\inetpub\\adfs\\ls\\web.config**, o IIS não é instalado e configurado no servidor AD FS.
4. Configure um identificador de parte confiável AD FS adicional. Isso permite que o seu sistema solucione qualquer problema do AD FS ao sair do SAML.
    
    Execute um destes procedimentos:
    
    Windows Server 2008 R2:
    
    1. No **AD FS 2.0**, clique com o botão direito do mouse na parte confiável criada anteriormente para o Tableau Cloud ou TCM e em clique em **Propriedades**.
    2. Na guia **Identificadores**, na caixa **Identificador da parte confiável**, insira **https://<tableauservername>/public/sp/metadata** e clique em **Adicionar**.
    
    Windows Server 2012 R2:
    
    1. Em **Gerenciamento de AD FS** na lista **Confianças de parte confiável**, clique com o botão direito do mouse na parte confiável criada anteriormente para o Tableau Cloud ou TCM e clique em **Propriedades**.
    2. Na guia **Identificadores**, na caixa **Identificador da parte confiável**, insira **https://<tableauservername>/public/sp/metadata** e clique em **Adicionar**.

## Etapa 2: configurar SAML em Tableau Cloud ou TCM

Conclua o procedimento a seguir depois de salvar o arquivo de metadados SAML do AD FS, conforme descrito na seção acima.

**Para o Tableau Cloud**

1. De volta ao Tableau Cloud, na página Nova configuração, em 2\. Carregar metadados no Tableau, clique no botão Escolher um arquivo e navegue até o arquivo de metadados SAML (FederationMetadata.xml) que você exportou no AD FS. Isso preenche automaticamente os valores de ID da entidade IdP e URL do serviço SSO.
2. Pule 3\. Atributos do mapa porque você criará uma regra de reivindicação no AD FS para corresponder aos nomes de atributos que Tableau Cloud espera na seção abaixo.
3. Em 4\. Escolher padrão para exibições inseridas (opcional), selecione a experiência que você deseja habilitar quando os usuários acessam o conteúdo inserido.
4. Clique no botão Salvar e continuar.
5. Em 5\. Obter metadados do Tableau Cloud clique no botão Exportar metadados e salve o arquivo de metadados do Tableau no computador.
    
    Por padrão, o arquivo é chamado **saml\_sp\_metadata.xml**.

**Para TCM**

1. De volta ao TCM, em página Autenticação, em 2\. Carregar metadados no Tableau, clique no botão Escolher um arquivo e navegue até o arquivo de metadados SAML (FederationMetadata.xml) que você exportou no AD FS. Isso preenche automaticamente os valores de ID da entidade IdP e URL do serviço SSO.
2. Pule 3\. Atributos do mapa porque você criará uma regra de reivindicação no AD FS para corresponder aos nomes de atributos que o TCM espera na seção abaixo.
3. Clique no botão Salvar e continuar.
4. Em 4\. Obter metadados do Tableau Cloud clique no botão Exportar metadados e salve o arquivo de metadados do Tableau no computador.
    
    Por padrão, o arquivo é chamado **saml\_sp\_metadata.xml**.

## Etapa 3: configurar o aplicativo “Tableau Cloud” no IdP

A configuração do AD FS para aceitar as solicitações de logon do Tableau Cloud ou TCM é um processo de várias etapas, iniciando com a importação do arquivo de metadados do Tableau Cloud ou TCM para AD FS.

1. Realize uma das seguintes ações para abrir o **Assistente de confiança de terceira parte confiável**:

Windows Server 2008 R2:

1. Selecione **menu Iniciar** \> **para Ferramentas administrativas**\> **AD FS 2.0**.
2. No **AD FS 2.0**, em **Relacionamentos Confiáveis**, clique com o botão direito do mouse na pasta **Confianças de Terceira Parte Confiável** e, em seguida, clique em **Adicionar Confiança de Terceira Parte Confiável**.

Windows Server 2012 R2:

1. Abra o **Gerenciador de servidores** e, em seguida, no menu **Ferramentas**, clique em **Gerenciamento do AD FS**.
2. Em **Gerenciamento do AD FS**, no menu **Ação**, clique em **Adicionar Confiança de Terceira Parte Confiável**.

6. No **Assistente Adicionar Terceira Parte Confiável**, clique em **Iniciar**.
7. Na página **Selecionar fonte de dados**, selecione **Importar dados sobre a parte confiável de um arquivo** e clique em **Procurar** para encontrar o arquivo de metadados do Tableau Cloud ou or TCM.
    
    Por padrão, o arquivo é chamado **saml\_sp\_metadata.xml**.
8. Clique em **Avançar** e na página **Especificar nome de exibição**, digite um nome e uma descrição para a confiança da parte confiável nas caixas **Nome de exibição** e **Observações**.
9. Clique em Avançar para ignorar a página **Configurar autenticação multifator agora**.
10. Clique em Avançar para ignorar a página **Escolher regras de autorização de emissão**.
11. Clique em Avançar para ignorar a página **Pronto para incluir confiança**.
12. Na página **Concluir**, selecione a caixa de seleção **Abrir a caixa de diálogo Editar Regras de Declarações para esta confiança de terceira parte confiável quando o assistente fechar**, e clique em **Fechar**.

O próximo passo é trabalhar na caixa de diálogo **Editar regras de declaração** para adicionar uma regra que garanta que as afirmações enviadas pelo AD FS coincidam com as afirmações ou TCM esperadas pelo Tableau Cloud ou TCM. No mínimo, o Tableau Cloud ou TCM precisa de um nome de usuário (no formato de endereço de e-mail). No entanto, incluir o nome e o sobrenome, além do e-mail, garantirá que os nomes de usuário exibidos no Tableau Cloud ou TCM sejam os mesmos que os da sua conta AD.

1. Na caixa de diálogo Editar regras de declaração, clique em **Adicionar regra**.
2. Na página **Escolher tipo de regra**, para **Modelo da regra de declaração**, selecione **Enviar atributos LDAP como declarações** e, em seguida, clique em **Avançar**.
3. Na página **Configurar regra de declaração**, para **Nome da regra de declaração**, insira um nome que fizer sentido para você.
4. Para **Repositório de atributos**, selecione **Active Directory**, complete o mapeamento conforme mostrado abaixo e clique em **Concluir**.

O mapeamento diferencia maiúsculas de minúsculas, portanto verifique suas entradas. Esta tabela mostra atributos comuns e mapeamentos de declaração. Verifique os atributos com a configuração específica do Active Directory.

**Observação:** o Tableau Cloud ou TCM requer o atributo **NameID** na resposta SAML. Você pode fornecer outros atributos para mapear nomes de usuário no Tableau Cloud ou TCM, mas a mensagem de resposta deve incluir o atributo **NameID.**

<table class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Atributo LDAP</th><th>Tipo de declaração de saída</th></tr><tr><td><p>Dependendo da versão do AD FS:</p><p>Nome-Principal-Usuário<br><i>ou</i><br>Endereço de e-mail</p></td><td><p>&nbsp;</p><p>email<br><i>ou</i><br>Endereço de email<br></p></td></tr><tr><td>Nome</td><td>firstName</td></tr><tr><td>Sobrenome</td><td>lastName</td></tr></tbody></table>

Se você estiver executando o AD FS 2016 ou posterior, deverá adicionar uma regra para transmitir todos os valores de solicitação. Se você estiver executando uma versão antiga do AD FS, vá para o próximo procedimento para exportar metadados do AD FS.

1. Clique em **Adicionar regra**.
2. Em **Solicitar modelo de regra,** escolha **Transmitir ou Filtrar uma solicitação de entrada.**
3. Em **Solicitar nome da regra**, digite Windows.
4. Na janela pop-up **Editar Regra - Windows**:
    - Em **Tipo de solicitação de entrada**, selecione **Nome da conta do Windows**.
    - Selecione **Transmitir todos os valores de solicitação**.
    - Clique em **OK**.

No Tableau Cloud, faça o seguinte:

1. Retorne ao Tableau Cloud, na página Nova configuração, em 3\. Atributos do mapa, preencha os valores de declaração do AD FS no Tableau Cloud.
2. Clique no botão Salvar e continuar.

Como alternativa, no TCM faça o seguinte:

1. De volta ao TCM, em página Autenticação, em 3\. Atributos do mapa, preencha os valores de declaração do AD FS no TCM.
2. Clique no botão Salvar e continuar.

## Etapa 4: teste a configuração do SAML no Tableau Cloud ou TCM

1. No Tableau Cloud ou TCM, adicione um usuário de amostra ao AD FS e ao Tableau Cloud ou TCM para testar a configuração SAML.
    
    - Para adicionar usuários no Tableau Cloud, consulte o tópico [Adicionar usuários a um site](https://help.tableau.com/v0.0/online/pt-br/sites_addusers.htm).
    - Para adicionar usuários no TCM, consulte o tópico [Gerenciar usuários com o Tableau Cloud Manager](https://help.tableau.com/v0.0/online/pt-br/cloud_manager_users.htm).

## Etapa 3. Configure o aplicativo Tableau Cloud no IdP

A configuração do AD FS para aceitar as solicitações de logon do Tableau Cloud é um processo de várias etapas, iniciando com a importação do arquivo de metadados do Tableau Cloud para o AD FS.

1. Realize uma das seguintes ações para abrir o **Assistente de confiança de terceira parte confiável**:

Windows Server 2008 R2:

1. Selecione **menu Iniciar** \> **para Ferramentas administrativas**\> **AD FS 2.0**.
2. No **AD FS 2.0**, em **Relacionamentos Confiáveis**, clique com o botão direito do mouse na pasta **Confianças de Terceira Parte Confiável** e, em seguida, clique em **Adicionar Confiança de Terceira Parte Confiável**.

Windows Server 2012 R2:

1. Abra o **Gerenciador de servidores** e, em seguida, no menu **Ferramentas**, clique em **Gerenciamento do AD FS**.
2. Em **Gerenciamento do AD FS**, no menu **Ação**, clique em **Adicionar Confiança de Terceira Parte Confiável**.

6. No **Assistente Adicionar Terceira Parte Confiável**, clique em **Iniciar**.
7. Na página **Selecionar fonte de dados**, selecione **Importar dados sobre a parte confiável de um arquivo** e clique em **Procurar** para encontrar o arquivo de metadados do Tableau Cloud.
    
    Por padrão, o arquivo é chamado **saml\_sp\_metadata.xml**.
8. Clique em **Avançar** e na página **Especificar nome de exibição**, digite um nome e uma descrição para a confiança da parte confiável nas caixas **Nome de exibição** e **Observações**.
9. Clique em Avançar para ignorar a página **Configurar autenticação multifator agora**.
10. Clique em Avançar para ignorar a página **Escolher regras de autorização de emissão**.
11. Clique em Avançar para ignorar a página **Pronto para incluir confiança**.
12. Na página **Concluir**, selecione a caixa de seleção **Abrir a caixa de diálogo Editar Regras de Declarações para esta confiança de terceira parte confiável quando o assistente fechar**, e clique em **Fechar**.

O próximo passo é trabalhar na caixa de diálogo **Editar regras de declaração** para adicionar uma regra que garanta que as afirmações enviadas pelo AD FS coincidam com as afirmações esperadas pelo Tableau Cloud. No mínimo, o Tableau Cloud precisa de um nome de usuário (no formato de endereço de e-mail). No entanto, incluir o nome e o sobrenome, além do e-mail, garantirá que os nomes de usuário exibidos no Tableau Cloud sejam os mesmos que os da sua conta AD.

1. Na caixa de diálogo Editar regras de declaração, clique em **Adicionar regra**.
2. Na página **Escolher tipo de regra**, para **Modelo da regra de declaração**, selecione **Enviar atributos LDAP como declarações** e, em seguida, clique em **Avançar**.
3. Na página **Configurar regra de declaração**, para **Nome da regra de declaração**, insira um nome que fizer sentido para você.
4. Para **Repositório de atributos**, selecione **Active Directory**, complete o mapeamento conforme mostrado abaixo e clique em **Concluir**.

O mapeamento diferencia maiúsculas de minúsculas, portanto verifique suas entradas. Esta tabela mostra atributos comuns e mapeamentos de declaração. Verifique os atributos com a configuração específica do Active Directory.

**Observação:** o Tableau Cloud requer o atributo **NameID** na resposta SAML. Você pode fornecer outros atributos para mapear nomes de usuário no Tableau Cloud, mas a mensagem de resposta deve incluir o atributo **NameID.**

<table class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Atributo LDAP</th><th>Tipo de declaração de saída</th></tr><tr><td><p>Dependendo da versão do AD FS:</p><p>Nome-Principal-Usuário<br><i>ou</i><br>Endereço de e-mail</p></td><td><p>&nbsp;</p><p>email<br><i>ou</i><br>Endereço de email<br></p></td></tr><tr><td>Nome</td><td>firstName</td></tr><tr><td>Sobrenome</td><td>lastName</td></tr></tbody></table>

Se você estiver executando o AD FS 2016 ou posterior, deverá adicionar uma regra para transmitir todos os valores de solicitação. Se você estiver executando uma versão antiga do AD FS, vá para o próximo procedimento para exportar metadados do AD FS.

1. Clique em **Adicionar regra**.
2. Em **Solicitar modelo de regra,** escolha **Transmitir ou Filtrar uma solicitação de entrada.**
3. Em **Solicitar nome da regra**, digite Windows.
4. Na janela pop-up **Editar Regra - Windows**:
    - Em **Tipo de solicitação de entrada**, selecione **Nome da conta do Windows**.
    - Selecione **Transmitir todos os valores de solicitação**.
    - Clique em **OK**.

No Tableau Cloud, faça o seguinte:

1. Retorne ao Tableau Cloud, na página Nova configuração, em 3\. Atributos do mapa, preencha os valores de declaração do AD FS no Tableau Cloud.
2. Clique no botão Salvar e continuar.

## Etapa 4: teste as etapas de configuração do SAML em Tableau Cloud

1. No Tableau Cloud, adicione um usuário de amostra ao ADFS e ao Tableau Cloud para testar a configuração SAML. Para adicionar usuários no Tableau Cloud, consulte o tópico [Adicionar usuários a um site](https://help.tableau.com/v0.0/online/pt-br/sites_addusers.htm).
2. Volte para a página Nova configuração, em 7\. Configuração de teste, clique no botão Configuração de teste.

É altamente recomendável testar a configuração SAML para evitar cenários de bloqueio. Testar a configuração ajuda a garantir a configuração correta de SAML antes de alterar o tipo de autenticação de seus usuários para SAML. Para testar a configuração com êxito, certifique-se de que haja pelo menos um usuário com quem você possa fazer login e que já esteja provisionado no IdP e adicionado ao Tableau Cloud ou TCM com o tipo de autenticação SAML configurado.

## Etapa 5: adicionar usuários ao site do Tableau Cloud habilitado por SAML

Usar etapas abaixo para adicionar usuários ao seu site. O procedimento descrito nesta seção é executado na página Usuários do Tableau Cloud.

1. Depois de concluir as etapas acima, no painel esquerdo, navegue até a página Usuários.
2. Siga o procedimento descrito no tópico [Adicionar usuários a um site](https://help.tableau.com/v0.0/online/pt-br/sites_addusers.htm). Como alternativa, você pode adicionar usuários usando um arquivo .csv seguindo o procedimento descrito no tópico [Importar usuários](https://help.tableau.com/v0.0/online/pt-br/users_import.htm).

É altamente recomendável testar a configuração SAML para evitar cenários de bloqueio. Testar a configuração ajuda a garantir a configuração correta de SAML antes de alterar o tipo de autenticação de seus usuários para SAML. Para testar a configuração com êxito, certifique-se de que haja pelo menos um usuário com quem você possa fazer login e que já esteja provisionado no IdP e adicionado ao Tableau Cloud ou TCM com o tipo de autenticação SAML configurado.

## Etapa 5: adicionar usuários ao site do Tableau Cloud ou TCM habilitado por SAML

Usar etapas abaixo para adicionar usuários ao seu site. O procedimento descrito nesta seção são executadas na página Usuários do Tableau Cloud ou do TCM.

1. Depois de concluir as etapas acima, no painel esquerdo, navegue até a página Usuários.
2. Siga o procedimento descrito em um dos tópicos a seguir:
    
    - Para o Tableau Cloud, consulte o tópico [Adicionar usuários a um site](https://help.tableau.com/v0.0/online/pt-br/sites_addusers.htm). Como alternativa, você pode adicionar usuários usando um arquivo .csv seguindo o procedimento descrito no tópico [Importar usuários](https://help.tableau.com/v0.0/online/pt-br/users_import.htm).
    - Para o TCM, consulte o tópico [Gerenciar usuários com o Tableau Cloud Manager](https://help.tableau.com/v0.0/online/pt-br/cloud_manager_users.htm). Como alternativa, você pode adicionar usuários usando um arquivo .csv seguindo o procedimento descrito no tópico [Gerenciar usuários com o Tableau Cloud Manager](https://help.tableau.com/v0.0/online/pt-br/cloud_manager_users.htm##bulk-import-users).

## Requisitos adicionais e dicas para suporte SAML com AD FS

- Depois de configurar a integração de SAML entre o AD FS e o Tableau Cloud ou TCM, você deve atualizar o Tableau para refletir alterações específicas do usuário feitas no Active Directory. Por exemplo, adicionar ou remover usuários.
    
    Você pode adicionar usuários automaticamente ou manualmente:
    
    - **Para adicionar usuários de forma automática:** crie um script (usando PowerShell, Python ou arquivo de lote) para enviar as alterações do AD para Tableau Cloud ou TCM. O script pode usar [tabcmd](https://help.tableau.com/v0.0/online/pt-br/tabcmd_cmd.htm) ou [API REST do Tableau](https://help.tableau.com/v0.0/online/pt-br/dev_resources.htm) para interagir com Tableau Cloud. O script pode usar a [API REST do Tableau Cloud Manager](https://help.tableau.com/v0.0/online/pt-br/dev_resources.htm) para interagir com TCM.
    - **Para adicionar usuários manualmente:** faça logon na interface de usuário do Tableau Cloud ou TCM, acesse a página Usuários, clique em Adicionar usuários, selecione Adicionar usuários por nome de usuários insira nome de usuário dos usuários ou faça o upload do arquivo.csv que contenha suas informações.
    
    **Observação:** para remover um usuário e manter os ativos de conteúdo que ele possui, altere o proprietário do conteúdo antes de removê-lo. Excluir um usuário também exclui o conteúdo dele.
- Em Tableau Cloud ou TCM, um nome de usuário do usuário é seu identificador exclusivo. Conforme descrito nas etapas de configuração do AD FS para aceitar solicitações de logon dos usuários do Tableau Cloud ou TCM, nomes de usuários do Tableau Cloud ou TCM devem corresponder ao nome de usuário do armazenado no AD.
- Na [Etapa 3: configurar o aplicativo “Tableau Cloud” no IdP](#idp), você adicionou uma regra de declaração no AD FS para corresponder aos atributos de nome, sobrenome e nome de usuário entre o AD FS e o Tableau Cloud. Como alternativa, use a etapa **3\. Mapear atributos** no Tableau Cloud para fazer o mesmo.