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.

xauthn_username<br />

xauthn_qop<br />

xauthn_ipaddr<br />

xauthn_browser_info<br />

The<br />

xauthn_browser_info,<br />

xauthn_qop,<br />

and<br />

xauthn_ipaddr<br />

identity<br />

components<br />

represent<br />

those<br />

of<br />

the<br />

administrator,<br />

not<br />

the<br />

″switched<br />

to″<br />

user.<br />

This<br />

data<br />

is<br />

supplied<br />

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

any<br />

authentication<br />

module<br />

that<br />

must<br />

per<strong>for</strong>m<br />

additional<br />

validations<br />

of<br />

the<br />

administrator’s<br />

account.<br />

Note:<br />

Refer<br />

to<br />

the<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 />

Web<br />

Security<br />

Developer<br />

Reference<br />

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

more<br />

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

on<br />

writing<br />

a<br />

custom<br />

authentication<br />

module.<br />

Configuring<br />

a<br />

custom<br />

authentication<br />

module<br />

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

switch<br />

user<br />

The<br />

following<br />

example<br />

expands<br />

on<br />

the<br />

example<br />

presented<br />

in<br />

“Part<br />

2:<br />

Configuring<br />

switch<br />

user<br />

authentication<br />

mechanisms”<br />

on<br />

page<br />

191.<br />

The<br />

example<br />

adds<br />

a<br />

custom<br />

authentication<br />

module<br />

to<br />

list<br />

of<br />

enabled<br />

authentication<br />

mechanisms.<br />

The<br />

example,<br />

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

a<br />

Solaris<br />

plat<strong>for</strong>m,<br />

shows<br />

an<br />

existing<br />

environment<br />

that<br />

has<br />

three<br />

authentication<br />

methods<br />

enabled:<br />

v<br />

Forms<br />

authentication<br />

using<br />

the<br />

built-in<br />

libldapauthn<br />

library<br />

v<br />

Certificates<br />

authentication<br />

using<br />

the<br />

built-in<br />

libsslauthn<br />

library<br />

v<br />

Token<br />

authentication<br />

using<br />

a<br />

custom<br />

authentication<br />

module<br />

In<br />

this<br />

example,<br />

the<br />

administrator<br />

wants<br />

to<br />

be<br />

able<br />

to<br />

use<br />

switch<br />

user<br />

authentication<br />

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

all<br />

three<br />

authentication<br />

methods.<br />

Thus,<br />

three<br />

additional<br />

authentication<br />

parameters<br />

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

switch<br />

user<br />

must<br />

be<br />

enabled<br />

in<br />

the<br />

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

configuration<br />

file.<br />

The<br />

third<br />

parameter<br />

represents<br />

the<br />

new<br />

custom<br />

authentication<br />

module<br />

library<br />

that<br />

was<br />

written<br />

to<br />

emulate<br />

the<br />

existing<br />

token<br />

authentication<br />

and<br />

support<br />

the<br />

requirements<br />

of<br />

switch<br />

user<br />

authentication:<br />

The<br />

configuration<br />

file<br />

entries<br />

be<strong>for</strong>e<br />

enabling<br />

switch<br />

user<br />

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

the<br />

three<br />

authentication<br />

mechanism<br />

are:<br />

[authentication-mechanisms]<br />

passwd-ldap<br />

=<br />

/opt/PolicyDirector/lib/libldapauthn.so<br />

cert-ssl<br />

=<br />

/opt/PolicyDirector/lib/libsslauthn.so<br />

token-cdas<br />

=<br />

/opt/PolicyDirector/lib/libcustom.so<br />

Note<br />

that<br />

the<br />

example<br />

token<br />

custom<br />

authentication<br />

library<br />

is<br />

called<br />

libcustom.so.<br />

The<br />

new<br />

switch<br />

user<br />

version<br />

of<br />

this<br />

token<br />

custom<br />

authentication<br />

library<br />

will<br />

be<br />

called<br />

libsucustom.so<br />

After<br />

adding<br />

the<br />

switch<br />

user<br />

authentication<br />

mechanism,<br />

the<br />

configuration<br />

file<br />

entries<br />

are:<br />

[authentication-mechanisms]<br />

passwd-ldap<br />

=<br />

/opt/PolicyDirector/lib/libldapauthn.so<br />

cert-ssl<br />

=<br />

/opt/PolicyDirector/lib/libsslauthn.so<br />

token-cdas<br />

=<br />

/opt/PolicyDirector/lib/libcustom.so<br />

su-password<br />

=<br />

/opt/PolicyDirector/lib/libsu<strong>for</strong>mauthn.so<br />

su-certificate<br />

=<br />

/opt/PolicyDirector/lib/libsucert.so<br />

su-token-card<br />

=<br />

/opt/PolicyDirector/lib/libsucustom.so<br />

Notice<br />

the<br />

following<br />

changes:<br />

v<br />

The<br />

new<br />

entry<br />

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

the<br />

authentication<br />

module<br />

has<br />

the<br />

name<br />

su-token-card.<br />

The<br />

value<br />

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

this<br />

entry<br />

is<br />

the<br />

full<br />

path<br />

name<br />

to<br />

the<br />

shared<br />

library<br />

that<br />

has<br />

been<br />

extended<br />

to<br />

support<br />

switch<br />

user.<br />

v<br />

For<br />

the<br />

non-custom<br />

authentication<br />

methods<br />

in<br />

this<br />

example,<br />

remember<br />

that:<br />

198<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!