Sun Java System Access Manager 7 2005Q4 Developer's Guide

Customizing the Self-Registration Page

You can customize the Self-registration page which is part of Membership authentication module. The default data and interface provided with the Membership authentication module is generic and can work with any domain. You can configure it to reflect custom data and information. You can add custom user profile data or fields to register or to create a new user.

ProcedureTo Modify the Self-Registration Page

  1. Customize the Membership.xml file.

    By default, the first three data fields are required in the default Membership Module configuration:

    • User name

    • User Password

    • Confirm User Password

      You can specify which data is requested, which is required, and which is optional. The sample below illustrates how to add a telephone number as requested data.

      You can specify or add data which should be requested from a user as part of the User Profile. By default you can specify or add any attributes from the following objectClasses:

    • top

    • person

    • organizationalPerson

    • inetOrgPerson

    • iplanet-am-user-service

    • inetuser

      Administrators can add their own user attributes to the User Profile.

  2. Update and redeploy services.war.

    Once you’ve modified the authentication GUI files, in order to see the changes in the actual GUI, you must update and then redeploy services.war. See Updating and Redeploying services.war in this chapter for instructions. See Chapter 12, Updating and Redeploying Access Manager WAR Files for general information on updating and redeploying Access Manager .war files.

  3. Restart both Access Manager and the web container server.


    <Callbacks length="9" order="16" timeout="300"
    header="Self Registration" template="register.jsp" >
    
        <NameCallback isRequired="true" attribute="uid" >
        <Prompt> User Name: </Prompt>
        </NameCallback>
    
        <PasswordCallback echoPassword="false" isRequired="true"
    				attribute="userPassword" >
        <Prompt> Password: </Prompt>
        </PasswordCallback>
    
        <PasswordCallback echoPassword="false" isRequired="true" >
        <Prompt> Confirm Password: </Prompt>
        </PasswordCallback>
    
        <NameCallback isRequired="true" attribute="givenname" >
        <Prompt> First Name: </Prompt>
        </NameCallback>
    
        <NameCallback isRequired="true" attribute="sn" >
        <Prompt> Last Name: </Prompt>
        </NameCallback>
    
        <NameCallback isRequired="true" attribute="cn" >
        <Prompt> Full Name: </Prompt>
        </NameCallback>
    
        <NameCallback attribute="mail" >
        <Prompt> Email Address: </Prompt>
        </NameCallback>
    
    
    <NameCallback isRequired="true"attribute="telphonenumber">
    <Prompt> Tel:</Prompt>
    </NameCallback>
    
        <ConfirmationCallback>
    
            <OptionValues>
            <OptionValue>
            <Value> Register </Value>
            </OptionValue>
            <OptionValue>
            <Value> Cancel </Value>
            </OptionValue>
            </OptionValues>
    
        </ConfirmationCallback>
    
    </Callbacks>