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.

This<br />

ID<br />

(required)<br />

refers<br />

to<br />

the<br />

unique<br />

protocol<br />

ID<br />

of<br />

one<br />

of<br />

the<br />

attribute<br />

retrieval<br />

service<br />

protocols.<br />

The<br />

protocol<br />

given<br />

with<br />

this<br />

ID<br />

is<br />

used<br />

to<br />

retrieve<br />

the<br />

container<br />

from<br />

the<br />

provider.<br />

This<br />

element<br />

has<br />

to<br />

match<br />

an<br />

ID<br />

known<br />

to<br />

the<br />

service.<br />

provider_id<br />

This<br />

ID<br />

(required)<br />

refers<br />

to<br />

the<br />

attribute<br />

retrieval<br />

service<br />

provider<br />

which<br />

is<br />

capable<br />

of<br />

sending<br />

a<br />

container<br />

corresponding<br />

to<br />

the<br />

descriptor.<br />

The<br />

service<br />

connects<br />

to<br />

this<br />

provider<br />

when<br />

this<br />

container<br />

is<br />

requested.<br />

properties<br />

General<br />

client<br />

and<br />

protocol<br />

dependent<br />

properties.<br />

You<br />

add<br />

a<br />

property<br />

setting<br />

the<br />

following<br />

way:<br />

Add<br />

an<br />

element<br />

called<br />

property<br />

with<br />

an<br />

attribute<br />

named<br />

key.<br />

The<br />

attribute<br />

contains<br />

the<br />

name<br />

or<br />

key<br />

of<br />

the<br />

property,<br />

the<br />

content<br />

of<br />

the<br />

element,<br />

and<br />

the<br />

corresponding<br />

value.<br />

Consider<br />

the<br />

client_init_properties<br />

in<br />

the<br />

example<br />

code<br />

below.<br />

client_init_properties<br />

Properties<br />

specific<br />

to<br />

the<br />

initialization<br />

of<br />

the<br />

attribute<br />

retrieval<br />

service<br />

clients.<br />

One<br />

property<br />

used<br />

by<br />

different<br />

protocols<br />

is<br />

the<br />

attribute<br />

mapping<br />

described<br />

below.<br />

ContainerPayloadFormat<br />

This<br />

element<br />

(required)<br />

describes<br />

the<br />

structure<br />

and<br />

contents<br />

of<br />

the<br />

containers<br />

corresponding<br />

to<br />

this<br />

descriptor.<br />

The<br />

content<br />

of<br />

this<br />

element<br />

is<br />

protocol<br />

dependent.<br />

The<br />

DynAdiProtocols<br />

currently<br />

available<br />

provides<br />

a<br />

list<br />

of<br />

elements<br />

named<br />

with<br />

the<br />

attribute<br />

names<br />

to<br />

be<br />

retrieved<br />

from<br />

the<br />

provider<br />

in<br />

this<br />

element.<br />

The<br />

containers<br />

are<br />

wrapped<br />

by<br />

a<br />

element<br />

named<br />

with<br />

the<br />

container_name.<br />

Attribute<br />

mapping<br />

Attribute<br />

mapping<br />

might<br />

be<br />

necessary,<br />

if<br />

the<br />

attribute<br />

retrieval<br />

service<br />

provider<br />

uses<br />

attribute<br />

names<br />

not<br />

compatible<br />

with<br />

XML<br />

element<br />

names.<br />

Such<br />

a<br />

mapping<br />

is<br />

generated<br />

the<br />

following<br />

way:<br />

The<br />

key<br />

has<br />

the<br />

structure:<br />

"map_provider_attribute_name__"<br />

+<br />

source__provider_attribute_name<br />

if<br />

you<br />

map<br />

one<br />

of<br />

the<br />

provider’s<br />

attribute<br />

names<br />

to<br />

one<br />

of<br />

your<br />

own,<br />

or<br />

"map_attribute_name__"<br />

+<br />

source_attribute_name<br />

if<br />

you<br />

do<br />

a<br />

reverse<br />

mapping.<br />

The<br />

value<br />

of<br />

such<br />

a<br />

property<br />

contains<br />

the<br />

attribute<br />

name<br />

to<br />

map<br />

to.<br />

Please<br />

note<br />

the<br />

such<br />

an<br />

declaration<br />

is<br />

only<br />

one-way.<br />

You<br />

must<br />

add<br />

a<br />

second<br />

one<br />

to<br />

generate<br />

a<br />

reverse-mapping.<br />

Example<br />

ContainerDescriptorTable<br />

Example<br />

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

a<br />

ContainerDescriptorTable<br />

with<br />

only<br />

one<br />

descriptor:<br />

<br />

<br />

<br />

<br />

http://ese.erandt.com/attributes:ese__test_container_address_line<br />

<br />

ese__test_container_address_line<br />

Chapter<br />

14.<br />

Attribute<br />

retrieval<br />

service<br />

reference<br />

373

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

Saved successfully!

Ooh no, something went wrong!