blob: 016073e835721fea7434cad5347c1aa5106ade8a [file] [log] [blame]
Alex Stapletonc5fffd32014-03-18 15:29:00 +00001Test vectors
Paul Kehrer1681a692014-02-11 23:43:51 -06002============
3
4Testing the correctness of the primitives implemented in each ``cryptography``
Alex Stapletona39a3192014-03-14 20:03:12 +00005backend requires trusted test vectors. Where possible these vectors are
6obtained from official sources such as `NIST`_ or `IETF`_ RFCs. When this is
7not possible ``cryptography`` has chosen to create a set of custom vectors
8using an official vector file as input to verify consistency between
9implemented backends.
10
11Vectors are kept in the `cryptography_vectors` package rather than within our
12main test suite.
Paul Kehrer1681a692014-02-11 23:43:51 -060013
14Sources
15-------
16
Alex Stapletonc5fffd32014-03-18 15:29:00 +000017Asymmetric ciphers
Paul Kehrer1681a692014-02-11 23:43:51 -060018~~~~~~~~~~~~~~~~~~
19
Alex Stapletonabec8a12014-02-22 16:33:24 +000020* RSA PKCS #1 from the RSA FTP site (ftp://ftp.rsasecurity.com/pub/pkcs/pkcs-1/
Paul Kehrer1681a692014-02-11 23:43:51 -060021 and ftp://ftp.rsa.com/pub/rsalabs/tmp/).
Paul Kehrer7f0039c2014-03-03 22:32:11 -040022* RSA FIPS 186-2 and PKCS1 v1.5 vulnerability test vectors from `NIST CAVP`_.
Alex Stapleton07c6a392014-04-02 11:05:30 +010023* FIPS 186-2 and FIPS 186-3 DSA test vectors from `NIST CAVP`_.
24* FIPS 186-2 and FIPS 186-3 ECDSA test vectors from `NIST CAVP`_.
Simo Sorce83e563e2015-05-06 10:56:31 -040025* DH and ECDH and ECDH+KDF(17.4) test vectors from `NIST CAVP`_.
Alex Stapleton833a8ea2014-04-02 14:50:56 +010026* Ed25519 test vectors from the `Ed25519 website_`.
Alex Stapletone7da0ab2014-03-02 14:04:33 +000027* OpenSSL PEM RSA serialization vectors from the `OpenSSL example key`_ and
28 `GnuTLS key parsing tests`_.
29* OpenSSL PEM DSA serialization vectors from the `GnuTLS example keys`_.
Alex Stapletonabec8a12014-02-22 16:33:24 +000030* PKCS #8 PEM serialization vectors from
31
Paul Kehrerb525adf2014-09-29 15:18:23 -050032 * GnuTLS: `enc-rsa-pkcs8.pem`_, `enc2-rsa-pkcs8.pem`_,
Alex Gaynor899c3ac2014-11-18 18:45:24 -080033 `unenc-rsa-pkcs8.pem`_, `pkcs12_s2k_pem.c`_. The contents of
34 `enc2-rsa-pkcs8.pem`_ was re-encrypted using a stronger PKCS#8 cipher.
Alex Stapletonabec8a12014-02-22 16:33:24 +000035 * `Botan's ECC private keys`_.
Paul Kehrerb07a0c92015-03-02 13:21:27 -060036* `asymmetric/public/PKCS1/dsa.pub.pem`_ is a PKCS1 DSA public key from the
37 Ruby test suite.
38
Paul Kehrer1681a692014-02-11 23:43:51 -060039
Alex Stapletone0afa5d2015-05-03 18:14:20 +010040Custom asymmetric vectors
Paul Kehrerebc26502014-11-26 19:18:56 -100041~~~~~~~~~~~~~~~~~~~~~~~~~
42
Alex Stapletone0afa5d2015-05-03 18:14:20 +010043.. toctree::
44 :maxdepth: 1
45
46 custom-vectors/secp256k1
47
Paul Kehrer10831a02015-01-03 18:45:04 -060048* ``asymmetric/PEM_Serialization/ec_private_key.pem`` and
49 ``asymmetric/DER_Serialization/ec_private_key.der`` - Contains an Elliptic
Paul Kehrer0498d4c2015-01-01 22:29:12 -060050 Curve key generated by OpenSSL from the curve ``secp256r1``.
Paul Kehrer10831a02015-01-03 18:45:04 -060051* ``asymmetric/PEM_Serialization/ec_private_key_encrypted.pem`` and
52 ``asymmetric/DER_Serialization/ec_private_key_encrypted.der``- Contains the
Paul Kehrer0498d4c2015-01-01 22:29:12 -060053 same Elliptic Curve key as ``ec_private_key.pem``, except that it is
54 encrypted with AES-128 with the password "123456".
Paul Kehrer10831a02015-01-03 18:45:04 -060055* ``asymmetric/PEM_Serialization/ec_public_key.pem`` and
56 ``asymmetric/DER_Serialization/ec_public_key.der``- Contains the public key
Paul Kehrer0498d4c2015-01-01 22:29:12 -060057 corresponding to ``ec_private_key.pem``, generated using OpenSSL.
58* ``asymmetric/PEM_Serialization/rsa_private_key.pem`` - Contains an RSA 2048
59 bit key generated using OpenSSL, protected by the secret "123456" with DES3
60 encryption.
Paul Kehrer10831a02015-01-03 18:45:04 -060061* ``asymmetric/PEM_Serialization/rsa_public_key.pem`` and
62 ``asymmetric/DER_Serialization/rsa_public_key.der``- Contains an RSA 2048
Paul Kehrer0498d4c2015-01-01 22:29:12 -060063 bit public generated using OpenSSL from ``rsa_private_key.pem``.
64* ``asymmetric/PEM_Serialization/dsaparam.pem`` - Contains 2048-bit DSA
65 parameters generated using OpenSSL; contains no keys.
66* ``asymmetric/PEM_Serialization/dsa_private_key.pem`` - Contains a DSA 2048
67 bit key generated using OpenSSL from the parameters in ``dsaparam.pem``,
68 protected by the secret "123456" with DES3 encryption.
Paul Kehrer10831a02015-01-03 18:45:04 -060069* ``asymmetric/PEM_Serialization/dsa_public_key.pem`` and
70 ``asymmetric/DER_Serialization/dsa_public_key.der`` - Contains a DSA 2048 bit
Paul Kehrer0498d4c2015-01-01 22:29:12 -060071 key generated using OpenSSL from ``dsa_private_key.pem``.
Paul Kehrer4b8abc32015-01-06 14:46:15 +000072* ``asymmetric/PKCS8/unenc-dsa-pkcs8.pem`` and
Paul Kehrer10831a02015-01-03 18:45:04 -060073 ``asymmetric/DER_Serialization/unenc-dsa-pkcs8.der`` - Contains a DSA 1024
Paul Kehrera36661e2015-01-04 07:57:40 -060074 bit key generated using OpenSSL.
Paul Kehrer4b8abc32015-01-06 14:46:15 +000075* ``asymmetric/PKCS8/unenc-dsa-pkcs8.pub.pem`` and
Paul Kehrer10831a02015-01-03 18:45:04 -060076 ``asymmetric/DER_Serialization/unenc-dsa-pkcs8.pub.der`` - Contains a DSA
Paul Kehrera673dcc2015-01-03 23:26:01 -060077 2048 bit public key generated using OpenSSL from ``unenc-dsa-pkcs8.pem``.
Paul Kehrer10831a02015-01-03 18:45:04 -060078* DER conversions of the `GnuTLS example keys`_ for DSA as well as the
79 `OpenSSL example key`_ for RSA.
80* DER conversions of `enc-rsa-pkcs8.pem`_, `enc2-rsa-pkcs8.pem`_, and
81 `unenc-rsa-pkcs8.pem`_.
Paul Kehrer6d977422015-03-02 19:38:34 -060082* ``asymmetric/public/PKCS1/rsa.pub.pem`` and
83 ``asymmetric/public/PKCS1/rsa.pub.der`` are PKCS1 conversions of the public
84 key from ``asymmetric/PKCS8/unenc-rsa-pkcs8.pem`` using PEM and DER encoding.
Paul Kehrerebc26502014-11-26 19:18:56 -100085
Alex Stapletone0afa5d2015-05-03 18:14:20 +010086
Alex Stapleton91ca3432015-04-12 20:06:39 +010087Key exchange
88~~~~~~~~~~~~
89
90* ``vectors/cryptography_vectors/asymmetric/DH/RFC5114.txt`` contains
91 Diffie-Hellman examples from appendix A.1, A.2 and A.3 of :rfc:`5114`.
92
Paul Kehrerbab4e392014-11-24 11:48:17 -100093X.509
94~~~~~
95
96* PKITS test suite from `NIST PKI Testing`_.
Paul Kehrerebc26502014-11-26 19:18:56 -100097* ``v1_cert.pem`` from the OpenSSL source tree (`testx509.pem`_).
98* ``ecdsa_root.pem`` - `DigiCert Global Root G3`_, a ``secp384r1`` ECDSA root
99 certificate.
Paul Kehrerb01622d2015-02-13 11:59:15 -0600100* ``verisign-md2-root.pem`` - A legacy Verisign public root signed using the
Paul Kehrer2b6ba0c2015-02-14 18:58:20 -0600101 MD2 algorithm. This is a PEM conversion of the `root data`_ in the NSS source
102 tree.
Paul Kehrere0eafaa2015-03-20 22:33:37 -0500103* ``cryptography.io.pem`` - A leaf certificate issued by RapidSSL for the
104 cryptography website.
Paul Kehrer4113d5b2015-08-05 17:42:43 +0100105* ``rapidssl_sha256_ca_g3.pem`` - The intermediate CA that issued the
106 ``cryptography.io.pem`` certificate.
Paul Kehrere651b7f2015-06-23 08:31:15 -0500107* ``wildcard_san.pem`` - A leaf certificate issued by a public CA for
108 ``langui.sh`` that contains wildcard entries in the SAN extension.
Paul Kehrer0ed3d912015-07-04 16:48:08 -0500109* ``san_edipartyname.der`` - A DSA certificate from a `Mozilla bug`_
110 containing a SAN extension with an ``ediPartyName`` general name.
111* ``san_x400address.der`` - A DSA certificate from a `Mozilla bug`_ containing
112 a SAN extension with an ``x400Address`` general name.
Alex Gaynor0ab8e9e2016-02-26 12:29:56 -0500113* ``department-of-state-root.pem`` - The intermediary CA for the Department of
114 State, issued by the United States Federal Government's Common Policy CA.
115 Notably has a ``critical`` policy constraints extensions.
Paul Kehrerd3c21ca2016-03-11 23:38:00 -0400116* ``e-trust.ru.der`` - A certificate from a `Russian CA`_ signed using the GOST
117 cipher and containing numerous unusual encodings such as NUMERICSTRING in
118 the subject DN.
Paul Kehrerebc26502014-11-26 19:18:56 -1000119
120Custom X.509 Vectors
121~~~~~~~~~~~~~~~~~~~~
122
123* ``invalid_version.pem`` - Contains an RSA 2048 bit certificate with the
124 X.509 version field set to ``0x7``.
125* ``post2000utctime.pem`` - Contains an RSA 2048 bit certificate with the
126 ``notBefore`` and ``notAfter`` fields encoded as post-2000 ``UTCTime``.
Paul Kehrera850c612014-12-12 14:21:18 -0600127* ``dsa_selfsigned_ca.pem`` - Contains a DSA self-signed CA certificate
128 generated using OpenSSL.
Paul Kehrerd317bae2014-12-12 11:42:31 -0600129* ``ec_no_named_curve.pem`` - Contains an ECDSA certificate that does not have
130 an embedded OID defining the curve.
Paul Kehrer22217202015-01-17 21:26:28 -0600131* ``all_supported_names.pem`` - An RSA 2048 bit certificate generated using
132 OpenSSL that contains a subject and issuer that have two of each supported
133 attribute type from :rfc:`5280`.
Paul Kehrer1207d152015-01-17 21:31:42 -0600134* ``unsupported_subject_name.pem`` - An RSA 2048 bit self-signed CA certificate
135 generated using OpenSSL that contains the unsupported "initials" name.
Paul Kehrer6392b4b2015-01-17 22:20:01 -0600136* ``utf8_common_name.pem`` - An RSA 2048 bit self-signed CA certificate
137 generated using OpenSSL that contains a UTF8String common name with the value
138 "We heart UTF8!â„¢".
Paul Kehrere0eafaa2015-03-20 22:33:37 -0500139* ``two_basic_constraints.pem`` - An RSA 2048 bit self-signed certificate
140 containing two basic constraints extensions.
141* ``basic_constraints_not_critical.pem`` - An RSA 2048 bit self-signed
142 certificate containing a basic constraints extension that is not marked as
143 critical.
Paul Kehrerd1ed6732015-03-25 00:17:36 -0500144* ``bc_path_length_zero.pem`` - An RSA 2048 bit self-signed
145 certificate containing a basic constraints extension with a path length of
146 zero.
Paul Kehrerb2e6c832015-03-27 22:19:13 -0500147* ``unsupported_extension.pem`` - An RSA 2048 bit self-signed certificate
148 containing an unsupported extension type. The OID was encoded as
149 "1.2.3.4" with an ``extnValue`` of "value".
Paul Kehrer249d9be2015-12-30 09:52:56 -0600150* ``unsupported_extension_2.pem`` - A ``secp256r1`` certificate
151 containing two unsupported extensions. The OIDs are ``1.3.6.1.4.1.41482.2``
152 with an ``extnValue`` of ``1.3.6.1.4.1.41482.1.2`` and
153 ``1.3.6.1.4.1.45724.2.1.1`` with an ``extnValue`` of ``\x03\x02\x040``
Paul Kehrerf5ac6c62015-03-27 23:27:00 -0500154* ``unsupported_extension_critical.pem`` - An RSA 2048 bit self-signed
155 certificate containing an unsupported extension type marked critical. The OID
156 was encoded as "1.2.3.4" with an ``extnValue`` of "value".
Paul Kehrer2e3c7092015-03-27 10:24:05 -0500157* ``san_email_dns_ip_dirname_uri.pem`` - An RSA 2048 bit self-signed
158 certificate containing a subject alternative name extension with the
159 following general names: ``rfc822Name``, ``dNSName``, ``iPAddress``,
160 ``directoryName``, and ``uniformResourceIdentifier``.
Dominic Chen87bb9572015-10-09 00:23:07 -0400161* ``san_empty_hostname.pem`` - An RSA 2048 bit self-signed certificate
162 containing a subject alternative extension with an empty ``dNSName``
163 general name.
Paul Kehrer2e3c7092015-03-27 10:24:05 -0500164* ``san_other_name.pem`` - An RSA 2048 bit self-signed certificate containing
165 a subject alternative name extension with the ``otherName`` general name.
166* ``san_registered_id.pem`` - An RSA 1024 bit certificate containing a
167 subject alternative name extension with the ``registeredID`` general name.
Paul Kehrerc88bce52015-04-02 19:32:45 -0500168* ``all_key_usages.pem`` - An RSA 2048 bit self-signed certificate containing
169 a key usage extension with all nine purposes set to true.
Paul Kehrer986e5fa2015-05-01 23:24:10 -0500170* ``extended_key_usage.pem`` - An RSA 2048 bit self-signed certificate
171 containing an extended key usage extension with eight usages.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500172* ``san_idna_names.pem`` - An RSA 2048 bit self-signed certificate containing
173 a subject alternative name extension with ``rfc822Name``, ``dNSName``, and
174 ``uniformResourceIdentifier`` general names with IDNA (:rfc:`5895`) encoding.
Paul Kehrer3f0522f2015-06-26 18:46:19 -0500175* ``san_wildcard_idna.pem`` - An RSA 2048 bit self-signed certificate
176 containing a subject alternative name extension with a ``dNSName`` general
177 name with a wildcard IDNA (:rfc:`5895`) domain.
Paul Kehrerd0a66e72015-05-15 08:50:50 -0700178* ``san_idna2003_dnsname.pem`` - An RSA 2048 bit self-signed certificate
179 containing a subject alternative name extension with an IDNA 2003
180 (:rfc:`3490`) ``dNSName``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500181* ``san_rfc822_names.pem`` - An RSA 2048 bit self-signed certificate containing
182 a subject alternative name extension with various ``rfc822Name`` values.
Paul Kehrer60163d72015-04-29 21:23:14 -0500183* ``san_rfc822_idna.pem`` - An RSA 2048 bit self-signed certificate containing
184 a subject alternative name extension with an IDNA ``rfc822Name``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500185* ``san_uri_with_port.pem`` - An RSA 2048 bit self-signed certificate
186 containing a subject alternative name extension with various
187 ``uniformResourceIdentifier`` values.
Paul Kehrerfbc62192015-04-29 21:37:42 -0500188* ``san_ipaddr.pem`` - An RSA 2048 bit self-signed certificate containing a
189 subject alternative name extension with an ``iPAddress`` value.
190* ``san_dirname.pem`` - An RSA 2048 bit self-signed certificate containing a
191 subject alternative name extension with a ``directoryName`` value.
Paul Kehrer67a62c82015-05-01 23:15:58 -0500192* ``inhibit_any_policy_5.pem`` - An RSA 2048 bit self-signed certificate
193 containing an inhibit any policy extension with the value 5.
194* ``inhibit_any_policy_negative.pem`` - An RSA 2048 bit self-signed certificate
195 containing an inhibit any policy extension with the value -1.
Paul Kehrerb0deb442015-05-03 10:53:45 -0500196* ``authority_key_identifier.pem`` - An RSA 2048 bit self-signed certificate
197 containing an authority key identifier extension with key identifier,
198 authority certificate issuer, and authority certificate serial number fields.
Paul Kehrer0d52e2a2015-05-03 11:17:12 -0500199* ``authority_key_identifier_no_keyid.pem`` - An RSA 2048 bit self-signed
200 certificate containing an authority key identifier extension with authority
201 certificate issuer and authority certificate serial number fields.
Paul Kehrer64c82e02015-05-04 17:38:52 -0500202* ``aia_ocsp_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
203 containing an authority information access extension with two OCSP and one
204 CA issuers entry.
205* ``aia_ocsp.pem`` - An RSA 2048 bit self-signed certificate
206 containing an authority information access extension with an OCSP entry.
207* ``aia_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
208 containing an authority information access extension with a CA issuers entry.
Dominic Chen87bb9572015-10-09 00:23:07 -0400209* ``cdp_empty_hostname.pem`` - An RSA 2048 bit self-signed certificate
210 containing a CRL distribution point extension with ``fullName`` URI without
211 a hostname.
Paul Kehrer28d54212015-05-10 14:58:21 -0500212* ``cdp_fullname_reasons_crl_issuer.pem`` - An RSA 1024 bit certificate
213 containing a CRL distribution points extension with ``fullName``,
214 ``cRLIssuer``, and ``reasons`` data.
215* ``cdp_crl_issuer.pem`` - An RSA 1024 bit certificate containing a CRL
216 distribution points extension with ``cRLIssuer`` data.
Paul Kehrer208d6782015-05-12 23:09:13 -0500217* ``cdp_all_reasons.pem`` - An RSA 1024 bit certificate containing a CRL
218 distribution points extension with all ``reasons`` bits set.
219* ``cdp_reason_aa_compromise.pem`` - An RSA 1024 bit certificate containing a
220 CRL distribution points extension with the ``AACompromise`` ``reasons`` bit
221 set.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600222* ``nc_permitted_excluded.pem`` - An RSA 2048 bit self-signed certificate
223 containing a name constraints extension with both permitted and excluded
Paul Kehrer7155c982015-06-29 07:53:54 -0500224 elements. Contains ``IPv4`` and ``IPv6`` addresses with network mask as well
225 as ``dNSName`` with a leading period.
226* ``nc_permitted_excluded_2.pem`` - An RSA 2048 bit self-signed certificate
227 containing a name constraints extension with both permitted and excluded
228 elements. Unlike ``nc_permitted_excluded.pem``, the general names do not
229 contain any name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600230* ``nc_permitted.pem`` - An RSA 2048 bit self-signed certificate containing a
231 name constraints extension with permitted elements.
Paul Kehrer7155c982015-06-29 07:53:54 -0500232* ``nc_permitted_2.pem`` - An RSA 2048 bit self-signed certificate containing a
233 name constraints extension with permitted elements that do not contain any
234 name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600235* ``nc_excluded.pem`` - An RSA 2048 bit self-signed certificate containing a
236 name constraints extension with excluded elements.
Paul Kehrer5d3f7b72015-06-28 00:39:21 -0500237* ``nc_invalid_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
238 containing a name constraints extension with a permitted element that has an
239 ``IPv6`` IP and an invalid network mask.
Paul Kehrer8f458ab2015-07-01 21:17:17 -0500240* ``nc_single_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
241 containing a name constraints extension with a permitted element that has two
242 IPs with ``/32`` and ``/128`` network masks.
Paul Kehrercdfe0f92015-05-11 20:00:29 -0500243* ``cp_user_notice_with_notice_reference.pem`` - An RSA 2048 bit self-signed
244 certificate containing a certificate policies extension with a
245 notice reference in the user notice.
246* ``cp_user_notice_with_explicit_text.pem`` - An RSA 2048 bit self-signed
247 certificate containing a certificate policies extension with explicit
248 text and no notice reference.
249* ``cp_cps_uri.pem`` - An RSA 2048 bit self-signed certificate containing a
250 certificate policies extension with a CPS URI and no user notice.
Paul Kehrer5ac41542015-05-12 16:04:52 -0500251* ``cp_user_notice_no_explicit_text.pem`` - An RSA 2048 bit self-signed
252 certificate containing a certificate policies extension with a user notice
253 with no explicit text.
Paul Kehrer0f984362015-08-01 20:45:08 +0100254* ``cp_invalid.pem`` - An RSA 2048 bit self-signed certificate containing a
255 certificate policies extension with invalid data.
Paul Kehrer769e7f22015-06-17 22:28:29 -0600256* ``ian_uri.pem`` - An RSA 2048 bit certificate containing an issuer
257 alternative name extension with a ``URI`` general name.
Paul Kehrerd59b07c2015-06-07 18:51:50 -0500258* ``ocsp_nocheck.pem`` - An RSA 2048 bit self-signed certificate containing
259 an ``OCSPNoCheck`` extension.
Paul Kehrer77335622015-06-17 21:52:32 -0600260* ``pc_inhibit_require.pem`` - An RSA 2048 bit self-signed certificate
261 containing a policy constraints extension with both inhibit policy mapping
262 and require explicit policy elements.
263* ``pc_inhibit.pem`` - An RSA 2048 bit self-signed certificate containing a
264 policy constraints extension with an inhibit policy mapping element.
265* ``pc_require.pem`` - An RSA 2048 bit self-signed certificate containing a
266 policy constraints extension with a require explicit policy element.
Alex Gaynor96605fc2015-10-10 09:03:07 -0400267* ``unsupported_subject_public_key_info.pem`` - A certificate whose public key
268 is an unknown OID (``1.3.6.1.4.1.8432.1.1.2``).
Paul Kehrer4a6e2de2016-02-27 10:31:17 -0600269* ``policy_constraints_explicit.pem`` - A self-signed certificate containing
270 a ``policyConstraints`` extension with a ``requireExplicitPolicy`` value.
Paul Kehrerff2167a2015-02-24 10:45:41 -0600271
272Custom X.509 Request Vectors
273~~~~~~~~~~~~~~~~~~~~~~~~~~~~
274
Paul Kehrer89e4c952015-03-30 15:15:00 -0500275* ``dsa_sha1.pem`` and ``dsa_sha1.der`` - Contain a certificate request using
276 1024-bit DSA parameters and SHA1 generated using OpenSSL.
277* ``rsa_md4.pem`` and ``rsa_md4.der`` - Contain a certificate request using
278 2048 bit RSA and MD4 generated using OpenSSL.
279* ``rsa_sha1.pem`` and ``rsa_sha1.der`` - Contain a certificate request using
280 2048 bit RSA and SHA1 generated using OpenSSL.
281* ``rsa_sha256.pem`` and ``rsa_sha256.der`` - Contain a certificate request
282 using 2048 bit RSA and SHA256 generated using OpenSSL.
283* ``ec_sha256.pem`` and ``ec_sha256.der`` - Contain a certificate request
284 using EC (``secp384r1``) and SHA256 generated using OpenSSL.
Paul Kehrer0c518be2015-03-30 21:10:51 -0500285* ``san_rsa_sha1.pem`` and ``san_rsa_sha1.der`` - Contain a certificate
286 request using RSA and SHA1 with a subject alternative name extension
287 generated using OpenSSL.
Andre Caron2b54fb02015-05-16 10:20:51 -0400288* ``two_basic_constraints.pem`` - A certificate signing request
Joern Heissler1bd77e22016-01-13 22:51:37 +0100289 for an RSA 2048 bit key containing two basic constraints extensions.
Andre Caron2b54fb02015-05-16 10:20:51 -0400290* ``unsupported_extension.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400291 for an RSA 2048 bit key containing containing an unsupported
292 extension type. The OID was encoded as "1.2.3.4" with an
293 ``extnValue`` of "value".
Andre Caron2b54fb02015-05-16 10:20:51 -0400294* ``unsupported_extension_critical.pem`` - A certificate signing
Andre Caron6cfe79b2015-05-16 08:41:52 -0400295 request for an RSA 2048 bit key containing containing an unsupported
296 extension type marked critical. The OID was encoded as "1.2.3.4"
297 with an ``extnValue`` of "value".
Joern Heissler1bd77e22016-01-13 22:51:37 +0100298* ``basic_constraints.pem`` - A certificate signing request for an RSA
Andre Caronc97ca7e2015-05-16 22:16:44 -0400299 2048 bit key containing a basic constraints extension marked as
300 critical.
Joern Heissler1bd77e22016-01-13 22:51:37 +0100301* ``invalid_signature.pem`` - A certificate signing request for an RSA
302 1024 bit key containing an invalid signature with correct padding.
Paul Kehrerbab4e392014-11-24 11:48:17 -1000303
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700304Custom X.509 Certificate Revocation List Vectors
305~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
306
307* ``crl_all_reasons.pem`` - Contains a CRL with 12 revoked certificates, whose
308 serials match their list position. It includes one revocation without
Erik Trauschke70d31382015-05-29 14:29:28 -0700309 any entry extensions, 10 revocations with every supported reason code and one
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700310 revocation with an unsupported, non-critical entry extension with the OID
311 value set to "1.2.3.4".
312* ``crl_dup_entry_ext.pem`` - Contains a CRL with one revocation which has a
313 duplicate entry extension.
314* ``crl_md2_unknown_crit_entry_ext.pem`` - Contains a CRL with one revocation
315 which contains an unsupported critical entry extension with the OID value set
316 to "1.2.3.4". The CRL uses an unsupported MD2 signature algorithm.
317* ``crl_unsupported_reason.pem`` - Contains a CRL with one revocation which has
318 an unsupported reason code.
Erik Trauschkea6c82592015-10-15 21:10:20 -0700319* ``crl_inval_cert_issuer_entry_ext.pem`` - Contains a CRL with one revocation
320 which has one entry extension for certificate issuer with an empty value.
Paul Kehrer9543a332015-12-20 18:48:24 -0600321* ``crl_empty.pem`` - Contains a CRL with no revoked certificates.
Paul Kehrer93df8b72015-12-22 17:16:13 -0600322* ``crl_ian_aia_aki.pem`` - Contains a CRL with ``IssuerAlternativeName``,
323 ``AuthorityInformationAccess``, ``AuthorityKeyIdentifier`` and ``CRLNumber``
324 extensions.
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700325
Paul Kehrer1681a692014-02-11 23:43:51 -0600326Hashes
327~~~~~~
328
329* MD5 from :rfc:`1321`.
330* RIPEMD160 from the `RIPEMD website`_.
331* SHA1 from `NIST CAVP`_.
332* SHA2 (224, 256, 384, 512) from `NIST CAVP`_.
333* Whirlpool from the `Whirlpool website`_.
Terry Chia7e6afe82016-04-09 22:04:12 +0800334* Blake2s and Blake2b from OpenSSL `test/evptests.txt`_.
Paul Kehrer1681a692014-02-11 23:43:51 -0600335
336HMAC
337~~~~
338
339* HMAC-MD5 from :rfc:`2202`.
340* HMAC-SHA1 from :rfc:`2202`.
341* HMAC-RIPEMD160 from :rfc:`2286`.
342* HMAC-SHA2 (224, 256, 384, 512) from :rfc:`4231`.
343
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000344Key derivation functions
Paul Kehrer1681a692014-02-11 23:43:51 -0600345~~~~~~~~~~~~~~~~~~~~~~~~
346
347* HKDF (SHA1, SHA256) from :rfc:`5869`.
348* PBKDF2 (HMAC-SHA1) from :rfc:`6070`.
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800349* scrypt from the `draft RFC`_.
Simo Sorcee69da952015-09-15 11:16:56 -0400350* X9.63 KDF from `NIST CAVP`_.
Jared Messengerfac4d642016-03-14 14:27:09 -0700351* SP 800-108 Counter Mode KDF (HMAC-SHA1, HMAC-SHA224, HMAC-SHA256,
352 HMAC-SHA384, HMAC-SHA512) from `NIST CAVP`_.
Paul Kehrer1681a692014-02-11 23:43:51 -0600353
Paul Kehrer16430f92015-03-15 09:06:25 -0500354Key wrapping
355~~~~~~~~~~~~
356
357* AES key wrap (AESKW) and 3DES key wrap test vectors from `NIST CAVP`_.
358
Paul Kehrer1681a692014-02-11 23:43:51 -0600359Recipes
360~~~~~~~
361
362* Fernet from its `specification repository`_.
363
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000364Symmetric ciphers
Paul Kehrer1681a692014-02-11 23:43:51 -0600365~~~~~~~~~~~~~~~~~
366
Paul Kehrere547d8f2014-02-15 21:37:52 -0600367* AES (CBC, CFB, ECB, GCM, OFB) from `NIST CAVP`_.
368* AES CTR from :rfc:`3686`.
Paul Kehrer1681a692014-02-11 23:43:51 -0600369* 3DES (CBC, CFB, ECB, OFB) from `NIST CAVP`_.
Ehren Krete23c0b72015-11-28 02:40:33 -0800370* ARC4 (KEY-LENGTH: 40, 56, 64, 80, 128, 192, 256) from :rfc:`6229`.
371* ARC4 (KEY-LENGTH: 160) generated by this project.
372 See: :doc:`/development/custom-vectors/arc4`
Paul Kehrer1681a692014-02-11 23:43:51 -0600373* Blowfish (CBC, CFB, ECB, OFB) from `Bruce Schneier's vectors`_.
374* Camellia (ECB) from NTT's `Camellia page`_ as linked by `CRYPTREC`_.
375* Camellia (CBC, CFB, OFB) from `OpenSSL's test vectors`_.
376* CAST5 (ECB) from :rfc:`2144`.
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600377* CAST5 (CBC, CFB, OFB) generated by this project.
378 See: :doc:`/development/custom-vectors/cast5`
Paul Kehrerb09622c2014-02-16 19:32:04 -0600379* IDEA (ECB) from the `NESSIE IDEA vectors`_ created by `NESSIE`_.
380* IDEA (CBC, CFB, OFB) generated by this project.
381 See: :doc:`/development/custom-vectors/idea`
Paul Kehrer1d0f9732014-04-08 08:44:25 -0500382* SEED (ECB) from :rfc:`4269`.
Paul Kehrerf0e12ac2014-04-08 08:59:40 -0500383* SEED (CBC) from :rfc:`4196`.
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500384* SEED (CFB, OFB) generated by this project.
385 See: :doc:`/development/custom-vectors/seed`
Paul Kehrer1681a692014-02-11 23:43:51 -0600386
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000387Two factor authentication
Ayrx933dd682014-02-18 23:26:11 +0800388~~~~~~~~~~~~~~~~~~~~~~~~~
389
390* HOTP from :rfc:`4226`
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800391* TOTP from :rfc:`6238` (Note that an `errata`_ for the test vectors in RFC
392 6238 exists)
Ayrx933dd682014-02-18 23:26:11 +0800393
Ayrx1d6b77b2014-04-10 23:11:03 +0800394CMAC
395~~~~
396
Ayrxfa52e6a2014-04-14 22:26:21 +0800397* AES-128, AES-192, AES-256, 3DES from `NIST SP-800-38B`_
Ayrx1d6b77b2014-04-10 23:11:03 +0800398
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000399Creating test vectors
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600400---------------------
401
402When official vectors are unavailable ``cryptography`` may choose to build
Paul Kehrer9f7ad192014-09-24 21:54:39 -0500403its own using existing vectors as source material.
michael-hart59f72192014-09-24 11:31:20 +0100404
Paul Kehrerebc26502014-11-26 19:18:56 -1000405Custom Symmetric Vectors
406~~~~~~~~~~~~~~~~~~~~~~~~
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600407
408.. toctree::
409 :maxdepth: 1
410
Ehren Kret6c83cc62015-11-28 03:24:15 -0800411 custom-vectors/arc4
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600412 custom-vectors/cast5
Paul Kehrerb09622c2014-02-16 19:32:04 -0600413 custom-vectors/idea
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500414 custom-vectors/seed
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600415
416If official test vectors appear in the future the custom generated vectors
417should be discarded.
418
419Any vectors generated by this method must also be prefixed with the following
420header format (substituting the correct information):
421
422.. code-block:: python
423
424 # CAST5 CBC vectors built for https://github.com/pyca/cryptography
425 # Derived from the AESVS MMT test data for CBC
426 # Verified against the CommonCrypto and Go crypto packages
427 # Key Length : 128
428
Paul Kehrer1681a692014-02-11 23:43:51 -0600429.. _`NIST`: http://www.nist.gov/
430.. _`IETF`: https://www.ietf.org/
431.. _`NIST CAVP`: http://csrc.nist.gov/groups/STM/cavp/
432.. _`Bruce Schneier's vectors`: https://www.schneier.com/code/vectors.txt
Alex Gaynor4566cb92015-10-02 06:40:05 -0700433.. _`Camellia page`: https://info.isl.ntt.co.jp/crypt/eng/camellia/
Alex Gaynor6422d832016-03-06 21:40:57 -0500434.. _`CRYPTREC`: https://www.cryptrec.go.jp
Paul Kehrer1681a692014-02-11 23:43:51 -0600435.. _`OpenSSL's test vectors`: https://github.com/openssl/openssl/blob/97cf1f6c2854a3a955fd7dd3a1f113deba00c9ef/crypto/evp/evptests.txt#L232
436.. _`RIPEMD website`: http://homes.esat.kuleuven.be/~bosselae/ripemd160.html
437.. _`Whirlpool website`: http://www.larc.usp.br/~pbarreto/WhirlpoolPage.html
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800438.. _`draft RFC`: https://tools.ietf.org/html/draft-josefsson-scrypt-kdf-01
Paul Kehrer1681a692014-02-11 23:43:51 -0600439.. _`Specification repository`: https://github.com/fernet/spec
Alex Gaynor3197ab52015-10-02 06:33:11 -0700440.. _`errata`: https://www.rfc-editor.org/errata_search.php?rfc=6238
Paul Kehrer5e9a8a32015-03-02 13:25:45 -0600441.. _`OpenSSL example key`: https://github.com/openssl/openssl/blob/d02b48c63a58ea4367a0e905979f140b7d090f86/test/testrsa.pem
Paul Kehrerdac86a92015-03-06 08:36:07 -0600442.. _`GnuTLS key parsing tests`: https://gitlab.com/gnutls/gnutls/commit/f16ef39ef0303b02d7fa590a37820440c466ce8d
443.. _`enc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/encpkcs8.pem
444.. _`enc2-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/enc2pkcs8.pem
445.. _`unenc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/unencpkcs8.pem
446.. _`pkcs12_s2k_pem.c`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs12_s2k_pem.c
Alex Stapletonabec8a12014-02-22 16:33:24 +0000447.. _`Botan's ECC private keys`: https://github.com/randombit/botan/tree/4917f26a2b154e841cd27c1bcecdd41d2bdeb6ce/src/tests/data/ecc
Alex Gaynor3efbf492015-03-09 07:13:22 -0400448.. _`GnuTLS example keys`: https://gitlab.com/gnutls/gnutls/commit/ad2061deafdd7db78fd405f9d143b0a7c579da7b
Paul Kehrerb09622c2014-02-16 19:32:04 -0600449.. _`NESSIE IDEA vectors`: https://www.cosic.esat.kuleuven.be/nessie/testvectors/bc/idea/Idea-128-64.verified.test-vectors
450.. _`NESSIE`: https://en.wikipedia.org/wiki/NESSIE
Alex Stapleton833a8ea2014-04-02 14:50:56 +0100451.. _`Ed25519 website`: http://ed25519.cr.yp.to/software.html
Ayrx40afce02014-04-13 19:17:52 +0800452.. _`NIST SP-800-38B`: http://csrc.nist.gov/publications/nistpubs/800-38B/Updated_CMAC_Examples.pdf
Paul Kehrerbab4e392014-11-24 11:48:17 -1000453.. _`NIST PKI Testing`: http://csrc.nist.gov/groups/ST/crypto_apps_infra/pki/pkitesting.html
Paul Kehrerebc26502014-11-26 19:18:56 -1000454.. _`testx509.pem`: https://github.com/openssl/openssl/blob/master/test/testx509.pem
455.. _`DigiCert Global Root G3`: http://cacerts.digicert.com/DigiCertGlobalRootG3.crt
Paul Kehrer2b6ba0c2015-02-14 18:58:20 -0600456.. _`root data`: https://hg.mozilla.org/projects/nss/file/25b2922cc564/security/nss/lib/ckfw/builtins/certdata.txt#l2053
Paul Kehrerb07a0c92015-03-02 13:21:27 -0600457.. _`asymmetric/public/PKCS1/dsa.pub.pem`: https://github.com/ruby/ruby/blob/4ccb387f3bc436a08fc6d72c4931994f5de95110/test/openssl/test_pkey_dsa.rb#L53
Paul Kehrer0ed3d912015-07-04 16:48:08 -0500458.. _`Mozilla bug`: https://bugzilla.mozilla.org/show_bug.cgi?id=233586
Paul Kehrerd3c21ca2016-03-11 23:38:00 -0400459.. _`Russian CA`: http://e-trust.gosuslugi.ru/MainCA
Terry Chia7e6afe82016-04-09 22:04:12 +0800460.. _`test/evptests.txt`: https://github.com/openssl/openssl/blob/2d0b44126763f989a4cbffbffe9d0c7518158bb7/test/evptests.txt