A.1 Driver Settings

This section describes the Driver Configuration parameters.

Many of these parameters are actually for the Publisher channel Web server. They appear in the Driver Settings area because the Manual Task Service driver Subscriber channel also needs access to them.

A.1.1 DN of the Document Base

This parameter is an eDirectory DN of a container object. The Manual Task Service driver can load XML documents (including XSLT style sheets) from eDirectory as well as from disk. If XML documents should be loaded from eDirectory, this parameter identifies the root container from which documents are loaded.

Documents loaded from eDirectory reside in the attribute value of an eDirectory object. If unspecified, the attribute is XmlData. The attribute can be specified by appending a # character followed by the attribute name to the name of the object containing the document.

For example, suppose that the document base DN is specified to be novell\Manual Task Documents and that there is a container under Manual Task Documents named templates.

If a DirXML-Style Sheet object named e-mail _template resides under the templates directory, then the following resource identifiers can be used to refer to the XML document: templates/e-mail _template or templates/e-mail _template#XmlData.

The resource identifiers can be supplied as replacement data, URL data, or HTTP POST data. For example, the following element might appear under a <message> element on the Subscriber channel:

<template>templates/e-mail _template#XmlData</template>

A.1.2 Document Directory

This parameter identifies a file system directory that is used as the base directory for locating resources such as templates, XSLT style sheets, and other file resources served by the Publisher channel Web server. Example values are:

Windows

c:\Novell\Nds\mt_files

UNIX

/usr/lib/dirxml/rules/manualtask/mt_files

A.1.3 Use HTTP Server (true|false)

This parameter indicates whether the Publisher channel should run a Web server or not. Set the parameter to True if the Web server should run, or False if the Web server should not run.

If the Manual Task Service driver is only used for sending e-mail with no response URL, or with a URL that points to another application, then the HTTP server should not run, to save system resources.

A.1.4 HTTP IP Address or Host Name

This parameter allows you to specify which multiple, local IP addresses the Publisher channel Web server should us to listen for HTTP requests.

Leaving the HTTP IP address or hostname parameter value blank causes the Publisher channel Web server to listen on the default IP address. For servers with a single IP address, this is sufficient. Placing a dot-notation IP address as the parameter value causes the Publisher channel Web server to listen for HTTP requests on the address specified.

The value specified for HTTP IP address or hostname is used by the Subscriber channel mail handler to construct URLs if the hostname or address is not specified in the mail command element. If the Use HTTP server parameter is set to False, the HTTP IP address or hostname can be used to specify the address or name of a Web server to use in constructing URLs for mail messages.

A.1.5 HTTP Port

This parameter is an integer value indicating which TCP port the Publisher channel Web server should listen on for incoming requests. If this value is not specified, the port number defaults to 80 or 443, depending on whether or not SSL is being used for the Web server connections.

If the Manual Task Service driver is running on the Identity Manager server (that is, it is not being run under the Remote Loader on a remote machine) then the HTTP port should be set to something other than 80 or 443. This is because iMonitor or another process typically uses ports 80 and 443.

A.1.6 Name of KMO

If it is not blank, this parameter is the name of an eDirectory Key Material Object that contains the server certificate and key used for SSL by the Publisher channel Web server.

Setting this parameter causes the Publisher channel Web server to use SSL for servicing HTTP requests.

This parameter takes precedence over any Java keystore parameters (see Name of Keystore File.)

Using SSL is recommended for security reasons because eDirectory passwords are passed in HTTP POST data when using the Publisher channel Web server.

A.1.7 Name of Keystore File

This parameter, together with the Keystore password, Name of certificate (key alias), and Certificate password (key password), is used to specify a Java keystore file that contains a certificate and key used for SSL by the Publisher channel Web server.

Setting this parameter causes the Publisher channel Web server to use SSL for servicing HTTP requests.

If the Name of KMO parameter is set, this parameter and its associated parameters are ignored.

Using SSL is recommended for security reasons because eDirectory passwords are passed in HTTP POST data when using the Publisher channel Web server.

A.1.8 Keystore Password

This parameter specifies the password for the Java keystore file specified with the Name of keystore file parameter.

A.1.9 Name of Certificate (key alias)

This parameter specifies the name of the certificate to use in the Java keystore file specified with the Name of keystore file parameter.

A.1.10 Certificate Password (key password)

This parameter specifies the password for the certificate specified using the Name of certificate (key alias) parameter.