Crear un controlador de usuarios externos de invitación create-invite-external-users-handler

Las muestras y los ejemplos de este documento solo son para AEM Forms en un entorno JEE.

Puede crear un controlador de usuarios externos de invitación para el servicio de Rights Management. El controlador de usuarios externos de invitación permite al servicio de Rights Management invitar a usuarios externos para que se conviertan en usuarios de Rights Management. Una vez que un usuario se convierte en un usuario Rights Management, puede realizar tareas como abrir un documento de PDF protegido por políticas. Una vez implementado el controlador de usuarios externos de invitación en AEM Forms, puede utilizar la consola de administración para interactuar con él.

Resumen de los pasos

Para desarrollar un controlador de usuarios externos de invitación, debe realizar los siguientes pasos:

Configuración del entorno de desarrollo setting-up-development-environment

Para configurar el entorno de desarrollo, debe crear un proyecto Java, como un proyecto Eclipse. La versión de Eclipse compatible es 3.2.1 o posterior.

La SPI del Rights Management requiere que el archivo edc-server-spi.jar se establezca en la ruta de clase del proyecto. Si no hace referencia a este archivo JAR, no puede utilizar el SPI de Rights Management en su proyecto Java. Este archivo JAR se instala con el SDK de AEM Forms en la carpeta [install directory]\Adobe\Adobe_Experience_Manager_forms\sdk\spi.

Además de agregar el archivo edc-server-spi.jar a la ruta de clase del proyecto, también debe agregar los archivos JAR necesarios para utilizar la API del servicio de Rights Management. Estos archivos son necesarios para utilizar la API del servicio de Rights Management dentro del controlador de usuarios externos de invitación.

Definición de la implementación del controlador de usuarios externos de invitación define-invite-external-users-handler

Para desarrollar un controlador de usuarios externos de invitación, debe crear una clase Java que implemente la interfaz com.adobe.edc.server.spi.ersp.InvitedUserProvider. Esta clase contiene un método denominado invitedUser, que el servicio de Rights Management invoca cuando se envían direcciones de correo electrónico utilizando la página Agregar usuarios invitados a la que se puede acceder mediante la consola de administración.

El método invitedUser acepta una instancia de java.util.List, que contiene direcciones de correo electrónico con tipo de cadena enviadas desde la página Agregar usuarios invitados. El método invitedUser devuelve una matriz de objetos InvitedUserProviderResult, que generalmente es una asignación de direcciones de correo electrónico a objetos User (no devuelven null).

La implementación del controlador de usuarios externos de invitación contiene un método definido por el usuario denominado createLocalPrincipalAccount. Este método acepta un valor de cadena que especifica una dirección de correo electrónico como valor de parámetro. El método createLocalPrincipalAccount supone la preexistencia de un dominio local denominado EDC_EXTERNAL_REGISTERED. Puede configurar este nombre de dominio para que sea lo que desee; sin embargo, para una aplicación de producción, puede que desee integrarlo con un dominio de empresa.

El método createUsers recorre en iteración todas las direcciones de correo electrónico y crea el objeto User correspondiente (un usuario local del dominio EDC_EXTERNAL_REGISTERED). Finalmente, se llama al método doEmails. Este método se deja intencionalmente como un código auxiliar en la muestra. En una implementación de producción, contendría la lógica de la aplicación para enviar mensajes de correo electrónico de invitación a los usuarios recién creados. Se deja en el ejemplo para mostrar el flujo lógico de una aplicación real.

Definición de la implementación del controlador de usuarios externos de invitación user-handler-implementation

La siguiente implementación del controlador de usuarios externos de invitación acepta direcciones de correo electrónico que se envían desde la página Agregar usuarios invitados a la que se puede acceder mediante la consola de administración.

package com.adobe.livecycle.samples.inviteexternalusers.provider;

import com.adobe.edc.server.spi.ersp.*;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;
import com.adobe.idp.um.api.*;
import com.adobe.idp.um.api.infomodel.*;
import com.adobe.idp.um.api.impl.UMBaseLibrary;
import com.adobe.livecycle.usermanager.client.DirectoryManagerServiceClient;

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

public class InviteExternalUsersSample implements InvitedUserProvider
{
       private ServiceClientFactory _factory = null;

       private User createLocalPrincipalAccount(String email_address) throws Exception
       {
    String ret = null;

    //  Assume the local domain already exists!
    String domain = "EDC_EXTERNAL_REGISTERED";

    List aliases = new ArrayList();
    aliases.add( email_address );

    User local_user = UMBaseLibrary.createUser( email_address, domain, email_address );
    local_user.setCommonName( email_address );
    local_user.setEmail( email_address );
    local_user.setEmailAliases( aliases );

    //  You may wish to disable the local user until, for example, his registration is processed by a confirmation link
    //local_user.setDisabled( true );

    DirectoryManager directory_manager = new DirectoryManagerServiceClient( _factory );
    String ret_oid = directory_manager.createLocalUser( local_user, null );

    if( ret_oid == null )
    {
        throw new Exception( "FAILED TO CREATE PRINCIPAL FOR EMAIL ADDRESS: " + email_address );
    }

    return local_user;
       }

