--- schema_version: "1" id: ae519a17bbcbb8eaa6a351bf2486398e1fda2da12a3fac7ab52ea2a84e2b1809 title: tsm authentication collection: tableau version: next locale: pt-br portal_url: https://docs.salesforce.com/tableau/next/pt-br/server/cli_authentication_tsm.md canonical_url: https://help.tableau.com/v0.0/server/pt-br/cli_authentication_tsm.htm source_site: help.tableau.com content_type: documentation content_hash: c01f3feef5b6ba46810c245fdf281d13359d746537c4ab3cddf891dc488a6130 description: Reference for tsm authentication commands to enable and configure Tableau Server user authentication. --- [Pular para o conteúdo principal](#main-content) # tsm authentication Use os comandos `tsm authentication` para habilitar, desabilitar e configurar as opções de autenticação de usuário do Tableau Server. - [identity-migration](#tsm_identity_mig_config) - [kerberos](#TSMKerb) - configure - disable - enable - [legacy-identity-mode](#tsm_identity_mig_legacy) - enable - disable - [list](#TSMAuthList) - [mutual-ssl](#TSMMutualSSL) - configure - disable - enable - [openid](#TSMOIDC) - configure - disable - enable - get-redirect-url - map-claims - [pat-impersonation](#TSMpat) - disable - enable - [saml](#TSMsaml) - configure - disable - enable - export-metadata - map-assertions - [sitesaml](#TSMsitesaml) - disable - enable - [sspi](#TSMSspi) - disable - enable - [trusted](#TSMTrusted) ## tsm authentication identity-migration configure Altere as configurações de trabalho padrão para a migração de identidade. Para obter mais informações, consulte [Gerenciar a migração de identidade](https://help.tableau.com/v0.0/server/pt-br/identity_migration_manage.htm) . ### Sinopse `tsm authentication identity-migration configure –job-run-time` `tsm authentication identity-migration configure –rate` ### Opções \-j,--job-run-time Opcional. Determina o tempo mais longo permitido, em minutos, que o trabalho de migração agendado pode ser executado. O valor padrão é 120 minutos. \-r,--rate Opcional. Determina o número de solicitações durante um trabalho de migração que podem ser executadas por segundo. O valor padrão é 5 solicitações por segundo. ## tsm authentication kerberos Habilita, desabilita e configura a autenticação de usuário do Kerberos no Tableau Server. Consulte [Configurar o Kerberos](https://help.tableau.com/v0.0/server/pt-br/config_kerberos.htm). ### Sinopse `tsm authentication kerberos configure --keytab-file [global options]` `tsm authentication kerberos enable [global options]` `tsm authentication kerberos disable [global options]` ### Opções de configuração do Kerberos \-kt, --keytab-file Obrigatório. Especifica o arquivo de serviço .keytab usado para solicitações ao KDC. ## tsm authentication legacy-identity-mode Habilite ou desabilite o modo de armazenamento de identidade herdado que pode ser necessário durante a migração de identidade. Reveja a seção [Não foi possível restaurar o backup](https://help.tableau.com/v0.0/server/pt-br/identity_migration_troubleshoot.htm#restore) para determinar quando usar este comando. Para obter mais informações, consulte [Sobre a migração de identidade](https://help.tableau.com/v0.0/server/pt-br/identity_migration.htm). ### Sinopse `tsm authentication legacy-identity-mode enable` `tsm authentication legacy-identity-mode disable` ## tsm authentication list Lista as definições de configuração relacionadas à autenticação existente do servidor. ### Sinopse `tsm authentication list [--verbose][global options]` ### Opções v, --verbose Opcional. Apresenta parâmetros configurados. ## tsm authentication mutual-ssl Habilita, desabilita e configura o SSL mútuo para autenticação de usuário no Tableau Server. Para saber mais sobre SSL mútuo, consulte [Configurar autenticação do SSL mútuo](https://help.tableau.com/v0.0/server/pt-br/ssl_config_mutual.htm). Antes de habilitar o SSL mútuo, é necessário configurar o SSL para comunicação externa. Para obter informações, consulte [Configurar o SSL para tráfego de HTTP externo e do Tableau Server](https://help.tableau.com/v0.0/server/pt-br/ssl_config.htm). ### Sinopse `tsm authentication mutual-ssl configure [options] [global options]` `tsm authentication mutual-ssl disable [global options]` `tsm authentication mutual-ssl enable [global options]` ### Opções \-cf, --ca-cert Opcional. Especifica a localização e o nome do arquivo do arquivo de certificado. O arquivo deve ser um certificado confiável e válido de uma Autoridade de certificação (Verisign, por exemplo). \-fb, --fallback-to-basic Opcional. Especifica se o Tableau Server deve aceitar o nome e senha de usuário para a autenticação se a autenticação do SSL falhar. O valor padrão é falso para indicar que, quando configurado para SSL mútuo, o Tableau Server não permite uma conexão se houver falha na autenticação de SSL. No entanto, o Tableau Server aceita autenticação com nome de usuário e senha de clientes REST API, mesmo que a opção acima esteja definida como `false`. \-m, --user-name-mapping Opcional. Especifica a sintaxe do nome de usuário (UPN, LDAP or CN) para recuperar do armazenamento de identidades ou diretório. A sintaxe deve corresponder ao formato de Subject (Assunto) ou de Subject Alternative Name (SAN, Nome alternativo) no certificado do usuário. \-rf, --revocation-file Opcional. Especifica a localização e o nome do arquivo do arquivo de certificado da lista de revogação. Este arquivo pode ser um arquivo .pem ou .der. ## tsm authentication openid Habilite, desabilite e configure a autenticação de usuário do OpenID Connect (OIDC) no Tableau Server. ### Sinopse `tsm authentication openid configure [options] [global options]` `tsm authentication openid disable [global options]` `tsm authentication openid enable [global options]` `tsm authentication openid get-redirect-url [global options]` `tsm authentication openid map-claims [options] [global options]` `tsm authentication openid enable-slo [options][global options]` `tsm authentication openid disable-slo [options][global options]` `tsm authentication openid get-slo-redirect-url [options][global options]` ### Observações - Os comandos `tsm authentication openid enable-slo`, `tsm authentication openid disable-slo` e `tsm authentication get-slo-redirect-url` foram adicionados no Tableau Server 2025.3 ### Opções de configuração do OpenID **Observação:** as opções devem ser definidas durante a configuração inicial ou durante a reconfiguração. As opções individuais não podem ser definidas separadamente. \-a, --client-authentication Obrigatório. Especifica o método de autenticação de cliente personalizado para OpenID Connect. Para configurar o Tableau Server para usar o Salesforce IdP, defina esse valor como `client_secret_post`. \-cs, --client-secret Obrigatório. 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. \-cu, --config-url Obrigatório. Especifica a localização do documento de descoberta de configuração do provedor que contém os metadados do provedor OpenID. Se o provedor hospedar um arquivo JSON público, use --config-url. Caso contrário, especifique um caminho no computador local e o nome do arquivo usando --metadata-file. \-mf, --metadata-file , --config-file Opcional. Especifica o caminho local para o documento JSON de descoberta OIDC estático. \-i, --client-id Obrigatório. Especifica a ID do cliente do provedor que o IdP designou para o aplicativo. \-id, --ignore-domain Opcional. Padrão: `false` Defina isso como `true`, se o seguinte for verdadeiro: - Você está usando endereços de e-mail como nomes de usuário no Tableau Server - Você forneceu aos usuários no IdP vários nomes de domínio - Você quer ignorar a parte de nome de domínio da recuperação `email` no IdP Antes de prosseguir, revise os nomes de usuário que serão usados como um resultado da configuração desta opção como `true`. Podem ocorrer conflitos do nome de usuário. Em caso de conflito de nome de usuário, o risco de divulgação de informações é alto. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/v0.0/server/pt-br/openid_auth_requirements.htm). \-if, --iframed-idp-enabled Opcional. Padrão: `false` Especifica se o IdP é permitido em um iFrame. O IdP deve desabilitar a proteção contra roubo de cliques para permitir a apresentação do iFrame. \-ij, --ignore-jwk Opcional. Padrão: `false` Defina como `true` se o seu IdP não oferecer suporte à validação JWK. Neste caso, recomendamos autenticar a comunicação com o seu IdP usando TLS mútuo ou outro protocolo de segurança da camada de rede. \-r, --return-url A URL do servidor. Ela é normalmente o nome público do seu servidor, como `"http://example.tableau.com"`. \-sn, --custom-scope-name Opcional. Especifica um valor de escopo personalizado relacionado ao usuário que pode ser usado para consultar o IdP. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/v0.0/server/pt-br/openid_auth_requirements.htm). ### Opções para openid map-claims Use essas opções para alterar as solicitações padrão do OIDC que o Tableau Server usará ao se comunicar com o IdP. Consulte [Requisitos para usar o OpenID Connect](https://help.tableau.com/v0.0/server/pt-br/openid_auth_requirements.htm). \-i, --id Opcional. Padrão: `sub` Altere este valor se o seu IdP não usar a recuperação `sub` para identificar exclusivamente os usuários do token ID. A recuperação IdP especificada deve conter uma única e exclusiva cadeia de caracteres. \-un, --user-name Opcional. Padrão: `email` Altere este valor para a recuperação IdP que a sua empresa usará para corresponder nomes de usuários, conforme armazenado no Tableau Server. ### Observações - Os comandos `tsm authentication openid enable-slo`, `tsm authentication openid disable-slo` e `tsm authentication get-slo-redirect-url` foram adicionados no Tableau Server 2025.3. ## tsm authentication pat-impersonation Ative e desative a representação do token de acesso pessoal para administradores em Tableau Server. Para obter mais informações sobre tokens de acesso pessoal, consulte [Tokens de acesso pessoal](https://help.tableau.com/v0.0/server/pt-br/security_personal_access_tokens.htm). ### Sinopse `tsm authentication pat-impersonation disable [global options]` `tsm authentication pat-impersonation enable [global options]` Para ver se a representação do token de acesso pessoal está ativada, execute o seguinte comando: `tsm authentication list` ## tsm authentication saml Configura o Tableau Server para suportar logon único ao usar o padrão do SAML 2.0, habilita ou desabilita o SAML para um site, mapeia nomes de atributo de afirmação entre o Tableau Server e o provedor de identidade (IdP). ### Comandos disponíveis `tsm authentication saml configure [options] [global options]` `tsm authentication saml disable [options] [global options]` `tsm authentication saml enable [options] [global options]` `tsm authentication saml export-metadata [options] [global options]` `tsm authentication saml map-assertions [options]` ## tsm authentication saml configure Defina as configurações de SAML para o servidor. Especifique o certificado SAML e os arquivos de metadados, forneça informações adicionais necessárias e defina as opções adicionais. Se estiver configurando o SAML pela primeira vez ou se o tiver desativado anteriormente, você deverá executar este comando com `tsm authentication saml enable`. Para obter mais informações, consulte [Configurar SAML em todo o servidor](https://help.tableau.com/v0.0/server/pt-br/config_saml.htm). ### Sinopse `tsm authentication saml configure [options] [global options]` ### Opções \-e, --idp-entity-id Obrigatório para a configuração SAML inicial; opcional em outros casos. Valor de ID da entidade do IdP Normalmente, é igual a URL de retorno do Tableau Server (especificada no parâmetro `--idp-return-url`). A ID de entidade que você insere é usada como uma base para a geração de IDs de entidade de sites específicos. Por exemplo, se você inserir: http://tableau-server Um site configurado para SAML pode exibir a seguinte ID de entidade: http://tableau-server/samlservice/public/sp/metadata?alias=48957410-9396-430a-967c-75bdb6e002a0 Para localizar a ID da entidade do site, vá para a página de Configurações do site e selecione a guia Autenticação. Quando o SAML está habilitado, a ID da entidade é mostrada na primeira etapa para configurar o SAML específico do site, exportando os metadados. \-r, --idp-return-url Obrigatório para a configuração SAML inicial; opcional em outros casos. A URL de retorno do SAML configurada no IdP. Normalmente, é a URL externa do Tableau Server; por exemplo, https://tableau-server. **Observações** - http://localhost não funciona em um servidor externo. - Adicionar uma barra à direita da URL (http://tableau-server/) não é suportado. \-i, --idp-metadata Obrigatório para a configuração SAML inicial; opcional em outros casos. Forneça o local e o nome do arquivo de metadados XML exportado das configurações do IdP. Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\` \-cf, --cert-file Obrigatório para a configuração SAML inicial; opcional em outros casos. O local e o nome do arquivo de certificado. Para requisitos do arquivo de certificado, consulte [Requisitos do SAML](https://help.tableau.com/v0.0/server/pt-br/saml_requ.htm). Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\` \-kf, --key-file Obrigatório para a configuração SAML inicial; opcional em outros casos. Local e nome do arquivo-chave que acompanha o certificado. Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\` Obrigatório para a configuração SAML inicial ao usar FIPS; opcional em outros casos. A localização e o nome do arquivo de certificado de criptografia. Para requisitos do arquivo de certificado, consulte [Requisitos do SAML](https://help.tableau.com/v0.0/server/pt-br/saml_requ.htm). Por exemplo, `/var/opt/tableau/tableau_server/data/saml/` Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\` \-ekf, --encryption-key-file Obrigatório para a configuração SAML inicial ao usar FIPS; opcional em outros casos. Local e nome do arquivo da chave de criptografia que corresponde ao certificado de criptografia. Por exemplo, `/var/opt/tableau/tableau_server/data/saml/` Por exemplo, `C:\ProgramData\Tableau\Tableau Server\data\saml\` \-a, --max-auth-age Opcional. O valor padrão é -1 (começando no Tableau Server versão 2020.4.15, 2021.1.12, 2021.2.9,2021.3.8, 20214.4, 2022 e posteriores). O valor padrão anterior é 7200 (2 horas). O número máximo de segundos permitidos entre a autenticação do usuário e o processamento da mensagem AuthNResponse. Recomendamos que você mantenha esse valor padrão, que desativa a verificação da idade máxima de autenticação. Se esse valor for diferente do seu IdP, os usuários que fizerem login no Tableau Server poderão ver um erro de login. Para obter mais informações sobre esse erro, consulte o artigo [Erro intermitente “Não é possível fazer login” com SAML SSO no Tableau Server](https://kb.tableau.com/articles/issue/intermittent-error-unable-to-sign-in-with-saml-sso-on-tableau-server?lang=pt-br) na Base de dados de conhecimento do Tableau. \-d, --desktop-access Opcional. O valor padrão é enable. Esta opção aplica-se somente ao SAML em todo o servidor Usa o SAML para fazer logon no servidor pelo Tableau Desktop. Se o logon único por meio dos aplicativos cliente do Tableau não funcionar com seu IdP, é possível definir isso como `disable`. \-m, --mobile-access Opcional. O valor padrão é enable. Permita o uso de SAML para fazer logon de versões mais antigas do aplicativo Tableau Mobile. Os dispositivos que executam a versão 19.225.1731 do aplicativo Tableau Mobile e ignoram essa opção. Para desabilitar os dispositivos que executam a versão 19.225.1731 e posteriores do Tableau Mobile, desabilite o SAML como uma opção de logon do cliente no Tableau Server. \-so, --signout Opcional. Habilitado por padrão. Habilita ou desabilita a opção SAML de "sair da sessão" para Tableau Server. \-su, --signout-url Opcional. Insere a URL de redirecionamento usada depois que os usuários saem do servidor. Por padrão, esta é a página de logon do Tableau Server. Você pode especificar uma URL absoluta ou relativa. ### Exemplo `tsm authentication saml configure --idp-entity-id https://tableau-server --idp-metadata "C:\ProgramData\Tableau\Tableau Server\data\saml\" --idp-return-url https://tableau-server --cert-file "C:\ProgramData\Tableau\Tableau Server\data\saml\" --key-file "C:\ProgramData\Tableau\Tableau Server\data\saml\"` ## tsm authentication saml enable and saml disable Habilita ou desabilita a autenticação SAML por todo o servidor. Neste contexto, todos os sites e usuários habilitados para SAML passam por um único provedor de identidade. ### Sinopse `tsm authentication saml enable [global options]` `tsm authentication saml disable [global options]` ## tsm authentication saml export-metadata Exportar o arquivo de metadados.xml do Tableau Server que será usado para configurar o SAML IdP. ### Sinopse `tsm authentication saml export-metadata [options] [global options]` ### Opções \-f, --file \[/path/to/file.xml\] Opcional. Especifica a localização e nome de arquivo em que os metadados serão gravados. Se não incluir essa opção, o comando `export-metadata` salva o arquivo no diretório atual e o nomeia `samlmetadata.xml`. \-o, --overwrite Opcional. Substitui um arquivo existente com o mesmo nome especificado em `-f`, ou do nome padrão se o `-f` não estiver incluído. Caso um arquivo especificado em `-f` existir e `-o` não estiver incluído, o comando não substitui o arquivo existente. ## tsm authentication saml map-assertions Mapeia atributos entre o IdP e o Tableau Server. Fornece o nome que o IdP usa para o atributo especificado em cada argumento. ### Sinopse `tsm authentication saml map-assertions --user-name  [global options]` ### Opções \-r, --user-name Opcional. O atributo no qual o IdP armazena o nome de usuário. No Tableau Server é igual ao nome de exibição. \-e, --email Não use. Esta opção não é compatível com o Tableau. \-o, --domain Opcional. O atributo no qual o IdP armazena o nome de domínio. Use essa opção se você adicionar usuários de um domínio diferente do domínio do computador do Tableau Server. Para obter mais informações, consulte [Ao executar vários domínios](https://help.tableau.com/v0.0/server/pt-br/saml_requ.htm#multiple_domains). \-d --display-name Não use. Esta opção não é compatível com o Tableau. ### Example for saml map-assertions `tsm authentication saml map-assertions --user-name= --domain=` ou `tsm authentication saml map-assertions --user-name=jnguyen --domain=example.myco.com` ## tsm authentication sitesaml enable and sitesaml disable Configura o servidor para permitir ou negar a autenticação SAML no nível de site. Habilitar o SAML específico ao site fornece acesso à guia Configurações > Autenticação na interface do usuário na Web do Tableau Server. A guia Autenticação contém as definições de configuração para o SAML específico ao site. Use o comando `sitesaml enable` com o `saml configure` se o servidor ainda não foi configurado para permitir o SAML específico ao site. Para obter mais informações, consulte [Configurar SAML específico do site](https://help.tableau.com/v0.0/server/pt-br/saml_site_specific.htm). ### Sinopse `tsm authentication sitesaml enable [global options]` `tsm authentication sitesaml disable [global options]` ## tsm authentication sspi Este comando só funcionará no Tableau Server no Windows. Ao tentar habilitar o SSPI no Tableau Server no Linux, um erro será retornado. Habilita ou desabilita o logon automático usando o Microsoft SSPI. Se usar o Active Directory, também é possível habilitar o logon automático, que usa o Microsoft SSPI para conectar automaticamente seus usuários com base em seus nomes de usuário e suas senhas do Windows. Isso cria uma experiência semelhante à de logon único (SSO). Não habilite o SSPI se planeja configurar o Tableau Server para SAML, autenticação confiável, uma balanceador de carga ou servidor proxy. O SSPI não é compatível com esses cenários. ### Sinopse `tsm authentication sspi disable [global options]` `tsm authentication sspi enable [global options]` Como em todos os comandos de autenticação, você deve executar `tsm pending-changes apply` depois de executar este comando. ## tsm authentication trusted Configura autenticação confiável (tickets confiáveis) para autenticação de usuário no Tableau Server. ### Sinopse `tsm authentication trusted configure [options] [global options]` ### Opções \-th, --hosts Opcional. Especifica os nomes de host confiável (ou endereços do IPv4) dos servidores da Web que hospedarão páginas com o conteúdo do Tableau. Para vários valores, insira os nomes em uma lista separada por vírgulas onde cada valor é encapsulado em aspas duplas. Por exemplo: tsm authentication trusted configure -th "192.168.1.101", "192.168.1.102", "192.168.1.103" ou tsm authentication trusted configure -th "webserv1", "webserv2", "webserv3" \-t, --token-length Opcional. Determina o número de caracteres em cada ticket confiável. A configuração padrão de 24 caracteres fornece 144 bits de aleatório. O valor pode ser definido como qualquer inteiro entre 9 e 255, inclusive. ## Opções globais \-h, --help Opcional. Exibir a ajuda do comando. \-p, --password Obrigatório, com `-u` ou `--username` se não tiver sessões ativas. Especificar a senha do usuário especificado no `-u` ou `--username`. Se a senha tiver espaços ou caracteres especiais, coloque-a entre aspas: `--password "my password"` \-s, --server https://:8850 Opcional. Usar o endereço definido para o Gerenciador de serviços do Tableau. A URL deve começar com `https`, incluir a porta 8850 e usar o nome do servidor, não o endereço IP. Por exemplo, `https://:8850`. Se nenhum servidor for especificado, o `https://:8850` é considerado. \--trust-admin-controller-cert Opcional. Use este sinalizador para confiar no certificado autoassinado do controlador TSM. Para obter mais informações sobre confiança de certificado e conexões CLI, consulte [Conexão de clientes do TSM](https://help.tableau.com/v0.0/server/pt-br/tsm_overview.htm#Connecti). \-u, --username Obrigatório se nenhuma sessão estiver ativa, com `-p` ou `--password`. Especificar uma conta de usuário. Se não incluir essa opção, o comando é executado usando as credenciais de logon.