Administración de usuarios managing-users

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente de DirectoryManagerServices.

Cree un DirectoryManagerServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión.

Defina la información del usuario.

• Cree un UserImpl usando su constructor.
• Establezca el nombre del dominio invocando la variable UserImpl del objeto setDomainName método. Pase un valor de cadena que especifique el nombre de dominio.
• Establezca el tipo principal invocando la variable UserImpl del objeto setPrincipalType método. Pasa un valor de cadena que especifica el tipo de usuario. Por ejemplo, puede especificar USER.
• Establezca el valor del identificador de usuario invocando la variable UserImpl del objeto setUserid método. Pase un valor de cadena que especifique el valor del identificador de usuario. Por ejemplo, puede especificar wblue.
• Establezca el nombre canónico invocando la variable UserImpl del objeto setCanonicalName método. Pase un valor de cadena que especifique el nombre canónico del usuario. Por ejemplo, puede especificar wblue.
• Establezca el nombre dado invocando la variable UserImpl del objeto setGivenName método. Pase un valor de cadena que especifique el nombre dado del usuario. Por ejemplo, puede especificar Wendy.
• Establezca el nombre de la familia invocando la variable UserImpl del objeto setFamilyName método. Pase un valor de cadena que especifique el nombre de familia del usuario. Por ejemplo, puede especificar Blue.

Agregue el usuario a AEM Forms.

Invocar el DirectoryManagerServiceClient del objeto createLocalUser y pase los siguientes valores:

• La variable UserImpl objeto que representa al nuevo usuario
• Un valor de cadena que representa la contraseña del usuario

La variable createLocalUser devuelve un valor de cadena que especifica el valor del identificador de usuario local.

Compruebe que se ha agregado el usuario.

• Cree un PrincipalSearchFilter usando su constructor.
• Establezca el valor del identificador de usuario invocando la variable PrincipalSearchFilter del objeto setUserId método. Pase un valor de cadena que represente el valor del identificador de usuario.
• Invocar el DirectoryManagerServiceClient del objeto findPrincipals y pase el PrincipalSearchFilter objeto. Este método devuelve un java.util.List instancia, donde cada elemento es un User objeto. Iterar a través de la variable java.util.List para localizar el usuario.

Incluir archivos de proyecto.

Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL para la referencia de servicio: http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1.

Cree un cliente DirectoryManagerService.

• Cree un DirectoryManagerServiceClient usando su constructor predeterminado.

• Cree un DirectoryManagerServiceClient.Endpoint.Address usando la variable System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). No es necesario que use la variable lc_version atributo. Este atributo se utiliza al crear una referencia de servicio. Asegúrese de especificar ?blob=mtom.

• Cree un System.ServiceModel.BasicHttpBinding obteniendo el valor de DirectoryManagerServiceClient.Endpoint.Binding campo . Conversión del valor devuelto a BasicHttpBinding.

• Configure las variables System.ServiceModel.BasicHttpBinding del objeto MessageEncoding campo a WSMessageEncoding.Mtom. Este valor garantiza que se utilice MTOM.

• Habilite la autenticación HTTP básica realizando las siguientes tareas:

  • Asignar el nombre de usuario de los formularios AEM al campo DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  • Asignar el valor de contraseña correspondiente al campo DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  • Asignar el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Asignar el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Defina la información del usuario.

• Cree un UserImpl usando su constructor.
• Establezca el nombre principal asignando un valor de cadena a la variable UserImpl del objeto domainName campo .
• Establezca el tipo principal asignando un valor de cadena al UserImpl del objeto principalType campo . Por ejemplo, puede especificar USER.
• Establezca el valor del identificador de usuario asignando un valor de cadena a la variable UserImpl del objeto userid campo .
• Establezca el valor del nombre canónico asignando un valor de cadena al UserImpl del objeto canonicalName campo .
• Establezca el valor de nombre dado asignando un valor de cadena al UserImpl del objeto givenName campo .
• Establezca el valor del nombre de familia asignando un valor de cadena a la variable UserImpl del objeto familyName campo .

Agregue el usuario a AEM Forms.

Invocar el DirectoryManagerServiceClient del objeto createLocalUser y pase los siguientes valores:

• La variable UserImpl objeto que representa al nuevo usuario
• Un valor de cadena que representa la contraseña del usuario

La variable createLocalUser devuelve un valor de cadena que especifica el valor del identificador de usuario local.

Compruebe que se ha agregado el usuario.

• Cree un PrincipalSearchFilter usando su constructor.
• Establezca el valor del identificador de usuario asignando un valor de cadena que represente el valor del identificador de usuario al valor PrincipalSearchFilter del objeto userId campo .
• Invocar el DirectoryManagerServiceClient del objeto findPrincipals y pase el PrincipalSearchFilter objeto. Este método devuelve un MyArrayOfUser objeto de colección, donde cada elemento es un User objeto. Iterar a través de la variable MyArrayOfUser colección para localizar al usuario.

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente DirectoryManagerService.

