| Main Page  Authentication User ID Generation SPI Sample :
UserIDGeneratorSampleThis file explains how to compile, deploy and configure
the Authentication User ID Generation SPI Sample.
 PRODUCT_DIR setting on different
Platforms: 
 Steps to compile the UserIDGeneratorSample Sample
program on
Solaris Sparc/x86, LinuxFollow the steps given below to compile the
sample found
under <PRODUCT_DIR>/samples/authentication/spi/genuid . Set the following environment variables. These
variables will be used to run the gmake command. You can also set these
variables in the Makefile. This Makefile is in 
<PRODUCT_DIR>/samples/authentication/spi/genuid.
 
          Go to the
<PRODUCT_DIR>/samples/authentication/spi/genuid directory and run
gmake. JAVA_HOMESet this variable to your installation of JDK. The JDK
should be version 1.3.1_06 or higher.
 
  CLASSPATHSet this variable to refer to am_services.jar which can
be found in the <PRODUCT_DIR>/lib directory. (Note: Include
jaas.jar in your classpath if you are using JDK version less than
JDK1.4)
 
  BASE_DIRSet this variable to the directory where the Access
Manager is installed.
 
  BASE_CLASS_DIRSet this variable to the directory where all the Sample
compiled classes are located.
 
  JAR_DIRSet this variable to the directory where the JAR files of
the Sample compiled classes will be created.
 
      Steps to "deploy" the UserIDGeneratorSample Sample program
          Copy
UserIDGeneratorSample.jar from JAR_DIR to <PRODUCT_DIR>/lib.  Update classpath with UserIDGeneratorSample.jar in
the Web
Container from which this sample has to run. For use with Sun ONE
Webserver,
go to server instance's config directory
/<WS-home-dir>/https-<WS-instance-name>/config/. For Sun
ONE App Server <AS-home-dir>/domain/domain1/server1/config/ and
update server.xml with new classpath.for all other containers consult
their documentation.  Restart web container (e.g.
/<WS-home-dir>/https-<WS-instance-name>/start,
/<AS-home-dir>/domains/domain1/server1/bin/start for Web Server
and App server respectively) 
      Steps to configure UserIDGeneratorSample Sample programThe Authentication User ID Generation Sample can
be configured at the Organization level and used/invoked by out of box
Membership/Self registration auth module.  Configuring UserIDGeneratorSample Sample for
Organization : 
         Log in to Access Manager console as amAdmin to
http://<host>.<domain>:<port>/<Service-Deploy-URI>/UI/LoginClick on  "Access Control" tab. 
Click on the realm.
 Click on "Authentication" tab.
 Click on "Advanced Properties" button under
Authentication.
 Add
"com.iplanet.am.samples.authentication.spi.genuid.UserIDGeneratorSample"
to "Pluggable User Name Generator Class" attribute  Click on "Save" to save the changes.  Log out. Accessing authentication module for
Organization : Note : This module is the one which invokes
UserIDGenerator SPI implementation class. Out of box, only
Membership/Self registration
authentication module calls this SPI implementation.
  On Windows2000
      Steps to compile UserIDGeneratorSample Sample program on
Windows2000
        
           Go to the
<install-root>\samples\authentication\spi\genuid directory and
run make.  
      Steps to deploy the UserIDGeneratorSample Sample program
        
           Copy UserIDGeneratorSample.jar from JAR_DIR to
<install-root>\lib Update classpath with UserIDGeneratorSample.jar in
the Web
Container from which this sample has to run. Restart Access Manager
("<install-root>\bin\amserver
start").  
      Steps to configure UserIDGeneratorSample Sample programRefer to this section in the "On Solaris" section
in this document. |