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.

The<br />

default<br />

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

configuration<br />

file<br />

entry<br />

is:<br />

[acnt-mgt]<br />

certificate-login<br />

=<br />

certlogin.html<br />

Specify<br />

the<br />

certificate<br />

login<br />

error<br />

page<br />

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

provides<br />

a<br />

default<br />

HTML<br />

page<br />

containing<br />

an<br />

error<br />

message<br />

that<br />

is<br />

displayed<br />

when<br />

a<br />

user<br />

fails<br />

to<br />

successfully<br />

authenticate<br />

using<br />

client-side<br />

certificate<br />

authentication.<br />

Administrators<br />

can<br />

choose<br />

to<br />

either<br />

use<br />

the<br />

default<br />

error<br />

page,<br />

customize<br />

the<br />

error<br />

message,<br />

or<br />

specify<br />

an<br />

entirely<br />

different<br />

customized<br />

error<br />

page.<br />

Typically,<br />

administrators<br />

use<br />

the<br />

default<br />

page<br />

but<br />

might<br />

customize<br />

the<br />

contents<br />

of<br />

the<br />

error<br />

message.<br />

Administrators<br />

who<br />

choose<br />

to<br />

create<br />

a<br />

new<br />

HTML<br />

error<br />

page<br />

must<br />

edit<br />

the<br />

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

configuration<br />

file<br />

to<br />

indicate<br />

the<br />

location<br />

of<br />

the<br />

new<br />

page.<br />

The<br />

default<br />

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

configuration<br />

file<br />

entry<br />

is:<br />

[acnt-mgt]<br />

cert-failure<br />

=<br />

certfailure.html<br />

Disable<br />

SSL<br />

session<br />

IDs<br />

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

session<br />

tracking<br />

This<br />

configuration<br />

step<br />

applies<br />

only<br />

when<br />

delayed<br />

certificate<br />

authentication<br />

has<br />

been<br />

enabled.<br />

Disable<br />

the<br />

use<br />

of<br />

SSL<br />

session<br />

IDs<br />

to<br />

track<br />

session<br />

state.<br />

Set<br />

the<br />

following<br />

stanza<br />

entry<br />

in<br />

the<br />

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

configuration<br />

file:<br />

[ssl]<br />

ssl-id-sessions<br />

=<br />

no<br />

Note:<br />

In<br />

this<br />

case,<br />

SSL<br />

IDs<br />

cannot<br />

be<br />

used<br />

to<br />

maintain<br />

user<br />

sessions<br />

because<br />

when<br />

the<br />

user<br />

is<br />

prompted<br />

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

a<br />

certificate,<br />

the<br />

user’s<br />

SSL<br />

ID<br />

will<br />

change.<br />

If<br />

ssl-id-sessions<br />

is<br />

set<br />

to<br />

yes,<br />

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

generates<br />

an<br />

error<br />

message<br />

upon<br />

startup<br />

and<br />

shuts<br />

down.<br />

Enable<br />

and<br />

configure<br />

the<br />

Certificate<br />

SSL<br />

ID<br />

cache<br />

This<br />

configuration<br />

step<br />

applies<br />

only<br />

when<br />

delayed<br />

certificate<br />

authentication<br />

has<br />

been<br />

enabled.<br />

To<br />

configure<br />

the<br />

cache,<br />

complete<br />

the<br />

following<br />

steps:<br />

1.<br />

Verify<br />

that<br />

certificate<br />

authentication<br />

is<br />

enabled.<br />

See<br />

“Enable<br />

certificate<br />

authentication”<br />

on<br />

page<br />

151<br />

2.<br />

Specify<br />

the<br />

maximum<br />

number<br />

of<br />

entries<br />

allowed<br />

in<br />

the<br />

cache.<br />

Edit<br />

the<br />

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

configuration<br />

file.<br />

In<br />

the<br />

[certificate]<br />

stanza,<br />

assign<br />

a<br />

value<br />

to<br />

cert-cache-max-entries:<br />

[certificate]<br />

cert-cache-max-entries<br />

=<br />

1024<br />

The<br />

value<br />

corresponds<br />

to<br />

the<br />

maximum<br />

number<br />

of<br />

concurrent<br />

certificate<br />

authentications.<br />

The<br />

default<br />

value<br />

is<br />

one<br />

quarter<br />

of<br />

the<br />

default<br />

number<br />

of<br />

entries<br />

in<br />

the<br />

SSL<br />

ID<br />

cache.<br />

(Most<br />

SSL<br />

sessions<br />

do<br />

not<br />

require<br />

certificate<br />

logins<br />

or<br />

will<br />

only<br />

require<br />

certificate<br />

authentication<br />

once<br />

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

the<br />

session).<br />

The<br />

number<br />

of<br />

entries<br />

in<br />

the<br />

SSL<br />

ID<br />

cache<br />

is<br />

set<br />

in<br />

the<br />

[ssl]<br />

stanza:<br />

[ssl]<br />

ssl-max-entries<br />

=<br />

4096<br />

Chapter<br />

6.<br />

Authentication<br />

153

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

Saved successfully!

Ooh no, something went wrong!