Configuring the Administration UI

To use the Administration UI in Rich Client, perform the following procedure:
  1. Configure the IBTTSecurityObjectManager interface on the server side.
  2. Configure the BTT Service Connector on the server side. Deploy the com.ibm.btt.webapp.BTTServerStarter and com.ibm.btt.remote.BTTRemoteConnector classes to the server.

    Here's the sample code for configuring the BTT Service Connector on the server side.

    <listener>
          <description>BTTServerStarter</description>
          <display-name>BTTServerStarter</display-name>
          <listener-class>
          com.ibm.btt.webapp.BTTServerStarter</listener-class>
    </listener>
    
    <context-param>
          <description>elementFactoryConfigPath</description>
          <param-name>elementFactoryConfigPath</param-name>
          <param-value>jar:///config/branch001_xml.xml</param-value>
    <context-param>
    
    <servlet>
          <description>BTTRemoteConnector</description>
          <display-name>BTTRemoteConnector</display-name>
          <servlet-name>BTTRemoteConnector</servlet-name>
          <servlet-class>
          com.ibm.btt.remote.BTTRemoteConnector
          </servlet-class>
    <servlet>
    Remember: You should replace jar:///config/branch001_xml.xml with your configuration file of the BTT Access Control.
  3. Configure the IBTTSecurityObjectManager interface on the client side. This configuration is based on BTT Element Factory.

    Here's the sample code for configuring the IBTTSecurityObjectManager interface on the client side.

    <branch001.xml>
          <com.ibm.btt.bc.ac.rcp.AccessControlClientConfig 
    id="clientConfig">
                 <ref Injection="securityObjectManager"	
           refId="securityObjectManager" />
           </com.ibm.btt.bc.ac.rcp.AccessControlClientConfig>
           <com.ibm.btt.bc.ac.ISecurityObjectManager 
    id="securityObjectManager"
    		         Instantiate="factoryElement"
    		         FactoryClass="com.ibm.btt.remote.RemoteProxyFactory"
    		
          serviceUrl="http://hostname:port/ContextRootofServer/BTTRemoteCon
    nector"
    		
    		         serviceId="securityObjectManager">
            </com.ibm.btt.bc.ac.ISecurityObjectManager>
    </branch001.xml>

    where, AccessControlClientConfig is a help class for Administration UI configuration; serviceUrl is the URL of the BTTRemoteConnector servlet which you have deployed to the server.

  4. Configure the Administration UI in Rich Client.

    The Administration UI of BTT Access Control is an Eclipse plug-in which is designed as a BTT Business Component Activity (com.ibm.btt.bc.common.activity.BCActivity). The definition of this activity is different from other activity definitions. You need to specify not only the composite class , but also the initialized object ID for the UI. The initialized object ID is located in the definition file of the element factory.

    The following figure illustrates of how to define a business component activity for the user management. The definitions of service, right, and role management is similar to the user management in the figure, except for the parameter field.

    The screen capture is an example about how to define a business component activity for the user management
    • User Management parameter: com.ibm.btt.bc.ac.rcp.factory.QueryUserCompositeFactory;clientConfig
    • Service Management parameter: com.ibm.btt.bc.ac.rcp.factory.QueryServiceCompositeFactory;clientConfig
    • Right Management parameter: com.ibm.btt.bc.ac.rcp.factory.QueryRightCompositeFactory;clientConfig
    • Role Management parameter: com.ibm.btt.bc.ac.rcp.factory.QueryRoleCompositeFactory;clientConfig