       protected User[] createUsers( List emails ) throws Exception
       {
    ArrayList ret_users = new ArrayList();

    _factory = ServiceClientFactory.createInstance();

    Iterator iter = emails.iterator();

    while( iter.hasNext() )
    {
        String current_email = (String)iter.next();

        ret_users.add( createLocalPrincipalAccount( current_email ) );
    }

    return (User[])ret_users.toArray( new User[0] );
       }

       protected void doInvitations(List emails)
       {
    //  Here you may choose to send the users who were created an invitation email
    //  This step is completely optional, depending on your requirements.
       }

       public InvitedUserProviderResult[] invitedUser(List emails)
       {
    //  This sample demonstrates the workflow for inviting a user via email

    try
    {

        User[] principals = createUsers(emails);

        InvitedUserProviderResult[] result = new InvitedUserProviderResult[principals.length];
        for( int i = 0; i < principals.length; i++ )
        {
        result[i] = new InvitedUserProviderResult();

        result[i].setEmail( (String)emails.get( i ) );
        result[i].setUser( principals[i] );
        }

        doInvitations(emails);

        System.out.println( "SUCCESSFULLY INVITED " + result.length + " USERS" );

        return result;

    }
    catch( Exception e )
    {
        System.out.println( "FAILED TO INVITE USERS FOR INVITE USERS SAMPLE" );
        e.printStackTrace();

        return new InvitedUserProviderResult[0];
    }
       }
}

Definición del archivo XML del componente para el controlador de autorización define-component-xml-authorization-handler

Defina un archivo XML de componente para implementar el componente de controlador de usuarios externos de invitación. Existe un archivo XML de componente para cada componente y proporciona metadatos sobre el componente.

El siguiente archivo component.xml se usa para el controlador de usuarios externos de invitación. Observe que el nombre del servicio es InviteExternalUsersSample y la operación que expone este servicio se denomina invitedUser. El parámetro de entrada es una instancia de java.util.List y el valor de salida es una matriz de com.adobe.edc.server.spi.esrp.InvitedUserProviderResult instancias.

Definición del archivo XML del componente para el controlador de usuarios externos de invitación component-xml-invite-external-users-handler

<component xmlns="https://adobe.com/idp/dsc/component/document">
<component-id>com.adobe.livecycle.samples.inviteexternalusers</component-id>
<version>1.0</version>
<bootstrap-class>com.adobe.livecycle.samples.inviteexternalusers.provider.BootstrapImpl</bootstrap-class>
<descriptor-class>com.adobe.idp.dsc.component.impl.DefaultPOJODescriptorImpl</descriptor-class>
<services>
<service name="InviteExternalUsersSample">
<specifications>
<specification spec-id="com.adobe.edc.server.spi.ersp.InvitedUserProvider"/>
</specifications>
<specification-version>1.0</specification-version>
<implementation-class>com.adobe.livecycle.samples.inviteexternalusers.provider.InviteExternalUsersSample</implementation-class>
<auto-deploy category-id="Samples" service-id="InviteExternalUsersSample" major-version="1" minor-version="0"/>
<operations>
<operation name="invitedUser">
<input-parameter name="input" type="java.util.List" required="true"/>
<output-parameter name="result" type="com.adobe.edc.server.spi.esrp.InvitedUserProviderResult[]"/>
</operation>
</operations>
</service>
</services>
</component>

Empaquetando el controlador de usuarios externos de invitación packaging-invite-external-users-handler

Para implementar el controlador de usuarios externos de invitación en AEM Forms, debe empaquetar el proyecto Java en un archivo JAR. Asegúrese de que los archivos JAR externos de los que depende la lógica empresarial del controlador de usuarios externos de invitación, como los archivos edc-server-spi.jar y adobe-rightsmanagement-client.jar, también se incluyan en el archivo JAR. Además, el archivo XML de componente debe estar presente. El archivo component.xml y los archivos JAR externos deben encontrarse en la raíz del archivo JAR.

La siguiente ilustración muestra el contenido del proyecto Java que se empaqueta en el archivo JAR del controlador de usuarios externos de invitación.

A. Archivos JAR externos requeridos por el componente B. Archivo JAVA

Empaquete el controlador de usuarios externos de invitación en un archivo JAR. En el diagrama anterior, observe que se muestran los archivos .JAVA. Una vez empaquetados en un archivo JAR, también se deben especificar los archivos .CLASS correspondientes. Sin los archivos .CLASS, el controlador de autorización no funciona.

Prueba del controlador de usuarios externos de invitación testing-invite-external-users-handler

Para probar el controlador de usuarios externos de invitación, puede agregar usuarios externos a la invitación mediante la consola de administración.

Para agregar usuarios externos a los que invitar mediante la consola de administración: