blob: 98e8d5118d5f582fe3e3549340edb8017ffe849c [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.
Paul Kehrerebc26502014-11-26 19:18:56 -1000113
114Custom X.509 Vectors
115~~~~~~~~~~~~~~~~~~~~
116
117* ``invalid_version.pem`` - Contains an RSA 2048 bit certificate with the
118 X.509 version field set to ``0x7``.
119* ``post2000utctime.pem`` - Contains an RSA 2048 bit certificate with the
120 ``notBefore`` and ``notAfter`` fields encoded as post-2000 ``UTCTime``.
Paul Kehrera850c612014-12-12 14:21:18 -0600121* ``dsa_selfsigned_ca.pem`` - Contains a DSA self-signed CA certificate
122 generated using OpenSSL.
Paul Kehrerd317bae2014-12-12 11:42:31 -0600123* ``ec_no_named_curve.pem`` - Contains an ECDSA certificate that does not have
124 an embedded OID defining the curve.
Paul Kehrer22217202015-01-17 21:26:28 -0600125* ``all_supported_names.pem`` - An RSA 2048 bit certificate generated using
126 OpenSSL that contains a subject and issuer that have two of each supported
127 attribute type from :rfc:`5280`.
Paul Kehrer1207d152015-01-17 21:31:42 -0600128* ``unsupported_subject_name.pem`` - An RSA 2048 bit self-signed CA certificate
129 generated using OpenSSL that contains the unsupported "initials" name.
Paul Kehrer6392b4b2015-01-17 22:20:01 -0600130* ``utf8_common_name.pem`` - An RSA 2048 bit self-signed CA certificate
131 generated using OpenSSL that contains a UTF8String common name with the value
132 "We heart UTF8!â„¢".
Paul Kehrere0eafaa2015-03-20 22:33:37 -0500133* ``two_basic_constraints.pem`` - An RSA 2048 bit self-signed certificate
134 containing two basic constraints extensions.
135* ``basic_constraints_not_critical.pem`` - An RSA 2048 bit self-signed
136 certificate containing a basic constraints extension that is not marked as
137 critical.
Paul Kehrerd1ed6732015-03-25 00:17:36 -0500138* ``bc_path_length_zero.pem`` - An RSA 2048 bit self-signed
139 certificate containing a basic constraints extension with a path length of
140 zero.
Paul Kehrerb2e6c832015-03-27 22:19:13 -0500141* ``unsupported_extension.pem`` - An RSA 2048 bit self-signed certificate
142 containing an unsupported extension type. The OID was encoded as
143 "1.2.3.4" with an ``extnValue`` of "value".
Paul Kehrerf5ac6c62015-03-27 23:27:00 -0500144* ``unsupported_extension_critical.pem`` - An RSA 2048 bit self-signed
145 certificate containing an unsupported extension type marked critical. The OID
146 was encoded as "1.2.3.4" with an ``extnValue`` of "value".
Paul Kehrer2e3c7092015-03-27 10:24:05 -0500147* ``san_email_dns_ip_dirname_uri.pem`` - An RSA 2048 bit self-signed
148 certificate containing a subject alternative name extension with the
149 following general names: ``rfc822Name``, ``dNSName``, ``iPAddress``,
150 ``directoryName``, and ``uniformResourceIdentifier``.
Dominic Chen87bb9572015-10-09 00:23:07 -0400151* ``san_empty_hostname.pem`` - An RSA 2048 bit self-signed certificate
152 containing a subject alternative extension with an empty ``dNSName``
153 general name.
Paul Kehrer2e3c7092015-03-27 10:24:05 -0500154* ``san_other_name.pem`` - An RSA 2048 bit self-signed certificate containing
155 a subject alternative name extension with the ``otherName`` general name.
156* ``san_registered_id.pem`` - An RSA 1024 bit certificate containing a
157 subject alternative name extension with the ``registeredID`` general name.
Paul Kehrerc88bce52015-04-02 19:32:45 -0500158* ``all_key_usages.pem`` - An RSA 2048 bit self-signed certificate containing
159 a key usage extension with all nine purposes set to true.
Paul Kehrer986e5fa2015-05-01 23:24:10 -0500160* ``extended_key_usage.pem`` - An RSA 2048 bit self-signed certificate
161 containing an extended key usage extension with eight usages.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500162* ``san_idna_names.pem`` - An RSA 2048 bit self-signed certificate containing
163 a subject alternative name extension with ``rfc822Name``, ``dNSName``, and
164 ``uniformResourceIdentifier`` general names with IDNA (:rfc:`5895`) encoding.
Paul Kehrer3f0522f2015-06-26 18:46:19 -0500165* ``san_wildcard_idna.pem`` - An RSA 2048 bit self-signed certificate
166 containing a subject alternative name extension with a ``dNSName`` general
167 name with a wildcard IDNA (:rfc:`5895`) domain.
Paul Kehrerd0a66e72015-05-15 08:50:50 -0700168* ``san_idna2003_dnsname.pem`` - An RSA 2048 bit self-signed certificate
169 containing a subject alternative name extension with an IDNA 2003
170 (:rfc:`3490`) ``dNSName``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500171* ``san_rfc822_names.pem`` - An RSA 2048 bit self-signed certificate containing
172 a subject alternative name extension with various ``rfc822Name`` values.
Paul Kehrer60163d72015-04-29 21:23:14 -0500173* ``san_rfc822_idna.pem`` - An RSA 2048 bit self-signed certificate containing
174 a subject alternative name extension with an IDNA ``rfc822Name``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500175* ``san_uri_with_port.pem`` - An RSA 2048 bit self-signed certificate
176 containing a subject alternative name extension with various
177 ``uniformResourceIdentifier`` values.
Paul Kehrerfbc62192015-04-29 21:37:42 -0500178* ``san_ipaddr.pem`` - An RSA 2048 bit self-signed certificate containing a
179 subject alternative name extension with an ``iPAddress`` value.
180* ``san_dirname.pem`` - An RSA 2048 bit self-signed certificate containing a
181 subject alternative name extension with a ``directoryName`` value.
Paul Kehrer67a62c82015-05-01 23:15:58 -0500182* ``inhibit_any_policy_5.pem`` - An RSA 2048 bit self-signed certificate
183 containing an inhibit any policy extension with the value 5.
184* ``inhibit_any_policy_negative.pem`` - An RSA 2048 bit self-signed certificate
185 containing an inhibit any policy extension with the value -1.
Paul Kehrerb0deb442015-05-03 10:53:45 -0500186* ``authority_key_identifier.pem`` - An RSA 2048 bit self-signed certificate
187 containing an authority key identifier extension with key identifier,
188 authority certificate issuer, and authority certificate serial number fields.
Paul Kehrer0d52e2a2015-05-03 11:17:12 -0500189* ``authority_key_identifier_no_keyid.pem`` - An RSA 2048 bit self-signed
190 certificate containing an authority key identifier extension with authority
191 certificate issuer and authority certificate serial number fields.
Paul Kehrer64c82e02015-05-04 17:38:52 -0500192* ``aia_ocsp_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
193 containing an authority information access extension with two OCSP and one
194 CA issuers entry.
195* ``aia_ocsp.pem`` - An RSA 2048 bit self-signed certificate
196 containing an authority information access extension with an OCSP entry.
197* ``aia_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
198 containing an authority information access extension with a CA issuers entry.
Dominic Chen87bb9572015-10-09 00:23:07 -0400199* ``cdp_empty_hostname.pem`` - An RSA 2048 bit self-signed certificate
200 containing a CRL distribution point extension with ``fullName`` URI without
201 a hostname.
Paul Kehrer28d54212015-05-10 14:58:21 -0500202* ``cdp_fullname_reasons_crl_issuer.pem`` - An RSA 1024 bit certificate
203 containing a CRL distribution points extension with ``fullName``,
204 ``cRLIssuer``, and ``reasons`` data.
205* ``cdp_crl_issuer.pem`` - An RSA 1024 bit certificate containing a CRL
206 distribution points extension with ``cRLIssuer`` data.
Paul Kehrer208d6782015-05-12 23:09:13 -0500207* ``cdp_all_reasons.pem`` - An RSA 1024 bit certificate containing a CRL
208 distribution points extension with all ``reasons`` bits set.
209* ``cdp_reason_aa_compromise.pem`` - An RSA 1024 bit certificate containing a
210 CRL distribution points extension with the ``AACompromise`` ``reasons`` bit
211 set.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600212* ``nc_permitted_excluded.pem`` - An RSA 2048 bit self-signed certificate
213 containing a name constraints extension with both permitted and excluded
Paul Kehrer7155c982015-06-29 07:53:54 -0500214 elements. Contains ``IPv4`` and ``IPv6`` addresses with network mask as well
215 as ``dNSName`` with a leading period.
216* ``nc_permitted_excluded_2.pem`` - An RSA 2048 bit self-signed certificate
217 containing a name constraints extension with both permitted and excluded
218 elements. Unlike ``nc_permitted_excluded.pem``, the general names do not
219 contain any name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600220* ``nc_permitted.pem`` - An RSA 2048 bit self-signed certificate containing a
221 name constraints extension with permitted elements.
Paul Kehrer7155c982015-06-29 07:53:54 -0500222* ``nc_permitted_2.pem`` - An RSA 2048 bit self-signed certificate containing a
223 name constraints extension with permitted elements that do not contain any
224 name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600225* ``nc_excluded.pem`` - An RSA 2048 bit self-signed certificate containing a
226 name constraints extension with excluded elements.
Paul Kehrer5d3f7b72015-06-28 00:39:21 -0500227* ``nc_invalid_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
228 containing a name constraints extension with a permitted element that has an
229 ``IPv6`` IP and an invalid network mask.
Paul Kehrer8f458ab2015-07-01 21:17:17 -0500230* ``nc_single_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
231 containing a name constraints extension with a permitted element that has two
232 IPs with ``/32`` and ``/128`` network masks.
Paul Kehrercdfe0f92015-05-11 20:00:29 -0500233* ``cp_user_notice_with_notice_reference.pem`` - An RSA 2048 bit self-signed
234 certificate containing a certificate policies extension with a
235 notice reference in the user notice.
236* ``cp_user_notice_with_explicit_text.pem`` - An RSA 2048 bit self-signed
237 certificate containing a certificate policies extension with explicit
238 text and no notice reference.
239* ``cp_cps_uri.pem`` - An RSA 2048 bit self-signed certificate containing a
240 certificate policies extension with a CPS URI and no user notice.
Paul Kehrer5ac41542015-05-12 16:04:52 -0500241* ``cp_user_notice_no_explicit_text.pem`` - An RSA 2048 bit self-signed
242 certificate containing a certificate policies extension with a user notice
243 with no explicit text.
Paul Kehrer0f984362015-08-01 20:45:08 +0100244* ``cp_invalid.pem`` - An RSA 2048 bit self-signed certificate containing a
245 certificate policies extension with invalid data.
Paul Kehrer769e7f22015-06-17 22:28:29 -0600246* ``ian_uri.pem`` - An RSA 2048 bit certificate containing an issuer
247 alternative name extension with a ``URI`` general name.
Paul Kehrerd59b07c2015-06-07 18:51:50 -0500248* ``ocsp_nocheck.pem`` - An RSA 2048 bit self-signed certificate containing
249 an ``OCSPNoCheck`` extension.
Paul Kehrer77335622015-06-17 21:52:32 -0600250* ``pc_inhibit_require.pem`` - An RSA 2048 bit self-signed certificate
251 containing a policy constraints extension with both inhibit policy mapping
252 and require explicit policy elements.
253* ``pc_inhibit.pem`` - An RSA 2048 bit self-signed certificate containing a
254 policy constraints extension with an inhibit policy mapping element.
255* ``pc_require.pem`` - An RSA 2048 bit self-signed certificate containing a
256 policy constraints extension with a require explicit policy element.
Alex Gaynor96605fc2015-10-10 09:03:07 -0400257* ``unsupported_subject_public_key_info.pem`` - A certificate whose public key
258 is an unknown OID (``1.3.6.1.4.1.8432.1.1.2``).
Paul Kehrerff2167a2015-02-24 10:45:41 -0600259
260Custom X.509 Request Vectors
261~~~~~~~~~~~~~~~~~~~~~~~~~~~~
262
Paul Kehrer89e4c952015-03-30 15:15:00 -0500263* ``dsa_sha1.pem`` and ``dsa_sha1.der`` - Contain a certificate request using
264 1024-bit DSA parameters and SHA1 generated using OpenSSL.
265* ``rsa_md4.pem`` and ``rsa_md4.der`` - Contain a certificate request using
266 2048 bit RSA and MD4 generated using OpenSSL.
267* ``rsa_sha1.pem`` and ``rsa_sha1.der`` - Contain a certificate request using
268 2048 bit RSA and SHA1 generated using OpenSSL.
269* ``rsa_sha256.pem`` and ``rsa_sha256.der`` - Contain a certificate request
270 using 2048 bit RSA and SHA256 generated using OpenSSL.
271* ``ec_sha256.pem`` and ``ec_sha256.der`` - Contain a certificate request
272 using EC (``secp384r1``) and SHA256 generated using OpenSSL.
Paul Kehrer0c518be2015-03-30 21:10:51 -0500273* ``san_rsa_sha1.pem`` and ``san_rsa_sha1.der`` - Contain a certificate
274 request using RSA and SHA1 with a subject alternative name extension
275 generated using OpenSSL.
Andre Caron2b54fb02015-05-16 10:20:51 -0400276* ``two_basic_constraints.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400277 for a RSA 2048 bit key containing two basic constraints extensions.
Andre Caron2b54fb02015-05-16 10:20:51 -0400278* ``unsupported_extension.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400279 for an RSA 2048 bit key containing containing an unsupported
280 extension type. The OID was encoded as "1.2.3.4" with an
281 ``extnValue`` of "value".
Andre Caron2b54fb02015-05-16 10:20:51 -0400282* ``unsupported_extension_critical.pem`` - A certificate signing
Andre Caron6cfe79b2015-05-16 08:41:52 -0400283 request for an RSA 2048 bit key containing containing an unsupported
284 extension type marked critical. The OID was encoded as "1.2.3.4"
285 with an ``extnValue`` of "value".
Andre Caronc97ca7e2015-05-16 22:16:44 -0400286* ``basic_constraints.pem`` - A certificate signing request for a RSA
287 2048 bit key containing a basic constraints extension marked as
288 critical.
Paul Kehrerbab4e392014-11-24 11:48:17 -1000289
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700290Custom X.509 Certificate Revocation List Vectors
291~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
292
293* ``crl_all_reasons.pem`` - Contains a CRL with 12 revoked certificates, whose
294 serials match their list position. It includes one revocation without
Erik Trauschke70d31382015-05-29 14:29:28 -0700295 any entry extensions, 10 revocations with every supported reason code and one
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700296 revocation with an unsupported, non-critical entry extension with the OID
297 value set to "1.2.3.4".
298* ``crl_dup_entry_ext.pem`` - Contains a CRL with one revocation which has a
299 duplicate entry extension.
300* ``crl_md2_unknown_crit_entry_ext.pem`` - Contains a CRL with one revocation
301 which contains an unsupported critical entry extension with the OID value set
302 to "1.2.3.4". The CRL uses an unsupported MD2 signature algorithm.
303* ``crl_unsupported_reason.pem`` - Contains a CRL with one revocation which has
304 an unsupported reason code.
Erik Trauschkea6c82592015-10-15 21:10:20 -0700305* ``crl_inval_cert_issuer_entry_ext.pem`` - Contains a CRL with one revocation
306 which has one entry extension for certificate issuer with an empty value.
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700307
Paul Kehrer1681a692014-02-11 23:43:51 -0600308Hashes
309~~~~~~
310
311* MD5 from :rfc:`1321`.
312* RIPEMD160 from the `RIPEMD website`_.
313* SHA1 from `NIST CAVP`_.
314* SHA2 (224, 256, 384, 512) from `NIST CAVP`_.
315* Whirlpool from the `Whirlpool website`_.
316
317HMAC
318~~~~
319
320* HMAC-MD5 from :rfc:`2202`.
321* HMAC-SHA1 from :rfc:`2202`.
322* HMAC-RIPEMD160 from :rfc:`2286`.
323* HMAC-SHA2 (224, 256, 384, 512) from :rfc:`4231`.
324
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000325Key derivation functions
Paul Kehrer1681a692014-02-11 23:43:51 -0600326~~~~~~~~~~~~~~~~~~~~~~~~
327
328* HKDF (SHA1, SHA256) from :rfc:`5869`.
329* PBKDF2 (HMAC-SHA1) from :rfc:`6070`.
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800330* scrypt from the `draft RFC`_.
Simo Sorcee69da952015-09-15 11:16:56 -0400331* X9.63 KDF from `NIST CAVP`_.
Paul Kehrer1681a692014-02-11 23:43:51 -0600332
Paul Kehrer16430f92015-03-15 09:06:25 -0500333Key wrapping
334~~~~~~~~~~~~
335
336* AES key wrap (AESKW) and 3DES key wrap test vectors from `NIST CAVP`_.
337
Paul Kehrer1681a692014-02-11 23:43:51 -0600338Recipes
339~~~~~~~
340
341* Fernet from its `specification repository`_.
342
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000343Symmetric ciphers
Paul Kehrer1681a692014-02-11 23:43:51 -0600344~~~~~~~~~~~~~~~~~
345
Paul Kehrere547d8f2014-02-15 21:37:52 -0600346* AES (CBC, CFB, ECB, GCM, OFB) from `NIST CAVP`_.
347* AES CTR from :rfc:`3686`.
Paul Kehrer1681a692014-02-11 23:43:51 -0600348* 3DES (CBC, CFB, ECB, OFB) from `NIST CAVP`_.
Ehren Krete23c0b72015-11-28 02:40:33 -0800349* ARC4 (KEY-LENGTH: 40, 56, 64, 80, 128, 192, 256) from :rfc:`6229`.
350* ARC4 (KEY-LENGTH: 160) generated by this project.
351 See: :doc:`/development/custom-vectors/arc4`
Paul Kehrer1681a692014-02-11 23:43:51 -0600352* Blowfish (CBC, CFB, ECB, OFB) from `Bruce Schneier's vectors`_.
353* Camellia (ECB) from NTT's `Camellia page`_ as linked by `CRYPTREC`_.
354* Camellia (CBC, CFB, OFB) from `OpenSSL's test vectors`_.
355* CAST5 (ECB) from :rfc:`2144`.
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600356* CAST5 (CBC, CFB, OFB) generated by this project.
357 See: :doc:`/development/custom-vectors/cast5`
Paul Kehrerb09622c2014-02-16 19:32:04 -0600358* IDEA (ECB) from the `NESSIE IDEA vectors`_ created by `NESSIE`_.
359* IDEA (CBC, CFB, OFB) generated by this project.
360 See: :doc:`/development/custom-vectors/idea`
Paul Kehrer1d0f9732014-04-08 08:44:25 -0500361* SEED (ECB) from :rfc:`4269`.
Paul Kehrerf0e12ac2014-04-08 08:59:40 -0500362* SEED (CBC) from :rfc:`4196`.
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500363* SEED (CFB, OFB) generated by this project.
364 See: :doc:`/development/custom-vectors/seed`
Paul Kehrer1681a692014-02-11 23:43:51 -0600365
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000366Two factor authentication
Ayrx933dd682014-02-18 23:26:11 +0800367~~~~~~~~~~~~~~~~~~~~~~~~~
368
369* HOTP from :rfc:`4226`
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800370* TOTP from :rfc:`6238` (Note that an `errata`_ for the test vectors in RFC
371 6238 exists)
Ayrx933dd682014-02-18 23:26:11 +0800372
Ayrx1d6b77b2014-04-10 23:11:03 +0800373CMAC
374~~~~
375
Ayrxfa52e6a2014-04-14 22:26:21 +0800376* AES-128, AES-192, AES-256, 3DES from `NIST SP-800-38B`_
Ayrx1d6b77b2014-04-10 23:11:03 +0800377
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000378Creating test vectors
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600379---------------------
380
381When official vectors are unavailable ``cryptography`` may choose to build
Paul Kehrer9f7ad192014-09-24 21:54:39 -0500382its own using existing vectors as source material.
michael-hart59f72192014-09-24 11:31:20 +0100383
Paul Kehrerebc26502014-11-26 19:18:56 -1000384Custom Symmetric Vectors
385~~~~~~~~~~~~~~~~~~~~~~~~
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600386
387.. toctree::
388 :maxdepth: 1
389
390 custom-vectors/cast5
Paul Kehrerb09622c2014-02-16 19:32:04 -0600391 custom-vectors/idea
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500392 custom-vectors/seed
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600393
394If official test vectors appear in the future the custom generated vectors
395should be discarded.
396
397Any vectors generated by this method must also be prefixed with the following
398header format (substituting the correct information):
399
400.. code-block:: python
401
402 # CAST5 CBC vectors built for https://github.com/pyca/cryptography
403 # Derived from the AESVS MMT test data for CBC
404 # Verified against the CommonCrypto and Go crypto packages
405 # Key Length : 128
406
Paul Kehrer1681a692014-02-11 23:43:51 -0600407.. _`NIST`: http://www.nist.gov/
408.. _`IETF`: https://www.ietf.org/
409.. _`NIST CAVP`: http://csrc.nist.gov/groups/STM/cavp/
410.. _`Bruce Schneier's vectors`: https://www.schneier.com/code/vectors.txt
Alex Gaynor4566cb92015-10-02 06:40:05 -0700411.. _`Camellia page`: https://info.isl.ntt.co.jp/crypt/eng/camellia/
Alex Gaynorbfda7652015-10-02 19:41:43 -0700412.. _`CRYPTREC`: http://www.cryptrec.go.jp
Paul Kehrer1681a692014-02-11 23:43:51 -0600413.. _`OpenSSL's test vectors`: https://github.com/openssl/openssl/blob/97cf1f6c2854a3a955fd7dd3a1f113deba00c9ef/crypto/evp/evptests.txt#L232
414.. _`RIPEMD website`: http://homes.esat.kuleuven.be/~bosselae/ripemd160.html
415.. _`Whirlpool website`: http://www.larc.usp.br/~pbarreto/WhirlpoolPage.html
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800416.. _`draft RFC`: https://tools.ietf.org/html/draft-josefsson-scrypt-kdf-01
Paul Kehrer1681a692014-02-11 23:43:51 -0600417.. _`Specification repository`: https://github.com/fernet/spec
Alex Gaynor3197ab52015-10-02 06:33:11 -0700418.. _`errata`: https://www.rfc-editor.org/errata_search.php?rfc=6238
Paul Kehrer5e9a8a32015-03-02 13:25:45 -0600419.. _`OpenSSL example key`: https://github.com/openssl/openssl/blob/d02b48c63a58ea4367a0e905979f140b7d090f86/test/testrsa.pem
Paul Kehrerdac86a92015-03-06 08:36:07 -0600420.. _`GnuTLS key parsing tests`: https://gitlab.com/gnutls/gnutls/commit/f16ef39ef0303b02d7fa590a37820440c466ce8d
421.. _`enc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/encpkcs8.pem
422.. _`enc2-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/enc2pkcs8.pem
423.. _`unenc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/unencpkcs8.pem
424.. _`pkcs12_s2k_pem.c`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs12_s2k_pem.c
Alex Stapletonabec8a12014-02-22 16:33:24 +0000425.. _`Botan's ECC private keys`: https://github.com/randombit/botan/tree/4917f26a2b154e841cd27c1bcecdd41d2bdeb6ce/src/tests/data/ecc
Alex Gaynor3efbf492015-03-09 07:13:22 -0400426.. _`GnuTLS example keys`: https://gitlab.com/gnutls/gnutls/commit/ad2061deafdd7db78fd405f9d143b0a7c579da7b
Paul Kehrerb09622c2014-02-16 19:32:04 -0600427.. _`NESSIE IDEA vectors`: https://www.cosic.esat.kuleuven.be/nessie/testvectors/bc/idea/Idea-128-64.verified.test-vectors
428.. _`NESSIE`: https://en.wikipedia.org/wiki/NESSIE
Alex Stapleton833a8ea2014-04-02 14:50:56 +0100429.. _`Ed25519 website`: http://ed25519.cr.yp.to/software.html
Ayrx40afce02014-04-13 19:17:52 +0800430.. _`NIST SP-800-38B`: http://csrc.nist.gov/publications/nistpubs/800-38B/Updated_CMAC_Examples.pdf
Paul Kehrerbab4e392014-11-24 11:48:17 -1000431.. _`NIST PKI Testing`: http://csrc.nist.gov/groups/ST/crypto_apps_infra/pki/pkitesting.html
Paul Kehrerebc26502014-11-26 19:18:56 -1000432.. _`testx509.pem`: https://github.com/openssl/openssl/blob/master/test/testx509.pem
433.. _`DigiCert Global Root G3`: http://cacerts.digicert.com/DigiCertGlobalRootG3.crt
Paul Kehrer2b6ba0c2015-02-14 18:58:20 -0600434.. _`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 -0600435.. _`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 -0500436.. _`Mozilla bug`: https://bugzilla.mozilla.org/show_bug.cgi?id=233586