lib/libtls/man/tls_config_verify.3

   1 .\" $OpenBSD: tls_config_verify.3,v 1.4 2017/03/02 11:05:50 jmc Exp $
   2 .\"
   3 .\" Copyright (c) 2014 Ted Unangst <tedu@openbsd.org>
   4 .\" Copyright (c) 2015 Joel Sing <jsing@openbsd.org>
   5 .\"
   6 .\" Permission to use, copy, modify, and distribute this software for any
   7 .\" purpose with or without fee is hereby granted, provided that the above
   8 .\" copyright notice and this permission notice appear in all copies.
   9 .\"
  10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17 .\"
  18 .Dd $Mdocdate: March 2 2017 $
  19 .Dt TLS_CONFIG_VERIFY 3
  20 .Os
  21 .Sh NAME
  22 .Nm tls_config_verify ,
  23 .Nm tls_config_insecure_noverifycert ,
  24 .Nm tls_config_insecure_noverifyname ,
  25 .Nm tls_config_insecure_noverifytime
  26 .Nd insecure TLS configuration
  27 .Sh SYNOPSIS
  28 .In tls.h
  29 .Ft void
  30 .Fn tls_config_verify "struct tls_config *config"
  31 .Ft void
  32 .Fn tls_config_insecure_noverifycert "struct tls_config *config"
  33 .Ft void
  34 .Fn tls_config_insecure_noverifyname "struct tls_config *config"
  35 .Ft void
  36 .Fn tls_config_insecure_noverifytime "struct tls_config *config"
  37 .Sh DESCRIPTION
  38 These functions disable parts of the normal certificate verification
  39 process, resulting in insecure configurations.
  40 Be very careful when using them.
  41 .Pp
  42 .Fn tls_config_insecure_noverifycert
  43 disables certificate verification and OCSP validation.
  44 .Pp
  45 .Fn tls_config_insecure_noverifyname
  46 disables server name verification (client only).
  47 .Pp
  48 .Fn tls_config_insecure_noverifytime
  49 disables validity checking of certificates and OCSP validation.
  50 .Pp
  51 .Fn tls_config_verify
  52 reenables server name and certificate verification.
  53 .Sh SEE ALSO
  54 .Xr tls_client 3 ,
  55 .Xr tls_config_ocsp_require_stapling 3 ,
  56 .Xr tls_config_set_protocols 3 ,
  57 .Xr tls_conn_version 3 ,
  58 .Xr tls_connect 3 ,
  59 .Xr tls_handshake 3 ,
  60 .Xr tls_init 3
  61 .Sh HISTORY
  62 .Fn tls_config_verify
  63 appeared in
  64 .Ox 5.6
  65 and got its final name in
  66 .Ox 5.7 .
  67 .Pp
  68 .Fn tls_config_insecure_noverifycert
  69 and
  70 .Fn tls_config_insecure_noverifyname
  71 appeared in
  72 .Ox 5.7
  73 and
  74 .Nm tls_config_insecure_noverifytime
  75 in
  76 .Ox 5.9 .
  77 .Sh AUTHORS
  78 .An Joel Sing Aq Mt jsing@openbsd.org
  79 .An Ted Unangst Aq Mt tedu@openbsd.org