10.02.2013 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Appendix<br />

A.<br />

<strong>WebSEAL</strong><br />

configuration<br />

file<br />

reference<br />

The<br />

operation<br />

of<br />

the<br />

<strong>WebSEAL</strong><br />

server<br />

is<br />

controlled<br />

through<br />

the<br />

use<br />

of<br />

the<br />

<strong>WebSEAL</strong><br />

configuration<br />

file.<br />

The<br />

file<br />

contains<br />

sections<br />

that<br />

control<br />

specific<br />

portions<br />

of<br />

<strong>WebSEAL</strong><br />

functionality.<br />

Each<br />

section<br />

contains<br />

further<br />

divisions<br />

called<br />

stanzas.<br />

Stanza<br />

labels<br />

appear<br />

within<br />

brackets,<br />

such<br />

as:<br />

[stanza_name].<br />

For<br />

example,<br />

the<br />

[ssl]<br />

stanza<br />

defines<br />

the<br />

SSL<br />

configuration<br />

settings<br />

<strong>for</strong><br />

use<br />

by<br />

the<br />

<strong>WebSEAL</strong><br />

server.<br />

Each<br />

stanza<br />

in<br />

a<br />

<strong>Tivoli</strong><br />

<strong>Access</strong><br />

<strong>Manager</strong><br />

configuration<br />

file<br />

contains<br />

one<br />

or<br />

more<br />

stanza<br />

entries.<br />

A<br />

stanza<br />

entry<br />

consists<br />

of<br />

a<br />

key<br />

value<br />

pair,<br />

which<br />

contain<br />

in<strong>for</strong>mation<br />

that<br />

is<br />

expressed<br />

as<br />

a<br />

paired<br />

set<br />

of<br />

parameters.<br />

Each<br />

stanza<br />

entry<br />

has<br />

the<br />

following<br />

<strong>for</strong>mat:<br />

key<br />

=<br />

value<br />

The<br />

initial<br />

installation<br />

of<br />

<strong>WebSEAL</strong><br />

establishes<br />

many<br />

of<br />

the<br />

default<br />

values.<br />

Some<br />

values<br />

are<br />

static<br />

and<br />

will<br />

never<br />

change;<br />

other<br />

values<br />

can<br />

be<br />

modified<br />

to<br />

customize<br />

server<br />

functionality<br />

and<br />

per<strong>for</strong>mance.<br />

Configuration<br />

file<br />

name<br />

and<br />

location<br />

A<br />

unique<br />

<strong>WebSEAL</strong><br />

configuration<br />

file<br />

is<br />

created<br />

<strong>for</strong><br />

each<br />

<strong>WebSEAL</strong><br />

server<br />

instance.<br />

The<br />

name<br />

of<br />

the<br />

configuration<br />

file<br />

includes<br />

the<br />

instance<br />

name.<br />

The<br />

<strong>for</strong>mat<br />

is:<br />

/opt/pdweb/etc/webseald-instance_name.conf<br />

The<br />

first<br />

<strong>WebSEAL</strong><br />

server<br />

instance<br />

installed<br />

on<br />

a<br />

computer<br />

has<br />

an<br />

instance_name<br />

of<br />

default.<br />

The<br />

administrator<br />

has<br />

the<br />

option<br />

of<br />

changing<br />

this<br />

name<br />

during<br />

the<br />

server<br />

configuration.<br />

When<br />

the<br />

administrator<br />

accepts<br />

the<br />

default<br />

name,<br />

the<br />

configuration<br />

file<br />

is<br />

named<br />

as<br />

follows:<br />

UNIX<br />

/opt/pdweb/etc/webseald-default.conf<br />

Windows<br />

C:\Program<br />

Files\<strong>Tivoli</strong>\PDWeb\etc\webseald-default.conf<br />

When<br />

additional<br />

<strong>WebSEAL</strong><br />

server<br />

instances<br />

are<br />

configured,<br />

the<br />

administrator<br />

specifies<br />

the<br />

instance_name.<br />

This<br />

method<br />

<strong>for</strong><br />

specifying<br />

the<br />

name<br />

is<br />

dependent<br />

on<br />

the<br />

configuration<br />

utility<br />

method,<br />

either<br />

as<br />

a<br />

field<br />

entry<br />

in<br />

the<br />

pdconfig<br />

GUI<br />

or<br />

as<br />

a<br />

command<br />

line<br />

argument<br />

to<br />

amwebcfg<br />

v<br />

Interactive<br />

installation:<br />

As<br />

a<br />

GUI<br />

field<br />

entry<br />

in<br />

pdconfig.<br />

v<br />

Command<br />

line<br />

installation:<br />

As<br />

a<br />

command<br />

line<br />

option<br />

to<br />

amwebcfg<br />

v<br />

Silent<br />

installation:<br />

As<br />

an<br />

entry<br />

in<br />

a<br />

response<br />

file<br />

used<br />

by<br />

amwebcfg<br />

In<br />

all<br />

cases,<br />

the<br />

configuration<br />

utility<br />

uses<br />

the<br />

entered<br />

instance_name<br />

to<br />

name<br />

the<br />

new<br />

<strong>WebSEAL</strong><br />

configuration<br />

file.<br />

For<br />

example,<br />

if<br />

you<br />

name<br />

the<br />

new<br />

server<br />

instance<br />

webseal2,<br />

the<br />

following<br />

configuration<br />

file<br />

is<br />

created:<br />

UNIX<br />

/opt/pdweb/etc/webseald-webseal2.conf<br />

©<br />

Copyright<br />

<strong>IBM</strong><br />

Corp.<br />

1999,<br />

2003<br />

377

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!