22.12.2012 Views

Front cover - IBM Redbooks

Front cover - IBM Redbooks

Front cover - IBM Redbooks

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

kFilterParsedRequest Event<br />

All filters currently loaded and supporting this event are notified with this event<br />

when the HTTP stack has finished pre-parsing all the HTTP input headers. Note<br />

that this reflects the same state as in the event kFilterRawRequest since the<br />

HTTP stack pre-parses the HTTP input headers before it starts calling any filter.<br />

Any filter once again can choose to process the request completely at this step.<br />

pEventData is a pointer to the structure, FilterParsedRequest. Note that only two<br />

callback functions are provided. You can only access the HTTP input headers in<br />

this step. With the kFilterRawRequest, you have the opportunity to change them<br />

as well.<br />

kFilterRewriteURL Event<br />

All filters currently loaded and supporting this event have the opportunity to<br />

change the URL to redirect the request to some other resource. If a filter<br />

successfully rewrites the URL to be processed, and the server processes the<br />

new URL, then the DSAPI layer stops processing this event, meaning no other<br />

filters in the list are notified. pEventData is a pointer to an instance of the<br />

structure, FilterMapURL. Note that the structure FilterMapURL is also used in the<br />

events, kFilterTranslateRequest, and kFilterPostTranslate.<br />

kFilterAuthenticate Event<br />

This event occurs when the HTTP stack is in the authentication phase of the<br />

process. The filter code can view the request and user credentials, authenticate<br />

the user for the HTTP stack, or completely handle the request. pEventData is a<br />

pointer to an instance of the structure.<br />

kFilterUserNameList Event<br />

This event occurs when the HTTP stack is about to generate the user's group<br />

name list. These are group names the user is a member of. This event follows the<br />

kFilterAuthenticate event. The filter can have the Domino server populate the list,<br />

add groups to or remove groups from the list, or completely handle the event<br />

(generate completely the group list itself). The parameter in the function,<br />

HttpEventProc, pEventData, is a pointer to the structure, FilterUserNameList.<br />

kFilterTranslateRequest Event<br />

This event occurs when the HTTP stack is about to translate the path URL to a<br />

target resource. The filter can translate the request using its own translation and<br />

mapping rules, or completely handle the request. pEventData points to an<br />

instance of the structure, FilterMapURL.<br />

kFilterPostTranslate Event<br />

This event occurs after the event, kFilterTranslateEvent, has been handled. It is<br />

an opportunity for the filter to change the target resource to be accessed. The<br />

filter can change both the target resource path and the mapping type. The filter<br />

Chapter 7. Single sign-on 299

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

Saved successfully!

Ooh no, something went wrong!