管理用户

快速开始（SOAP模式）:使用Java API添加用户

使用Web服务API添加用户

使用目录管理器服务API（Web服务）添加用户：

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保对服务引用使用以下WSDL定义：http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1。

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建DirectoryManagerService客户端。
- 使用其默认构造函数创建DirectoryManagerServiceClient对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DirectoryManagerServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom）。您无需使用lc_version属性。此属性在您创建服务引用时使用。确保指定?blob=mtom。
- 通过获取DirectoryManagerServiceClient.Endpoint.Binding字段的值创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 为字段DirectoryManagerServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段DirectoryManagerServiceClient.ClientCredentials.UserName.Password分配相应的口令值。
  - 将常量值HttpClientCredentialType.Basic指定到字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
  - 将常量值BasicHttpSecurityMode.TransportCredentialOnly指定到字段BasicHttpBindingSecurity.Security.Mode。
定义用户信息。
- 使用UserImpl对象的构造函数创建<a0/>对象。
- 通过为UserImpl对象的domainName字段指定字符串值来设置demain名称。
- 通过为UserImpl对象的principalType字段指定字符串值来设置主体类型。例如，可以指定USER。
- 通过为UserImpl对象的userid字段指定字符串值来设置用户标识符值。
- 通过为UserImpl对象的canonicalName字段指定字符串值来设置规范名称值。
- 通过为UserImpl对象的givenName字段指定字符串值来设置给定的名称值。
- 通过为UserImpl对象的familyName字段指定字符串值来设置系列名称值。
将用户添加到AEM Forms。

调用DirectoryManagerServiceClient对象的createLocalUser方法并传递以下值：
- 表示新用户的UserImpl对象
- 表示用户口令的字符串值
createLocalUser方法返回一个指定本地用户标识符值的字符串值。
验证是否已添加用户。
- 使用PrincipalSearchFilter对象的构造函数创建<a0/>对象。
- 通过将表示用户标识符值的字符串值分配给PrincipalSearchFilter对象的userId字段，设置用户的用户标识符值。
- 调用DirectoryManagerServiceClient对象的findPrincipals方法并传递PrincipalSearchFilter对象。此方法返回MyArrayOfUser集合对象，其中每个元素都是User对象。对MyArrayOfUser集合进行迭代以找到用户。

另请参阅

使用SwaRef调用AEM Forms

删除用户

您可以使用目录管理器服务API（Java和Web服务）以编程方式从AEM Forms删除用户。删除用户后，用户无法再用于执行需要用户的服务操作。例如，您不能将任务分配给已删除的用户。

步骤的摘要

要删除用户，请执行以下步骤：

包括项目文件。
创建DirectoryManagerService客户端。
指定要删除的用户。
从AEM Forms删除用户。

包括项目文件

在开发项目中包含必要的文件。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请包含代理文件。

创建DirectoryManagerService客户端

在以编程方式执行目录管理器服务API操作之前，请先创建目录管理器服务客户端。

指定要删除的用户

您可以使用用户的标识符值指定要删除的用户。

从AEM Forms删除用户

要删除用户，请调用DirectoryManagerServiceClient对象的deleteLocalUser方法。

另请参阅

使用Java API删除用户

使用目录管理器服务API(Java)删除用户：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar。
创建DirectoryManagerService客户端。

使用DirectoryManagerServiceClient对象的构造函数创建一个ServiceClientFactory对象，并传递一个包含连接属性的<a1/>对象。
指定要删除的用户。
- 使用PrincipalSearchFilter对象的构造函数创建<a0/>对象。
- 通过调用PrincipalSearchFilter对象的setUserId方法设置用户标识符值。传递表示用户标识符值的字符串值。
- 调用DirectoryManagerServiceClient对象的findPrincipals方法并传递PrincipalSearchFilter对象。此方法返回一个java.util.List实例，其中每个元素都是一个User对象。对java.util.List实例进行迭代以找到要删除的用户。
从AEM Forms删除用户。

调用DirectoryManagerServiceClient对象的deleteLocalUser方法并传递User对象的oid字段的值。调用User对象的getOid方法。使用从java.util.List实例检索的User对象。

另请参阅

快速开始（EJB模式）:使用Java API删除用户

