class type key_handler =
method inquire_key :
domain:Neturl.url option -> realm:string -> auth:string -> key
The method is called when a new session must be authenticated.
domain is the URI from the request. URIs
must have the form "http://host:port/path", i.e. the port is
always written out. If the request doesn't have a URI, or if the
request is directed to a proxy,
domain will be
realm parameter is the realm identifier.
auth the name of the authentication
method is passed (lowercase characters). The method must
search (or interactively ask for) a key, and return it.
The key must refer to one of the passed realms.
If the method raises
authentication will fail.
method invalidate_key :
key -> unit
The handler is notified that authentication failed for this key