Using the HTTP Gateway


The HTTP gateway enables access to documents on CGI compliant web servers. Using this gateway, documents managed by web servers can be indexed, searched, and viewed.

Features

The HTTP gateway has these features:

Security

The HTTP gateway accesses all repositories by default in this release. The administrator can limit which repositories, secure directories, and URLs to be accessed by editing the default HTTP gateway configuration file, vgwhttp.cfg.

Style Directory

The default style directory contains the style files for the HTTP gateway. The default style directory is located here:

verity/prdname/k2/common/vdkstyle/

where verity/prdname is the user-definable portion of the installation directory.

It is recommended that you backup the sample directory to another location before making changes.

Configuration File-Syntax

The gateway configuration file, called vgwhttp.cfg in the HTTP gateway style directory must be present for proper functioning of the gateway. The sample vgwhttp.cfg file in common/vdkstyle contains this syntax:


$control:1
## Repository settings. Zero or multiple repository entries
## can be listed.
# repository: name
# {
# /securityModuleId = 0x0 or 0xdff4
# /url = http://.*
# }
## Proxy settings (optional)
# proxy: hostname portnum
# {
# proxyAuth: login passwd (optional)
# noproxy: (optional)
# {
# server: string hostname/addr (one or more "server" lines)
# }
# }
$$
Element
Description
repository
The repository name for a single, logical repository to be associated with a security module. The repository name can be arbitrary. Multiple repository keywords can be used to define multiple repositories.
/securityModuleID
The security module ID to be used. Valid values are:
0xdff4 for secure access;
0x0 for non-secure access.

/url
The location of the documents to be accessed. The /url entry accepts regular expression style syntax. Multiple /url entries may be supplied for a single repository name. The sample vgwhttp.cfg file enables Verity indexers to access all repositories, without limit.
Proxy Settings
Proxy setting may be supplied for proxy server authentication.

Configuration File-Sample

A sample HTTP gateway configuration file is shown below. This configuration file defines three separate repositories. Each repository is defined for a secure directory.


$control:1
repository: A
{
/securityModuleId = 0x0
/url = http://www.verity.org/dirA/*
}
repository: B
{
/securityModuleId = 0x0
/url = http://www.verity.org/dirB/*
}
repository: C
{
/securityModuleId = 0x0
/url = http://www.verity.org/dirC/*
}
$$
Using the above vgwhttp.cfg file, the Verity prompts the user for credentials for each repository, as defined.





Copyright © 2002, Verity, Inc. All rights reserved.