Administración de usuarios managing-users

Incluir archivos de proyecto.

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

Cree un cliente de DirectoryManagerServices.

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

Definir información de usuario.

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

Añada el usuario a AEM Forms.

Invoque el método createLocalUser del objeto DirectoryManagerServiceClient y pase los siguientes valores:

• El objeto UserImpl que representa al nuevo usuario
• Valor de cadena que representa la contraseña del usuario

El método createLocalUser devuelve un valor de cadena que especifica el valor del identificador de usuario local.

Compruebe que se ha agregado el usuario.

• Crear un objeto PrincipalSearchFilter mediante su constructor.
• Establezca el valor del identificador de usuario invocando el método setUserId del objeto PrincipalSearchFilter. Pase un valor de cadena que represente el valor del identificador de usuario.
• Invoque el método findPrincipals del objeto DirectoryManagerServiceClient y pase el objeto PrincipalSearchFilter. Este método devuelve una instancia java.util.List, donde cada elemento es un objeto User. Itere por la instancia java.util.List para localizar al usuario.

Incluir archivos de proyecto.

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

Cree un cliente DirectoryManagerService.

• Cree un objeto DirectoryManagerServiceClient utilizando su constructor predeterminado.

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

• Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo DirectoryManagerServiceClient.Endpoint.Binding. Convertir el valor devuelto en BasicHttpBinding.

• Establezca el campo MessageEncoding del objeto System.ServiceModel.BasicHttpBinding en WSMessageEncoding.Mtom. Este valor garantiza que se utiliza MTOM.

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

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

Definir información de usuario.

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

Añada el usuario a AEM Forms.

Invoque el método createLocalUser del objeto DirectoryManagerServiceClient y pase los siguientes valores:

• El objeto UserImpl que representa al nuevo usuario
• Valor de cadena que representa la contraseña del usuario

El método createLocalUser devuelve un valor de cadena que especifica el valor del identificador de usuario local.

Compruebe que se ha agregado el usuario.

• Crear un objeto PrincipalSearchFilter mediante su constructor.
• Establezca el valor del identificador de usuario del usuario asignando un valor de cadena que represente el valor del identificador de usuario al campo userId del objeto PrincipalSearchFilter.
• Invoque el método findPrincipals del objeto DirectoryManagerServiceClient y pase el objeto PrincipalSearchFilter. Este método devuelve un objeto de colección MyArrayOfUser, donde cada elemento es un objeto User. Recorra en iteración la colección MyArrayOfUser para localizar al usuario.

Incluir archivos de proyecto.

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

Cree un cliente DirectoryManagerService.

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

Especifique el usuario que desea eliminar.

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

Elimine el usuario de AEM Forms.

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

Incluir archivos de proyecto.

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

Cree un cliente DirectoryManagerService.

• Cree un objeto DirectoryManagerServiceClient utilizando su constructor predeterminado.

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

• Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo DirectoryManagerServiceClient.Endpoint.Binding. Convertir el valor devuelto en BasicHttpBinding.

• Establezca el campo MessageEncoding del objeto System.ServiceModel.BasicHttpBinding en WSMessageEncoding.Mtom. Este valor garantiza que se utiliza MTOM.

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

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

Especifique el usuario que desea eliminar.

• Crear un objeto PrincipalSearchFilter mediante su constructor.
• Establezca el valor del identificador de usuario asignando un valor de cadena al campo userId del objeto PrincipalSearchFilter.
• Invoque el método findPrincipals del objeto DirectoryManagerServiceClient y pase el objeto PrincipalSearchFilter. Este método devuelve un objeto de colección MyArrayOfUser, donde cada elemento es un objeto User. Recorra en iteración la colección MyArrayOfUser para localizar al usuario. El objeto User recuperado del objeto de colección MyArrayOfUser se usa para eliminar al usuario.

Elimine el usuario de AEM Forms.

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

Incluir archivos de proyecto.

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

Cree un cliente DirectoryManagerService.

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

Determine si el grupo existe.

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

