Preface


The descriptions, instructions, and examples in this guide can be used to create and modify a gateway instance to suit the needs of users in your organization.

Audience

---

This guide is for anyone who needs to implement a simple gateway instance with basic directory lookup functionality. It is also for users who wish to implement a more powerful gateway instance with directory authentication and administration capability. This guide assumes the reader is familiar with HTML file syntax and has a rudimentary understanding of how the LDAP directory stores information.

Typographic Conventions

---

The following table lists the typographic conventions used in this guide:

Table 1    Typographic Conventions in the Gateway Customization Guide

Convention	Example	Comment
Pathnames	http://host:port/dsgw/bin/lang?context=CONTEXT	Pathnames specified in this guide are displayed in UNIX format.
4.0 gateway installation directory	/usr/iplanet/servers/ dsgw	Represents the installation directory for the Directory Server instance on the host machine.
3.x gateway installation directory	<NSHOME>/slapd-<server>/dsgw	Represents the release 3.x gateway installation directory for the Directory Server instance on the host machine.
Configuration file	pb.conf dsgw.conf	The .conf file represents the primary configuration file for a gateway instance.
File syntax	People "" "Search for": "(&(objectClass=person)" "dsgw-people"	Gateway HTML file syntax is displayed on a distinct line in a monospaced font.
Command line syntax	# chown <uid> authck	Command line syntax to be entered by the user is displayed on a separate line in a monospaced font.

Related Information

---

The document set for iPlanet Directory Server also contains the following guides:

iPlanet Directory Server Installation Guide. Procedures for installing your Directory Server as well as procedures for migrating your Netscape Directory Server to iPlanet Directory Server.

iPlanet Directory Server Deployment Guide. Provides an overview for planning your deployment of the Gateway Customization Guide. Includes deployment examples.

iPlanet Directory Server Command and File Reference. Provides reference information on the command-line scripts, configuration attributes, and log files shipped with Directory Server.

iPlanet Schema Reference. Information about all the schema used in the iPlanet suite of products.

Other useful iPlanet information can be found at the following Internet locations:

• iPlanet release notes and other documentation: http://docs.iplanet.com/docs/manuals/

• iPlanet product status: http://www.iplanet.com/support/technical_resources/

• iPlanet Professional Services information: http://www.iplanet.com/services/pro_serv/index.html

• iPlanet developer information:
  http://developer.iplanet.com/

• iPlanet learning solutions:
  http://www.iplanet.com/learning/index.html

• iPlanet product data sheets:
  http://www.iplanet.com/products/index.html