快速开始（SOAP模式）:使用Java API删除用户

使用Web服务API删除用户

使用目录管理器服务API（Web服务）删除用户：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar。
创建DirectoryManagerService客户端。
- 使用其默认构造函数创建DirectoryManagerServiceClient对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建DirectoryManagerServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom）。您无需使用lc_version属性。此属性在您创建服务引用时使用。确保指定blob=mtom.
- 通过获取DirectoryManagerServiceClient.Endpoint.Binding字段的值创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 为字段DirectoryManagerServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段DirectoryManagerServiceClient.ClientCredentials.UserName.Password分配相应的口令值。
  - 将常量值HttpClientCredentialType.Basic指定到字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
  - 将常量值BasicHttpSecurityMode.TransportCredentialOnly指定到字段BasicHttpBindingSecurity.Security.Mode。
指定要删除的用户。
- 使用PrincipalSearchFilter对象的构造函数创建<a0/>对象。
- 通过为PrincipalSearchFilter对象的userId字段指定字符串值来设置用户标识符值。
- 调用DirectoryManagerServiceClient对象的findPrincipals方法并传递PrincipalSearchFilter对象。此方法返回MyArrayOfUser集合对象，其中每个元素都是User对象。对MyArrayOfUser集合进行迭代以找到用户。从MyArrayOfUser集合对象检索的User对象用于删除用户。
从AEM Forms删除用户。

将User对象的oid字段值传递给DirectoryManagerServiceClient对象的deleteLocalUser方法，以删除用户。

另请参阅

使用SwaRef调用AEM Forms

创建组

您可以使用目录管理器服务API（Java和Web服务）以编程方式创建AEM Forms组。创建组后，您可以使用该组执行需要组的服务操作。例如，可以将用户分配给新用户组。（请参阅管理用户和用户组。）

步骤的摘要

要创建用户组，请执行以下步骤：

包括项目文件。
创建DirectoryManagerService客户端。
确定组不存在。
创建组。
对组执行操作。

包括项目文件

在开发项目中包含必要的文件。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。

必须将以下JAR文件添加到项目的类路径中：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar(在JBoss上部署AEM Forms时是必需的)
jbossall-client.jar(在JBoss上部署AEM Forms时是必需的)

有关这些JAR文件的位置的信息，请参阅包括AEM FormsJava库文件。

创建DirectoryManagerService客户端

在以编程方式执行目录管理器服务操作之前，请创建目录管理器服务API客户端。

确定组是否存在

创建组时，请确保该组不存在于同一域中。也就是说，两个组不能在同一域中具有相同的名称。要执行此任务，请执行搜索并根据两个值筛选搜索结果。将主体类型设置为com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP以确保只返回组。另外，请确保指定域名。

创建组

确定域中不存在该组后，请创建该组并指定以下属性：

CommonName:组的名称。
域:添加组的域。
描述:组的描述。

对组执行操作

创建组后，可以使用组执行操作。例如，可以将用户添加到组。要将用户添加到组，请检索用户和组的唯一标识符值。将这些值传递给addPrincipalToLocalGroup方法。

另请参阅

使用Java API创建组

使用目录管理器服务API(Java)创建组：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar。
创建DirectoryManagerService客户端。

