summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--src/lib/libcrypto/man/Makefile4
-rw-r--r--src/lib/libcrypto/man/PROXY_POLICY_new.397
-rw-r--r--src/lib/libcrypto/man/X509_EXTENSION_set_object.35
-rw-r--r--src/lib/libcrypto/man/X509_VERIFY_PARAM_set_flags.36
-rw-r--r--src/lib/libcrypto/man/X509_get_extension_flags.36
-rw-r--r--src/lib/libcrypto/man/d2i_PROXY_POLICY.397
6 files changed, 10 insertions, 205 deletions
diff --git a/src/lib/libcrypto/man/Makefile b/src/lib/libcrypto/man/Makefile
index fc3204e3a2..42b4c2fbe1 100644
--- a/src/lib/libcrypto/man/Makefile
+++ b/src/lib/libcrypto/man/Makefile
@@ -1,4 +1,4 @@
1# $OpenBSD: Makefile,v 1.249 2023/04/30 14:49:47 tb Exp $ 1# $OpenBSD: Makefile,v 1.250 2023/04/30 19:40:23 tb Exp $
2 2
3.include <bsd.own.mk> 3.include <bsd.own.mk>
4 4
@@ -265,7 +265,6 @@ MAN= \
265 PKCS8_pkey_set0.3 \ 265 PKCS8_pkey_set0.3 \
266 PKEY_USAGE_PERIOD_new.3 \ 266 PKEY_USAGE_PERIOD_new.3 \
267 POLICYINFO_new.3 \ 267 POLICYINFO_new.3 \
268 PROXY_POLICY_new.3 \
269 RAND_add.3 \ 268 RAND_add.3 \
270 RAND_bytes.3 \ 269 RAND_bytes.3 \
271 RAND_load_file.3 \ 270 RAND_load_file.3 \
@@ -407,7 +406,6 @@ MAN= \
407 d2i_PKCS8_PRIV_KEY_INFO.3 \ 406 d2i_PKCS8_PRIV_KEY_INFO.3 \
408 d2i_PKEY_USAGE_PERIOD.3 \ 407 d2i_PKEY_USAGE_PERIOD.3 \
409 d2i_POLICYINFO.3 \ 408 d2i_POLICYINFO.3 \
410 d2i_PROXY_POLICY.3 \
411 d2i_PrivateKey.3 \ 409 d2i_PrivateKey.3 \
412 d2i_RSAPublicKey.3 \ 410 d2i_RSAPublicKey.3 \
413 d2i_TS_REQ.3 \ 411 d2i_TS_REQ.3 \
diff --git a/src/lib/libcrypto/man/PROXY_POLICY_new.3 b/src/lib/libcrypto/man/PROXY_POLICY_new.3
deleted file mode 100644
index c23a620177..0000000000
--- a/src/lib/libcrypto/man/PROXY_POLICY_new.3
+++ /dev/null
@@ -1,97 +0,0 @@
1.\" $OpenBSD: PROXY_POLICY_new.3,v 1.6 2021/10/27 11:24:47 schwarze Exp $
2.\"
3.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: October 27 2021 $
18.Dt PROXY_POLICY_NEW 3
19.Os
20.Sh NAME
21.Nm PROXY_POLICY_new ,
22.Nm PROXY_POLICY_free ,
23.Nm PROXY_CERT_INFO_EXTENSION_new ,
24.Nm PROXY_CERT_INFO_EXTENSION_free
25.Nd X.509 proxy certificate extension
26.Sh SYNOPSIS
27.In openssl/x509v3.h
28.Ft PROXY_POLICY *
29.Fn PROXY_POLICY_new void
30.Ft void
31.Fn PROXY_POLICY_free "PROXY_POLICY *pp"
32.Ft PROXY_CERT_INFO_EXTENSION *
33.Fn PROXY_CERT_INFO_EXTENSION_new void
34.Ft void
35.Fn PROXY_CERT_INFO_EXTENSION_free "PROXY_CERT_INFO_EXTENSION *pcie"
36.Sh DESCRIPTION
37If a given non-CA certificate grants any privileges, using that
38certificate to issue a proxy certificate and handing that proxy
39certificate over to another person, organization, or service allows
40the bearer of the proxy certificate to exercise some or all of the
41privileges on behalf of the subject of the original certificate.
42.Pp
43.Fn PROXY_POLICY_new
44allocates and initializes an empty
45.Vt PROXY_POLICY
46object, representing an ASN.1
47.Vt ProxyPolicy
48structure defined in RFC 3820 section 3.8.
49It defines which privileges are to be delegated.
50.Fn PROXY_POLICY_free
51frees
52.Fa pp .
53.Pp
54.Fn PROXY_CERT_INFO_EXTENSION_new
55allocates and initializes an empty
56.Vt PROXY_CERT_INFO_EXTENSION
57object, representing an ASN.1
58.Vt ProxyCertInfo
59structure defined in RFC 3820 section 3.8.
60It can contain a
61.Vt PROXY_POLICY
62object, and it can additionally restrict the maximum depth of the
63path of proxy certificates that can be signed by this proxy
64certificate.
65.Fn PROXY_CERT_INFO_EXTENSION_free
66frees
67.Fa pcie .
68.Pp
69If a non-CA certificate contains a
70.Vt PROXY_CERT_INFO_EXTENSION ,
71it is a proxy certificate; otherwise, it is an end entity certificate.
72.Sh RETURN VALUES
73.Fn PROXY_POLICY_new
74and
75.Fn PROXY_CERT_INFO_EXTENSION_new
76return the new
77.Vt PROXY_POLICY
78or
79.Vt PROXY_CERT_INFO_EXTENSION
80object, respectively, or
81.Dv NULL
82if an error occurs.
83.Sh SEE ALSO
84.Xr BASIC_CONSTRAINTS_new 3 ,
85.Xr d2i_PROXY_POLICY 3 ,
86.Xr EXTENDED_KEY_USAGE_new 3 ,
87.Xr POLICYINFO_new 3 ,
88.Xr X509_EXTENSION_new 3 ,
89.Xr X509_get_extension_flags 3 ,
90.Xr X509_new 3
91.Sh STANDARDS
92RFC 3820: Internet X.509 Public Key Infrastructure (PKI) Proxy
93Certificate Profile
94.Sh HISTORY
95These functions first appeared in OpenSSL 0.9.7g
96and have been available since
97.Ox 3.8 .
diff --git a/src/lib/libcrypto/man/X509_EXTENSION_set_object.3 b/src/lib/libcrypto/man/X509_EXTENSION_set_object.3
index 3ade50e4d6..dcfe075ebd 100644
--- a/src/lib/libcrypto/man/X509_EXTENSION_set_object.3
+++ b/src/lib/libcrypto/man/X509_EXTENSION_set_object.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_EXTENSION_set_object.3,v 1.16 2023/04/25 18:48:32 tb Exp $ 1.\" $OpenBSD: X509_EXTENSION_set_object.3,v 1.17 2023/04/30 19:40:23 tb Exp $
2.\" full merge up to: OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400 2.\" full merge up to: OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
3.\" 3.\"
4.\" This file is a derived work. 4.\" This file is a derived work.
@@ -65,7 +65,7 @@
65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 65.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
66.\" OF THE POSSIBILITY OF SUCH DAMAGE. 66.\" OF THE POSSIBILITY OF SUCH DAMAGE.
67.\" 67.\"
68.Dd $Mdocdate: April 25 2023 $ 68.Dd $Mdocdate: April 30 2023 $
69.Dt X509_EXTENSION_SET_OBJECT 3 69.Dt X509_EXTENSION_SET_OBJECT 3
70.Os 70.Os
71.Sh NAME 71.Sh NAME
@@ -291,7 +291,6 @@ pointer.
291.Xr OCSP_SERVICELOC_new 3 , 291.Xr OCSP_SERVICELOC_new 3 ,
292.Xr PKEY_USAGE_PERIOD_new 3 , 292.Xr PKEY_USAGE_PERIOD_new 3 ,
293.Xr POLICYINFO_new 3 , 293.Xr POLICYINFO_new 3 ,
294.Xr PROXY_POLICY_new 3 ,
295.Xr TS_REQ_new 3 , 294.Xr TS_REQ_new 3 ,
296.Xr X509_check_ca 3 , 295.Xr X509_check_ca 3 ,
297.Xr X509_check_host 3 , 296.Xr X509_check_host 3 ,
diff --git a/src/lib/libcrypto/man/X509_VERIFY_PARAM_set_flags.3 b/src/lib/libcrypto/man/X509_VERIFY_PARAM_set_flags.3
index 65e20f1ad8..a0ae839f9a 100644
--- a/src/lib/libcrypto/man/X509_VERIFY_PARAM_set_flags.3
+++ b/src/lib/libcrypto/man/X509_VERIFY_PARAM_set_flags.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_VERIFY_PARAM_set_flags.3,v 1.28 2023/04/30 14:49:47 tb Exp $ 1.\" $OpenBSD: X509_VERIFY_PARAM_set_flags.3,v 1.29 2023/04/30 19:40:23 tb Exp $
2.\" full merge up to: OpenSSL d33def66 Feb 9 14:17:13 2016 -0500 2.\" full merge up to: OpenSSL d33def66 Feb 9 14:17:13 2016 -0500
3.\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100 3.\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
4.\" 4.\"
@@ -540,7 +540,9 @@ flag disables workarounds for some broken certificates and makes the
540verification strictly apply X509 rules. 540verification strictly apply X509 rules.
541.Pp 541.Pp
542.Dv X509_V_FLAG_ALLOW_PROXY_CERTS 542.Dv X509_V_FLAG_ALLOW_PROXY_CERTS
543enables proxy certificate verification. 543deprecated flag that used to
544enable proxy certificate verification.
545In LibreSSL, this flag has no effect.
544.Pp 546.Pp
545.Dv X509_V_FLAG_POLICY_CHECK 547.Dv X509_V_FLAG_POLICY_CHECK
546enables certificate policy checking; by default no policy checking is 548enables certificate policy checking; by default no policy checking is
diff --git a/src/lib/libcrypto/man/X509_get_extension_flags.3 b/src/lib/libcrypto/man/X509_get_extension_flags.3
index 1f63c6a910..1d7f29c687 100644
--- a/src/lib/libcrypto/man/X509_get_extension_flags.3
+++ b/src/lib/libcrypto/man/X509_get_extension_flags.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: X509_get_extension_flags.3,v 1.3 2021/11/11 13:58:59 schwarze Exp $ 1.\" $OpenBSD: X509_get_extension_flags.3,v 1.4 2023/04/30 19:40:23 tb Exp $
2.\" full merge up to: OpenSSL 361136f4 Sep 1 18:56:58 2015 +0100 2.\" full merge up to: OpenSSL 361136f4 Sep 1 18:56:58 2015 +0100
3.\" selective merge up to: OpenSSL 2b2e3106f Feb 16 15:04:45 2021 +0000 3.\" selective merge up to: OpenSSL 2b2e3106f Feb 16 15:04:45 2021 +0000
4.\" 4.\"
@@ -49,7 +49,7 @@
49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 49.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50.\" OF THE POSSIBILITY OF SUCH DAMAGE. 50.\" OF THE POSSIBILITY OF SUCH DAMAGE.
51.\" 51.\"
52.Dd $Mdocdate: November 11 2021 $ 52.Dd $Mdocdate: April 30 2023 $
53.Dt X509_GET_EXTENSION_FLAGS 3 53.Dt X509_GET_EXTENSION_FLAGS 3
54.Os 54.Os
55.Sh NAME 55.Sh NAME
@@ -87,6 +87,7 @@ The certificate contains a basic constraints extension.
87The certificate contains basic constraints and asserts the CA flag. 87The certificate contains basic constraints and asserts the CA flag.
88.It Dv EXFLAG_PROXY 88.It Dv EXFLAG_PROXY
89The certificate is a valid proxy certificate. 89The certificate is a valid proxy certificate.
90In LibreSSL this flag is never set.
90.It Dv EXFLAG_SI 91.It Dv EXFLAG_SI
91The certificate is self issued (that is subject and issuer names match). 92The certificate is self issued (that is subject and issuer names match).
92.It Dv EXFLAG_SS 93.It Dv EXFLAG_SS
@@ -217,7 +218,6 @@ return sets of flags corresponding to the certificate extension values.
217.Xr BASIC_CONSTRAINTS_new 3 , 218.Xr BASIC_CONSTRAINTS_new 3 ,
218.Xr EXTENDED_KEY_USAGE_new 3 , 219.Xr EXTENDED_KEY_USAGE_new 3 ,
219.Xr POLICYINFO_new 3 , 220.Xr POLICYINFO_new 3 ,
220.Xr PROXY_CERT_INFO_EXTENSION_new 3 ,
221.Xr X509_check_ca 3 , 221.Xr X509_check_ca 3 ,
222.Xr X509_check_purpose 3 , 222.Xr X509_check_purpose 3 ,
223.Xr X509_EXTENSION_new 3 , 223.Xr X509_EXTENSION_new 3 ,
diff --git a/src/lib/libcrypto/man/d2i_PROXY_POLICY.3 b/src/lib/libcrypto/man/d2i_PROXY_POLICY.3
deleted file mode 100644
index 794c6edcec..0000000000
--- a/src/lib/libcrypto/man/d2i_PROXY_POLICY.3
+++ /dev/null
@@ -1,97 +0,0 @@
1.\" $OpenBSD: d2i_PROXY_POLICY.3,v 1.2 2018/03/22 22:07:12 schwarze Exp $
2.\"
3.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: March 22 2018 $
18.Dt D2I_PROXY_POLICY 3
19.Os
20.Sh NAME
21.Nm d2i_PROXY_POLICY ,
22.Nm i2d_PROXY_POLICY ,
23.Nm d2i_PROXY_CERT_INFO_EXTENSION ,
24.Nm i2d_PROXY_CERT_INFO_EXTENSION
25.Nd decode and encode X.509 proxy certificate extensions
26.Sh SYNOPSIS
27.In openssl/x509v3.h
28.Ft PROXY_POLICY *
29.Fo d2i_PROXY_POLICY
30.Fa "PROXY_POLICY **val_out"
31.Fa "const unsigned char **der_in"
32.Fa "long length"
33.Fc
34.Ft int
35.Fo i2d_PROXY_POLICY
36.Fa "PROXY_POLICY *val_in"
37.Fa "unsigned char **der_out"
38.Fc
39.Ft PROXY_CERT_INFO_EXTENSION *
40.Fo d2i_PROXY_CERT_INFO_EXTENSION
41.Fa "PROXY_CERT_INFO_EXTENSION **val_out"
42.Fa "const unsigned char **der_in"
43.Fa "long length"
44.Fc
45.Ft int
46.Fo i2d_PROXY_CERT_INFO_EXTENSION
47.Fa "PROXY_CERT_INFO_EXTENSION *val_in"
48.Fa "unsigned char **der_out"
49.Fc
50.Sh DESCRIPTION
51These functions encode and decode X.509 extensions that decide
52whether a certificate is a proxy certificate, and which policies
53apply to it.
54For details about the semantics, examples, caveats, and bugs, see
55.Xr ASN1_item_d2i 3 .
56.Pp
57.Fn d2i_PROXY_POLICY
58and
59.Fn i2d_PROXY_POLICY
60decode and encode an ASN.1
61.Vt ProxyPolicy
62structure defined in RFC 3820 section 3.8.
63.Pp
64.Fn d2i_PROXY_CERT_INFO_EXTENSION
65and
66.Fn i2d_PROXY_CERT_INFO_EXTENSION
67decode and encode an ASN.1
68.Vt ProxyCertInfo
69structure defined in RFC 3820 section 3.8.
70.Sh RETURN VALUES
71.Fn d2i_PROXY_POLICY
72and
73.Fn d2i_PROXY_CERT_INFO_EXTENSION
74return a
75.Vt PROXY_POLICY
76or
77.Vt PROXY_CERT_INFO_EXTENSION
78object, respectively, or
79.Dv NULL
80if an error occurs.
81.Pp
82.Fn i2d_PROXY_POLICY
83and
84.Fn i2d_PROXY_CERT_INFO_EXTENSION
85return the number of bytes successfully encoded or a negative value
86if an error occurs.
87.Sh SEE ALSO
88.Xr ASN1_item_d2i 3 ,
89.Xr PROXY_POLICY_new 3 ,
90.Xr X509_EXTENSION_new 3
91.Sh STANDARDS
92RFC 3820: Internet X.509 Public Key Infrastructure (PKI) Proxy
93Certificate Profile
94.Sh HISTORY
95These functions first appeared in OpenSSL 0.9.7g
96and have been available since
97.Ox 3.8 .