blob: 1c84435b271466b2ceedc6630fbc4855e58b0ff2 [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``.
151* ``san_other_name.pem`` - An RSA 2048 bit self-signed certificate containing
152 a subject alternative name extension with the ``otherName`` general name.
153* ``san_registered_id.pem`` - An RSA 1024 bit certificate containing a
154 subject alternative name extension with the ``registeredID`` general name.
Paul Kehrerc88bce52015-04-02 19:32:45 -0500155* ``all_key_usages.pem`` - An RSA 2048 bit self-signed certificate containing
156 a key usage extension with all nine purposes set to true.
Paul Kehrer986e5fa2015-05-01 23:24:10 -0500157* ``extended_key_usage.pem`` - An RSA 2048 bit self-signed certificate
158 containing an extended key usage extension with eight usages.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500159* ``san_idna_names.pem`` - An RSA 2048 bit self-signed certificate containing
160 a subject alternative name extension with ``rfc822Name``, ``dNSName``, and
161 ``uniformResourceIdentifier`` general names with IDNA (:rfc:`5895`) encoding.
Paul Kehrer3f0522f2015-06-26 18:46:19 -0500162* ``san_wildcard_idna.pem`` - An RSA 2048 bit self-signed certificate
163 containing a subject alternative name extension with a ``dNSName`` general
164 name with a wildcard IDNA (:rfc:`5895`) domain.
Paul Kehrerd0a66e72015-05-15 08:50:50 -0700165* ``san_idna2003_dnsname.pem`` - An RSA 2048 bit self-signed certificate
166 containing a subject alternative name extension with an IDNA 2003
167 (:rfc:`3490`) ``dNSName``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500168* ``san_rfc822_names.pem`` - An RSA 2048 bit self-signed certificate containing
169 a subject alternative name extension with various ``rfc822Name`` values.
Paul Kehrer60163d72015-04-29 21:23:14 -0500170* ``san_rfc822_idna.pem`` - An RSA 2048 bit self-signed certificate containing
171 a subject alternative name extension with an IDNA ``rfc822Name``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500172* ``san_uri_with_port.pem`` - An RSA 2048 bit self-signed certificate
173 containing a subject alternative name extension with various
174 ``uniformResourceIdentifier`` values.
Paul Kehrerfbc62192015-04-29 21:37:42 -0500175* ``san_ipaddr.pem`` - An RSA 2048 bit self-signed certificate containing a
176 subject alternative name extension with an ``iPAddress`` value.
177* ``san_dirname.pem`` - An RSA 2048 bit self-signed certificate containing a
178 subject alternative name extension with a ``directoryName`` value.
Paul Kehrer67a62c82015-05-01 23:15:58 -0500179* ``inhibit_any_policy_5.pem`` - An RSA 2048 bit self-signed certificate
180 containing an inhibit any policy extension with the value 5.
181* ``inhibit_any_policy_negative.pem`` - An RSA 2048 bit self-signed certificate
182 containing an inhibit any policy extension with the value -1.
Paul Kehrerb0deb442015-05-03 10:53:45 -0500183* ``authority_key_identifier.pem`` - An RSA 2048 bit self-signed certificate
184 containing an authority key identifier extension with key identifier,
185 authority certificate issuer, and authority certificate serial number fields.
Paul Kehrer0d52e2a2015-05-03 11:17:12 -0500186* ``authority_key_identifier_no_keyid.pem`` - An RSA 2048 bit self-signed
187 certificate containing an authority key identifier extension with authority
188 certificate issuer and authority certificate serial number fields.
Paul Kehrer64c82e02015-05-04 17:38:52 -0500189* ``aia_ocsp_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
190 containing an authority information access extension with two OCSP and one
191 CA issuers entry.
192* ``aia_ocsp.pem`` - An RSA 2048 bit self-signed certificate
193 containing an authority information access extension with an OCSP entry.
194* ``aia_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
195 containing an authority information access extension with a CA issuers entry.
Paul Kehrer28d54212015-05-10 14:58:21 -0500196* ``cdp_fullname_reasons_crl_issuer.pem`` - An RSA 1024 bit certificate
197 containing a CRL distribution points extension with ``fullName``,
198 ``cRLIssuer``, and ``reasons`` data.
199* ``cdp_crl_issuer.pem`` - An RSA 1024 bit certificate containing a CRL
200 distribution points extension with ``cRLIssuer`` data.
Paul Kehrer208d6782015-05-12 23:09:13 -0500201* ``cdp_all_reasons.pem`` - An RSA 1024 bit certificate containing a CRL
202 distribution points extension with all ``reasons`` bits set.
203* ``cdp_reason_aa_compromise.pem`` - An RSA 1024 bit certificate containing a
204 CRL distribution points extension with the ``AACompromise`` ``reasons`` bit
205 set.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600206* ``nc_permitted_excluded.pem`` - An RSA 2048 bit self-signed certificate
207 containing a name constraints extension with both permitted and excluded
Paul Kehrer7155c982015-06-29 07:53:54 -0500208 elements. Contains ``IPv4`` and ``IPv6`` addresses with network mask as well
209 as ``dNSName`` with a leading period.
210* ``nc_permitted_excluded_2.pem`` - An RSA 2048 bit self-signed certificate
211 containing a name constraints extension with both permitted and excluded
212 elements. Unlike ``nc_permitted_excluded.pem``, the general names do not
213 contain any name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600214* ``nc_permitted.pem`` - An RSA 2048 bit self-signed certificate containing a
215 name constraints extension with permitted elements.
Paul Kehrer7155c982015-06-29 07:53:54 -0500216* ``nc_permitted_2.pem`` - An RSA 2048 bit self-signed certificate containing a
217 name constraints extension with permitted elements that do not contain any
218 name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600219* ``nc_excluded.pem`` - An RSA 2048 bit self-signed certificate containing a
220 name constraints extension with excluded elements.
Paul Kehrer5d3f7b72015-06-28 00:39:21 -0500221* ``nc_invalid_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
222 containing a name constraints extension with a permitted element that has an
223 ``IPv6`` IP and an invalid network mask.
Paul Kehrer8f458ab2015-07-01 21:17:17 -0500224* ``nc_single_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
225 containing a name constraints extension with a permitted element that has two
226 IPs with ``/32`` and ``/128`` network masks.
Paul Kehrercdfe0f92015-05-11 20:00:29 -0500227* ``cp_user_notice_with_notice_reference.pem`` - An RSA 2048 bit self-signed
228 certificate containing a certificate policies extension with a
229 notice reference in the user notice.
230* ``cp_user_notice_with_explicit_text.pem`` - An RSA 2048 bit self-signed
231 certificate containing a certificate policies extension with explicit
232 text and no notice reference.
233* ``cp_cps_uri.pem`` - An RSA 2048 bit self-signed certificate containing a
234 certificate policies extension with a CPS URI and no user notice.
Paul Kehrer5ac41542015-05-12 16:04:52 -0500235* ``cp_user_notice_no_explicit_text.pem`` - An RSA 2048 bit self-signed
236 certificate containing a certificate policies extension with a user notice
237 with no explicit text.
Paul Kehrer0f984362015-08-01 20:45:08 +0100238* ``cp_invalid.pem`` - An RSA 2048 bit self-signed certificate containing a
239 certificate policies extension with invalid data.
Paul Kehrer769e7f22015-06-17 22:28:29 -0600240* ``ian_uri.pem`` - An RSA 2048 bit certificate containing an issuer
241 alternative name extension with a ``URI`` general name.
Paul Kehrerd59b07c2015-06-07 18:51:50 -0500242* ``ocsp_nocheck.pem`` - An RSA 2048 bit self-signed certificate containing
243 an ``OCSPNoCheck`` extension.
Paul Kehrer77335622015-06-17 21:52:32 -0600244* ``pc_inhibit_require.pem`` - An RSA 2048 bit self-signed certificate
245 containing a policy constraints extension with both inhibit policy mapping
246 and require explicit policy elements.
247* ``pc_inhibit.pem`` - An RSA 2048 bit self-signed certificate containing a
248 policy constraints extension with an inhibit policy mapping element.
249* ``pc_require.pem`` - An RSA 2048 bit self-signed certificate containing a
250 policy constraints extension with a require explicit policy element.
Paul Kehrerff2167a2015-02-24 10:45:41 -0600251
252Custom X.509 Request Vectors
253~~~~~~~~~~~~~~~~~~~~~~~~~~~~
254
Paul Kehrer89e4c952015-03-30 15:15:00 -0500255* ``dsa_sha1.pem`` and ``dsa_sha1.der`` - Contain a certificate request using
256 1024-bit DSA parameters and SHA1 generated using OpenSSL.
257* ``rsa_md4.pem`` and ``rsa_md4.der`` - Contain a certificate request using
258 2048 bit RSA and MD4 generated using OpenSSL.
259* ``rsa_sha1.pem`` and ``rsa_sha1.der`` - Contain a certificate request using
260 2048 bit RSA and SHA1 generated using OpenSSL.
261* ``rsa_sha256.pem`` and ``rsa_sha256.der`` - Contain a certificate request
262 using 2048 bit RSA and SHA256 generated using OpenSSL.
263* ``ec_sha256.pem`` and ``ec_sha256.der`` - Contain a certificate request
264 using EC (``secp384r1``) and SHA256 generated using OpenSSL.
Paul Kehrer0c518be2015-03-30 21:10:51 -0500265* ``san_rsa_sha1.pem`` and ``san_rsa_sha1.der`` - Contain a certificate
266 request using RSA and SHA1 with a subject alternative name extension
267 generated using OpenSSL.
Andre Caron2b54fb02015-05-16 10:20:51 -0400268* ``two_basic_constraints.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400269 for a RSA 2048 bit key containing two basic constraints extensions.
Andre Caron2b54fb02015-05-16 10:20:51 -0400270* ``unsupported_extension.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400271 for an RSA 2048 bit key containing containing an unsupported
272 extension type. The OID was encoded as "1.2.3.4" with an
273 ``extnValue`` of "value".
Andre Caron2b54fb02015-05-16 10:20:51 -0400274* ``unsupported_extension_critical.pem`` - A certificate signing
Andre Caron6cfe79b2015-05-16 08:41:52 -0400275 request for an RSA 2048 bit key containing containing an unsupported
276 extension type marked critical. The OID was encoded as "1.2.3.4"
277 with an ``extnValue`` of "value".
Andre Caronc97ca7e2015-05-16 22:16:44 -0400278* ``basic_constraints.pem`` - A certificate signing request for a RSA
279 2048 bit key containing a basic constraints extension marked as
280 critical.
Paul Kehrerbab4e392014-11-24 11:48:17 -1000281
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700282Custom X.509 Certificate Revocation List Vectors
283~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
284
285* ``crl_all_reasons.pem`` - Contains a CRL with 12 revoked certificates, whose
286 serials match their list position. It includes one revocation without
Erik Trauschke70d31382015-05-29 14:29:28 -0700287 any entry extensions, 10 revocations with every supported reason code and one
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700288 revocation with an unsupported, non-critical entry extension with the OID
289 value set to "1.2.3.4".
290* ``crl_dup_entry_ext.pem`` - Contains a CRL with one revocation which has a
291 duplicate entry extension.
292* ``crl_md2_unknown_crit_entry_ext.pem`` - Contains a CRL with one revocation
293 which contains an unsupported critical entry extension with the OID value set
294 to "1.2.3.4". The CRL uses an unsupported MD2 signature algorithm.
295* ``crl_unsupported_reason.pem`` - Contains a CRL with one revocation which has
296 an unsupported reason code.
297
Paul Kehrer1681a692014-02-11 23:43:51 -0600298Hashes
299~~~~~~
300
301* MD5 from :rfc:`1321`.
302* RIPEMD160 from the `RIPEMD website`_.
303* SHA1 from `NIST CAVP`_.
304* SHA2 (224, 256, 384, 512) from `NIST CAVP`_.
305* Whirlpool from the `Whirlpool website`_.
306
307HMAC
308~~~~
309
310* HMAC-MD5 from :rfc:`2202`.
311* HMAC-SHA1 from :rfc:`2202`.
312* HMAC-RIPEMD160 from :rfc:`2286`.
313* HMAC-SHA2 (224, 256, 384, 512) from :rfc:`4231`.
314
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000315Key derivation functions
Paul Kehrer1681a692014-02-11 23:43:51 -0600316~~~~~~~~~~~~~~~~~~~~~~~~
317
318* HKDF (SHA1, SHA256) from :rfc:`5869`.
319* PBKDF2 (HMAC-SHA1) from :rfc:`6070`.
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800320* scrypt from the `draft RFC`_.
Paul Kehrer1681a692014-02-11 23:43:51 -0600321
Paul Kehrer16430f92015-03-15 09:06:25 -0500322Key wrapping
323~~~~~~~~~~~~
324
325* AES key wrap (AESKW) and 3DES key wrap test vectors from `NIST CAVP`_.
326
Paul Kehrer1681a692014-02-11 23:43:51 -0600327Recipes
328~~~~~~~
329
330* Fernet from its `specification repository`_.
331
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000332Symmetric ciphers
Paul Kehrer1681a692014-02-11 23:43:51 -0600333~~~~~~~~~~~~~~~~~
334
Paul Kehrere547d8f2014-02-15 21:37:52 -0600335* AES (CBC, CFB, ECB, GCM, OFB) from `NIST CAVP`_.
336* AES CTR from :rfc:`3686`.
Paul Kehrer1681a692014-02-11 23:43:51 -0600337* 3DES (CBC, CFB, ECB, OFB) from `NIST CAVP`_.
338* ARC4 from :rfc:`6229`.
339* Blowfish (CBC, CFB, ECB, OFB) from `Bruce Schneier's vectors`_.
340* Camellia (ECB) from NTT's `Camellia page`_ as linked by `CRYPTREC`_.
341* Camellia (CBC, CFB, OFB) from `OpenSSL's test vectors`_.
342* CAST5 (ECB) from :rfc:`2144`.
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600343* CAST5 (CBC, CFB, OFB) generated by this project.
344 See: :doc:`/development/custom-vectors/cast5`
Paul Kehrerb09622c2014-02-16 19:32:04 -0600345* IDEA (ECB) from the `NESSIE IDEA vectors`_ created by `NESSIE`_.
346* IDEA (CBC, CFB, OFB) generated by this project.
347 See: :doc:`/development/custom-vectors/idea`
Paul Kehrer1d0f9732014-04-08 08:44:25 -0500348* SEED (ECB) from :rfc:`4269`.
Paul Kehrerf0e12ac2014-04-08 08:59:40 -0500349* SEED (CBC) from :rfc:`4196`.
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500350* SEED (CFB, OFB) generated by this project.
351 See: :doc:`/development/custom-vectors/seed`
Paul Kehrer1681a692014-02-11 23:43:51 -0600352
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000353Two factor authentication
Ayrx933dd682014-02-18 23:26:11 +0800354~~~~~~~~~~~~~~~~~~~~~~~~~
355
356* HOTP from :rfc:`4226`
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800357* TOTP from :rfc:`6238` (Note that an `errata`_ for the test vectors in RFC
358 6238 exists)
Ayrx933dd682014-02-18 23:26:11 +0800359
Ayrx1d6b77b2014-04-10 23:11:03 +0800360CMAC
361~~~~
362
Ayrxfa52e6a2014-04-14 22:26:21 +0800363* AES-128, AES-192, AES-256, 3DES from `NIST SP-800-38B`_
Ayrx1d6b77b2014-04-10 23:11:03 +0800364
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000365Creating test vectors
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600366---------------------
367
368When official vectors are unavailable ``cryptography`` may choose to build
Paul Kehrer9f7ad192014-09-24 21:54:39 -0500369its own using existing vectors as source material.
michael-hart59f72192014-09-24 11:31:20 +0100370
Paul Kehrerebc26502014-11-26 19:18:56 -1000371Custom Symmetric Vectors
372~~~~~~~~~~~~~~~~~~~~~~~~
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600373
374.. toctree::
375 :maxdepth: 1
376
377 custom-vectors/cast5
Paul Kehrerb09622c2014-02-16 19:32:04 -0600378 custom-vectors/idea
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500379 custom-vectors/seed
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600380
381If official test vectors appear in the future the custom generated vectors
382should be discarded.
383
384Any vectors generated by this method must also be prefixed with the following
385header format (substituting the correct information):
386
387.. code-block:: python
388
389 # CAST5 CBC vectors built for https://github.com/pyca/cryptography
390 # Derived from the AESVS MMT test data for CBC
391 # Verified against the CommonCrypto and Go crypto packages
392 # Key Length : 128
393
Paul Kehrer1681a692014-02-11 23:43:51 -0600394.. _`NIST`: http://www.nist.gov/
395.. _`IETF`: https://www.ietf.org/
396.. _`NIST CAVP`: http://csrc.nist.gov/groups/STM/cavp/
397.. _`Bruce Schneier's vectors`: https://www.schneier.com/code/vectors.txt
398.. _`Camellia page`: http://info.isl.ntt.co.jp/crypt/eng/camellia/
399.. _`CRYPTREC`: http://www.cryptrec.go.jp
400.. _`OpenSSL's test vectors`: https://github.com/openssl/openssl/blob/97cf1f6c2854a3a955fd7dd3a1f113deba00c9ef/crypto/evp/evptests.txt#L232
401.. _`RIPEMD website`: http://homes.esat.kuleuven.be/~bosselae/ripemd160.html
402.. _`Whirlpool website`: http://www.larc.usp.br/~pbarreto/WhirlpoolPage.html
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800403.. _`draft RFC`: https://tools.ietf.org/html/draft-josefsson-scrypt-kdf-01
Paul Kehrer1681a692014-02-11 23:43:51 -0600404.. _`Specification repository`: https://github.com/fernet/spec
Ayrx933dd682014-02-18 23:26:11 +0800405.. _`errata`: http://www.rfc-editor.org/errata_search.php?rfc=6238
Paul Kehrer5e9a8a32015-03-02 13:25:45 -0600406.. _`OpenSSL example key`: https://github.com/openssl/openssl/blob/d02b48c63a58ea4367a0e905979f140b7d090f86/test/testrsa.pem
Paul Kehrerdac86a92015-03-06 08:36:07 -0600407.. _`GnuTLS key parsing tests`: https://gitlab.com/gnutls/gnutls/commit/f16ef39ef0303b02d7fa590a37820440c466ce8d
408.. _`enc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/encpkcs8.pem
409.. _`enc2-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/enc2pkcs8.pem
410.. _`unenc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/unencpkcs8.pem
411.. _`pkcs12_s2k_pem.c`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs12_s2k_pem.c
Alex Stapletonabec8a12014-02-22 16:33:24 +0000412.. _`Botan's ECC private keys`: https://github.com/randombit/botan/tree/4917f26a2b154e841cd27c1bcecdd41d2bdeb6ce/src/tests/data/ecc
Alex Gaynor3efbf492015-03-09 07:13:22 -0400413.. _`GnuTLS example keys`: https://gitlab.com/gnutls/gnutls/commit/ad2061deafdd7db78fd405f9d143b0a7c579da7b
Paul Kehrerb09622c2014-02-16 19:32:04 -0600414.. _`NESSIE IDEA vectors`: https://www.cosic.esat.kuleuven.be/nessie/testvectors/bc/idea/Idea-128-64.verified.test-vectors
415.. _`NESSIE`: https://en.wikipedia.org/wiki/NESSIE
Alex Stapleton833a8ea2014-04-02 14:50:56 +0100416.. _`Ed25519 website`: http://ed25519.cr.yp.to/software.html
Ayrx40afce02014-04-13 19:17:52 +0800417.. _`NIST SP-800-38B`: http://csrc.nist.gov/publications/nistpubs/800-38B/Updated_CMAC_Examples.pdf
Paul Kehrerbab4e392014-11-24 11:48:17 -1000418.. _`NIST PKI Testing`: http://csrc.nist.gov/groups/ST/crypto_apps_infra/pki/pkitesting.html
Paul Kehrerebc26502014-11-26 19:18:56 -1000419.. _`testx509.pem`: https://github.com/openssl/openssl/blob/master/test/testx509.pem
420.. _`DigiCert Global Root G3`: http://cacerts.digicert.com/DigiCertGlobalRootG3.crt
Paul Kehrer2b6ba0c2015-02-14 18:58:20 -0600421.. _`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 -0600422.. _`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 -0500423.. _`Mozilla bug`: https://bugzilla.mozilla.org/show_bug.cgi?id=233586