class type key_handler = object .. end
method inquire_key : domain:Neturl.url option -> realm:string -> auth:string -> key
The method is called when a new session must be authenticated.
The 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 None.
The realm parameter is the realm identifier.
In 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 Not_found,
authentication will fail.
method invalidate_key : key -> unit
The handler is notified that authentication failed for this key
