Netscape ENTERPRISE SERVER 6.1, Manual

Page: 134 / 373

Required Behavior of SAFs for Each Directive
134 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
NameTrans SAFs
• Purpose: Convert logical URI to physical path
• Perform operations on logical path (
ppath
in
rq->vars
) to convert it into a full
local file system path.
• Return
REQ_PROCEED
if
ppath
in
rq->vars
contains the full local file system
path, or
REQ_NOACTION
if not.
• To redirect the client to another site, change
ppath
in
rq->vars
to
/URL
. Add
url
to
rq->vars
with full URL (for example.,
http://home.example.com/
).
Return
REQ_PROCEED
.
PathCheck SAFs
• Purpose: Check path validity and user’s access rights.
• Check
auth-type
,
auth-user
and/or
auth-group
in
rq->vars.
• Return
REQ_PROCEED
if user (and group) is authorized for this area (
ppath
in
rq->vars
).
• If not authorized, insert
WWW-Authenticate
to
rq->srvhdrs
with a value such
as:
Basic; Realm=\"Our private area\"
. Call
protocol_status()
to set
HTTP response status to
PROTOCOL_UNAUTHORIZED
. Return
REQ_ABORTED
.
ObjectType SAFs
• Purpose: Determine content-type of data.
• If
content-type
in
rq->srvhdrs
already exists, return
REQ_NOACTION
.
• Determine the MIME type and create
content-type
in
rq->srvhdrs
• Return
REQ_PROCEED
if
content-type
is created,
REQ_NOACTION
otherwise
Service SAFs
• Purpose: Generate and send the response to the client.
• A Service SAF is only called if each of the optional parameters
type
,
method
,
and
query
specified in the directive in
obj.conf
match the request.