Creating custom plug-ins for Web Express Logon

Web Express Logon relies on plug-ins to provide the network user ID and host access credentials. Web Express Logon interacts with these plug-ins through Java interfaces, which are described in the following sections.

Web Express Logon is implemented at the enterprise archive (.ear) file level for HATS Web projects and at the Web archive (.war) file level for HATS portlet projects. Your plug-in needs to be placed into each enterprise archive file or Web archive file accordingly. Follow these steps to create your own plug-in:
  1. Create a Java project in Rational® SDP to hold your plug-in. Ensure that these HATS files are in the class path of the Java project, in this order:
    1. hatscommon.jar
    2. hodwel.jar
    These files are located in the common plug-ins (cache) directory of the HATS Toolkit (common plug-ins directory/plugins/com.ibm.hats.core_x.x.x.yearxxxxxxxx/lib) where x.x.x is the version level and yearxxxxxxxx is the build level of HATS and in the root directory of the HATS enterprise archive file.
  2. Code your plug-in using the APIs described in this chapter.
  3. Create a Java Archive (.jar) file from your Java project. For HATS Web projects, export the .jar file to the file system in each .ear file in which you want to use it. For HATS portlet projects, export the .jar file to the Web Content/WEB-INF/lib directory of the HATS portlet projects in which you want to use it.
  4. Add the Java Archive to the MANIFEST.MF located in Web-Content/META-INF.
  5. Configure your connections to use Web Express Logon, and configure Web Express Logon to use your custom plug-in. Refer to Security and Web Express Logon for information about planning and configuring Web Express Logon.