Changeset 11189 in project


Ignore:
Timestamp:
07/07/08 15:01:28 (12 years ago)
Author:
Ivan Raikov
Message:

Added some more documentation about http:authenticate.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • wiki/http-auth

    r11188 r11189  
    4747An implementation of an HTTP authentication state machine.
    4848
    49 Argument {{RESPONSE-HANDLER}} is a procedure of the form {{LAMBDA STATUS * RESPONSE-ATTRS * IN * OUT * QOP-STATE -> ...}}.
     49; Argument {{RESPONSE-HANDLER}} is a procedure of the form {{LAMBDA STATUS * RESPONSE-ATTRS * IN * OUT * QOP-STATE -> ...}}.
     50; Argument {{GET-USER+PW}} is a procedure of the form {{LAMBDA AUTH-TYPE * REALM -> USERNAME * PASSWORD}}, where
     51{{AUTH-TYPE}} is one of {{'BASIC}} or {{'DIGEST}}.
     52; Argument {{REQUEST}} is an HTTP request object.
     53; Argument {{RETRY?}} can be a positive integer to specify number of authentication retries, or a boolean ({{#t}} or {{#f}}).
     54; {{AUTH-STATE}} is a list {{[QOP-STATE RESPONSE-FST RESPONSE-ATTRS RESPONSE-IN RESPONSE-OUT]}}.
     55
     56When first called with an empty {{AUTH-STATE}}, this procedure sends
     57he request as-is. If the server returns 401 Unauthorized and argument
     58{{RETRY?}} is not {{#F}}, the procedure parses the WWW-Authenticate
     59header returned by the server, creates an authorization header for
     60basic or digest authentication, and resends the request. If the server
     61returns a code other than 401, the response handler is invoked with
     62the server response as arguments.
    5063
    5164
Note: See TracChangeset for help on using the changeset viewer.