使用DirectoryManagerServiceClient对象的构造函数创建一个ServiceClientFactory对象，并传递一个包含连接属性的<a1/>对象。
确定组是否存在。
- 使用PrincipalSearchFilter对象的构造函数创建<a0/>对象。
- 通过调用PrincipalSearchFilter对象的setPrincipalType对象来设置主体类型。传递值com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP。
- 通过调用PrincipalSearchFilter对象的setSpecificDomainName对象来设置域。传递指定域名的字符串值。
- 要查找组，请调用DirectoryManagerServiceClient对象的findPrincipals方法（主体可以是组）。传递指定主体类型和域名的PrincipalSearchFilter对象。此方法返回一个java.util.List实例，其中每个元素都是一个Group实例。每个组实例都符合使用PrincipalSearchFilter对象指定的筛选器。
- 在java.util.List实例中迭代。对于每个元素，检索组名称。确保用户组名称不等于新用户组名称。
创建组。
- 如果组不存在，请调用Group对象的setCommonName方法并传递一个指定组名称的字符串值。
- 调用Group对象的setDescription方法并传递一个指定组描述的字符串值。
- 调用Group对象的setDomainName方法并传递指定域名的字符串值。
- 调用DirectoryManagerServiceClient对象的createLocalGroup方法并传递Group实例。
createLocalUser方法返回一个指定本地用户标识符值的字符串值。
对组执行操作。
- 使用PrincipalSearchFilter对象的构造函数创建<a0/>对象。
- 通过调用PrincipalSearchFilter对象的setUserId方法设置用户标识符值。传递表示用户标识符值的字符串值。
- 调用DirectoryManagerServiceClient对象的findPrincipals方法并传递PrincipalSearchFilter对象。此方法返回一个java.util.List实例，其中每个元素都是一个User对象。在java.util.List实例中迭代以找到用户。
- 通过调用DirectoryManagerServiceClient对象的addPrincipalToLocalGroup方法将用户添加到组。传递User对象的getOid方法的返回值。传递Group对象的getOid方法的返回值（使用表示新组的Group实例）。

另请参阅

管理用户和用户组

本主题介绍如何使用(Java)以编程方式分配、删除和查询域、用户和用户组。

注意

配置域时，必须为组和用户设置唯一标识符。所选属性不仅必须在LDAP环境中唯一，而且必须不变，并且不会在目录中更改。此属性还必须是简单的字符串数据类型（Active Directory 2000/2003当前允许的唯一异常是"objectsid"，它是二进制值）。例如，Novell eDirectory属性"GUID"不是简单的字符串数据类型，因此将无法工作。

对于Active Directory，请使用"objectsid"。
对于SunOne，请使用"nsuniqueid"。

注意

不支持在LDAP目录同步过程中创建多个本地用户和用户组。尝试此过程可能会导致错误。

步骤的摘要

要管理用户和用户组，请执行以下步骤：

包括项目文件。
创建DirectoryManagerService客户端。
调用相应的用户或组操作。

包括项目文件

在开发项目中包含必要的文件。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建DirectoryManagerService客户端

在以编程方式执行目录管理器服务操作之前，必须创建目录管理器服务客户端。使用Java API，可通过创建DirectoryManagerServiceClient对象来完成此操作。借助Web服务API，可通过创建DirectoryManagerServiceService对象来完成此操作。

调用相应的用户或组操作

创建服务客户端后，即可调用用户或组管理操作。服务客户端允许您分配、删除和查询域、用户和组。请注意，可以将目录主体或本地主体添加到本地组，但不可以将本地主体添加到目录组。

另请参阅

使用Java API管理用户和用户组

要使用(Java)以编程方式管理用户、组和域，请执行以下任务:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar。有关这些文件的位置的信息，请参见包括AEM FormsJava库文件。
创建DirectoryManagerService客户端。

使用DirectoryManagerServiceClient对象的构造函数创建一个ServiceClientFactory对象，并传递一个包含连接属性的<a1/>对象。有关信息，请参阅设置连接属性。
调用相应的用户或组操作。

要查找用户或组，请调用DirectoryManagerServiceClient对象查找主体的方法之一（因为主体可以是用户或组）。在以下示例中，使用搜索筛选器（PrincipalSearchFilter对象）调用findPrincipals方法。

由于此情况下的返回值是包含Principal对象的java.util.List，因此对结果进行迭代，并将Principal对象转换为User或Group对象。

使用生成的User或Group对象（两者都继承自Principal接口），在工作流中检索所需信息。例如，域名和规范名称值组合使用来唯一标识主体。通过分别调用Principal对象的getDomainName和getCanonicalName方法来检索这些属性。

要删除本地用户，请调用DirectoryManagerServiceClient对象的deleteLocalUser方法并传递用户的标识符。

要删除本地组，请调用DirectoryManagerServiceClient对象的deleteLocalGroup方法并传递组的标识符。

另请参阅

使用Web服务API管理用户和用户组

要使用目录管理器服务API（Web服务）以编程方式管理用户、组和域，请执行以下任务:

包括项目文件。
- 创建一个使用目录管理器WSDL的Microsoft .NET客户端程序集。 (请参阅使用Base64编码调用AEM Forms。)
- 引用Microsoft .NET客户端程序集。（请参阅创建使用Base64编码的。NET客户端程序集。）
创建DirectoryManagerService客户端。

