Ajuda do Tableau Cloud

Tokens contêm informações sobre tokens de usuário ativos e não expirados no site, incluindo tokens de acesso pessoal (PATs), tokens de atualização e tokens OAuth. Os administradores do site podem monitorar o uso e a expiração dos tokens por meio da fonte de dados, alternando os tokens essenciais conforme necessário.

Os seguintes tokens estão incluídos na fonte de dados:

• Banco de dados OAuth - Gerencie os tokens de acesso usados para conexões OAuth. Os tokens de acesso permanecem válidos até um usuário do excluí-los ou o provedor de dados revogá-los. Para obter mais informações, consulte Conexões OAuth.

• Cliente OAuth - Gerencie tokens de atualização usados por clientes conectados, como Tableau Desktop e Tableau Prep. Para obter informações, consulte Acessar sites de clientes conectados.

• Tokens de acesso pessoal (PATs) - Gerencie tokens de autenticação de longa duração usados para fazer login no Tableau Cloud, como scripts automatizados e tarefas criadas com a API REST do Tableau. Para obter mais informações, consulte Tokens de acesso pessoal.

A qualquer momento, os administradores do site podem revogar rapidamente um token, cancelando a licença de um usuário com o token indesejado. Com a ressalva de que novos tokens deverão ser criados quando o usuário for relicenciado. Para conhecer as etapas de remoção ou revogação de tipos específicos de tokens, siga os links da seção anterior.

Se você for um administrador de site ou alguém com acesso ao projeto Informações administrativas, poderá acessar as fontes de dados do Informações administrativas diretamente do Tableau Cloud usando a criação na Web ou por meio do Tableau Desktop. Para obter mais informações sobre a conexão às fontes de dados de Informações administrativas, consulte Usar as Informações administrativas para criar Exibições personalizadas.

Use as etapas a seguir para criar uma exibição que mede quando os tokens do banco de dados OAuth foram atualizados pela última vez e a conformidade com a rotação de tokens dentro de uma organização.

1. Conecte-se à fonte de dados Tokens usando um dos procedimentos listados em Fonte de dados de Tokens.

2. No painel Dados, arraste Nome do grupo até a divisória Filtro. Marque a caixa de seleção Banco de dados Oauth e clique em OK.

3. Arraste Tipo de banco de dados, Nome de usuário do banco de dados, e Última atualização para a divisória Linhas.

4. Na divisória Linhas, clique com o botão direito em Ultima atualização e selecione Data exata no menu de contexto. Mude o campo de contínuo para discreto.

5. No menu, clique em Análise > Criar campo calculado.

   1. Nome: dias desde a última atualização

   2. Cálculo:

      ROUND(TODAY()-[Last Updated])

6. Clique em OK.

7. No painel Dados, arraste o campo Dias desde a última atualização na divisória Linhas. Mude o campo de contínuo para discreto.

Para evitar interrupções, como erros de carregamento de visualização e atualizações de extração com falha, é importante monitorar a expiração dos tokens de banco de dados OAuth inseridos. Use o exemplo a seguir para criar uma exibição que identifica tokens que estão prestes a expirar, permitindo que os usuários atualizem suas credenciais de forma proativa.

Observação: o Tableau não armazena prazos de expiração para tokens de banco de dados OAuth. Para obter essas informações, entre em contato com o administrador do banco de dados para verificar os detalhes de expiração de cada tipo de banco de dados.

1. Conecte-se à fonte de dados de Tokens.

2. No painel Dados, arraste Nome do grupo até a divisória Filtro. Marque a caixa de seleção Banco de dados Oauth e clique em OK.

3. Arraste Tipo de banco de dados e E-mail do proprietário para a divisória Linhas.

4. No menu, clique em Análise > Criar campo calculado. Neste exemplo, usamos um banco de dados Snowflake com prazo de validade de 90 dias.

   1. Nome: Expires At (all tokens)

   2. Cálculo:

      IF [Token Type] = 'OAuth Database'
      THEN
      IF [Database Type] = 'snowflake'
      THEN DATEADD('day', 90, [Last Updated])
      // add conditions for other database types here //
      ELSE NULL
      END
      ELSE [Expires At]
      END

5. No menu, clique em Análise > Criar campo calculado.

   1. Nome: Days Until Expiration

   2. Cálculo:

      DATEDIFF('day', TODAY(), [Expires At (all tokens)])

6. Arraste Dias até expirar à divisória Linhas. Mude o campo de contínuo para discreto.

7. Arraste Dias até expirar para a divisória Filtros. Selecione Todos os valores, definindo o Máximo como 14. Isso filtra os tokens que expiram nos próximos 14 dias ou aqueles que já expiraram. Ajuste conforme necessário.

8. Use os valores resultantes para entrar em contato com usuários cujos tokens expirarão em breve.

O exemplo a seguir exibe os nomes e funções de site dos usuários que têm PATs no site. Você pode ajustar o filtro para outros tipos de token.

1. Conecte-se às fontes de dados de Tokens e Usuários do TS.

2. Selecione Dados > Editar Combinar relacionamentos

3. Na caixa de diálogo Combinar relacionamentos, defina a fonte de dados primária como Tokens e selecione o botão de opções Personalizado.

4. Clique em Adicionar.

5. Na caixa de diálogo Adicionar/Editar mapeamento de campo, mapeie E-mail do proprietário para E-mail do usuário e clique em OK > OK.

6. No painel Dados, arraste Nome do grupo até a divisória Filtro. Marque a caixa de seleção PAT e clique em OK.

7. No painel Dados, arraste Nome de usuário, Função de site de usuário, Expira em e Última utilização em na divisória Linhas.

8. Verifique se E-mail do usuário é o campo de vinculação no painel Dados. Se houver um link quebrado, clique no ícone próximo ao nome do campo para vincular as duas fontes de dados.

9. Na divisória Linhas, clique com o botão direito Expira em e selecione Data exata no menu de contexto. Mude o campo de contínuo para discreto.

10. Repita a etapa 7 para Última atualização em.

Com o Tableau Prep, você pode unir outras fontes de dados de Informações administrativas nos seguintes campos para obter mais visibilidade do seu site. Se estiver analisando dados de vários sites do Tableau Cloud, você também deve ingressar em "Site LUID = Site LUID".

• Para ver a função do site do proprietário do token, junte Tokens aos usuários TS em “E-mail do proprietário” = “E-mail do usuário”

• Para ver a associação do proprietário do token ao grupo, junte os tokens aos grupos em “E-mail do proprietário” = “E-mail do usuário”

Para obter mais informações, consulte Agregar, Unir colunas ou Unir linhas de dados(O link abre em nova janela) na Ajuda do Prep do Tableau.

A tabela a seguir lista os campos incluídos na fonte de dados de Tokens. Cada linha de dados corresponde a uma combinação de ID do token e e-mail do proprietário.