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.

processed<br />

at<br />

the<br />

root<br />

junction<br />

first.<br />

If<br />

they<br />

do<br />

not<br />

start<br />

with<br />

patterns<br />

specified<br />

in<br />

the<br />

[process-root-filter]<br />

stanza,<br />

they<br />

are<br />

remapped<br />

immediately.<br />

When<br />

process-root-requests<br />

=<br />

filter,<br />

you<br />

must<br />

specify<br />

the<br />

patterns<br />

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

which<br />

you<br />

want<br />

root<br />

junction<br />

requests<br />

processed<br />

at<br />

the<br />

root<br />

junction.<br />

Use<br />

the<br />

[process-local-filter<br />

stanza].<br />

The<br />

syntax<br />

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

specifying<br />

a<br />

pattern<br />

is:<br />

root<br />

=<br />

pattern<br />

Pattern<br />

must<br />

be<br />

a<br />

standard<br />

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

wildcard<br />

pattern.<br />

For<br />

example:<br />

[process-local-filter]<br />

root<br />

=<br />

/index.html<br />

root<br />

=<br />

/cgi-bin*<br />

For<br />

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

on<br />

junction<br />

mapping<br />

mechanisms,<br />

see<br />

the<br />

following<br />

sections:<br />

v<br />

“Handling<br />

server-relative<br />

URLs<br />

with<br />

junction<br />

cookies<br />

(-j)”<br />

on<br />

page<br />

292<br />

v<br />

“Handling<br />

server-relative<br />

URLs<br />

with<br />

junction<br />

mapping”<br />

on<br />

page<br />

293<br />

Handling<br />

cookies<br />

from<br />

servers<br />

across<br />

multiple<br />

-j<br />

junctions<br />

This<br />

section<br />

describes<br />

<strong>WebSEAL</strong>’s<br />

default<br />

handling<br />

of<br />

cookies<br />

generated<br />

by<br />

back-end<br />

applications<br />

and<br />

returned<br />

to<br />

clients<br />

across<br />

–j<br />

junctions.<br />

Part<br />

1:<br />

-j<br />

junctions<br />

modify<br />

Set-Cookie<br />

Path<br />

attributes<br />

In<br />

addition<br />

to<br />

providing<br />

a<br />

junction<br />

identifier<br />

cookie<br />

to<br />

the<br />

browser,<br />

a<br />

junction<br />

configured<br />

with<br />

the<br />

–j<br />

option<br />

also<br />

supports<br />

the<br />

handling<br />

of<br />

cookies<br />

sent<br />

with<br />

responses<br />

from<br />

the<br />

back-end<br />

application.<br />

Browser<br />

rule:<br />

If<br />

a<br />

Set-Cookie<br />

header<br />

in<br />

a<br />

response<br />

from<br />

the<br />

server<br />

contains<br />

a<br />

Path<br />

attribute<br />

(such<br />

as<br />

Path=/xyz),<br />

the<br />

browser<br />

returns<br />

the<br />

cookie<br />

only<br />

when<br />

a<br />

request<br />

URL<br />

(activated<br />

from<br />

the<br />

returned<br />

page)<br />

begins<br />

with<br />

this<br />

path<br />

(such<br />

as<br />

/xyz/memo.html).<br />

Problem:<br />

When<br />

the<br />

junction<br />

environment<br />

contains<br />

mixed<br />

solutions<br />

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

handling<br />

visible<br />

and<br />

embedded<br />

URLs<br />

in<br />

responses,<br />

the<br />

ability<br />

of<br />

the<br />

browser<br />

to<br />

return<br />

cookies<br />

is<br />

compromised.<br />

For<br />

example,<br />

standard<br />

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

filtering<br />

of<br />

visible<br />

server-relative<br />

URLs<br />

normally<br />

adds<br />

the<br />

junction<br />

name<br />

to<br />

the<br />

Path<br />

attribute<br />

of<br />

a<br />

server<br />

cookie<br />

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

example,<br />

Path=/jct/xyz)<br />

in<br />

addition<br />

to<br />

modifying<br />

the<br />

URL<br />

itself.<br />

This<br />

match<br />

between<br />

URL<br />

path<br />

name<br />

and<br />

the<br />

cookie<br />

Path<br />

attribute<br />

allows<br />

the<br />

browser<br />

to<br />

return<br />

the<br />

cookie<br />

when<br />

the<br />

link<br />

is<br />

activated<br />

by<br />

the<br />

user.<br />

However,<br />

the<br />

–j<br />

junction-cookie-based<br />

solution<br />

adds<br />

the<br />

junction<br />

name<br />

to<br />

a<br />

URL<br />

only<br />

after<br />

the<br />

link<br />

(URL)<br />

has<br />

been<br />

activated<br />

by<br />

the<br />

user.<br />

When<br />

the<br />

pre-modified<br />

link<br />

is<br />

activated,<br />

the<br />

URL<br />

path<br />

name<br />

(/xyz/memo.html)<br />

does<br />

not<br />

match<br />

the<br />

Path<br />

attribute<br />

(Path=/jct/xyz).<br />

The<br />

server<br />

cookie<br />

is<br />

not<br />

returned.<br />

Solution:<br />

The<br />

–j<br />

option<br />

converts<br />

the<br />

Path<br />

attribute<br />

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

any<br />

server<br />

cookie<br />

(Set-Cookie)<br />

to<br />

″/″<br />

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

example,<br />

Path=/).<br />

Because<br />

all<br />

server-relative<br />

path<br />

names<br />

begin<br />

with<br />

a<br />

″/″,<br />

all<br />

server<br />

cookies<br />

are<br />

returned<br />

regardless<br />

of<br />

the<br />

requirements<br />

of<br />

the<br />

original<br />

Path<br />

attribute<br />

specifications.<br />

Chapter<br />

10.<br />

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

junctions<br />

295

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

Saved successfully!

Ooh no, something went wrong!