使用代理类的构造函数创建DirectoryManagerServiceService对象。
调用相应的用户或组操作。

要查找用户或组，请调用DirectoryManagerServiceService对象查找主体的方法之一（因为主体可以是用户或组）。在以下示例中，使用搜索筛选器（PrincipalSearchFilter对象）调用findPrincipalsWithFilter方法。使用PrincipalSearchFilter对象时，仅当isLocal属性设置为true时，才返回本地承担者。此行为与Java API的行为不同。

注意

如果未在搜索筛选器（通过PrincipalSearchFilter.resultsMax字段）中指定最大结果数，则最多将返回1000个结果。这与使用Java API时的行为不同，在Java API中，默认最大值为10个结果。此外，搜索方法（如findGroupMembers）不会生成任何结果，除非在搜索筛选器（例如，通过GroupMembershipSearchFilter.resultsMax字段）中指定最大结果数。这适用于继承GenericSearchFilter类的所有搜索过滤器。有关详细信息，请参阅AEM FormsAPI参考。

由于此情况下的返回值是包含Principal对象的object[]，因此对结果进行迭代，并将Principal对象转换为User或Group对象。

使用生成的User或Group对象（两者都继承自Principal接口），在工作流中检索所需信息。例如，域名和规范名称值组合使用来唯一标识主体。通过分别调用Principal对象的domainName和canonicalName字段来检索这些字段。

要删除本地用户，请调用DirectoryManagerServiceService对象的deleteLocalUser方法并传递用户的标识符。

要删除本地组，请调用DirectoryManagerServiceService对象的deleteLocalGroup方法并传递组的标识符。

另请参阅

管理角色和权限

本主题介绍如何使用Authorization Manager Service API(Java)以编程方式分配、删除和确定角色和权限。

在AEM Forms,角色是一组访问一个或多个系统级资源的权限。这些权限是通过用户管理创建的，并由服务组件实施。例如，管理员可以向一组用户分配“策略集作者”角色。 Rights Management随后将允许具有该角色的组的用户通过管理控制台创建策略集。

有两种角色：默认角色和自定义角色。默认角色（系统角色）已驻留在AEM Forms。假定默认角色不能由管理员删除或修改，因此不可变。因此，管理员创建的自定义角色可变，管理员随后可以修改或删除这些角色。

角色使权限管理更简单。当角色被分配给主体时，一组权限被自动分配给该主体，并且主体的所有与访问相关的特定决策都基于所分配的整个权限集。

步骤的摘要

要管理角色和权限，请执行以下步骤：

包括项目文件。
创建AuthorizationManagerService客户端。
调用相应的角色或权限操作。

包括项目文件

在开发项目中包含必要的文件。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建AuthorizationManagerService客户端

在以编程方式执行User Management AuthorizationManagerService操作之前，必须创建AuthorizationManagerService客户端。使用Java API，可通过创建AuthorizationManagerServiceClient对象来完成此操作。

调用适当的角色或权限操作

创建服务客户端后，即可调用角色或权限操作。服务客户端允许您分配、删除和确定角色和权限。

另请参阅

使用Java API管理角色和权限

要使用Authorization Manager Service API(Java)管理角色和权限，请执行以下任务:

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar。
创建AuthorizationManagerService客户端。

使用AuthorizationManagerServiceClient对象的构造函数创建一个ServiceClientFactory对象，并传递一个包含连接属性的<a1/>对象。
调用相应的角色或权限操作。

要向主体分配角色，请调用AuthorizationManagerServiceClient对象的assignRole方法并传递以下值：
- 包含角色标识符的java.lang.String对象
- 包含主标识符的java.lang.String对象的数组。
要从主体中删除角色，请调用AuthorizationManagerServiceClient对象的unassignRole方法并传递以下值：
- 包含角色标识符的java.lang.String对象。
- 包含主标识符的java.lang.String对象的数组。

另请参阅

快速开始（SOAP模式）:使用Java API管理角色和权限

使用Web服务API管理角色和权限

使用Authorization Manager Service API（Web服务）管理角色和权限：

包括项目文件。

