SetAuthentication (HttpRequest subroutine)
Issue username/password credentials (HttpRequest class)
This callable method lets you present
credentials to a password-protected portion of a website.
Such portions of a site are those where the server returns
a 401 return code (authentication is required) for a
request-for-URL in that portion of the site.
Syntax
httpRequest:SetAuthentication( userID, password, realm)
Syntax terms
%httpreq | An instantiated HttpRequest object. |
---|---|
userid | The user name for the protected area. |
pw | The password for the protected area. |
realm | The protected area of the site. |
Usage notes
- Once a SetAuthentication method is
issued, the information passed is used to respond to
any request to which the server responds with a
401 http
status code. - The most recent SetAuthentication issued is the one that will be in effect.
- Authentication values created with SetAuthentication are cleared with the RemoveAuthentication method.