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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

[failover-add-attributes]<br />

attribute_pattern<br />

=<br />

add<br />

The<br />

attribute_pattern<br />

can<br />

be<br />

either<br />

a<br />

specific<br />

attribute<br />

name,<br />

or<br />

a<br />

case-insensitive<br />

wildcard<br />

expression<br />

that<br />

matches<br />

more<br />

than<br />

one<br />

attribute<br />

name.<br />

For<br />

example,<br />

to<br />

specify<br />

all<br />

attributes<br />

with<br />

the<br />

prefix<br />

tagvalue_,<br />

add<br />

the<br />

following<br />

entry:<br />

[failover-add-attributes]<br />

tagvalue_*<br />

=<br />

add<br />

The<br />

order<br />

of<br />

the<br />

stanza<br />

entries<br />

is<br />

important.<br />

Rules<br />

that<br />

appear<br />

earlier<br />

in<br />

[failover-add-attributes]<br />

take<br />

priority<br />

over<br />

those<br />

placed<br />

later<br />

in<br />

the<br />

stanza.<br />

Attributes<br />

that<br />

do<br />

not<br />

match<br />

any<br />

of<br />

the<br />

wildcard<br />

patterns,<br />

or<br />

are<br />

not<br />

explicitly<br />

specified,<br />

are<br />

not<br />

added<br />

to<br />

the<br />

failover<br />

cookie.<br />

Specify<br />

the<br />

authentication<br />

level<br />

attribute<br />

after<br />

failover<br />

authentication<br />

When<br />

a<br />

failover<br />

cookie<br />

is<br />

used<br />

to<br />

authenticate,<br />

an<br />

authentication<br />

level<br />

can<br />

be<br />

associated<br />

with<br />

the<br />

generated<br />

credential.<br />

This<br />

can<br />

be<br />

done<br />

in<br />

the<br />

following<br />

ways:<br />

v<br />

Using<br />

a<br />

flag<br />

to<br />

the<br />

failover-*<br />

authentication<br />

mechanism.<br />

You<br />

can<br />

set<br />

the<br />

authentication<br />

level<br />

based<br />

on<br />

the<br />

last<br />

authentication<br />

method<br />

used.<br />

This<br />

is<br />

done<br />

by<br />

passing<br />

a<br />

flag<br />

to<br />

the<br />

authentication<br />

method.<br />

The<br />

syntax<br />

is:<br />

[authentication-mechanisms]<br />

failover-method_name<br />

=<br />

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

-i<br />

authentication_level<br />

For<br />

example:<br />

failover-password<br />

=<br />

/opt/pdweb/liblibfailoverauth.so&<br />

-i<br />

1<br />

failover-token<br />

=<br />

/opt/pdweb/liblibfailoverauth.so&<br />

-i<br />

2<br />

failover-certificate<br />

=<br />

/opt/pdweb/liblibfailoverauth.so&<br />

-i<br />

3<br />

Note:<br />

This<br />

method<br />

can<br />

be<br />

used<br />

only<br />

with<br />

the<br />

built-in<br />

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

failover<br />

authentication<br />

library.<br />

This<br />

method<br />

is<br />

not<br />

available<br />

to<br />

custom<br />

authentication<br />

modules.<br />

v<br />

Setting<br />

it<br />

in<br />

the<br />

[failover-restore-attributes]<br />

configuration<br />

file<br />

stanza<br />

entry.<br />

This<br />

attribute<br />

can<br />

specify<br />

whether<br />

to<br />

use<br />

the<br />

authentication<br />

level<br />

from<br />

the<br />

failover<br />

cookie,<br />

if<br />

it<br />

exists:<br />

[failover-restore-attributes]<br />

AUTHENTICATION_LEVEL<br />

=preserve<br />

Specify<br />

attributes<br />

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

extraction<br />

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

can<br />

optionally<br />

be<br />

configured<br />

to<br />

extract<br />

attributes<br />

from<br />

a<br />

failover<br />

authentication<br />

cookie<br />

and<br />

place<br />

them<br />

into<br />

a<br />

user<br />

credential.<br />

No<br />

attributes<br />

are<br />

configured<br />

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

extraction<br />

by<br />

default.<br />

Attributes<br />

to<br />

be<br />

extracted<br />

are<br />

declared<br />

in<br />

the<br />

[failover-restore-attributes]<br />

stanza<br />

in<br />

the<br />

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

configuration<br />

file.<br />

The<br />

syntax<br />

is:<br />

[failover-restore-attributes]<br />

attribute_pattern<br />

=<br />

{preserve|refresh}<br />

The<br />

value<br />

preserve<br />

tells<br />

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

to<br />

extract<br />

the<br />

attribute<br />

and<br />

add<br />

it<br />

to<br />

the<br />

credential.<br />

The<br />

value<br />

refresh<br />

tells<br />

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

to<br />

ignore<br />

the<br />

attribute,<br />

and<br />

not<br />

extract<br />

it<br />

from<br />

the<br />

cookie.<br />

178<br />

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

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

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

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

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

e-<strong>business</strong>:<br />

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

<strong>Administration</strong><br />

Guide

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

Saved successfully!

Ooh no, something went wrong!