---
schema_version: "1"
id: e1e077a391c0017830b0a1bc723c1d5eb2e62f0473454de1dfdfc22c468b4f0a
title: Gerenciar 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_manage.md
canonical_url: https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_manage.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 20cb86c59b2c85ac57b4323a8ab445e9e0cc13e1f7b3c84a47bd70022dddce59
description: Monitor and manage identity migration jobs and settings on Tableau Server.
---
[Pular para o conteúdo principal](#main-content)

# Gerenciar a migração de identidade

Como administrador, você pode monitorar e gerenciar a migração de identidade, incluindo alterar quando os trabalhos de migração são executados, por meio da 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.

![Página de visão geral da migração de identidade.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_main.png)

Os trabalhos de migração são projetados para serem executados em segundo plano sem interromper ou interferir no uso do Tableau Server. No entanto, se necessário, você pode fazer ajustes que afetam a frequência com que os trabalhos de migração são executados, quando os trabalhos de migração são executados e por quanto tempo os trabalhos de migração podem ser executados.

Geralmente, a migração pode levar de 3 minutos a 10 dias, dependendo do tamanho da implantação do Tableau Server e de quaisquer alterações nas configurações padrão feitas durante a migração. Por exemplo, se você tiver 10.000 usuários, a migração poderá levar cerca de 30 minutos.

**Observação:** enquanto os trabalhos de migração estão em execução, todos os recursos de autenticação e relacionados ao usuário funcionam normalmente.

## Gerenciar trabalhos de migração de identidade

Você pode gerenciar os seguintes aspectos da migração de identidade.

Resolver conflitos de identidade

Para revisar os conflitos de identidade que você pode encontrar durante a migração, consulte [Resolver conflitos de migração de identidade](https://help.tableau.com/v0.0/server-linux/pt-br/identity_migration_conflicts.htm) .

Alterar a programação diária do trabalho de migração

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.

1. Ao lado do título Visão geral da migração, clique no botão Editar agendamento.
2. Na caixa de diálogo Editar agendamento, altere quando e com que frequência os trabalhos podem ser executados.
    
    **Observação:** você pode ignorar as opções de Prioridade e Execução nesta caixa de diálogo.
    
    ![Caixa de diálogo Editar agendamento com opções para editar a frequência de migrações.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_schedule.png)
3. Quando concluir, clique em Atualizar.

Iniciar um trabalho de migração

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.

1. Em qualquer guia, selecione um usuário ou vários usuários.
2. No menu Ações, selecione Repetir a migração ou Reconhecer, dependendo do que você precisa fazer.
    
    ![Menu suspenso de ações Migração de identidade com opções para Repetir a migração ou Reconhecer.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_actions.png)
3. Ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento.
4. Selecione Executar agora .
    
    ![Menu suspenso para editar o agendamento de migração com a opção para executar agora destacada.](/tableau/next/pt-br/server-linux/pt-br/Img/id_mig_runnow.png)

Pausar a migração de identidade

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.

1. Ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento.
2. Selecione Desativar.

Reinicie a migração de identidade

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.

1. Ao lado do título Visão geral da migração, clique na seta suspensa Editar agendamento.
2. Selecione Ativar.

## Alterar as configurações de migração de identidade

Para reduzir qualquer tensão potencial que a migração de identidade possa causar em seu Tableau Server, a migração é configurada para ser executada com as configurações padrão listadas abaixo.

### Configurações de migração

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">Tipo</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">comando tsm</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">Padrão</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Procedimento</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Agenda de trabalhos</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">N/A</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">03:00, diariamente até concluir</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Configurável na página Migração de identidade, consulte <a href="#schedule" class="xref">Alterar a programação diária do trabalho de migração</a> acima.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Solicitações de identidade do usuário por segundo (taxa)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tsm authentication identity-migration configure -–rate</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Até 5</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="2"><p>Se necessário, você pode usar o comando <code>tsm authentication identity-migration</code> para alterar as configurações de migração listadas acima usando as etapas abaixo.</p><ol><li value="1">Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.</li><li value="2"><p>Execute um ou ambos os comandos descritos em <a href="https://help.tableau.com/v0.0/server-linux/pt-br/cli_authentication_tsm.htm#tsm_identity_mig_config"><code>tsm authentication identity-migration</code></a> .</p><p>Por exemplo, para alterar o tempo de execução e a taxa do trabalho individual de seus valores padrão, você pode executar o seguinte comando:</p><p><code>tsm authentication identity-migration configure --job-run-time 180 --rate 3</code></p></li></ol></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tempo de execução de fluxo individual</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tsm authentication identity-migration configure -–job-run-time</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">120 minutos</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a name="enable"></a>Habilitar a migração de identidade</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tsm configuration set -k features.IdentityMigrationBackgroundJob</code></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>false</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Ao habilitar a migração de identidade, o Tableau Server pode usar o serviço de identidade para armazenar e gerenciar informações de identidade do usuário.</p><ol><li value="1"><p>Abra um prompt de comando como administrador no nó inicial (onde o TSM está instalado) no cluster.</p></li><li value="2"><p>Executo o seguinte comando:</p><p><code>tsm configuration set -k features.IdentityMigrationBackgroundJob -v true</code></p></li></ol><p><b>Observação:</b> a migração de identidade e o Serviço de Identidade são um pré-requisito para certas capacidades como <a href="https://help.tableau.com/v0.0/server-linux/pt-br/identity_pools.htm" target="_blank">pools de identidades</a>. Para obter mais informações sobre o comando tsm, consulte <a href="https://help.tableau.com/v0.0/server-linux/pt-br/cli_configuration-set_tsm.htm#identity_migration" class="xref">features.IdentityMigrationBackgroundJob</a>.</p></td></tr></tbody></table>

### Desabilitar a migração de identidade

Se você atualizou para as versões 2021.4.21, 2022.1.17, 2022.3.9 e 2023.1.5 do Tableau Server, talvez seja necessário desabilitar a migração de identidade. Ao desabilitar a migração de identidade, o Tableau Server não poderá usar o serviço de identidade para armazenar e gerenciar informações de identidade do usuário.

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.IdentityMigrationBackgroundJob -v false`

**Observação:** a migração de identidade e o Serviço de Identidade são um pré-requisito para certas capacidades como [pools de identidades](https://help.tableau.com/v0.0/server-linux/pt-br/identity_pools.htm).

## Conclua a migração de identidade e configure o Serviço de Identidade

Depois que todos os conflitos de usuário forem resolvidos ou endereçados e os trabalhos de migração forem executados, você deverá configurar o Tableau Server para usar o Serviço de identidade para concluir o processo de migração de identidade.

### Etapa 1: validar e concluir a migração de identidade

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](#) .
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 2: configurar 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 3: habilitar pools de identidade

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.