Ajuda do Tableau Cloud

Observações:

• Antes de executar as etapas descritas aqui, você deve configurar o provedor OpenID, conforme descrito em Configurar o provedor de identidades para o OpenID Connect. A configuração separada e a integração do aplicativo são necessárias para habilitar a autenticação OIDC para Tableau Cloud e TCM.
• Como alternativa, você pode configurar a autenticação OIDC para o Tableau Cloud usando a API REST do Tableau e os Métodos OpenID Connect(O link abre em nova janela). Observação: se aplica somente ao Tableau Cloud.
• Para o Tableau Cloud, a API REST do Tableau e o tabcmd não oferecem suporte ao logon único (SSO) do OIDC. Para usar o tabcmd ou a REST API do Tableau(O link abre em nova janela), os usuários devem fazer logon no Tableau Cloud usando um token de acesso pessoal (PAT).
• Para o TCM, a API REST do Tableau Cloud Manager não oferece suporte ao OIDC SSO. Para usar o API REST do TCM(O link abre em nova janela), os usuários devem fazer login no TCM usando um PAT.

Requisitos

Parâmetros

• ID do cliente: este valor é emitido pelo IdP e especifica um identificador para o Tableau Cloud registrado ou TCM. Isso permite que o IdP saiba de onde vem a solicitação de autenticação.

• Segredo do cliente: este é um token usado pelo Tableau Cloud ou TCM para verificar a autenticidade da resposta do IdP. Este valor deve ser mantido em segurança.