创建使用MTOM的Microsoft .NET项目。确保使用以下WSDL定义：http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1。

注意

将localhost替换为承载AEM Forms的服务器的IP地址。
创建AuthorizationManagerService客户端。
- 使用其默认构造函数创建AuthorizationManagerServiceClient对象。
- 使用System.ServiceModel.EndpointAddress构造函数创建AuthorizationManagerServiceClient.Endpoint.Address对象。将指定WSDL的字符串值传递给AEM Forms服务（例如，http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom）。您无需使用lc_version属性。此属性在您创建服务引用时使用。
- 通过获取AuthorizationManagerServiceClient.Endpoint.Binding字段的值创建System.ServiceModel.BasicHttpBinding对象。将返回值转换为BasicHttpBinding。
- 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。此值确保使用MTOM。
- 通过执行以下任务启用基本HTTP身份验证：
  - 为字段AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
  - 为字段AuthorizationManagerServiceClient.ClientCredentials.UserName.Password分配相应的口令值。
  - 将常量值HttpClientCredentialType.Basic指定到字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
  - 将常量值BasicHttpSecurityMode.TransportCredentialOnly指定到字段BasicHttpBindingSecurity.Security.Mode。
调用相应的角色或权限操作。

要向主体分配角色，请调用AuthorizationManagerServiceClient对象的assignRole方法并传递以下值：
- 包含角色标识符的string对象
- 包含主标识符的MyArrayOf_xsd_string对象。
要从主体中删除角色，请调用AuthorizationManagerServiceService对象的unassignRole方法并传递以下值：
- 包含角色标识符的string对象。
- 包含主标识符的string对象的数组。

另请参阅

验证用户

本主题介绍如何使用Authentication Manager Service API(Java)使客户端应用程序能够以编程方式验证用户身份。

可能需要用户身份验证才能与存储安全数据的企业数据库或其他企业存储库进行交互。

例如，假设用户在网页中输入用户名和密码并将这些值提交到承载Forms的J2EE应用服务器。 Forms自定义应用程序可以使用身份验证管理器服务对用户进行身份验证。

如果身份验证成功，则应用程序将访问受保护的企业数据库。否则，将向用户发送一条消息，说明用户不是授权用户。

下图显示了应用程序的逻辑流。

au_au_umauth_process

下表介绍了此图中的步骤

步骤	描述
3	用户访问网站并指定用户名和密码。此信息将提交到承载AEM Forms的J2EE应用服务器。
2	用户凭据将通过Authentication Manager服务进行身份验证。如果用户凭据有效，则工作流将继续执行步骤3。否则，将向用户发送一条消息，说明用户不是授权用户。
1	从安全的企业数据库检索用户信息和表单设计。
4	用户信息与表单设计合并，并呈现给用户。

步骤的摘要

要以编程方式验证用户身份，请执行以下步骤：

包括项目文件。
创建AuthenticationManagerService客户端。
调用身份验证操作。
如有必要，请检索上下文，以便客户端应用程序可以将其转发到另一个AEM Forms服务进行身份验证。

包括项目文件

在开发项目中包含必要的文件。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建AuthenticationManagerService客户端

在以编程方式验证用户之前，必须先创建AuthenticationManagerService客户端。使用Java API时，创建一个AuthenticationManagerServiceClient对象。

调用身份验证操作

创建服务客户端后，即可调用身份验证操作。此操作需要有关用户的信息，如用户名和密码。如果用户未进行身份验证，则会引发异常。

检索身份验证上下文

对用户进行身份验证后，可以在经过身份验证的用户中创建上下文。然后，您可以使用该内容调用其他AEM Forms服务。例如，您可以使用上下文创建EncryptionServiceClient并使用口令加密PDF文档。确保已通过身份验证的用户具有调用AEM Forms服务所需的名为Services User的角色。

另请参阅

使用Java API验证用户身份

使用Authentication Manager Service API(Java)对用户进行身份验证：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar。
创建AuthenticationManagerServices客户端。

使用AuthenticationManagerServiceClient对象的构造函数创建一个ServiceClientFactory对象，并传递一个包含连接属性的<a1/>对象。
调用身份验证操作。

