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.

1.<br />

Enabling<br />

and<br />

disabling<br />

CDSSO<br />

authentication<br />

To<br />

enable<br />

CDSSO<br />

authentication,<br />

specify<br />

values<br />

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

two<br />

settings<br />

in<br />

the<br />

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

configuration<br />

file.<br />

There<br />

is<br />

a<br />

setting<br />

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

the<br />

token<br />

create<br />

(sso-create)<br />

library<br />

and<br />

a<br />

separate<br />

setting<br />

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

the<br />

token<br />

consume<br />

(sso-consume)<br />

library.<br />

To<br />

enable<br />

the<br />

token<br />

create<br />

library,<br />

set<br />

the<br />

following<br />

entry:<br />

[cdsso]<br />

cdsso-create<br />

=<br />

{none|http|https|both}<br />

The<br />

value<br />

both<br />

specifies<br />

both<br />

HTTP<br />

and<br />

HTTPS<br />

protocols.<br />

The<br />

value<br />

none<br />

disables<br />

the<br />

token<br />

create<br />

library.<br />

To<br />

enable<br />

the<br />

token<br />

consume<br />

library,<br />

(this<br />

means<br />

that<br />

the<br />

server<br />

will<br />

accept<br />

CDSSO<br />

tokens<br />

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

authentication)<br />

set<br />

the<br />

following<br />

entry:<br />

[cdsso]<br />

cdsso-auth<br />

=<br />

{none|http|https|both}<br />

The<br />

value<br />

both<br />

specifies<br />

both<br />

HTTP<br />

and<br />

HTTPS<br />

protocols.<br />

The<br />

value<br />

none<br />

disables<br />

the<br />

token<br />

consume<br />

library.<br />

Note:<br />

You<br />

must<br />

stop<br />

and<br />

restart<br />

the<br />

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

server<br />

in<br />

order<br />

to<br />

activate<br />

changes<br />

to<br />

the<br />

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

configuration<br />

file.<br />

Complete<br />

all<br />

of<br />

the<br />

applicable<br />

configuration<br />

steps<br />

in<br />

this<br />

section<br />

and<br />

then<br />

restart<br />

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

2.<br />

Configuring<br />

the<br />

single<br />

sign-on<br />

authentication<br />

mechanism<br />

The<br />

default<br />

CDSSO<br />

configuration<br />

requires<br />

that<br />

you<br />

enable<br />

the<br />

sso-create<br />

and<br />

sso-consume<br />

single<br />

sign-on<br />

authentication<br />

mechanisms.<br />

The<br />

sso-create<br />

mechanism<br />

is<br />

required<br />

by<br />

the<br />

initial<br />

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

server<br />

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

creating<br />

the<br />

CDSSO<br />

token<br />

and<br />

building<br />

the<br />

redirected<br />

request.<br />

The<br />

sso-consume<br />

mechanism<br />

is<br />

required<br />

by<br />

the<br />

receiving<br />

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

server<br />

to<br />

decode<br />

the<br />

token<br />

and<br />

build<br />

the<br />

user<br />

credentials<br />

from<br />

the<br />

identity<br />

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

contained<br />

in<br />

the<br />

token.<br />

For<br />

the<br />

default<br />

CDSSO<br />

configuration,<br />

each<br />

parameter<br />

specifies<br />

a<br />

built-in<br />

CDSSO<br />

token<br />

library<br />

file.<br />

One<br />

library<br />

contains<br />

the<br />

code<br />

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

the<br />

token<br />

create<br />

functionality<br />

and<br />

the<br />

other<br />

library<br />

contains<br />

the<br />

code<br />

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

the<br />

token<br />

consume<br />

functionality.<br />

v<br />

On<br />

UNIX,<br />

the<br />

library<br />

files<br />

are<br />

called<br />

libssocreate.<br />

{so<br />

|<br />

a<br />

|<br />

sl}<br />

and<br />

libssoconsume.<br />

{so<br />

|<br />

a<br />

|<br />

sl}.<br />

v<br />

On<br />

Windows,<br />

the<br />

library<br />

files<br />

are<br />

DLL<br />

files<br />

called<br />

ssocreate.dll<br />

and<br />

ssoconsume.dll.<br />

Authentication<br />

Mechanism<br />

Single<br />

Sign-on<br />

Token<br />

Library<br />

Solaris<br />

AIX<br />

Windows<br />

HP-UX<br />

sso-create<br />

libssocreate.so<br />

libssocreate.a<br />

ssocreate.dll<br />

libssocreate.sl<br />

sso-consume<br />

libssoconsume.so<br />

libssoconsume.a<br />

ssoconsume.dll<br />

libssoconsume.sl<br />

You<br />

can<br />

configure<br />

the<br />

CDSSO<br />

authentication<br />

mechanism<br />

by<br />

specifying<br />

the<br />

sso-create<br />

and<br />

sso-consume<br />

parameters<br />

with<br />

the<br />

full<br />

path<br />

name<br />

of<br />

the<br />

appropriate<br />

plat<strong>for</strong>m-specific<br />

default<br />

library<br />

file<br />

in<br />

the<br />

[authentication-mechanism]<br />

stanza<br />

of<br />

the<br />

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

configuration<br />

file.<br />

For<br />

example:<br />

Solaris:<br />

Chapter<br />

9.<br />

Client<br />

single<br />

sign-on<br />

solutions<br />

249

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

Saved successfully!

Ooh no, something went wrong!