$Web Realm: Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (→Syntax) |
||
| (7 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:$Web_Realm}} | {{DISPLAYTITLE:$Web_Realm}} | ||
<span class="pageSubtitle" | <span class="pageSubtitle">Set web "realm" for "Unauthorized" response</span> | ||
<var>$Web_Realm</var> allows the setting of the web "realm" before sending an "Unauthorized" response to the browser. | <var>$Web_Realm</var> allows the setting of the web "realm" before sending an "Unauthorized" response to the browser. | ||
<var>$Web_Realm</var> is a | <var>$Web_Realm</var> is a [[Calling Sirius Mods $functions|callable]] $function, and it takes a single argument and returns a number. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">< | <p class="syntax"><span class="term">%rc</span> = <span class="literal">$Web_Realm</span>(<span class="term"> realm_name</span> ) | ||
< | </p> | ||
===Syntax terms=== | ===Syntax terms=== | ||
| Line 14: | Line 14: | ||
<tr><th>%rc</th> | <tr><th>%rc</th> | ||
<td>A numeric variable to contain a return code.</td></tr> | <td>A numeric variable to contain a return code.</td></tr> | ||
<tr><th>realm_name</th> | <tr><th>realm_name</th> | ||
<td>Specifies the name of the realm to which a userid and password combination applies. This is a required parameter. | <td>Specifies the name of the realm to which a userid and password combination applies. This is a required parameter. | ||
Latest revision as of 22:00, 5 June 2013
Set web "realm" for "Unauthorized" response
$Web_Realm allows the setting of the web "realm" before sending an "Unauthorized" response to the browser.
$Web_Realm is a callable $function, and it takes a single argument and returns a number.
Syntax
%rc = $Web_Realm( realm_name )
Syntax terms
| %rc | A numeric variable to contain a return code. |
|---|---|
| realm_name | Specifies the name of the realm to which a userid and password combination applies. This is a required parameter. |
Usage notes
- Web realms can serve several purposes:
- By having multiple realms for a single host, different URLs could be made available to different sets of users.
- The realm could be used to send an arbitrary message to the browser to appear in a login pop-up window.
- Realms could be dynamically generated to prevent browsers from caching userids and passwords at public workstations.
- The realm sent by $Web_Realm is not sent to a browser unless a status of 401 ("Unauthorized") is sent to the browser.
This means that a $Web_Realm call is meaningless unless followed by a $Web_Done with a status code of 401, for example:
%rc = $Web_Realm('Toxico Database Systems') %rc = $Web_Done(401, 'Unauthorized')
- If all the $Web_Realm calls for a port in an Online are to have the same realm, it probably makes more sense to set the realm with the WEBREALM parameter on the JANUS DEFINE command for the port.
- While $Web_Realm can be used in any code, its most common use would be in exception rules, especially those associated with logon processing such as LOGONERR and NEWPASSWORD.