--- schema_version: "1" id: 7fb8d93128a3ba5860bd50716d153d7fbecb9e9a017681042b5ab729c51eb4b4 title: Configurar o Tableau Server para OpenID Connect collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/server-linux/openid_auth_server_config.md canonical_url: https://help.tableau.com/current/server-linux/pt-br/openid_auth_server_config.htm source_site: help.tableau.com content_type: documentation content_hash: aa716ad7e11d4f375c007232a0ae1a69cf977e7ad5de86635614ade05c3dbea4 description: Configure Tableau Cloud or TCM to use OpenID Connect for single sign-on. --- [Pular para o conteúdo principal](#main-content) # Configurar o Tableau Server para OpenID Connect Este tópico descreve como configurar o Tableau Server para usar o OpenID Connect (OIDC) para logon único (SSO, Single Sign-on). Esta é uma etapa contida em um processo de várias etapas. Os tópicos a seguir fornecem informações sobre a configuração e uso de OIDC com Tableau Server. 1. Visão geral do [OpenID Connect](https://help.tableau.com/current/server-linux/pt-br/openid_auth.htm) 2. [Configurar o provedor de identidades para o OpenID Connect](https://help.tableau.com/current/server-linux/pt-br/openid_auth_idp_config.htm) 3. Configurar Tableau Server para OpenID Connect (você está aqui) 4. [Como fazer logon no Tableau Server usando o OpenID Connect](https://help.tableau.com/current/server-linux/pt-br/openid_auth_signing_in.htm) **Observações:** - Antes de executar as etapas descritas aqui, você deve configurar o provedor de identidade OpenID (IdP), conforme descrito em [Configurar o provedor de identidades para o OpenID Connect](https://help.tableau.com/current/server-linux/pt-br/openid_auth_idp_config.htm). - Os procedimentos descritos neste tópico podem se aplicar à autenticação OIDC configurada com pools de identidades. No entanto, primeiro siga [Provisionar e autenticar usuários usando grupos de identidade](https://help.tableau.com/current/server-linux/pt-br/identity_pools.htm) e consulte este tópico, se necessário. - A API REST do Tableau e o tabcmd não oferecem suporte ao logon único (SSO) do OIDC. Para usar o [tabcmd](https://help.tableau.com/current/server-linux/pt-br/tabcmd.htm) ou a [API REST](https://help.tableau.com/current/api/rest_api/pt-br/help.htm "Abre a ajuda da API REST em uma nova guia"), os usuários devem fazer logon no Tableau Server usando uma conta do TableauID. 1. Abra o TSM em um navegador: https://:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server-linux/pt-br/sign_in_tsm.htm). 2. Na guia CONFIGURAÇÃO, selecione Identidade e acesso do usuário > Método de autenticação. 3. Em Método de autenticação, selecione OpenID Connect no menu suspenso. 4. Em OpenID Connect, selecione Habilitar autenticação do OpenID para o servidor. 5. Insira as informações de configuração do OpenID da sua empresa: ![Imagem de uma configuração do OpenID Connect no TSM](/tableau/current/pt-br/server-linux/pt-br/Img/tsm_ui_oidc.png) **Observações:** - Para a **Etapa 3:** se seu provedor depender de um arquivo de configuração hospedado no computador local (em vez de um arquivo hospedado em uma URL pública), você poderá especificar o arquivo com o [tsm authentication openid ](https://help.tableau.com/current/server-linux/pt-br/cli_authentication_tsm.htm#TSMOIDC). Use a opção `--metadata-file ` para especificar um arquivo de configuração do IdP local. - Para a **Etapa 4:** a partir do Tableau Server 2025.3, você pode habilitar o logout único (SLO) e especificar uma URL para redirecionar seus usuários após serem desconectados. - Para a Etapa 5: a partir do Tableau Server 2026.2, você pode habilitar atributos de usuário e suas funções como parte do fluxo de trabalho de autenticação OIDC. Para obter mais informações, consulte [Atributos de usuário em declarações OIDC](https://help.tableau.com/current/server-linux/pt-br/openid_auth.htm#user_attributes). 6. Clique em Salvar alterações pendentes após ter inserido as informações de configuração. 7. Clique em Alterações pendentes na parte superior da página: ![Barra de ferramentas do Tableau Server Manager indicando que há alterações pendentes.](/tableau/current/pt-br/server-linux/pt-br/Img/tsm-ui-pending-changes-btn.png) 8. Clique em Aplicar alterações e reiniciar. O procedimento nesta seção descreve como usar a interface de linha de comando de TSM para configurar o OpenID Connect. Como alternativa, use um arquivo de configuração para a configuração inicial do OpenID Connect. Consulte [Entidade openIDSettings](https://help.tableau.com/current/server-linux/pt-br/entity_openid.htm). 1. Use o comando `configure` de [tsm authentication openid ](https://help.tableau.com/current/server-linux/pt-br/cli_authentication_tsm.htm#TSMOIDC) para definir as seguintes opções exigidas: - `--client-id `: especifica a ID do cliente do provedor que a IdP atribuiu ao aplicativo. Por exemplo, `“xxxkjwdlnaoiloadjkwha"`. - `--client-secret `: especifica o segredo do cliente do provedor. Este é um token usado pelo Tableau para verificar a autenticidade da resposta do IdP. Este valor é um segredo e deve ser mantido em segurança. Por exemplo, `“xxxhfkjaw72123="`. - `--config-url ` ou `--metadata-file `: especifica a localização do arquivo json de configuração do provedor. Se o provedor hospedar um arquivo de descoberta JSON público, use `--config-url`. Caso contrário, especifique um caminho no computador local e o nome do arquivo para `--metadata-file`. - `--return-url `: a URL do servidor. É normalmente o nome público do seu servidor, como `"http://example.tableau.com"`. Por exemplo, execute o comando: `tsm authentication openid configure --client-id “xxxkjwdlnaoiloadjkwha" --client-secret “xxxhfkjaw72123=" --config-url "https://example.com/openid-configuration" --return-url "http://tableau.example.com"` **Observação:**  - Existem configurações adicionais e opcionais que podem ser definidas para o Open ID Connect usando [Entidade openIDSettings](https://help.tableau.com/current/server-linux/pt-br/entity_openid.htm). Como alternativa, você pode usar [tsm authentication openid ](https://help.tableau.com/current/server-linux/pt-br/cli_authentication_tsm.htm#TSMOIDC). Além disso, se for necessário configurar o mapeamento de reivindicação de IdP, consulte [Opções para openid map-claims](https://help.tableau.com/current/server-linux/pt-br/cli_authentication_tsm.htm#Options2). - A partir do Tableau Server 2025.3, você pode usar o [tsm authentication openid ](https://help.tableau.com/current/server-linux/pt-br/cli_authentication_tsm.htm#TSMOIDC) para habilitar opcionalmente o logout único (SLO). 2. Digite o seguinte comando para habilitar o Open ID Connect: `tsm authentication openid enable` 3. Execute `tsm pending-changes apply` para aplicar as alterações. 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/current/server-linux/pt-br/cli_pending-changes.htm#pending-changes-apply). ## Personalizar e controlar o acesso aos dados usando atributos de usuário Os atributos de usuário são metadados de usuário definidos pela sua organização. Os atributos de usuário podem ser usados para determinar o acesso em um modelo de autorização típico de controle de acesso baseado em atributos (ABAC). Os atributos de usuário podem ser qualquer aspecto do perfil do usuário, incluindo cargos, associação departamental, nível de gerenciamento etc. Eles também podem estar associados a contextos de usuário de tempo de execução, como onde o usuário está conectado ou sua preferência de idioma. Ao incluir atributos do usuário em seu fluxo de trabalho, você pode controlar e personalizar a experiência do usuário por meio de acesso e personalização de dados. - **Acesso aos dados**: os atributos do usuário podem ser usados para impor políticas de segurança de dados. Isso garante que os usuários vejam apenas as informações que estão autorizados a ver. - **Personalização**: ao passar atributos de usuário como localização e função, seu conteúdo pode ser personalizado para exibir apenas as informações relevantes para o usuário que o acessa, facilitando a localização das informações de que precisa. **Resumo das etapas para passar atributos de usuário** O processo de habilitar atributos de usuário em um fluxo de trabalho é resumido nas seguintes etapas: 1. Habilitar a configuração de atributos de usuário 2. Incluir atributos de usuário na asserção 3. Verificar se o autor do conteúdo inclui funções de atributo de usuário e filtros relevantes 4. Revisar o conteúdo ### Etapa 1: habilitar a configuração de atributos de usuário Por motivos de segurança, os atributos de usuário só são validados em um fluxo de trabalho de autenticação quando a configuração de atributo de usuário é habilitada por um administrador de servidor. 1. Abra o TSM em um navegador: https://:8850. Para obter mais informações, consulte [Fazer logon na interface do usuário na Web do Tableau Services Manager](https://help.tableau.com/current/server-linux/pt-br/sign_in_tsm.htm). 2. Na guia CONFIGURAÇÃO, selecione Identidade e acesso do usuário > Método de autenticação. 3. Em Método de autenticação, selecione SAML no menu suspenso. 4. **Sob Etapa 8**, marque a caixa de seleção Habilitar captura de atributos do usuário durante autenticação SAML. 5. Quando terminar, faça o seguinte: 1. Clique em Salvar alterações pendentes. 2. Clique no botão Alterações o pendentes na parte superior da página. 3. Clique em Aplicar alterações e reiniciar. ### Etapa 2: incluir o atributo de usuário na asserção Certifique-se de que a asserção contenha os atributos de usuário. **Observação:** os atributos na resposta SAML estão sujeitos ao limite de 4096 caracteres, com exceção dos atributos `scope` ou `scp`. Se os atributos na resposta, incluindo os atributos do usuário, excederem esse limite, o Tableau vai remover os atributos e passar o atributo `ExtraAttributesRemoved`. O autor do conteúdo pode então criar um cálculo com o atributo `ExtraAttributesRemoved` para determinar como exibir o conteúdo aos usuários quando o atributo for detectado. **Exemplo** Suponha que você tenha um funcionário, Fred Suzuki, que é um gerente localizado na região Sul. Você quer garantir que, quando Fred revisar relatórios, ele só consiga ver os dados da região Sul. Em um cenário como este, você pode incluir o atributo de usuário Region na resposta SAML, como no exemplo abaixo. https://myidp.okta.com/saml South ### Etapa 3: verificar se o autor do conteúdo inclui funções de atributo Verifique se o autor do conteúdo inclui as funções de atributo do usuário e filtros relacionados para controlar quais dados podem ser exibidos em seu conteúdo. Para garantir que as asserções de atributo do usuário sejam passadas para o Tableau, o conteúdo deve conter uma das seguintes funções de atributo do usuário: - `USERATTRIBUTE('attribute_name')` - `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')` A função usada pelo autor de conteúdo depende se os atributos do usuário devem retornar um único valor ou vários. Para obter mais informações sobre essas funções e exemplos de cada uma, consulte [Funções do usuário](https://help.tableau.com/current/pro/desktop/pt-br/functions_functions_user.htm#user_attributes) na Ajuda do Tableau. **Observações:** - Visualização do conteúdo com essas funções não está disponível durante a criação no Tableau Desktop ou Tableau Cloud. A função retornará NULL ou FALSE. Para garantir que as funções do usuário funcionem conforme o esperado, recomendamos que o autor revise as funções após disponibilizar o conteúdo. - Para garantir que o conteúdo seja renderizado conforme o esperado, o autor do conteúdo pode considerar a inclusão de um cálculo que use `ExtraAttributesRemoved` que 1) verifica esse atributo e 2) determina o que fazer com o conteúdo se ele existir, como exibir uma mensagem. O Tableau só adicionará o atributo `ExtraAttributesRemoved` e removerá todos os outros atributos (exceto `scp` ou `scope`) quando os atributos no SAML XML excederem 4096 caracteres. Isso é para garantir o desempenho ideal e respeitar as limitações de armazenamento. **Exemplo** Continuando o exemplo introduzido na [Etapa 2: incluir o atributo de usuário na asserção](#step_pass_user_attribute) acima, para passar a asserção de atributo de usuário “Region” para uma pasta de trabalho, o autor pode incluir `USERATTRIBUTEINCLUDES`. Por exemplo, `USERATTRIBUTEINCLUDES('Region', [Region])`, onde “Region” é o atributo do usuário e \[Region\] é uma coluna nos dados. Usando o novo cálculo, o autor pode criar uma tabela com dados de Gerente e Vendas. Quando o cálculo é adicionado, a pasta de trabalho retorna os valores “False” conforme esperado. ![](/tableau/current/pt-br/server-linux/pt-br/Img/uaf_calc_view.png) Para mostrar apenas os dados associados à região Sul na pasta de trabalho inserida, o autor pode criar um filtro e personalizá-lo para mostrar valores quando a região Sul for “True”. Quando o filtro é aplicado, a pasta de trabalho fica em branco, conforme esperado, porque a função está retornando valores “False” e o filtro é personalizado para mostrar apenas valores “True”. ![](/tableau/current/pt-br/server-linux/pt-br/Img/uaf_filter_view.png) ### Etapa 4: revisar o conteúdo Revise e valide o conteúdo. **Exemplo** Para concluir o exemplo da [Etapa 3: verificar se o autor do conteúdo inclui funções de atributo](#step_include_uaf) acima, você pode ver que os dados de vendas na exibição são personalizados para Fred Suzuki porque o contexto de usuário dele é a região Sul. ![](/tableau/current/pt-br/server-linux/pt-br/Img/uaf_embedded_view_south.png) Os gerentes das regiões representadas na pasta de trabalho devem ver o valor associado à sua região. Por exemplo, Sawdie Pawthorne, da região Oeste, vê dados específicos para sua região. ![](/tableau/current/pt-br/server-linux/pt-br/Img/uaf_embedded_view_west.png) Os gerentes cujas regiões não estão representadas na pasta de trabalho verão uma pasta de trabalho em branco. ### Problemas conhecidos e limitações Existem alguns problemas conhecidos e limitações que você deve considerar ao trabalhar com funções de atributo do usuário.