Cree el grupo.

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

El método createLocalUser devuelve un valor de cadena que especifica el valor del identificador de usuario local.

Realice una acción con el grupo.

• Crear un objeto PrincipalSearchFilter mediante su constructor.
• Establezca el valor del identificador de usuario invocando el método setUserId del objeto PrincipalSearchFilter. Pase un valor de cadena que represente el valor del identificador de usuario.
• Invoque el método findPrincipals del objeto DirectoryManagerServiceClient y pase el objeto PrincipalSearchFilter. Este método devuelve una instancia java.util.List, donde cada elemento es un objeto User. Itere por la instancia java.util.List para localizar al usuario.
• Agregue un usuario al grupo invocando el método addPrincipalToLocalGroup del objeto DirectoryManagerServiceClient. Pase el valor devuelto del método getOid del objeto User. Pase el valor devuelto del método getOid de los objetos Group (utilice la instancia Group que representa el nuevo grupo).

Incluir archivos de proyecto.

Incluya archivos JAR de cliente, como adobe-usermanager-client.jar, en la ruta de clase del 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 objeto DirectoryManagerServiceClient utilizando su constructor y pasando un objeto ServiceClientFactory que contenga propiedades de conexión. Para obtener más información, vea Configurar propiedades de conexión.

Invoque las operaciones de usuario o grupo adecuadas.

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

Dado que el valor devuelto en este caso es un(a) java.util.List que contiene Principal objetos, iterar por el resultado y convertir los objetos Principal en objetos User o Group.

Con el objeto User o Group resultante (que heredan de la interfaz Principal), recupere la información que necesite en los flujos de trabajo. Por ejemplo, los valores de nombre de dominio y nombre canónico, en combinación, identifican de forma exclusiva un principal. Se recuperan invocando los métodos getDomainName y getCanonicalName del objeto Principal, respectivamente.

Para eliminar un usuario local, invoque el método deleteLocalUser del objeto DirectoryManagerServiceClient y pase el identificador del usuario.

Para eliminar un grupo local, invoque el método deleteLocalGroup del objeto DirectoryManagerServiceClient y pase el identificador del grupo.

Incluir archivos de proyecto.

• Crear un ensamblado de cliente de Microsoft .NET que consuma el WSDL de Directory Manager. (Consulte Invocación de AEM Forms mediante codificación Base64).
• Hacer referencia al ensamblado de cliente de Microsoft .NET. (Vea Crear un ensamblado de cliente .NET que utiliza codificación Base64.)

Cree un cliente DirectoryManagerService.

Cree un objeto DirectoryManagerServiceService utilizando el constructor de la clase de proxy.

Invoque las operaciones de usuario o grupo adecuadas.

Para buscar un usuario o grupo, invoque uno de los métodos del objeto DirectoryManagerServiceService para buscar principales (ya que una entidad de seguridad puede ser un usuario o un grupo). En el ejemplo siguiente, se llama al método findPrincipalsWithFilter mediante un filtro de búsqueda (un objeto PrincipalSearchFilter). Cuando se usa un objeto PrincipalSearchFilter, las entidades de seguridad locales sólo se devuelven si la propiedad isLocal está establecida en true. Este comportamiento es diferente al que se produciría con la API de Java.

Dado que el valor devuelto en este caso es un(a) object[] que contiene Principal objetos, iterar por el resultado y convertir los objetos Principal en objetos User o Group.

Con el objeto User o Group resultante (que heredan de la interfaz Principal), recupere la información que necesite en los flujos de trabajo. Por ejemplo, los valores de nombre de dominio y nombre canónico, en combinación, identifican de forma exclusiva un principal. Se recuperan invocando los campos domainName y canonicalName del objeto Principal, respectivamente.

Para eliminar un usuario local, invoque el método deleteLocalUser del objeto DirectoryManagerServiceService y pase el identificador del usuario.

Para eliminar un grupo local, invoque el método deleteLocalGroup del objeto DirectoryManagerServiceService y pase el identificador del grupo.

