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.

2.<br />

\Program<br />

Files\Company<br />

Inc.\Release.Notes<br />

3.<br />

\program<br />

files\company<br />

inc\release.notes<br />

Example<br />

1<br />

illustrates<br />

how<br />

Windows<br />

can<br />

create<br />

an<br />

alias<br />

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

DOS<br />

compatibility)<br />

that<br />

contains<br />

no<br />

spaces<br />

in<br />

the<br />

file<br />

names<br />

and<br />

con<strong>for</strong>ms<br />

to<br />

the<br />

8.3<br />

<strong>for</strong>mat.<br />

The<br />

–w<br />

option<br />

causes<br />

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

to<br />

reject<br />

this<br />

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

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

ACL<br />

checks.<br />

Example<br />

2<br />

illustrates<br />

how<br />

Windows<br />

can<br />

include<br />

trailing<br />

extension<br />

dots.<br />

The<br />

–w<br />

option<br />

causes<br />

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

to<br />

reject<br />

this<br />

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

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

ACL<br />

checks.<br />

Example<br />

3<br />

illustrates<br />

how<br />

Windows<br />

allows<br />

case-insensitivity<br />

on<br />

the<br />

file<br />

name.<br />

The<br />

–w<br />

option<br />

invokes<br />

the<br />

–i<br />

option<br />

to<br />

ensure<br />

a<br />

case-insensitive<br />

ACL<br />

check.<br />

ACLs<br />

and<br />

POPs<br />

must<br />

attach<br />

to<br />

lower-case<br />

object<br />

names<br />

When<br />

a<br />

junction<br />

is<br />

created<br />

with<br />

the<br />

–w<br />

or<br />

–i<br />

option,<br />

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

per<strong>for</strong>ms<br />

ACL<br />

and<br />

POP<br />

comparisons<br />

as<br />

case-insensitive.<br />

This<br />

means<br />

that<br />

the<br />

name<br />

of<br />

any<br />

object<br />

being<br />

evaluated<br />

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

an<br />

ACL<br />

is<br />

placed<br />

into<br />

lower-case<br />

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

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

checks<br />

it<br />

against<br />

the<br />

object<br />

list<br />

to<br />

which<br />

ACLs<br />

are<br />

attached.<br />

As<br />

a<br />

result,<br />

protected<br />

objects<br />

with<br />

names<br />

that<br />

contain<br />

upper<br />

case<br />

letters<br />

are<br />

not<br />

found<br />

during<br />

the<br />

ACL<br />

or<br />

POP<br />

checks.<br />

If<br />

this<br />

occurs,<br />

the<br />

ACL<br />

or<br />

POP<br />

is<br />

not<br />

applied<br />

to<br />

the<br />

protected<br />

object,<br />

and<br />

the<br />

parent<br />

policy<br />

is<br />

applied<br />

instead.<br />

To<br />

avoid<br />

the<br />

possible<br />

misapplication<br />

of<br />

policy<br />

in<br />

this<br />

configuration,<br />

you<br />

must<br />

create<br />

lower-case<br />

versions<br />

of<br />

the<br />

same<br />

names<br />

of<br />

the<br />

real<br />

protected<br />

objects<br />

to<br />

which<br />

you<br />

want<br />

to<br />

attach<br />

explicit<br />

ACLs<br />

or<br />

POPs.<br />

Specifying<br />

UTF-8<br />

encoding<br />

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

HTTP<br />

header<br />

data<br />

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

inserts<br />

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

into<br />

HTTP<br />

headers<br />

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

requests<br />

to<br />

the<br />

backend<br />

server.<br />

This<br />

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

can<br />

include<br />

extended<br />

attributes<br />

or<br />

user<br />

data.<br />

In<br />

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

versions<br />

prior<br />

to<br />

5.1,<br />

the<br />

headers<br />

were<br />

added<br />

to<br />

the<br />

request<br />

using<br />

raw<br />

local<br />

code<br />

page.<br />

In<br />

Version<br />

5.1,<br />

the<br />

header<br />

data<br />

is<br />

transmitted<br />

in<br />

a<br />

configurable<br />

<strong>for</strong>mat.<br />

By<br />

default,<br />

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

now<br />

adds<br />

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

to<br />

HTTP<br />

headers<br />

using<br />

UTF-8<br />

encoding.<br />

This<br />

prevents<br />

any<br />

potential<br />

data<br />

loss<br />

that<br />

could<br />

occur<br />

when<br />

converting<br />

to<br />

a<br />

non-UTF-8<br />

code<br />

page.<br />

Also<br />

by<br />

default,<br />

this<br />

data<br />

is<br />

sent<br />

URI<br />

encoded.<br />

For<br />

backwards<br />

compatibility,<br />

the<br />

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

of<br />

the<br />

header<br />

data<br />

can<br />

be<br />

configured<br />

to<br />

raw<br />

local<br />

code<br />

page.<br />

In<br />

addition,<br />

two<br />

other<br />

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

are<br />

supported:<br />

Raw<br />

UTF-8<br />

and<br />

URI<br />

encoded<br />

local<br />

code<br />

page.<br />

The<br />

-e<br />

option<br />

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

creating<br />

junctions<br />

specifies<br />

the<br />

encoding<br />

of<br />

user<br />

name,<br />

groups,<br />

and<br />

other<br />

extended<br />

attributes<br />

which<br />

are<br />

sent<br />

within<br />

the<br />

HTTP<br />

header<br />

to<br />

the<br />

backend<br />

server.<br />

The<br />

encode<br />

option<br />

can<br />

take<br />

one<br />

of<br />

the<br />

following<br />

arguments:<br />

Argument<br />

Description<br />

utf8_uri<br />

URI<br />

encoded<br />

UTF-8<br />

data<br />

All<br />

white<br />

space<br />

and<br />

non-ascii<br />

bytes<br />

are<br />

encoded<br />

%XY,<br />

where<br />

X<br />

and<br />

Y<br />

are<br />

hex<br />

values<br />

(0–F).<br />

utf8_bin<br />

Un-encoded<br />

UTF-8<br />

data.<br />

This<br />

setting<br />

allows<br />

data<br />

to<br />

be<br />

transmitted<br />

without<br />

data<br />

loss,<br />

and<br />

the<br />

customer<br />

does<br />

not<br />

need<br />

to<br />

URI-decode<br />

the<br />

data.<br />

This<br />

setting<br />

should<br />

be<br />

used<br />

with<br />

caution,<br />

because<br />

it<br />

is<br />

not<br />

part<br />

of<br />

the<br />

HTTP<br />

specification<br />

Chapter<br />

10.<br />

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

junctions<br />

305

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

Saved successfully!

Ooh no, something went wrong!