Cree un DirectoryManagerServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión.

Especifique el usuario que desea eliminar.

• Cree un PrincipalSearchFilter usando su constructor.
• Establezca el valor del identificador de usuario invocando la variable PrincipalSearchFilter del objeto setUserId método. Pase un valor de cadena que represente el valor del identificador de usuario.
• Invocar el DirectoryManagerServiceClient del objeto findPrincipals y pase el PrincipalSearchFilter objeto. Este método devuelve un java.util.List instancia, donde cada elemento es un User objeto. Iterar a través de la variable java.util.List para localizar el usuario que desea eliminar.

Elimine el usuario de AEM Forms.

Invocar el DirectoryManagerServiceClient del objeto deleteLocalUser y pase el valor de la variable User del objeto oid campo . Invocar el User del objeto getOid método. Utilice la variable User objeto recuperado del java.util.List instancia.

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente DirectoryManagerService.

• Cree un DirectoryManagerServiceClient usando su constructor predeterminado.

• Cree un DirectoryManagerServiceClient.Endpoint.Address usando la variable System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). No es necesario que use la variable lc_version atributo. Este atributo se utiliza al crear una referencia de servicio. Asegúrese de especificar blob=mtom.

• Cree un System.ServiceModel.BasicHttpBinding obteniendo el valor de DirectoryManagerServiceClient.Endpoint.Binding campo . Conversión del valor devuelto a BasicHttpBinding.

• Configure las variables System.ServiceModel.BasicHttpBinding del objeto MessageEncoding campo a WSMessageEncoding.Mtom. Este valor garantiza que se utilice MTOM.

• Habilite la autenticación HTTP básica realizando las siguientes tareas:

  • Asignar el nombre de usuario de los formularios AEM al campo DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  • Asignar el valor de contraseña correspondiente al campo DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  • Asignar el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Asignar el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Especifique el usuario que desea eliminar.

• Cree un PrincipalSearchFilter usando su constructor.
• Establezca el valor del identificador de usuario asignando un valor de cadena a la variable PrincipalSearchFilter del objeto userId campo .
• Invocar el DirectoryManagerServiceClient del objeto findPrincipals y pase el PrincipalSearchFilter objeto. Este método devuelve un MyArrayOfUser objeto de colección, donde cada elemento es un User objeto. Iterar a través de la variable MyArrayOfUser colección para localizar al usuario. La variable User objeto recuperado del MyArrayOfUser el objeto collection se utiliza para eliminar al usuario.

Elimine el usuario de AEM Forms.

Elimine el usuario pasando el User del objeto oid valor de campo a la variable DirectoryManagerServiceClient del objeto deleteLocalUser método.

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente DirectoryManagerService.

Cree un DirectoryManagerServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión.

Determine si existe el grupo.

• Cree un PrincipalSearchFilter usando su constructor.
• Establezca el tipo principal invocando la variable PrincipalSearchFilter del objeto setPrincipalType objeto. Transmitir el valor com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP.
• Establezca el dominio invocando la variable PrincipalSearchFilter del objeto setSpecificDomainName objeto. Pase un valor de cadena que especifique el nombre de dominio.
• Para buscar un grupo, invoque la variable DirectoryManagerServiceClient del objeto findPrincipals método (una entidad de seguridad puede ser un grupo). Pase el PrincipalSearchFilter objeto que especifica el tipo principal y el nombre de dominio. Este método devuelve un java.util.List instancia en la que cada elemento es un Group instancia. Cada instancia de grupo se ajusta al filtro especificado utilizando la variable PrincipalSearchFilter objeto.
• Iterar a través de la variable java.util.List instancia. Para cada elemento, recupere el nombre del grupo. Asegúrese de que el nombre del grupo no sea igual al nuevo nombre del grupo.

Cree el grupo.

• Si el grupo no existe, invoque la variable Group del objeto setCommonName y pase un valor de cadena que especifique el nombre del grupo.
• Invocar el Group del objeto setDescription y pase un valor de cadena que especifique la descripción del grupo.
• Invocar el Group del objeto setDomainName y pase un valor de cadena que especifique el nombre de dominio.
• Invocar el DirectoryManagerServiceClient del objeto createLocalGroup y pase el Group instancia.

La variable createLocalUser devuelve un valor de cadena que especifica el valor del identificador de usuario local.

Realice una acción con el grupo.

