--- schema_version: "1" id: 7d89d23e262c13d2be380cd09b606156e31e7d9b45a3318db42955418863d398 title: 关于身份迁移 collection: tableau version: next locale: zh-cn portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server/identity_migration.md canonical_url: https://help.tableau.com/v0.0/server/zh-cn/identity_migration.htm source_site: help.tableau.com content_type: documentation content_hash: 76ffc37aed7ccc5b2401554c76e3c6fefbb3ab1c16e15cfd63cf671729c91a99 description: Run the identity migration to move Tableau Server to use the Identity Service. --- [跳转到主要内容](#main-content) # 关于身份迁移 从版本 2022.1 开始，Tableau Server 使用身份服务存储和管理身份信息。身份迁移是配置和使用的[身份池](https://help.tableau.com/v0.0/server/zh-cn/identity_pools.htm)的先决条件。 > [!WARNING] > > **重要信息：**如果您不打算使用身份池功能，我们建议您不要运行身份迁移。在没有计划使用身份池的情况下运行身份迁移不会给您的 Tableau Server 部署带来好处。 对于现有部署，如果将 Tableau Server 升级到版本 2022.1（或更高版本）并还原 Tableau 2021.4（或更低版本）的备份，则可以在 Tableau Server 升级完成后启动身份迁移以填充新的身份服务。身份迁移为所有 Tableau Server 用户填充补充“身份服务”表，然后使用这些表通过身份服务对用户进行身份验证。迁移在后台运行，不会中断或干扰用户对 Tableau Server 的使用。 作为管理员，您可以通过 Tableau Server 的“用户”页面中提供的专用**“身份迁移”**页面来监控和管理迁移，包括更改迁移运行的时间或解决任何潜在的迁移冲突。此页面在迁移过程中可用。 ## 现有部署的步骤摘要 对于新部署和现有部署，您必须将 Tableau Server 配置为在迁移完成后使用身份服务，以利用身份结构改进并配置身份池。 > [步骤 1：开始之前](#step1) > > [步骤 2：启用新架构和登录功能](#step2) > > [步骤 3：开始身份迁移](#step3) > > [步骤 4：完成身份迁移](#step4) > > [步骤 5：将 Tableau Server 配置为使用身份服务](#step5) > > [步骤 6：启用身份池](#step6) ### 关键术语 - **身份服务** - Tableau Server 2022.1（及更高版本）中的一项服务，负责管理用户身份，包括身份验证和预置。该服务使用身份架构，其中用户身份由“身份服务”表和旧版“system\_users”表表示。 - **身份池** - 一种身份管理工具，它使用预置和身份验证信息来支持用户访问 Tableau Server。身份池可实现基于身份服务的更集中、更灵活的身份管理工作流，用于存储和管理 Tableau Server 中的用户身份。 - **旧版身份存储模式** - Tableau Server 2021.4（及更低版本）使用的有限身份架构，其中用户身份仅由旧版“system\_users”表表示。 - **身份迁移** - 评估现有 Tableau Server 用户身份、查询上游外部身份存储以获取其他身份信息（视情况而定）并将该附加身份信息导入身份服务的审核过程。 - **外部身份存储** - Tableau Server 外部和上游的身份存储类型，所有身份信息都由外部目录服务（Active Directory (AD) 或 LDAP）存储和管理。如果已配置，Tableau Server 会同步到外部目录，以便身份信息的副本存在于 Tableau Server 中。 - **本地身份存储** - Tableau Server 提供的身份存储类型。如果已配置，Tableau Server 将在 Tableau Server 存储库中存储和管理身份信息，而无需为此信息配置的任何外部目录。 - **系统用户** - Tableau Server 用户。用户对应于身份服务（通过“system\_users\_identities”表）和旧版身份存储模式中的登录记录（“system\_users”）。“System\_users”记录可能具有与其关联的多个用户身份，并且可以登录到多个站点。“system\_user”记录和站点之间的链接是在“users”表中定义的。 ### 身份迁移的目的 创建 Tableau Server 备份时，身份信息保存在为其创建备份的 Tableau Server 版本所使用的身份架构中。迁移对于将身份信息从备份中使用的身份架构填充到身份服务使用的身份架构是必要的。 **Tableau Server 2021.4 及更低版本的身份架构** ![应用服务图表，其中有两个框，分别标有“system\_users”和“domains”。](/tableau/next/zh-cn/server/zh-cn/Img/id_mig_tables_legacy.png) 旧版身份存储模式使用的身份架构由两个表组成：“system\_users”和“domains”。 **Tableau Server 2022.1 及更高版本的身份架构** ![说明身份服务数据库表的图表。](/tableau/next/zh-cn/server/zh-cn/Img/id_mig_tables.png) 身份服务使用的身份架构包括捕获更多身份信息的旧版“system\_users”表，以及补充“身份服务”表（\*\_identity\_stores 和 \*identities）。附加表有助于减少外部身份存储的上游更改可能导致的问题。 ### 身份迁移期间会发生什么 当迁移有关用户身份的信息时，存储在旧版“system\_users”表中的身份信息将由“身份服务”表进行补充。 补充身份信息的“身份服务”表的类型取决于为 Tableau Server 配置的身份存储类型：本地、Active Directory (AD) 或轻量级目录访问协议 (LDAP)。 - 对于 **AD** 身份存储类型，“身份服务”表仅继承明确的属性或未存储在同一数据库记录中的属性。 例如，sAMAccountNAme 和 userPrincipalName (UPN) 可以存储在旧版“systems\_users”表的相同名称记录中，这可能是一系列复杂规则的结果。在大多数情况下，迁移能够正确解释并成功迁移用户身份。但是，如果迁移产生不明确的结果，您必须手动确认不明确之处，或使用专用的“身份迁移”页面手动解决冲突。有关详细信息，请参见[解决身份迁移冲突](https://help.tableau.com/v0.0/server/zh-cn/identity_migration_conflicts.htm)。 - 对于 **LDAP** 身份存储类型，如 AD 身份存储类型，“身份服务”表仅继承明确的属性。在大多数情况下，迁移能够正确解释并成功迁移用户身份。但是，如果迁移产生不明确的结果，您必须手动确认不明确之处，或使用专用的“身份迁移”页面手动解决冲突。有关详细信息，请参见[解决身份迁移冲突](https://help.tableau.com/v0.0/server/zh-cn/identity_migration_conflicts.htm)。 - 对于**本地**身份存储类型，“身份服务”表直接继承用户和域字段。这意味着，您无需提供其他信息或进行手动解决。为这种类型的身份存储配置 Tableau Server 时，用户身份的迁移会在 Tableau Server 备份还原过程之后发生。 ## 执行身份迁移 ### 步骤 1：开始之前 在开始之前，请确定下面的 Tableau Server 版本和升级方法（如果适用），以确定身份迁移的后续步骤。
升级起始版本升级到升级方法后续步骤
不适用Tableau Server 版本：2022.1.0（及更高版本）、2022.3.0（及更高版本）、2023.1（及更高版本）及更高版本新安装转至步骤 2。
Tableau Server 版本：2022.1-2022.1.7、2022.3-2022.3.9 或 2023.1-2023.1.5Tableau Server 版本：2022.1.8（及更高版本）、2022.3.10（及更高版本）、2023.1.6（及更高版本）及更高版本不适用

