Ocamlnet 4 Reference Manual : Nethttp_client.key

# Class type Nethttp_client.key

    class type key = object .. end

A `key` is a user/password combination for a certain realm

    method user : string

The user name (UTF-8)

    method password : string

The password in cleartext (UTF-8)

    method realm : string

The realm

    method domain : Neturl.url list

The domain URIs defining the protection space. The domain URIs are absolute URIs. For proxy access the list must be empty.

Normally, this is just a list with one element. The URI must include the protocol scheme, the host name, the port, and a path (at minimum "/"). The key is valid for all request URIs for which this domain string is a prefix of the request URI. Examples: "http://localhost:80/" would cover all of "localhost". "http://localhost:80/space/" would cover all URIs at this or below this URI. "https://localhost:443/" would cover all of "localhost" when accessed via TLS.

If the key is applicable to all domains, set this to [].

    method credentials : (string * string * (string * string) list) list

The key in the common "credentials" format that is used by generic mechanisms. See `Nethttp.HTTP_CLIENT_MECHANISM.init_credentials` for details.

Note that since Ocamlnet-4.1 we explicitly specify that cleartext passwords are encoded in UTF-8 - independently of what the protocol assumes.