Incluir archivos de proyecto.

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

Cree un cliente AuthorizationManagerService.

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

Invoque las operaciones de rol o permiso correspondientes.

Para asignar un rol a un principal, invoque el método assignRole del objeto AuthorizationManagerServiceClient y pase los siguientes valores:

• Un objeto java.lang.String que contiene el identificador de rol
• Matriz de java.lang.String objetos que contiene los identificadores principales.

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

• Un objeto java.lang.String que contiene el identificador de rol.
• Matriz de java.lang.String objetos que contiene los identificadores principales.

Incluir archivos de proyecto.

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

Cree un cliente AuthorizationManagerService.

• Cree un objeto AuthorizationManagerServiceClient utilizando su constructor predeterminado.

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

• Cree un objeto System.ServiceModel.BasicHttpBinding obteniendo el valor del campo AuthorizationManagerServiceClient.Endpoint.Binding. Convertir el valor devuelto en BasicHttpBinding.

• Establezca el campo MessageEncoding del objeto System.ServiceModel.BasicHttpBinding en WSMessageEncoding.Mtom. Este valor garantiza que se utiliza MTOM.

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

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

Invoque las operaciones de rol o permiso correspondientes.

Para asignar un rol a un principal, invoque el método assignRole del objeto AuthorizationManagerServiceClient y pase los siguientes valores:

• Un objeto string que contiene el identificador de rol
• Un objeto MyArrayOf_xsd_string que contiene los identificadores principales.

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

• Un objeto string que contiene el identificador de rol.
• Matriz de string objetos que contiene los identificadores principales.

Incluir archivos de proyecto.

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

Cree un cliente AuthenticationManagerServices.

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

Invoque la operación de autenticación.

Invoque el método authenticate del objeto AuthenticationManagerServiceClient y pase los siguientes valores:

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

El método authenticate devuelve un objeto AuthResult, que contiene información sobre el usuario autenticado.

Recupere el contexto de autenticación.

Invoque el método getContext del objeto ServiceClientFactory, el cual devolverá un objeto Context.

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

Incluir archivos de proyecto.

• Cree un ensamblado de cliente de Microsoft .NET que consuma el WSDL de Authentication Manager. (Consulte Invocación de AEM Forms mediante codificación Base64).
• Hacer referencia al ensamblado de cliente de Microsoft .NET. (Consulte "Hacer referencia al ensamblado de cliente .NET" en Invocar AEM Forms mediante codificación Base64.)

Cree un cliente AuthenticationManagerService.

Cree un objeto AuthenticationManagerServiceService utilizando el constructor de la clase de proxy.

Invoque la operación de autenticación.

Invoque el método authenticate del objeto AuthenticationManagerServiceClient y pase los siguientes valores:

• Objeto string que contiene el nombre del usuario
• Matriz de bytes (un objeto byte[]) que contiene la contraseña del usuario. Puede obtener el objeto byte[] convirtiendo un objeto string que contenga la contraseña en una matriz byte[] mediante la lógica que se muestra en el ejemplo siguiente.
• El valor devuelto será un objeto AuthResult, que se puede usar para recuperar información sobre el usuario. En el ejemplo siguiente, la información del usuario se recupera obteniendo primero el campo authenticatedUser del objeto AuthResult y, a continuación, los campos canonicalName y domainName del objeto User resultante.

Incluir archivos de proyecto.

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

Cree un cliente UserManagerUtilServiceClient.

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

Especifique el dominio de empresa.

• Invoque el método scheduleSynchronization del objeto UserManagerUtilServiceClient para iniciar la operación de sincronización de usuarios.
• Crear una instancia de java.util.Set mediante un constructor de HashSet. Asegúrese de especificar String como tipo de datos. Esta instancia de Java.util.Set 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 el método add del objeto java.util.Set y pase el nombre de dominio.

Invoque la operación de sincronización.

Invoque el método getContext del objeto ServiceClientFactory, el cual devolverá un objeto Context.

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