Registering New Instant Messaging Users

You can customize Instant Messenger to allow new user registration. When a user registers, the Instant Messaging server uses the information provided during registration to perform an ldapadd operation to create a user entry in the directory.

---

Note –

If you are using Instant Messaging with Sun Java^TM System Access Manager, you should not allow users to register using this method. Instead, you should use the provisioning tools provided with Access Manager.

---

To allow new user registration, you need to configure the server to allow registration and then customize Instant Messenger resources by adding an argument to the im.jnlp.template and im.html.template files, running the configure utility, then (if necessary) redeploying the resource files.

This section describes:

• Configuring the Instant Messaging Server to Allow New User Registration

• Customizing Instant Messenger to Allow New User Registration

• Registering as a New Instant Messaging User

See Chapter 13, Managing Instant Messenger for more information about customizing resource files.

Configuring the Instant Messaging Server to Allow New User Registration

In order to configure the Instant Messaging server to allow new user registration you need to add four configuration parameters to iim.conf. Table 12–1 lists the parameters you need add and a brief description of each.

Table 12–1 Instant Messaging Server New User Registration Configuration Parameters

Parameter	Description
iim.register.enable	If TRUE, the server allows new Instant Messaging end users to register themselves (add themselves to the directory) using Instant Messenger.
iim_ldap.register.basedn	If self-registration is enabled, the value of this parameter is the DN of the location in the LDAP directory in which person entries are stored. For example: "ou=people,dc=siroe,dc=com"
iim_ldap.register.domain	The domain to which new users will be added. For example, directory.siroe.com.

To Configure the Instant Messaging Server to Allow New User Registration

Steps

1. Open iim.conf.

   See iim.conf File Syntax for instructions on locating and modifying iim.conf.

2. Add the configuration parameters and appropriate values as described in Table 12–1.

3. Save and close iim.conf.

4. Refresh the server configuration using the imadmin command.

   imadmin refresh server

Customizing Instant Messenger to Allow New User Registration

When you customize the resource files to allow new user registration, a new button appears on the Login dialog box. Users click this button to access the New User Registration dialog box where they can register. When a user registers, their information is added to the LDAP directory.

To Customize Instant Messenger to Allow New User Registration

Steps

1. Open the im.jnlp.template file in a text editor.

   By default this file is stored in im_svr_base/html.

2. Search for the line:

   <application-desc main-class="com.iplanet.im.client.iIM">

3. Add the following argument to the end of the section:

   <argument>register=true</argument>

4. Save and close im.jnlp.template.

5. Open the im.html.template file in a text editor.

   By default this file is stored in im_svr_base/html.

6. Add the register parameter to the file:

   <PARAM NAME="register" VALUE="true">

7. Add the following parameter to the EMBED tag:

   register=true

8. Save and close im.html.template.

9. Run the configure utility, selecting the “Messenger Resources” component only when prompted for which components you want to configure.

   See Configuring Instant Messaging After Installing or Upgrading for instructions.

10. If you are using Sun Java^TM System Access Manager or Sun Java^TM System Web Server, redeploy the resource files.

    See Redeploying Resource Files for instructions.

11. Launch Instant Messenger.

    The I am a New User button should appear on the Login dialog box.

Registering as a New Instant Messaging User

Once you have added the new user registration argument to the im.jnlp and im.html files and redeployed the resource files users can register themselves.

To Register as a New Instant Messaging User

Steps

1. In a web browser, go to the Instant Messaging home page.

2. Click Start or click Use Java Plug-in.

   The Login dialog box appears, displaying the I am a New User button.

3. Click I am a New User.

   The New User Registration dialog box appears.

4. Enter the information in the fields provided and click OK.

   The information is stored in the directory.