• URL de configuration: esse valor especifica a URL para a qual o IdP faz o redirecionamento, depois que o usuário for autenticado. A URL deve incluir o host e protocolo (por exemplo, https://admin.okta.com/oauth2/default/.well-known/openid-configuration), mas o Tableau fornece o endpoint da URL. Esta URL especifica a localização do documento de descoberta de configuração do provedor que contém os metadados do provedor OpenID.

  Observação: se o seu IdP não fornecer uma URL de configuração, use uma URL que termine com .well-known/openid-configuration. Para o Tableau Cloud, considere usar o Métodos de autenticação OpenID Connect(O link abre em nova janela) na API REST do Tableau para configurar o OIDC.

Parâmetros opcionais

Observação: se aplica somente ao Tableau Cloud.

Os seguintes parâmetros opcionais podem ser configurados usando Métodos de autenticação OpenID Connect(O link abre em nova janela) na API REST do Tableau.

• Prompt: solicita ao usuário reautenticação e consentimento. Por padrão, o consentimento do usuário está ativado.

• Escopo personalizado: valor relacionado ao usuário do escopo personalizado para consultar o IdP.

• Autenticação do cliente: método de autenticação de endpoint de token. O valor padrão é: 'client_secret_basic'. O valor 'client_secret_post' é aceito.

• Valores essenciais do ACR: lista de valores essenciais da classe de referência de contexto de autenticação usados para autenticação.

• Valores voluntários de ACR: lista de valores voluntários de Classe de Referência de Contexto de Autenticação usados para autenticação.

Reinvidicações

Para fazer logon com êxito no Tableau Cloud ou TCM, um determinado usuário deve ser provisionado no IdP do OpenID Connect (OIDC) e, em seguida, mapeado para uma conta de usuário no Tableau Cloud ou TCM. O OIDC usa um método que depende que as reivindicações compartilhem os atributos da conta de usuário com outros aplicativos. O Tableau Cloud ou TCM depende que a reivindicação de IdP mapeiem as contas de usuário do IdP para as hospedadas no Tableau Cloud ou TCM. As reivindicações incluem atributos de conta de usuário, como e-mail, nome etc. Para compreender como o Tableau Cloud ou TCM mapeia as reivindicações de IdP nas contas de usuário, consulte Visão geral da autenticação.

Observação: as reinvidicações diferenciam letras maiúsculas de minúsculas.

• Nome de usuário: por padrão, o Tableau espera que o IdP passe a reivindicação de nome de usuário. Dependendo do IdP, talvez seja necessário configurar o Tableau Cloud para usar uma reivindicação de IdP diferente. Observação: o nome de usuário no Tableau é imutável e não pode ser atualizado em nenhum momento.

• Reivindicação de nome: você pode especificar o nome ou o nome e o sobrenome para recuperar DisplayName para o usuário.

• Reivindicação de e-mail: opcionalmente, a partir de julho de 2025, você pode especificar um endereço de e-mail diferente do nome de usuário. A reinvidicações de endereço de e-mail é usado apenas para fins de notificação e não para login.

Habilitar logon único de OIDC

Etapa 1: configurar o OpenID Connect

Para o Tableau Cloud

1. Entre no 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 OpenID Connect (OIDC) e insira um nome para a configuração.

3. Siga as etapas para configurar a autenticação do Tableau Cloud para OIDC fazendo o seguinte:

   1. Na etapa 1, insira as informações necessárias do seu IdP, incluindo ID do cliente, segredo do cliente e URL de configuração.

   2. Na etapa 2, copie a URL de redirecionamento do Tableau Cloud que você colará no portal do seu IdP para redirecionar os usuários após a autenticação.

   3. Na etapa 3, insira as declarações para garantir o mapeamento correto do nome de usuário e do nome de exibição dos usuários.

   4. Na etapa 4, habilite opcionalmente o logout único (SLO) se o seu IdP oferecer suporte.

   5. Na etapa 5, escolha como os usuários serão autenticados ao acessar a visualização incorporada: em uma janela pop-up separada ou usando um iFrame em linha.

      Observação: você pode selecionar o tipo de autenticação para visualizações incorporadas no Tipo de autenticação padrão para visualizações inseridas seção na página Autenticação (abaixo das etapas de configuração do OIDC).

4. Quando terminar, clique no botão Salvar alterações.

Observação: ao editar a configuração do OIDC, o segredo do cliente fica oculto e precisa ser digitado novamente antes que qualquer alteração possa ser salva.

Para TCM

1. Entre no TCM como um administrador e nuvem e selecione Configurações > Autenticação.

2. Na guia Autenticação, marque a caixa de seleção Habilitar um método de autenticação adicional.

3. Selecione Conexão OpenID (OIDC) no menu suspenso e clique na seta suspensa Configuração (obrigatório).

4. Siga as etapas para configurar a autenticação do TCM para OIDC fazendo o seguinte:

   1. Na etapa 1, insira as informações necessárias do seu IdP, incluindo ID do cliente, segredo do cliente e URL de configuração.

   2. Na etapa 2, copie a URL de redirecionamento do TCM que você colará no portal do seu IdP para redirecionar os usuários após a autenticação.

   3. Na etapa 3, insira as declarações para garantir o mapeamento correto do nome de usuário e do nome de exibição dos usuários.

   4. Na etapa 4, habilite opcionalmente o logout único (SLO) se o seu IdP oferecer suporte.

5. Quando terminar, clique no botão Salvar alterações.

Observação: ao editar a configuração do OIDC, o segredo do cliente fica oculto e precisa ser digitado novamente antes que qualquer alteração possa ser salva.

Etapa 2: testar a configuração

É altamente recomendável que você teste a configuração para evitar cenários de bloqueio. Testar a configuração ajuda a garantir a configuração correta de OIDC antes de alterar o tipo de autenticação de seus usuários para OIDC. 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 OIDC configurado.

Observação: se não tiver certeza de quais são as reivindicações, conclua a configuração e teste-a. Testar a configuração produzirá uma nova janela com os detalhes dos mapeamentos de declarações, incluindo as declarações de nome de usuário e nome de exibição. Alguns IdPs podem mapear o endereço de e-mail para o nome de usuário do Tableau.

Para o Tableau Cloud

1. Na guia Autenticação enquanto OpenID Connect (OIDC) estiver selecionado, na etapa 6, clique no botão Configuração de teste. Uma nova janela é exibida com detalhes da configuração.

2. Ao terminar, conclua a configuração do OIDC adicionando usuários ao seu site seguindo a etapa abaixo.

Para TCM

1. Na guia Autenticação enquanto OpenID Connect (OIDC) estiver selecionado, na etapa 5, clique no botão Configuração de teste. Uma nova janela é exibida com detalhes da configuração.

2. Ao terminar, conclua a configuração do OIDC adicionando usuários ao seu locatário seguindo a etapa abaixo.

Etapa 3: adicionar usuários ao site do Tableau habilitado por OpenID Connect ou TCM

As etapas descritas nesta seção são executadas na página Usuários do Tableau Cloud ou do TCM.

1. Depois de concluir as etapas acima, retorne ao site do Tableau Cloud ou TCM.

2. No painel esquerdo, selecione a página Usuários.

3. Siga o procedimento descrito em um dos tópicos a seguir:

   • Para o Tableau Cloud, consulte Adicionar usuários a um site

   • Para o TCM, consulte Gerenciar usuários com o Tableau Cloud Manager

{
"iss":"https://myidp.okta.com/oauth2/default,
"sub": user,
"aud": "Tableau",
"email": "fsuzuki@example.com",
"email_verified": true,
"name": "Fred Suzuki",
"region": "South"
}