• Cree un PrincipalSearchFilter usando su constructor.
• Establezca el valor del identificador de usuario invocando la variable PrincipalSearchFilter del objeto setUserId método. Pase un valor de cadena que represente el valor del identificador de usuario.
• Invocar el DirectoryManagerServiceClient del objeto findPrincipals y pase el PrincipalSearchFilter objeto. Este método devuelve un java.util.List instancia, donde cada elemento es un User objeto. Iterar a través de la variable java.util.List para localizar el usuario.
• Agregue un usuario al grupo invocando la variable DirectoryManagerServiceClient del objeto addPrincipalToLocalGroup método. Pasa el valor devuelto de la variable User del objeto getOid método. Pasa el valor devuelto de la variable Group objetos getOid (utilice el método Group que representa el nuevo grupo).

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java. Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java de AEM Forms.

Cree un cliente DirectoryManagerService.

Cree un DirectoryManagerServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión. Para obtener más información, consulte Configuración de las propiedades de conexión.

Invoque las operaciones de usuario o grupo correspondientes.

Para buscar un usuario o grupo, invoque uno de los DirectoryManagerServiceClient métodos del objeto para encontrar entidades principales (ya que una entidad de seguridad puede ser un usuario o un grupo). En el ejemplo siguiente, la variable findPrincipals se llama mediante un filtro de búsqueda (un PrincipalSearchFilter ).

Dado que el valor devuelto en este caso es un java.util.List contain Principal , repita el resultado y convierta el objeto Principal objetos a User o Group objetos.

Uso del resultante User o Group (que heredan de la variable Principal ), recupere la información que necesita en sus flujos de trabajo. Por ejemplo, los valores de nombre de dominio y nombre canónico, en combinación, identifican de forma exclusiva una entidad de seguridad. Se recuperan invocando la variable Principal del objeto getDomainName y getCanonicalName métodos, respectivamente.

Para eliminar un usuario local, invoque la función DirectoryManagerServiceClient del objeto deleteLocalUser y pasar el identificador del usuario.

Para eliminar un grupo local, invoque la función DirectoryManagerServiceClient del objeto deleteLocalGroup y pase el identificador del grupo.

Incluir archivos de proyecto.

• Cree un ensamblado de cliente Microsoft .NET que consuma el WSDL del Administrador de directorios. (Consulte Invocación de AEM Forms mediante la codificación Base64.)
• Haga referencia al ensamblado del cliente Microsoft .NET. (Consulte Creación de un ensamblado de cliente .NET que utilice la codificación Base64.)

Cree un cliente DirectoryManagerService.

Cree un DirectoryManagerServiceService usando el constructor de su clase proxy.

Invoque las operaciones de usuario o grupo correspondientes.

Para buscar un usuario o grupo, invoque uno de los DirectoryManagerServiceService métodos del objeto para encontrar entidades principales (ya que una entidad de seguridad puede ser un usuario o un grupo). En el ejemplo siguiente, la variable findPrincipalsWithFilter se llama mediante un filtro de búsqueda (un PrincipalSearchFilter ). Al usar un PrincipalSearchFilter objeto, los principales locales solo se devuelven si el valor isLocal la propiedad se establece en true. Este comportamiento es diferente a lo que ocurriría con la API de Java.

Dado que el valor devuelto en este caso es un object[] contain Principal , repita el resultado y convierta el objeto Principal objetos a User o Group objetos.

Uso del resultante User o Group (que heredan de la variable Principal ), recupere la información que necesita en sus flujos de trabajo. Por ejemplo, los valores de nombre de dominio y nombre canónico, en combinación, identifican de forma exclusiva una entidad de seguridad. Se recuperan invocando la variable Principal del objeto domainName y canonicalName , respectivamente.

Para eliminar un usuario local, invoque la función DirectoryManagerServiceService del objeto deleteLocalUser y pasar el identificador del usuario.

Para eliminar un grupo local, invoque la función DirectoryManagerServiceService del objeto deleteLocalGroup y pase el identificador del grupo.

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente AuthorizationManagerService.

Cree un AuthorizationManagerServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión.

Invoque la función adecuada o las operaciones de permisos.

Para asignar una función a una entidad de seguridad, invoque la variable AuthorizationManagerServiceClient del objeto assignRole y pase los siguientes valores:

• A java.lang.String objeto que contiene el identificador de función
• Una matriz de java.lang.String objetos que contienen los identificadores principales.

Para quitar una función de una entidad de seguridad, invoque la función AuthorizationManagerServiceClient del objeto unassignRole y pase los siguientes valores:

• A java.lang.String objeto que contiene el identificador de función.
• Una matriz de java.lang.String objetos que contienen los identificadores principales.

Incluir archivos de proyecto.

Cree un proyecto de Microsoft .NET que utilice MTOM. Asegúrese de utilizar la siguiente definición WSDL: http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1.

Cree un cliente AuthorizationManagerService.

• Cree un AuthorizationManagerServiceClient usando su constructor predeterminado.