调用AuthenticationManagerServiceClient对象的authenticate方法并传递以下值：
- 包含用户名的java.lang.String对象。
- 包含用户口令的字节数组（byte[]对象）。通过调用java.lang.String对象的getBytes方法，可以获得byte[]对象。
authenticate方法返回AuthResult对象，该对象包含有关已验证用户的信息。
检索身份验证上下文。

调用ServiceClientFactory对象的getContext方法，该方法将返回Context对象。

然后调用Context对象的initPrincipal方法并传递AuthResult。

使用Web服务API验证用户身份

使用Authentication Manager Service API（Web服务）对用户进行身份验证：

包括项目文件。
- 创建一个Microsoft .NET客户端程序集，它使用Authentication Manager WSDL。 (请参阅使用Base64编码调用AEM Forms。)
- 引用Microsoft .NET客户端程序集。 (请参阅使用Base64编码调用AEM Forms中的“引用。NET客户端程序集”。)
创建AuthenticationManagerService客户端。

使用代理类的构造函数创建AuthenticationManagerServiceService对象。
调用身份验证操作。

调用AuthenticationManagerServiceClient对象的authenticate方法并传递以下值：
- 包含用户名的string对象
- 包含用户口令的字节数组（byte[]对象）。您可以使用以下示例中显示的逻辑将包含密码的string对象转换为byte[]数组，从而获得byte[]对象。
- 返回的值将是AuthResult对象，可用于检索有关用户的信息。在以下示例中，首先获取AuthResult对象的authenticatedUser字段，然后获取生成的User对象的canonicalName和domainName字段，以检索用户的信息。

另请参阅

使用SwaRef调用AEM Forms

以编程方式同步用户

您可以使用用户管理API以编程方式同步用户。同步用户时，您将使用用户存储库中的用户数据更新AEM Forms。例如，假定您向用户存储库添加新用户。执行同步操作后，新用户将成为AEM forms用户。此外，您的用户存储库中不再存在的用户也会从AEM Forms删除。

下图显示了与用户存储库同步的AEM Forms。

ps_ps_umauth_sync

下表介绍了此图中的步骤

步骤	描述
1	客户端应用程序请求AEM Forms执行同步操作。
2	AEM Forms执行同步操作。
1	用户信息已更新。
4	用户能够视图更新的用户信息。

步骤的摘要

要以编程方式同步用户，请执行以下步骤：

包括项目文件。
创建UserManagerUtilServiceClient客户端。
指定企业域。
调用身份验证操作。
确定同步操作是否完成

包括项目文件

在开发项目中包含必要的文件。如果您使用Java创建客户端应用程序，请包含必要的JAR文件。如果您使用Web服务，请确保包含代理文件。

创建UserManagerUtilServiceClientclient

必须先创建UserManagerUtilServiceClient对象，然后才能以编程方式同步用户。

指定企业域

在使用用户管理API执行同步操作之前，您需要指定用户所属的企业域。可以指定一个或多个企业域。在以编程方式执行同步操作之前，必须使用管理控制台设置企业域。（请参阅管理帮助。）

调用同步操作

指定一个或多个企业域后，可以执行同步操作。执行此操作所需的时间取决于位于用户存储库中的用户记录数。

确定同步操作是否完成

在以编程方式执行同步操作后，可以确定操作是否完成。

另请参阅

使用Java API以编程方式同步用户

使用用户管理API(Java)同步用户：

包括项目文件。

在Java项目的类路径中包含客户端JAR文件，如adobe-usermanager-client.jar和adobe-usermanager-util-client.jar。
创建UserManagerUtilServiceClient客户端。

使用UserManagerUtilServiceClient对象的构造函数创建一个ServiceClientFactory对象，并传递一个包含连接属性的<a1/>对象。
指定企业域。
- 调用UserManagerUtilServiceClient对象的scheduleSynchronization方法以开始用户同步操作。
- 使用HashSet构造函数创建java.util.Set实例。确保指定String为数据类型。此Java.util.Set实例存储同步操作所应用的域名。
- 对于要添加的每个域名，调用java.util.Set对象的add方法并传递域名。
调用同步操作。

调用ServiceClientFactory对象的getContext方法，该方法将返回Context对象。

然后调用Context对象的initPrincipal方法并传递AuthResult。

另请参阅

以编程方式同步用户