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.

credattrs_email<br />

joeuser@bigco.com<br />

credattrs_<strong>business</strong>category<br />

finance<br />

Note<br />

that<br />

the<br />

service,<br />

source,<br />

and<br />

attributes<br />

can<br />

be<br />

multi-valued.<br />

If<br />

you<br />

specify<br />

the<br />

same<br />

attribute<br />

name<br />

as<br />

a<br />

stanza<br />

entry<br />

keyword,<br />

then<br />

the<br />

attributes<br />

retrieved<br />

will<br />

be<br />

added<br />

as<br />

a<br />

multi-valued<br />

attribute<br />

even<br />

when<br />

they<br />

come<br />

from<br />

different<br />

sources.<br />

For<br />

example,<br />

more<br />

than<br />

one<br />

entitlement<br />

service<br />

can<br />

be<br />

chained<br />

together.<br />

This<br />

enables<br />

values<br />

retrieved<br />

from<br />

one<br />

service.<br />

to<br />

be<br />

used<br />

as<br />

input<br />

values<br />

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

another<br />

service.<br />

Likewise,<br />

attributes<br />

can<br />

be<br />

retrieved<br />

from<br />

more<br />

than<br />

one<br />

DN<br />

in<br />

the<br />

user<br />

registry.<br />

Thus,<br />

using<br />

the<br />

example<br />

above,<br />

you<br />

could<br />

add<br />

values<br />

from<br />

multiple<br />

users<br />

(DNs)<br />

to<br />

one<br />

credattrs_<strong>business</strong>category<br />

attribute,<br />

if<br />

you<br />

wanted<br />

a<br />

list<br />

of<br />

all<br />

the<br />

<strong>business</strong>category<br />

entries<br />

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

a<br />

group<br />

of<br />

users.<br />

For<br />

example,<br />

if<br />

you<br />

want<br />

to<br />

build<br />

an<br />

attribute<br />

called<br />

myemployeeinfo<br />

to<br />

add<br />

to<br />

the<br />

credential,<br />

and<br />

you<br />

want<br />

this<br />

attribute<br />

to<br />

contain<br />

the<br />

last<br />

name<br />

and<br />

employee<br />

type<br />

of<br />

everyone<br />

that<br />

authenticates,<br />

you<br />

could<br />

then<br />

define<br />

the<br />

following:<br />

[myID]<br />

source<br />

=<br />

azn_cred_authzn_id<br />

[myID:source]<br />

myemployeeinfo<br />

=<br />

lastname<br />

myemployeeinfo<br />

=<br />

employeetype<br />

Junction<br />

handling<br />

of<br />

extended<br />

credential<br />

attributes<br />

The<br />

user-defined<br />

credential<br />

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

created<br />

in<br />

the<br />

previous<br />

section<br />

can<br />

be<br />

placed<br />

in<br />

an<br />

HTTP<br />

header<br />

of<br />

the<br />

request<br />

that<br />

is<br />

sent<br />

across<br />

a<br />

junction<br />

to<br />

a<br />

back-end<br />

server.<br />

You<br />

must<br />

configure<br />

the<br />

junction<br />

to<br />

extract<br />

extended<br />

attribute<br />

data<br />

from<br />

the<br />

credential<br />

and<br />

insert<br />

the<br />

data<br />

into<br />

the<br />

HTTP<br />

header<br />

of<br />

the<br />

request.<br />

This<br />

functionality<br />

is<br />

achieved<br />

by<br />

setting<br />

a<br />

junction<br />

extended<br />

attribute,<br />

called<br />

HTTP-Tag-Value,<br />

on<br />

the<br />

junction<br />

object<br />

in<br />

the<br />

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

protected<br />

object<br />

space.<br />

You<br />

use<br />

the<br />

pdadmin<br />

object<br />

modify<br />

set<br />

attribute<br />

command<br />

to<br />

set<br />

extended<br />

attributes<br />

on<br />

a<br />

junction<br />

object<br />

in<br />

the<br />

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

protected<br />

object<br />

space.<br />

pdadmin><br />

object<br />

modify<br />

object_name<br />

set<br />

attribute<br />

attr_name<br />

attr_value<br />

The<br />

above<br />

command<br />

must<br />

be<br />

entered<br />

as<br />

one<br />

continuous<br />

command<br />

line.<br />

An<br />

extended<br />

attribute<br />

(attr_name)<br />

enables<br />

the<br />

junction<br />

to<br />

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

a<br />

specific<br />

type<br />

of<br />

functionality.<br />

The<br />

HTTP-Tag-Value<br />

extended<br />

attribute<br />

instructs<br />

the<br />

junction<br />

to<br />

extract<br />

a<br />

particular<br />

value<br />

from<br />

a<br />

user’s<br />

credential<br />

and<br />

send<br />

the<br />

value<br />

to<br />

the<br />

back-end<br />

server<br />

in<br />

an<br />

HTTP<br />

header.<br />

The<br />

value<br />

of<br />

the<br />

HTTP-Tag-Value<br />

extended<br />

attribute<br />

uses<br />

the<br />

following<br />

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

credential_extended_attribute_name<br />

=<br />

http_header_name<br />

The<br />

credential_extended_attribute_name<br />

entry<br />

is<br />

the<br />

same<br />

as<br />

the<br />

attributed<br />

specified<br />

in<br />

the<br />

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

configuration<br />

file<br />

but<br />

without<br />

the<br />

″tagvalue_″<br />

prefix.<br />

The<br />

entry<br />

is<br />

not<br />

case-sensitive.<br />

The<br />

http_header_name<br />

entry<br />

specifies<br />

the<br />

name<br />

of<br />

the<br />

HTTP<br />

header<br />

used<br />

to<br />

deliver<br />

the<br />

data<br />

across<br />

the<br />

junction.<br />

For<br />

example:<br />

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