comparison mercurial/help/config.txt @ 29285:63a3749147af

mail: unsupport smtp.verifycert (BC)

smtp.verifycert was accidentally broken by cca59ef27e60. And,
I believe the "loose" value has been broken for longer than that.
The current code refuses to talk to a remote server unless the
CA is trusted or the fingerprint is validated. In other words,
we lost the ability for smtp.verifycert to lower/disable security.

There are special considerations for smtp.verifycert in
sslutil.validatesocket() (the "strict" argument). This violates
the direction sslutil is evolving towards, which has all security
options determined at wrapsocket() time and a unified code path and
configs for determining security options.

Since smtp.verifycert is broken and since we'll soon have new
security defaults and new mechanisms for controlling host security,
this patch formally deprecates smtp.verifycert. With this patch,
the socket security code in mail.py now effectively mirrors code
in url.py and other places we're doing socket security.

For the record, removing smtp.verifycert because it was accidentally
broken is a poor excuse to remove it. However, I would have done this
anyway because smtp.verifycert is a one-off likely used by few people
(users of the patchbomb extension) and I don't think the existence
of this seldom-used one-off in security code can be justified,
especially when you consider that better mechanisms are right around
the corner.

29284:1c7167009936

``tls``
    Optional. Method to enable TLS when connecting to mail server: starttls,
    smtps or none. (default: none)

``verifycert``
    Optional. Verification for the certificate of mail server, when
    ``tls`` is starttls or smtps. "strict", "loose" or False. For
    "strict" or "loose", the certificate is verified as same as the
    verification for HTTPS connections (see ``[hostfingerprints]`` and
    ``[web] cacerts`` also). For "strict", sending email is also
    aborted, if there is no configuration for mail server in
    ``[hostfingerprints]`` and ``[web] cacerts``.  --insecure for
    :hg:`email` overwrites this as "loose". (default: strict)

``username``
    Optional. User name for authenticating with the SMTP server.
    (default: None)

``password``

29285:63a3749147af

``tls``
    Optional. Method to enable TLS when connecting to mail server: starttls,
    smtps or none. (default: none)

``username``
    Optional. User name for authenticating with the SMTP server.
    (default: None)

``password``