您是否已启用新的登录架构（即 wgserver.authentication.legacy_identity_mode.enabled -v false）？

Tableau Server 版本：2021.4.x 或更低版本Tableau Server 版本：2022.1.8（及更高版本）、2022.3.10（及更高版本）、2023.1.6（及更高版本）及更高版本不适用转至步骤 2。
Tableau Server 版本：2021.4.x 或更低版本Tableau Server 版本：2022.1.0-2022.1.7、2022.3.0-2022.3.9 或 2023.1.0-2023.1.5如果您通过以下方式执行蓝/绿升级或手动升级 Tableau Server：1) 在新计算机上安装 Tableau Server，然后 2) 使用 tsm maintenance（备份和还原）命令备份和还原 Tableau Server，则需要采取一些额外的步骤来启动迁移。转至对身份迁移问题进行故障排除。
如果您使用此处描述的方法对 Tableau Server 进行“就地”单服务器或多节点升级，则您无需执行其他步骤即可启动迁移。迁移在 Tableau Server 升级到版本 2022.1（或更高版本）完成后启动。转至步骤 2。
如果您通过以下方式手动升级 Tableau Server：1) 在新计算机上安装 Tableau Server，然后 2) 使用 tsm settings（导出和导入）命令导出和导入配置和拓扑信息，您也无需执行其他步骤即可启动迁移。迁移在新 Tableau Server 计算机上完成导入过程后启动。转至步骤 2。
### 步骤 2：启用新架构和登录功能 在开始身份迁移之前，必须通过 tsm 命令 [features.NewIdentityMode](https://help.tableau.com/v0.0/server/zh-cn/cli_configuration-set_tsm.htm#identity_mode_new) 启用新的身份架构；并在身份迁移过程中通过 [wgserver.authentication.legacy\_identity\_mode.enabled](https://help.tableau.com/v0.0/server/zh-cn/cli_configuration-set_tsm.htm#legacy_identity_mode) 或 [tsm authentication legacy-identity-mode <命令>](https://help.tableau.com/v0.0/server/zh-cn/cli_authentication_tsm.htm#tsm_identity_mig_legacy) tsm 命令继续允许登录 Tableau Server。 1. 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。 2. 运行以下命令： ``` tsm configuration set -k features.NewIdentityMode -v true ``` 3. 视您运行的 Tableau Server 版本而定，运行以下命令： - 对于 Tableau Server 版本 2022.1.8（及更高版本）、2022.3.10（及更高版本）、2023.1.6（及更高版本）及更高版本： ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v true tsm pending-changes apply ``` - 对于 Tableau Server 版本 2022.1.0-2022.1.7、2022.3-2022.3.9 或 2023.1-2023.1.5： ``` tsm authentication legacy-identity-mode enable tsm pending-changes apply ``` **注意：**运行这些命令会导致 Tableau Server 重新启动。 ### 步骤 3：开始身份迁移 **注意：**如果您已升级到 Tableau Server 版本 2022.1-2022.1.7、2022.3-2022.3.9、或 2023.1-2023.1.5，则默认情况下会开始身份迁移，您可以跳到[步骤 4：完成身份迁移](#step4)。 若要启动身份迁移，您必须使用 tsm 命令 [features.IdentityMigrationBackgroundJob](https://help.tableau.com/v0.0/server/zh-cn/cli_configuration-set_tsm.htm#identity_migration) 启用身份迁移功能。 1. 运行以下命令： ``` tsm configuration set -k features.IdentityMigrationBackgroundJob -v true ``` 身份迁移开始后，您将在 Tableau Server 中看到一条通知，将您链接到“身份迁移”页面。在“身份迁移”页面中，您可以监控身份迁移的状态以及需要解决的身份冲突。 ### 步骤 4：完成身份迁移 **注意**：对于新安装，请跳过此步骤。 若要完成身份迁移，必须先解决或确认所有身份冲突，然后才能为 Tableau Server 启用身份服务。 1. 以管理员身份登录到 Tableau Server。 2. 从左侧导航窗格中，选择“用户”（或者，对于多站点 Tableau Server 为“所有站点”\>“用户”），然后单击“身份迁移”页面以验证迁移是否已开始。 您可以使用 Tableau Server 用户页面中提供的专用“身份迁移”页面来监控和管理其进度。有关详细信息，请参见[管理身份迁移](https://help.tableau.com/v0.0/server/zh-cn/identity_migration_manage.htm)。 3. 按照[解决身份迁移冲突](https://help.tableau.com/v0.0/server/zh-cn/identity_migration_conflicts.htm)中所述解决或确认所有身份冲突，以便“所有故障”选项卡显示“0”，如下图所示。 ![显示零失败的身份迁移摘要。](/tableau/next/zh-cn/server/zh-cn/Img/id_mig_failures_acknowledge.png) 4. 执行以下操作_之一_： - 若要立即运行身份迁移作业，请单击“迁移概述”标题旁边的“编辑计划”下拉箭头，然后选择“立即运行”。 ![用于编辑迁移计划的下拉菜单，其中包含禁用或立即运行的选项。](/tableau/next/zh-cn/server/zh-cn/Img/id_mig_overview_runnow.png) - 或者，您可以等待迁移作业在下一个计划时间运行。 5. 迁移完成后，从“身份迁移”页面验证“身份迁移”是否显示“100% 完成”。 ![显示 100％ 完成的身份迁移进度条。](/tableau/next/zh-cn/server/zh-cn/Img/id_mig_complete.png) ### 步骤 5：将 Tableau Server 配置为使用身份服务 身份迁移完成后，将 Tableau Server 配置为使用身份服务。 1. 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。 2. 根据您正在运行的 Tableau Server 版本运行以下命令： - 对于 Tableau Server 版本 2022.1.8（及更高版本）、2022.3.10（及更高版本）、2023.1.6（及更高版本）及更高版本： ``` tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false ``` - 对于 Tableau Server 版本 2022.1-2022.1.7、2022.3-2022.3.9 或 2023.1-2023.1.5： ``` tsm authentication legacy-identity-mode disable ``` **注意：**运行上述命令之一后，专用“身份迁移”页面将被移除，并且不再可访问。仅当 `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled` 为 `true` 或者启用 `tsm authentication legacy-identity-mode` 之后，该页面才可访问。 在 Tableau Server 配置为使用身份服务后，当用户登录到 Tableau Server 时，Tableau Server 会使用他们在配置的身份存储中的标识符来搜索他们的用户身份。从标识符中，将返回并使用通用唯一标识符 (UUID) 来匹配现有 Tableau Server 用户身份。然后，此过程为用户生成会话并完成身份验证工作流程。 ### 步骤 6：启用身份池 完成身份迁移并启用身份服务后，启用身份池功能以准备配置 [身份池](https://help.tableau.com/v0.0/server/zh-cn/identity_migration_manage.htm)。 1. 运行以下命令： ``` tsm configuration set -k features.IdentityPools -v true tsm pending-changes apply ``` **注意：**运行这些命令会导致 Tableau Server 重新启动。 ## 此部分中的其他文章