--- schema_version: "1" id: eb876baabf87ac8da46ea2f2eb6998d99dad6a182c32c5316009db623c84b7e4 title: Sobre a migração de identidade collection: tableau version: next locale: pt-br portal_url: https://docs.salesforce.com/tableau/next/pt-br/server-linux/identity_migration.md canonical_url: https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration.htm source_site: help.tableau.com content_type: documentation content_hash: 1c6b073ef6a035dbe94279cc771647f2ec7217d08d423a93c7604f6508eb1d82 description: Run the identity migration to move Tableau Server to use the Identity Service. --- [Pular para o conteúdo principal](#main-content) # Sobre a migração de identidade A partir da versão 2022.1, o Tableau Server armazena e gerencia informações de identidade usando o Identity Service. A migração de identidade é um pré-requisito para configurar e usar [pools de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_pools.htm). > [!WARNING] > > **Importante:** se você não planeja usar o recurso de pools de identidades, recomendamos não executar a migração de identidade. Executar a migração de identidade sem planos de usar pools de identidades não trará benefícios à implantação do Tableau Server. Para implantações existentes, se atualizar o Tableau Server para a versão 2022.1 (ou posterior) e restaurar um backup do Tableau 2021.4 (ou anterior), você pode iniciar a migração de identidade após a conclusão da atualização do Tableau Server para preencher o novo Serviço de identidade. A migração de identidade preenche tabelas complementares do Serviço de Identidade para todos os usuários do Tableau Server, que são usadas para autenticar usuários por meio do Serviço de Identidade. A migração é executada em segundo plano e não interromperá nem interferirá no uso do Tableau Server por seus usuários. Como administrador, você pode monitorar e gerenciar a migração, incluindo alterar quando a migração é executada ou resolver possíveis conflitos de migração, por meio de uma página dedicada de **Migração de Identidade** disponível na página Usuários do Tableau Server. Essa página está disponível durante o processo de migração. ## Resumo das etapas para implantações existentes Para implantações novas e existentes, você deve configurar o Tableau Server para usar o Serviço de identidade após a conclusão da migração para aproveitar as melhorias na estrutura de identidade e configurar pools de identidade. > [Etapa 1: antes de começar](#step1) > > [Etapa 2: habilitar novo esquema e capacidade de login](#step2) > > [Etapa 3: iniciar a migração de identidade](#step3) > > [Etapa 4: concluir a migração de identidade](#step4) > > [Etapa 5: configurar o Tableau Server para usar o Serviço de identidade](#step5) > > [Etapa 6: habilitar pools de identidade](#step6) ### Termos-chave - **Serviço de identidade** - um serviço no Tableau Server 2022.1 (e posterior) responsável pela administração de identidades de usuários, incluindo autenticação e provisionamento. O serviço usa um esquema de identidade em que as identidades do usuário são representadas pelas tabelas do Serviço de Identidade e a tabela herdada "system\_users". - **Pools de identidade** - uma ferramenta de gerenciamento de identidade que usa informações de provisionamento e autenticação para permitir o acesso do usuário ao Tableau Server. Os pools de identidade permitem um fluxo de trabalho de gerenciamento de identidade mais centralizado e flexível, criado no Serviço de identidade para repositório e gerenciamento de identidades de usuário no Tableau Server. - **Modo de armazenamento de identidade herdado** - um esquema de identidade limitado usado pelo Tableau Server 2021.4 (e anterior), em que as identidades de usuário são representadas apenas pela tabela "system\_users" herdada. - **Migração de identidade** - o processo de auditoria que avalia as identidades de usuários existentes do sistema Tableau Server, consulta os armazenamentos de identidade externos upstream para obter informações de identidade adicionais (conforme apropriado) e importa essas informações de identidade adicionais para o Serviço de identidade. - **Armazenamento de identidade externo** - um tipo de armazenamento de identidade externo e upstream para o Tableau Server, em que todas as informações de identidade são armazenadas e gerenciadas por um serviço de diretório externo (Active Directory \[AD\] ou LDAP). Se configurado, o Tableau Server sincroniza com o diretório externo para que exista uma cópia das informações de identidade no Tableau Server. - **Armazenamento de identidade site** - um tipo de armazenamento de identidade fornecido pelo Tableau Server. Se configurado, o Tableau Server armazena e gerencia informações de identidade no repositório do Tableau Server sem nenhum diretório externo configurado para essas informações. - **Usuário do sistema** - um usuário do Tableau Server. Um usuário corresponde a um registro de entrada ("system\_users") no Serviço de Identidade (por meio da tabela "system\_users\_identities") e no modo de armazenamento de identidade herdado. Um registro "system\_users" pode ter várias identidades de usuário associadas a ele e habilitado para entrar em vários sites. O vínculo entre um registro "system\_users" e sites é definido na tabela "users". ### Objetivo da migração de identidade Quando você cria um backup do Tableau Server, as informações de identidade são salvas no esquema de identidade usado pela versão do Tableau Server para a qual o backup foi criado. A migração é necessária para preencher as informações de identidade do esquema de identidade usado no backup para o esquema de identidade usado pelo Serviço de Identidade. **Esquema de identidade do Tableau Server 2021.4 e anteriores** ![Um diagrama de um serviço de aplicativo com duas caixas rotuladas como "system\_users" e "domains".](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_tables_legacy.png) O esquema de identidade usado pelo modo de armazenamento de identidade herdado consiste em duas tabelas, "system\_users" e "domains". **Esquema de identidade do Tableau Server 2022.1 e posteriores** ![Um diagrama que ilustra as tabelas do banco de dados para o serviço de identidade.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_tables.png) O esquema de identidade usado pelo Serviço de Identidade inclui as tabelas legadas "system\_users" e tabelas complementares do Serviço de Identidade (\*\_identity\_stores e \*identities) que capturam mais informações de identidade. As tabelas adicionais ajudam a reduzir problemas que podem ser causados por alterações upstream nos armazenamentos de identidade externos. ### O que acontece durante a migração de identidade Quando as informações sobre identidades de usuários são migradas, as informações de identidade armazenadas na tabela legada "system\_users" são complementadas com as tabelas do Serviço de Identidade. O tipo de tabelas de serviço de identidade com as quais as informações de identidade são complementadas depende do tipo de armazenamento de identidades configurado no Tableau Server: site, Active Directory (AD) ou Lightweight Directory Access Protocol (LDAP). - Para tipos de armazenamento de identidade do **AD**, as tabelas do Serviço de Identidade herdam apenas atributos não ambíguos ou atributos que não são armazenados no mesmo registro de banco de dados. Por exemplo, sAMAccountNAME e userPrincipalName (UPN) podem ser armazenados no mesmo registro de nome de uma tabela legada "systems\_users", que pode ocorrer como resultado de uma série complexa de regras. Na maioria dos casos, a migração é capaz de interpretar corretamente e migrar com êxito a identidade do usuário. No entanto, se a migração produzir resultados ambíguos, você deverá confirmar manualmente a ambiguidade ou resolver manualmente o conflito usando a página dedicada de migração de identidade. Para obter mais informações, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_conflicts.htm) . - Para tipos de armazenamento de identidade **LDAP**, como tipos de armazenamento de identidade AD, as tabelas do Serviço de Identidade herdam apenas atributos não ambíguos. Na maioria dos casos, a migração é capaz de interpretar corretamente e migrar com êxito a identidade do usuário. No entanto, se a migração produzir resultados ambíguos, você deverá confirmar manualmente a ambiguidade ou resolver manualmente o conflito usando a página dedicada de migração de identidade. Para obter mais informações, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_conflicts.htm) . - Para tipos de armazenamento de identidade **local**, as tabelas do Serviço de Identidade herdam os campos de usuário e domínio diretamente. Isso significa que nenhuma informação adicional ou resolução manual é exigida de você. Quando o Tableau Server é configurado para esse tipo de armazenamento de identidade, a migração de identidades de usuários ocorre após o processo de restauração de backup do Tableau Server. ## Desempenho da migração de identidade ### Etapa 1: antes de começar Antes de começar, identifique abaixo o método de versão e upgrade do Tableau Server (se aplicável) para determinar as próximas etapas da migração de identidade.
Fazer upgrade deUpgrade paraMétodo de upgradePróximas etapas
n/aVersões do Tableau Server: 2022.1.0 (e posterior), 2022.3.0 (e posterior), 2023.1 (e posterior) e posteriorNova instalaçãoVá para a Etapa 2.
Versões do Tableau Server: 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5Versões do Tableau Server: 2022.1.8 (e posterior), 2022.3.10 (e posterior), 2023.1.6 (e posterior) e posteriorn/a