• Cree un AuthorizationManagerServiceClient.Endpoint.Address usando la variable System.ServiceModel.EndpointAddress constructor. Pase un valor de cadena que especifique el WSDL al servicio de AEM Forms (por ejemplo, http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom.) No es necesario que use la variable lc_version atributo. Este atributo se utiliza al crear una referencia de servicio.

• Cree un System.ServiceModel.BasicHttpBinding obteniendo el valor de AuthorizationManagerServiceClient.Endpoint.Binding campo . Conversión del valor devuelto a BasicHttpBinding.

• Configure las variables System.ServiceModel.BasicHttpBinding del objeto MessageEncoding campo a WSMessageEncoding.Mtom. Este valor garantiza que se utilice MTOM.

• Habilite la autenticación HTTP básica realizando las siguientes tareas:

  • Asignar el nombre de usuario de los formularios AEM al campo AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName.
  • Asignar el valor de contraseña correspondiente al campo AuthorizationManagerServiceClient.ClientCredentials.UserName.Password.
  • Asignar el valor constante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Asignar el valor constante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Invoque la función adecuada o las operaciones de permisos.

Para asignar una función a una entidad de seguridad, invoque la variable AuthorizationManagerServiceClient del objeto assignRole y pase los siguientes valores:

• A string objeto que contiene el identificador de función
• A MyArrayOf_xsd_string objeto que contiene los identificadores principales.

Para quitar una función de una entidad de seguridad, invoque la función AuthorizationManagerServiceService del objeto unassignRole y pase los siguientes valores:

• A string objeto que contiene el identificador de función.
• Una matriz de string objetos que contienen los identificadores principales.

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente de AuthenticationManagerServices.

Cree un AuthenticationManagerServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión.

Invoque la operación de autenticación.

Invocar el AuthenticationManagerServiceClient del objeto authenticate y pase los siguientes valores:

• A java.lang.String objeto que contiene el nombre del usuario.
• Una matriz de bytes (un byte[] ) que contiene la contraseña del usuario. Puede obtener la variable byte[] invocando el objeto java.lang.String del objeto getBytes método.

El método de autenticación devuelve un valor AuthResult , que contiene información sobre el usuario autenticado.

Recupere el contexto de autenticación.

Invocar el ServiceClientFactory del objeto getContext que devolverá un Context objeto.

A continuación, invoque el Context del objeto initPrincipal y pase el AuthResult.

Incluir archivos de proyecto.

• Cree un ensamblado de cliente de Microsoft .NET que consuma el WSDL del administrador de autenticación. (Consulte Invocación de AEM Forms mediante la codificación Base64.)
• Haga referencia al ensamblado del cliente Microsoft .NET. (Consulte "Referencia al ensamblado de cliente .NET" en Invocación de AEM Forms mediante la codificación Base64.)

Cree un cliente AuthenticationManagerService.

Cree un AuthenticationManagerServiceService usando el constructor de su clase proxy.

Invoque la operación de autenticación.

Invocar el AuthenticationManagerServiceClient del objeto authenticate y pase los siguientes valores:

• A string objeto que contiene el nombre del usuario
• Una matriz de bytes (un byte[] ) que contiene la contraseña del usuario. Puede obtener la variable byte[] mediante la conversión de string objeto que contiene la contraseña de un byte[] empleando la lógica mostrada en el ejemplo siguiente.
• El valor devuelto será un AuthResult , que puede utilizarse para recuperar información sobre el usuario. En el ejemplo siguiente, la información del usuario se recupera obteniendo primero la variable AuthResult del objeto authenticatedUser y obtener posteriormente el resultado User del objeto canonicalName y domainName campos.

Incluir archivos de proyecto.

Incluya archivos JAR del cliente, como adobe-usermanager-client.jar y adobe-usermanager-util-client.jar, en la ruta de clase de su proyecto Java.

Cree un cliente UserManagerUtilServiceClient.

Cree un UserManagerUtilServiceClient usando su constructor y pasando un ServiceClientFactory objeto que contiene propiedades de conexión.

Especifique el dominio de empresa.

• Invocar el UserManagerUtilServiceClient del objeto scheduleSynchronization para iniciar la operación de sincronización de usuarios.
• Cree un java.util.Set usando una instancia de HashSet constructor. Asegúrese de especificar String como tipo de datos. Esta Java.util.Set instance almacena los nombres de dominio a los que se aplica la operación de sincronización.
• Para que se agregue cada nombre de dominio, invoque la variable java.util.Set método add del objeto y pase el nombre de dominio.

Invocar la operación de sincronización.

Invocar el ServiceClientFactory del objeto getContext que devolverá un Context objeto.

A continuación, invoque el Context del objeto initPrincipal y pase el AuthResult.