Whitebeam Library Definition

Site Map
 
Home
 
Application Guide
Reference
  Installation
  Configuration
  XML Markup
  JavaScript Classes
  ROM
  Templates
  Environment
  Dev Process
  Tools
  External Links
  Example libraries
Community
Contact Whitebeam
To-Do
Download
Credits
Licence
Whitebeam Users
 
 
 

Whitebeam Library Definition

Tag Description

<rbm:extauth>

Apply protection to a page or part of a page

See Also

extauth   

Syntax

<rbm:extauth community=string authfail=string mandatory=string>body</rbm:extauth>

Attributes

The 'rbm:extauth' tag has 3 attributes:

Name Type/Value Range/Length Description
communitystring2 to 31 characters Required. Identify the group of people against which the username and password will be validated. This may select one or more Communities, individuals or OUs (Organisational Units). To specify more than one, provide a comma separated list with no white-space.
authfailstring0+ characters Optional. The page to display if the user cannot be authenticated against the list of communities. This takes the form of a filename within the current website. If not specified, some generic text is output in place of the extauth body. The special value of "ignore" causes the contents of the tags to be silently deleted if authentication fails.
mandatorystringyes or no Optional. yes or no. Selects the action to take if the authentication fails to match any credentials held in the specified communities. See below.

Body

The rbm:extauth body contains XML which requires protection or authentication.

Remarks

mandatory='yes' (default)

If mandatory is 'yes' then the logged-in user MUST match against a member of the specified community list. If it doesn't then the section of XML contained within the tag is not executed and the authfail tag is used to define further behaviour.

mandatory='no'

If 'mandatory' is no then the XML subtree is executed anyway - allowing the Presentation Page to programmatically deal with the error. For example it might produce a registration page, or a reduced version of the page.

In order to provide the presentation page access to the current status of the authenticated user, a gloabl object is provided to store this information. See the defenition of the extauth struct in the See Also section above.
Whitebeam release 1.3.36
(loadtime : 11ms)