Você habilitou o novo esquema para login (ou seja, wgserver.authentication.legacy_identity_mode.enabled -v false)?

Tableau Server versões: 2021.4.x ou anterioresVersões do Tableau Server: 2022.1.8 (e posterior), 2022.3.10 (e posterior), 2023.1.6 (e posterior) e posteriorn/aVá para a Etapa 2.
Tableau Server versões: 2021.4.x ou anterioresVersões do Tableau Server: 2022.1.0-2022.1.7, 2022.3.0-2022.3.9 ou 2023.1.0-2023.1.5Se você estiver executando uma atualização Azul/Verde ou atualizando manualmente o Tableau Server 1) instalando o Tableau Server em uma nova máquina e 2) fazendo backup e restaurando o Tableau Server usando os comandos tsm Maintenance (backup and restore), será necessário que você siga algumas etapas adicionais para iniciar a migração.Vá para Solucionar problemas com migração de identidade.
Se você estiver fazendo uma atualização “in-loco” de servidor único ou de vários nós do Tableau Server usando o método descrito aqui, não há etapas adicionais necessárias para iniciar a migração. A migração é iniciada após a conclusão da atualização do Tableau Server para a versão 2022.1 (ou posterior).Vá para a Etapa 2.
Se você estiver atualizando manualmente o Tableau Server 1) instalando o Tableau Server em uma nova máquina e 2) exportando e importando informações de configuração e topologia usando os comandos tsm settings (exportar e importar), também não há etapas adicionais necessárias para iniciar a migração. A migração é iniciada após a conclusão do processo de importação na nova máquina do Tableau Server.Vá para a Etapa 2.
### Etapa 2: habilitar novo esquema e capacidade de login Antes de iniciar a migração de identidade, o novo esquema de identidade deve ser habilitado pelo comando tsm [features.NewIdentityMode](https://help.tableau.com/v0.0/server-linux/pt-br/cli_configuration-set_tsm.htm#identity_mode_new); e continuar permitindo o logon no Tableau Server enquanto o processo de migração de identidade ocorre pelos comandos tsm [wgserver.authentication.legacy\_identity\_mode.enabled](https://help.tableau.com/v0.0/server-linux/pt-br/cli_configuration-set_tsm.htm#legacy_identity_mode) ou [tsm authentication legacy-identity-mode ](https://help.tableau.com/v0.0/server-linux/pt-br/cli_authentication_tsm.htm#tsm_identity_mig_legacy). 1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster. 2. Execute o seguinte comando: ``` tsm configuration set -k features.NewIdentityMode -v true ``` 3. Execute os seguintes comandos dependendo da versão do Tableau Server que você está executando: - Para as versões 2022.1.8 (e posteriores), 2022.3.10 (e posteriores), 2023.1.6 (e posteriores) e posteriores do Tableau Server: ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v true tsm pending-changes apply ``` - Para as versões 2022.1.0-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server: ``` tsm authentication legacy-identity-mode enable tsm pending-changes apply ``` **Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado. ### Etapa 3: iniciar a migração de identidade **Observação:** se você atualizou para as versões 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server, a migração de identidade será iniciada por padrão e você poderá pular para a [Etapa 4: concluir a migração de identidade](#step4). Para iniciar a migração de identidade, deve-se ativar o recurso de migração de identidade usando o comando tsm [features.IdentityMigrationBackgroundJob](https://help.tableau.com/v0.0/server-linux/pt-br/cli_configuration-set_tsm.htm#identity_migration). 1. Execute o seguinte comando: ``` tsm configuration set -k features.IdentityMigrationBackgroundJob -v true ``` Após o início da migração de identidade, você verá uma notificação no Tableau Server que o vincula à página Migração de identidade. A página Migração de identidade é onde você pode monitorar o status da migração de identidade e dos conflitos de identidade que precisam ser resolvidos. ### Etapa 4: concluir a migração de identidade **Observação**: pule esta etapa para novas instalações. Para concluir a migração de identidade, todos os conflitos de identidade devem ser resolvidos ou reconhecidos antes que você possa habilitar o Serviço de identidade para Tableau Server. 1. Entre no Tableau Server como um administrador. 2. No painel de navegação esquerdo, selecione Usuários (ou Todos os sites > Usuários para um Tableau Server de vários sites) e clique na página Migração de identidade para verificar se a migração foi iniciada. Você pode monitorar e gerenciar seu progresso usando a página dedicada de migração de identidade disponível na página Usuários do Tableau Server. Para obter mais informações, consulte [Gerenciar a migração de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_manage.htm) . 3. Resolva ou reconheça todos os conflitos de identidade conforme descrito em [Resolver conflitos de migração de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_conflicts.htm) para que a guia Todas as falhas exiba "0" como na imagem abaixo. ![Resumo da migração de identidade mostrando zero falhas.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_failures_acknowledge.png) 4. Execute _um_ destes procedimentos: - Para executar o trabalho de migração de identidade agora, ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento e selecione Executar agora. ![Menu suspenso para editar o agendamento de migração com opções para desativar ou executar agora.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_overview_runnow.png) - Como alternativa, você pode aguardar a execução do trabalho de migração durante o próximo horário agendado. 5. Após a conclusão da migração, na página Migração de identidade, valide se a Visão geral da migração mostra 100% concluída. ![Barra de progresso da migração de identidade indicando 100% de conclusão.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_complete.png) ### Etapa 5: configurar o Tableau Server para usar o Serviço de identidade Após a conclusão da migração de identidade, configure o Tableau Server para usar o Serviço de identidade . 1. Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster. 2. Execute os seguintes comandos dependendo da versão do Tableau Server que você está executando: - Para as versões 2022.1.8 (e posteriores), 2022.3.10 (e posteriores), 2023.1.6 (e posteriores) e posteriores do Tableau Server: ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false ``` - Para as versões 2022.1-2022.1.7, 2022.3-2022.3.9 ou 2023.1-2023.1.5 do Tableau Server: ``` tsm authentication legacy-identity-mode disable ``` **Observação:** depois de executar um dos comandos acima, a página dedicada de Migração de identidade é removida e não está mais acessível. A página só é acessível quando `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled` is `true` ou `tsm authentication legacy-identity-mode` está ativado. Depois que o Tableau Server é configurado para usar o Serviço de Identidade, quando os usuários entram no Tableau Server, o Tableau Server pesquisa suas identidades de usuário usando seus identificadores no repositório de identidades configurado. A partir dos identificadores, os identificadores exclusivos universais (UUID) são retornados e usados para corresponder às identidades de usuário existentes do Tableau Server. Esse processo gera sessões para os usuários e conclui o fluxo de trabalho de autenticação. ### Etapa 6: habilitar pools de identidade Quando você tiver concluído a migração de identidade e habilitado o Serviço de Identidade, habilite o recurso de pools de identidade em preparação para a configuração de [pools de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_manage.htm). 1. Execute os seguintes comandos: ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **Observação:** a execução desses comandos faz com que o Tableau Server seja reiniciado. ## Outros artigos nesta seção