IBM Tivoli Access Manager for e-business: WebSEAL Administration ...

The
file
currently
contains
sample
entries
for
the
Microsoft
Internet
Information
Server
and
Netscape
FastTrack
servers.
The
lines
in
this
file
that
start
with
a
semi-colon
(;)
are
comments
and
are
ignored
by
the
query_contents
program.
6.
Create
a
junction
to
the
back-end
Windows
server
and
use
the
–q
option
to
specify
query_contents.exe
as
the
correct
file.
For
example:
pdadmin>
server
task
web1-webseald-cruz
create
-t
tcp
-h
host-name
...
\
-q
/cgi-bin/query_contents.exe
/junction-name
Testing
the
configuration
1.
From
an
MS-DOS
prompt
on
the
Win32
machine,
execute
the
query_contents
program
from
the
CGI
directory
as
follows:
MSDOS>
query_contents
dirlist=/
You
should
see
something
similar
to
the
following
output:
100
index.html
cgi-bin//
pics//
The
number
100
is
a
return
status
that
indicates
success.
It
is
most
important
to
see
at
least
the
number
100
as
the
first
(and
perhaps
only)
value.
If
you
see
an
error
code
instead,
then
the
configuration
file
is
not
in
the
correct
place,
or
does
not
contain
a
valid
document
root
entry.
Check
the
configuration
of
the
query_contents.cfg
file
and
make
sure
that
the
document
root
exists.
2.
From
a
browser,
enter
the
following
URL
http://win32-machine-name/cgi-bin/query_contents.exe?dirlist=/
This
should
return
the
same
result
as
the
preceding
step.
If
it
does
not
return
this
result,
the
CGI
configuration
of
your
Web
server
is
not
correct.
See
the
server’s
documentation
to
correct
the
problem.
Customizing
query_contents
The
job
of
query_contents
is
to
return
the
contents
of
directories
included
in
a
URL
request.
For
example,
to
get
the
contents
of
the
root
directory
of
a
server’s
Web
space,
the
browser
runs
query_contents
on
a
URL
such
as:
http://third-party-server/cgi-bin/query_contents?dirlist=/
The
query_contents
script
performs
the
following
actions:
1.
Reads
$SERVER_SOFTWARE,
a
standard
CGI
environment
variable,
to
determine
the
server
type.
Based
on
the
Web
server
type,
the
variable
$DOCROOTDIR
is
set
to
a
typical
document
root
location.
2.
Reads
the
environment
variable
$QUERY_STRING
from
the
requested
URL
to
obtain
the
requested
operation
and
get
the
object
path.
The
operation
value
is
stored
in
the
variable
$OPERATION,
and
the
object
path
in
$OBJPATH.
In
the
above
example,
the
$OPERATION
is
dirlist
and
$OBJPATH
is
″/″.
3.
Performs
a
directory
listing
(ls)
on
the
object
path
and
places
the
results
on
standard
output,
for
use
by
the
Tivoli
Access
Manager
server.
Entries
that
indicate
subdirectories
have
a
double
slash
(//)
appended
to
them.
Chapter
10.
WebSEAL
junctions
311