在 Active Directory 适配器之间切换

UiPath™ Identity Server 为两个 Active Directory 适配器提供支持：ad 和 ldapad。

• ad 适配器：仅在独立部署中工作的旧版适配器。ad 适配器仅在 Windows 上运行，并且支持外部信任域和 NTLM，为未加入域的客户端进行身份验证提供支持。
• ldapad 适配器：2021 年 10 月推出的适配器。ldapad 适配器适用于独立部署和 Automation Suite 部署，并且不支持外部信任域和 NTLM 对未加入域的客户端进行身份验证。

部署	ad 适配器	ldapad 适配器
Automation Suite	不支持	支持

备注：

版本 2021.10 之前的所有启用了 Active Directory 集成的部署在升级后都会保留 ad 适配器。启用 Active Directory 集成后，所有其他部署都会默认获取 ldapad 适配器。

检查 Active Directory 适配器类型

要确定适配器类型，可以执行 SQL 查询，以检查 [identity].[DirectoryConnections] 表中的适配器类型。

SELECT dc.* from [identity].[DirectoryConnections] dc
JOIN [identity].[Partitions] p ON p.[Id]=dc.[PartitionId]
WHERE p.[GlobalId]='FEB0DD79-85B6-483B-B297-0E49A1AA5B7D' AND dc.[IsDeleted]=0

如果是 [Type]=ad，则表示正在使用 ad 适配器。如果是 [Type]='ldapad'，则表示正在使用 ldapad 适配器。

从 ldapad 切换到 ad

备注：

仅在独立部署中支持此操作。

要将 ldapad 切换到 ad，请执行以下操作：

1. 确保以下查询返回一行，以检查 ldapad 适配器是否已启用。

   SELECT dc.* from [identity].[DirectoryConnections] dc JOIN [identity].[Partitions] p ON p.[Id]=dc.[PartitionId] WHERE p.[GlobalId]='FEB0DD79-85B6-483B-B297-0E49A1AA5B7D' AND dc.[Type]='ldapad' AND dc.[IsDeleted]=0

2. 连接到 Orchestrator/Identity 数据库并运行下面的脚本，确保将 FQDN-OF-DOMAIN 替换为默认域/主域的完全限定名称。在 UiPath 主机门户中启用 Active Directory 集成后，以下 SQL 脚本会更新 Active Directory 用户和组的DirectoryId，软删除 ldapad 目录连接，并创建 ad 目录连接。

   -- convert users
   
   IF OBJECT_ID('tempdb..#tmp_ldap_users') IS NOT NULL
   DROP TABLE #tmp_ldap_users
   
   SELECT [Id], [MasterPartitionId], CONCAT('ad', SUBSTRING([DirectoryId], 7, 256)) AS [DirectoryId] INTO #tmp_ldap_users
   FROM [identity].[AspNetUsers]
   WHERE [DirectoryId] LIKE 'ldapad|%' AND [IsDeleted]=0
   
   --SELECT * FROM #tmp_ldap_users
   
   DELETE tmp
   FROM #tmp_ldap_users tmp
   JOIN [identity].[AspNetUsers] u ON u.[MasterPartitionId]=tmp.[MasterPartitionId] AND u.[DirectoryId]=tmp.[DirectoryId]
   
   --SELECT * FROM #tmp_ldap_users
   
   UPDATE u
   SET u.[DirectoryId]=tmp.[DirectoryId]
   FROM [identity].[AspNetUsers] u
   JOIN #tmp_ldap_users tmp on tmp.[Id]=u.[Id]
   
   -- create 'ad' directory connection
   
   DECLARE @HostPartitionId int		-- host partition id
   SELECT @HostPartitionId = [Id] FROM [identity].[Partitions] WHERE [GlobalId]='FEB0DD79-85B6-483B-B297-0E49A1AA5B7D'
   
   UPDATE [identity].[DirectoryConnections] SET [IsDeleted]=1, [DeletionTime]=GETUTCDATE() WHERE [PartitionId]=@HostPartitionId AND [Type]='ldapad' and [IsDeleted]=0
   
   SELECT * FROM [identity].[DirectoryConnections] WHERE [PartitionId]=@HostPartitionId AND [Type]='ad' and [IsDeleted]=0
   IF @@ROWCOUNT=0
       INSERT INTO [identity].[DirectoryConnections] ([PartitionId], [Type], [CreationTime], [Configuration], [IsDeleted])
   	VALUES (@HostPartitionId, 'ad', GETUTCDATE(), '{ "Domain": "<FQDN-OF-DOMAIN>" }', 0)
   
   
   SELECT * FROM [identity].[DirectoryConnections] WHERE [PartitionId]=@HostPartitionId AND [IsDeleted]=0

3. 通过在提升的提示符下运行 iisreset 来重新启动身份应用程序池。

从 ad 切换到 ldapad

1. 确保以下查询返回一行，以检查 ad 适配器是否已启用。

   SELECT dc.* from [identity].[DirectoryConnections] dc
   JOIN [identity].[Partitions] p ON p.[Id]=dc.[PartitionId]
   WHERE p.[GlobalId]='FEB0DD79-85B6-483B-B297-0E49A1AA5B7D' AND dc.[Type]='ad' AND dc.[IsDeleted]=0

2. 在主机门户中禁用 Active Directory 集成。

3. 在主机门户中重新激活 Active Directory 集成。