Quick Start (SOAP mode): Managing roles and permissions using the Java API

The following code example assigns the Services User role to a principal, prints the roles the principal has, and subsequently removes the role from the principal. Two services are invoked for this quick start: the DirectoryManager service and the AuthorizationManager service.(See Managing Roles and Permissions.)

/* 
    * This Java Quick Start uses the SOAP mode and contains the following JAR files 
    * in the class path: 
    * 1. adobe-livecycle-client.jar 
    * 2. adobe-usermanager-client.jar 
    * 3 adobe-utilities.jar 
    * 4. jbossall-client.jar (use a different JAR file if the LiveCycle server is not deployed 
    * on JBoss) 
    * 5. activation.jar (required for SOAP mode) 
    * 6. axis.jar (required for SOAP mode) 
    * 7. commons-codec-1.3.jar (required for SOAP mode) 
    * 8.  commons-collections-3.1.jar  (required for SOAP mode) 
    * 9. commons-discovery.jar (required for SOAP mode) 
    * 10. commons-logging.jar (required for SOAP mode) 
    * 11. dom3-xml-apis-2.5.0.jar (required for SOAP mode) 
    * 12. jaxen-1.1-beta-9.jar (required for SOAP mode) 
    * 13. jaxrpc.jar (required for SOAP mode) 
    * 14. log4j.jar (required for SOAP mode) 
    * 15. mail.jar (required for SOAP mode) 
    * 16. saaj.jar (required for SOAP mode) 
    * 17. wsdl4j.jar (required for SOAP mode) 
    * 18. xalan.jar (required for SOAP mode) 
    * 19. xbean.jar (required for SOAP mode) 
    * 20. xercesImpl.jar (required for SOAP mode) 
    *  
    *  These JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/common 
    *  
    * The adobe-utilities.jar file is located in the following path: 
    * <install directory>/sdk/client-libs/jboss 
    *  
    * The jbossall-client.jar file is located in the following path: 
    * <install directory>/jboss/client 
    *  
    * SOAP required JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/thirdparty 
    *  
    * If you want to invoke a remote LiveCycle server instance and there is a 
    * firewall between the client application and the server, then it is  
    * recommended that you use the SOAP mode. When using the SOAP mode,  
    * you have to include these additional JAR files 
    *  
    * For information about the SOAP  
    * mode, see "Setting connection properties" in Programming  
    * with LiveCycle 
    */ 
 
import java.util.*; 
 
import com.adobe.idp.um.api.infomodel.*; 
import com.adobe.livecycle.usermanager.client.AuthorizationManagerServiceClient; 
import com.adobe.livecycle.usermanager.client.DirectoryManagerServiceClient; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
 
public class ManageRolesAndPermissionsTestSOAP 
 
{ 
    public static void main(String[] args) { 
        try{ 
            //Set connection properties required to invoke LiveCycle using SOAP mode                             
            Properties connectionProps = new Properties(); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://hiro-xp:8080"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);           
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password"); 
 
            //Create a ServiceClientFactory object 
            ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
 
            // Create an AuthorizationManagerServiceClient object 
            AuthorizationManagerServiceClient amClient = new AuthorizationManagerServiceClient(myFactory); 
 
            // Retrieve a principal 
            DirectoryManagerServiceClient dirClient = new DirectoryManagerServiceClient(myFactory); 
            PrincipalSearchFilter psf = new PrincipalSearchFilter(); 
            psf.setUserId("wblue"); 
            List principalList = dirClient.findPrincipals(psf); 
            Iterator pit = principalList.iterator(); 
            String oid = ""; 
            if (pit.hasNext()) 
            { 
                // Obtain the principal?s object identifier 
                oid = ((User)pit.next()).getOid(); 
                String[] principalOids = new String[1]; 
                principalOids[0] = oid; 
 
                //Obtain the roles to be assigned 
                RoleSearchFilter rsf = new RoleSearchFilter(); 
                rsf.setRoleName("Services User"); 
                List roleList = amClient.findRoles(rsf); 
                Iterator rit = roleList.iterator(); 
                String roleId1 = ""; 
                if (rit.hasNext()) 
                { 
                    // Obtain the role identifier 
                    roleId1 = ((Role)rit.next()).getId(); 
 
                    // Assign the role to the principal 
                    amClient.assignRole(roleId1, principalOids); 
                } 
                else 
                { 
                    System.out.println("Role not found"); 
                } 
 
                // Determine which roles the principal has 
                Set roleSet = amClient.findRolesForPrincipal(oid); 
 
                // Print the roles the principal has 
                Iterator it = roleSet.iterator(); 
                Role r = null; 
                System.out.println("Roles:"); 
                while (it.hasNext()) 
                { 
                    r = ((Role)it.next()); 
                    System.out.println(r.getName()); 
                } 
 
                // Remove a role from the principal 
                amClient.unassignRole(roleId1, principalOids); 
            } 
            else 
            { 
                System.out.println("Principal not found"); 
            } 
 
        }catch (Exception e) { 
            e.printStackTrace(); 
        } 
    } 
}