blob: d400e662cc8880947f2c93aaf2ab9570cc1149a0 [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 Kehrere651b7f2015-06-23 08:31:15 -0500105* ``wildcard_san.pem`` - A leaf certificate issued by a public CA for
106 ``langui.sh`` that contains wildcard entries in the SAN extension.
Paul Kehrer0ed3d912015-07-04 16:48:08 -0500107* ``san_edipartyname.der`` - A DSA certificate from a `Mozilla bug`_
108 containing a SAN extension with an ``ediPartyName`` general name.
109* ``san_x400address.der`` - A DSA certificate from a `Mozilla bug`_ containing
110 a SAN extension with an ``x400Address`` general name.
Paul Kehrerebc26502014-11-26 19:18:56 -1000111
112Custom X.509 Vectors
113~~~~~~~~~~~~~~~~~~~~
114
115* ``invalid_version.pem`` - Contains an RSA 2048 bit certificate with the
116 X.509 version field set to ``0x7``.
117* ``post2000utctime.pem`` - Contains an RSA 2048 bit certificate with the
118 ``notBefore`` and ``notAfter`` fields encoded as post-2000 ``UTCTime``.
Paul Kehrera850c612014-12-12 14:21:18 -0600119* ``dsa_selfsigned_ca.pem`` - Contains a DSA self-signed CA certificate
120 generated using OpenSSL.
Paul Kehrerd317bae2014-12-12 11:42:31 -0600121* ``ec_no_named_curve.pem`` - Contains an ECDSA certificate that does not have
122 an embedded OID defining the curve.
Paul Kehrer22217202015-01-17 21:26:28 -0600123* ``all_supported_names.pem`` - An RSA 2048 bit certificate generated using
124 OpenSSL that contains a subject and issuer that have two of each supported
125 attribute type from :rfc:`5280`.
Paul Kehrer1207d152015-01-17 21:31:42 -0600126* ``unsupported_subject_name.pem`` - An RSA 2048 bit self-signed CA certificate
127 generated using OpenSSL that contains the unsupported "initials" name.
Paul Kehrer6392b4b2015-01-17 22:20:01 -0600128* ``utf8_common_name.pem`` - An RSA 2048 bit self-signed CA certificate
129 generated using OpenSSL that contains a UTF8String common name with the value
130 "We heart UTF8!â„¢".
Paul Kehrere0eafaa2015-03-20 22:33:37 -0500131* ``two_basic_constraints.pem`` - An RSA 2048 bit self-signed certificate
132 containing two basic constraints extensions.
133* ``basic_constraints_not_critical.pem`` - An RSA 2048 bit self-signed
134 certificate containing a basic constraints extension that is not marked as
135 critical.
Paul Kehrerd1ed6732015-03-25 00:17:36 -0500136* ``bc_path_length_zero.pem`` - An RSA 2048 bit self-signed
137 certificate containing a basic constraints extension with a path length of
138 zero.
Paul Kehrerb2e6c832015-03-27 22:19:13 -0500139* ``unsupported_extension.pem`` - An RSA 2048 bit self-signed certificate
140 containing an unsupported extension type. The OID was encoded as
141 "1.2.3.4" with an ``extnValue`` of "value".
Paul Kehrerf5ac6c62015-03-27 23:27:00 -0500142* ``unsupported_extension_critical.pem`` - An RSA 2048 bit self-signed
143 certificate containing an unsupported extension type marked critical. The OID
144 was encoded as "1.2.3.4" with an ``extnValue`` of "value".
Paul Kehrer2e3c7092015-03-27 10:24:05 -0500145* ``san_email_dns_ip_dirname_uri.pem`` - An RSA 2048 bit self-signed
146 certificate containing a subject alternative name extension with the
147 following general names: ``rfc822Name``, ``dNSName``, ``iPAddress``,
148 ``directoryName``, and ``uniformResourceIdentifier``.
149* ``san_other_name.pem`` - An RSA 2048 bit self-signed certificate containing
150 a subject alternative name extension with the ``otherName`` general name.
151* ``san_registered_id.pem`` - An RSA 1024 bit certificate containing a
152 subject alternative name extension with the ``registeredID`` general name.
Paul Kehrerc88bce52015-04-02 19:32:45 -0500153* ``all_key_usages.pem`` - An RSA 2048 bit self-signed certificate containing
154 a key usage extension with all nine purposes set to true.
Paul Kehrer986e5fa2015-05-01 23:24:10 -0500155* ``extended_key_usage.pem`` - An RSA 2048 bit self-signed certificate
156 containing an extended key usage extension with eight usages.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500157* ``san_idna_names.pem`` - An RSA 2048 bit self-signed certificate containing
158 a subject alternative name extension with ``rfc822Name``, ``dNSName``, and
159 ``uniformResourceIdentifier`` general names with IDNA (:rfc:`5895`) encoding.
Paul Kehrer3f0522f2015-06-26 18:46:19 -0500160* ``san_wildcard_idna.pem`` - An RSA 2048 bit self-signed certificate
161 containing a subject alternative name extension with a ``dNSName`` general
162 name with a wildcard IDNA (:rfc:`5895`) domain.
Paul Kehrerd0a66e72015-05-15 08:50:50 -0700163* ``san_idna2003_dnsname.pem`` - An RSA 2048 bit self-signed certificate
164 containing a subject alternative name extension with an IDNA 2003
165 (:rfc:`3490`) ``dNSName``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500166* ``san_rfc822_names.pem`` - An RSA 2048 bit self-signed certificate containing
167 a subject alternative name extension with various ``rfc822Name`` values.
Paul Kehrer60163d72015-04-29 21:23:14 -0500168* ``san_rfc822_idna.pem`` - An RSA 2048 bit self-signed certificate containing
169 a subject alternative name extension with an IDNA ``rfc822Name``.
Paul Kehrer542f4e52015-04-20 14:57:32 -0500170* ``san_uri_with_port.pem`` - An RSA 2048 bit self-signed certificate
171 containing a subject alternative name extension with various
172 ``uniformResourceIdentifier`` values.
Paul Kehrerfbc62192015-04-29 21:37:42 -0500173* ``san_ipaddr.pem`` - An RSA 2048 bit self-signed certificate containing a
174 subject alternative name extension with an ``iPAddress`` value.
175* ``san_dirname.pem`` - An RSA 2048 bit self-signed certificate containing a
176 subject alternative name extension with a ``directoryName`` value.
Paul Kehrer67a62c82015-05-01 23:15:58 -0500177* ``inhibit_any_policy_5.pem`` - An RSA 2048 bit self-signed certificate
178 containing an inhibit any policy extension with the value 5.
179* ``inhibit_any_policy_negative.pem`` - An RSA 2048 bit self-signed certificate
180 containing an inhibit any policy extension with the value -1.
Paul Kehrerb0deb442015-05-03 10:53:45 -0500181* ``authority_key_identifier.pem`` - An RSA 2048 bit self-signed certificate
182 containing an authority key identifier extension with key identifier,
183 authority certificate issuer, and authority certificate serial number fields.
Paul Kehrer0d52e2a2015-05-03 11:17:12 -0500184* ``authority_key_identifier_no_keyid.pem`` - An RSA 2048 bit self-signed
185 certificate containing an authority key identifier extension with authority
186 certificate issuer and authority certificate serial number fields.
Paul Kehrer64c82e02015-05-04 17:38:52 -0500187* ``aia_ocsp_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
188 containing an authority information access extension with two OCSP and one
189 CA issuers entry.
190* ``aia_ocsp.pem`` - An RSA 2048 bit self-signed certificate
191 containing an authority information access extension with an OCSP entry.
192* ``aia_ca_issuers.pem`` - An RSA 2048 bit self-signed certificate
193 containing an authority information access extension with a CA issuers entry.
Paul Kehrer28d54212015-05-10 14:58:21 -0500194* ``cdp_fullname_reasons_crl_issuer.pem`` - An RSA 1024 bit certificate
195 containing a CRL distribution points extension with ``fullName``,
196 ``cRLIssuer``, and ``reasons`` data.
197* ``cdp_crl_issuer.pem`` - An RSA 1024 bit certificate containing a CRL
198 distribution points extension with ``cRLIssuer`` data.
Paul Kehrer208d6782015-05-12 23:09:13 -0500199* ``cdp_all_reasons.pem`` - An RSA 1024 bit certificate containing a CRL
200 distribution points extension with all ``reasons`` bits set.
201* ``cdp_reason_aa_compromise.pem`` - An RSA 1024 bit certificate containing a
202 CRL distribution points extension with the ``AACompromise`` ``reasons`` bit
203 set.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600204* ``nc_permitted_excluded.pem`` - An RSA 2048 bit self-signed certificate
205 containing a name constraints extension with both permitted and excluded
Paul Kehrer7155c982015-06-29 07:53:54 -0500206 elements. Contains ``IPv4`` and ``IPv6`` addresses with network mask as well
207 as ``dNSName`` with a leading period.
208* ``nc_permitted_excluded_2.pem`` - An RSA 2048 bit self-signed certificate
209 containing a name constraints extension with both permitted and excluded
210 elements. Unlike ``nc_permitted_excluded.pem``, the general names do not
211 contain any name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600212* ``nc_permitted.pem`` - An RSA 2048 bit self-signed certificate containing a
213 name constraints extension with permitted elements.
Paul Kehrer7155c982015-06-29 07:53:54 -0500214* ``nc_permitted_2.pem`` - An RSA 2048 bit self-signed certificate containing a
215 name constraints extension with permitted elements that do not contain any
216 name constraints specific values.
Paul Kehrercf1109d2015-06-17 22:40:06 -0600217* ``nc_excluded.pem`` - An RSA 2048 bit self-signed certificate containing a
218 name constraints extension with excluded elements.
Paul Kehrer5d3f7b72015-06-28 00:39:21 -0500219* ``nc_invalid_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
220 containing a name constraints extension with a permitted element that has an
221 ``IPv6`` IP and an invalid network mask.
Paul Kehrer8f458ab2015-07-01 21:17:17 -0500222* ``nc_single_ip_netmask.pem`` - An RSA 2048 bit self-signed certificate
223 containing a name constraints extension with a permitted element that has two
224 IPs with ``/32`` and ``/128`` network masks.
Paul Kehrercdfe0f92015-05-11 20:00:29 -0500225* ``cp_user_notice_with_notice_reference.pem`` - An RSA 2048 bit self-signed
226 certificate containing a certificate policies extension with a
227 notice reference in the user notice.
228* ``cp_user_notice_with_explicit_text.pem`` - An RSA 2048 bit self-signed
229 certificate containing a certificate policies extension with explicit
230 text and no notice reference.
231* ``cp_cps_uri.pem`` - An RSA 2048 bit self-signed certificate containing a
232 certificate policies extension with a CPS URI and no user notice.
Paul Kehrer5ac41542015-05-12 16:04:52 -0500233* ``cp_user_notice_no_explicit_text.pem`` - An RSA 2048 bit self-signed
234 certificate containing a certificate policies extension with a user notice
235 with no explicit text.
Paul Kehrer0f984362015-08-01 20:45:08 +0100236* ``cp_invalid.pem`` - An RSA 2048 bit self-signed certificate containing a
237 certificate policies extension with invalid data.
Paul Kehrer769e7f22015-06-17 22:28:29 -0600238* ``ian_uri.pem`` - An RSA 2048 bit certificate containing an issuer
239 alternative name extension with a ``URI`` general name.
Paul Kehrerd59b07c2015-06-07 18:51:50 -0500240* ``ocsp_nocheck.pem`` - An RSA 2048 bit self-signed certificate containing
241 an ``OCSPNoCheck`` extension.
Paul Kehrer77335622015-06-17 21:52:32 -0600242* ``pc_inhibit_require.pem`` - An RSA 2048 bit self-signed certificate
243 containing a policy constraints extension with both inhibit policy mapping
244 and require explicit policy elements.
245* ``pc_inhibit.pem`` - An RSA 2048 bit self-signed certificate containing a
246 policy constraints extension with an inhibit policy mapping element.
247* ``pc_require.pem`` - An RSA 2048 bit self-signed certificate containing a
248 policy constraints extension with a require explicit policy element.
Paul Kehrerff2167a2015-02-24 10:45:41 -0600249
250Custom X.509 Request Vectors
251~~~~~~~~~~~~~~~~~~~~~~~~~~~~
252
Paul Kehrer89e4c952015-03-30 15:15:00 -0500253* ``dsa_sha1.pem`` and ``dsa_sha1.der`` - Contain a certificate request using
254 1024-bit DSA parameters and SHA1 generated using OpenSSL.
255* ``rsa_md4.pem`` and ``rsa_md4.der`` - Contain a certificate request using
256 2048 bit RSA and MD4 generated using OpenSSL.
257* ``rsa_sha1.pem`` and ``rsa_sha1.der`` - Contain a certificate request using
258 2048 bit RSA and SHA1 generated using OpenSSL.
259* ``rsa_sha256.pem`` and ``rsa_sha256.der`` - Contain a certificate request
260 using 2048 bit RSA and SHA256 generated using OpenSSL.
261* ``ec_sha256.pem`` and ``ec_sha256.der`` - Contain a certificate request
262 using EC (``secp384r1``) and SHA256 generated using OpenSSL.
Paul Kehrer0c518be2015-03-30 21:10:51 -0500263* ``san_rsa_sha1.pem`` and ``san_rsa_sha1.der`` - Contain a certificate
264 request using RSA and SHA1 with a subject alternative name extension
265 generated using OpenSSL.
Andre Caron2b54fb02015-05-16 10:20:51 -0400266* ``two_basic_constraints.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400267 for a RSA 2048 bit key containing two basic constraints extensions.
Andre Caron2b54fb02015-05-16 10:20:51 -0400268* ``unsupported_extension.pem`` - A certificate signing request
Andre Caron6cfe79b2015-05-16 08:41:52 -0400269 for an RSA 2048 bit key containing containing an unsupported
270 extension type. The OID was encoded as "1.2.3.4" with an
271 ``extnValue`` of "value".
Andre Caron2b54fb02015-05-16 10:20:51 -0400272* ``unsupported_extension_critical.pem`` - A certificate signing
Andre Caron6cfe79b2015-05-16 08:41:52 -0400273 request for an RSA 2048 bit key containing containing an unsupported
274 extension type marked critical. The OID was encoded as "1.2.3.4"
275 with an ``extnValue`` of "value".
Andre Caronc97ca7e2015-05-16 22:16:44 -0400276* ``basic_constraints.pem`` - A certificate signing request for a RSA
277 2048 bit key containing a basic constraints extension marked as
278 critical.
Paul Kehrerbab4e392014-11-24 11:48:17 -1000279
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700280Custom X.509 Certificate Revocation List Vectors
281~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
282
283* ``crl_all_reasons.pem`` - Contains a CRL with 12 revoked certificates, whose
284 serials match their list position. It includes one revocation without
Erik Trauschke70d31382015-05-29 14:29:28 -0700285 any entry extensions, 10 revocations with every supported reason code and one
Erik Trauschke0150e3d2015-05-29 13:11:22 -0700286 revocation with an unsupported, non-critical entry extension with the OID
287 value set to "1.2.3.4".
288* ``crl_dup_entry_ext.pem`` - Contains a CRL with one revocation which has a
289 duplicate entry extension.
290* ``crl_md2_unknown_crit_entry_ext.pem`` - Contains a CRL with one revocation
291 which contains an unsupported critical entry extension with the OID value set
292 to "1.2.3.4". The CRL uses an unsupported MD2 signature algorithm.
293* ``crl_unsupported_reason.pem`` - Contains a CRL with one revocation which has
294 an unsupported reason code.
295
Paul Kehrer1681a692014-02-11 23:43:51 -0600296Hashes
297~~~~~~
298
299* MD5 from :rfc:`1321`.
300* RIPEMD160 from the `RIPEMD website`_.
301* SHA1 from `NIST CAVP`_.
302* SHA2 (224, 256, 384, 512) from `NIST CAVP`_.
303* Whirlpool from the `Whirlpool website`_.
304
305HMAC
306~~~~
307
308* HMAC-MD5 from :rfc:`2202`.
309* HMAC-SHA1 from :rfc:`2202`.
310* HMAC-RIPEMD160 from :rfc:`2286`.
311* HMAC-SHA2 (224, 256, 384, 512) from :rfc:`4231`.
312
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000313Key derivation functions
Paul Kehrer1681a692014-02-11 23:43:51 -0600314~~~~~~~~~~~~~~~~~~~~~~~~
315
316* HKDF (SHA1, SHA256) from :rfc:`5869`.
317* PBKDF2 (HMAC-SHA1) from :rfc:`6070`.
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800318* scrypt from the `draft RFC`_.
Paul Kehrer1681a692014-02-11 23:43:51 -0600319
Paul Kehrer16430f92015-03-15 09:06:25 -0500320Key wrapping
321~~~~~~~~~~~~
322
323* AES key wrap (AESKW) and 3DES key wrap test vectors from `NIST CAVP`_.
324
Paul Kehrer1681a692014-02-11 23:43:51 -0600325Recipes
326~~~~~~~
327
328* Fernet from its `specification repository`_.
329
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000330Symmetric ciphers
Paul Kehrer1681a692014-02-11 23:43:51 -0600331~~~~~~~~~~~~~~~~~
332
Paul Kehrere547d8f2014-02-15 21:37:52 -0600333* AES (CBC, CFB, ECB, GCM, OFB) from `NIST CAVP`_.
334* AES CTR from :rfc:`3686`.
Paul Kehrer1681a692014-02-11 23:43:51 -0600335* 3DES (CBC, CFB, ECB, OFB) from `NIST CAVP`_.
336* ARC4 from :rfc:`6229`.
337* Blowfish (CBC, CFB, ECB, OFB) from `Bruce Schneier's vectors`_.
338* Camellia (ECB) from NTT's `Camellia page`_ as linked by `CRYPTREC`_.
339* Camellia (CBC, CFB, OFB) from `OpenSSL's test vectors`_.
340* CAST5 (ECB) from :rfc:`2144`.
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600341* CAST5 (CBC, CFB, OFB) generated by this project.
342 See: :doc:`/development/custom-vectors/cast5`
Paul Kehrerb09622c2014-02-16 19:32:04 -0600343* IDEA (ECB) from the `NESSIE IDEA vectors`_ created by `NESSIE`_.
344* IDEA (CBC, CFB, OFB) generated by this project.
345 See: :doc:`/development/custom-vectors/idea`
Paul Kehrer1d0f9732014-04-08 08:44:25 -0500346* SEED (ECB) from :rfc:`4269`.
Paul Kehrerf0e12ac2014-04-08 08:59:40 -0500347* SEED (CBC) from :rfc:`4196`.
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500348* SEED (CFB, OFB) generated by this project.
349 See: :doc:`/development/custom-vectors/seed`
Paul Kehrer1681a692014-02-11 23:43:51 -0600350
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000351Two factor authentication
Ayrx933dd682014-02-18 23:26:11 +0800352~~~~~~~~~~~~~~~~~~~~~~~~~
353
354* HOTP from :rfc:`4226`
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800355* TOTP from :rfc:`6238` (Note that an `errata`_ for the test vectors in RFC
356 6238 exists)
Ayrx933dd682014-02-18 23:26:11 +0800357
Ayrx1d6b77b2014-04-10 23:11:03 +0800358CMAC
359~~~~
360
Ayrxfa52e6a2014-04-14 22:26:21 +0800361* AES-128, AES-192, AES-256, 3DES from `NIST SP-800-38B`_
Ayrx1d6b77b2014-04-10 23:11:03 +0800362
Alex Stapletonc5fffd32014-03-18 15:29:00 +0000363Creating test vectors
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600364---------------------
365
366When official vectors are unavailable ``cryptography`` may choose to build
Paul Kehrer9f7ad192014-09-24 21:54:39 -0500367its own using existing vectors as source material.
michael-hart59f72192014-09-24 11:31:20 +0100368
Paul Kehrerebc26502014-11-26 19:18:56 -1000369Custom Symmetric Vectors
370~~~~~~~~~~~~~~~~~~~~~~~~
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600371
372.. toctree::
373 :maxdepth: 1
374
375 custom-vectors/cast5
Paul Kehrerb09622c2014-02-16 19:32:04 -0600376 custom-vectors/idea
Paul Kehrer6d8f9b02014-04-08 09:17:02 -0500377 custom-vectors/seed
Paul Kehrercf6ffb52014-02-12 16:17:04 -0600378
379If official test vectors appear in the future the custom generated vectors
380should be discarded.
381
382Any vectors generated by this method must also be prefixed with the following
383header format (substituting the correct information):
384
385.. code-block:: python
386
387 # CAST5 CBC vectors built for https://github.com/pyca/cryptography
388 # Derived from the AESVS MMT test data for CBC
389 # Verified against the CommonCrypto and Go crypto packages
390 # Key Length : 128
391
Paul Kehrer1681a692014-02-11 23:43:51 -0600392.. _`NIST`: http://www.nist.gov/
393.. _`IETF`: https://www.ietf.org/
394.. _`NIST CAVP`: http://csrc.nist.gov/groups/STM/cavp/
395.. _`Bruce Schneier's vectors`: https://www.schneier.com/code/vectors.txt
396.. _`Camellia page`: http://info.isl.ntt.co.jp/crypt/eng/camellia/
397.. _`CRYPTREC`: http://www.cryptrec.go.jp
398.. _`OpenSSL's test vectors`: https://github.com/openssl/openssl/blob/97cf1f6c2854a3a955fd7dd3a1f113deba00c9ef/crypto/evp/evptests.txt#L232
399.. _`RIPEMD website`: http://homes.esat.kuleuven.be/~bosselae/ripemd160.html
400.. _`Whirlpool website`: http://www.larc.usp.br/~pbarreto/WhirlpoolPage.html
Alex Gaynor75e72ea2014-03-01 12:18:27 -0800401.. _`draft RFC`: https://tools.ietf.org/html/draft-josefsson-scrypt-kdf-01
Paul Kehrer1681a692014-02-11 23:43:51 -0600402.. _`Specification repository`: https://github.com/fernet/spec
Ayrx933dd682014-02-18 23:26:11 +0800403.. _`errata`: http://www.rfc-editor.org/errata_search.php?rfc=6238
Paul Kehrer5e9a8a32015-03-02 13:25:45 -0600404.. _`OpenSSL example key`: https://github.com/openssl/openssl/blob/d02b48c63a58ea4367a0e905979f140b7d090f86/test/testrsa.pem
Paul Kehrerdac86a92015-03-06 08:36:07 -0600405.. _`GnuTLS key parsing tests`: https://gitlab.com/gnutls/gnutls/commit/f16ef39ef0303b02d7fa590a37820440c466ce8d
406.. _`enc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/encpkcs8.pem
407.. _`enc2-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/enc2pkcs8.pem
408.. _`unenc-rsa-pkcs8.pem`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs8-decode/unencpkcs8.pem
409.. _`pkcs12_s2k_pem.c`: https://gitlab.com/gnutls/gnutls/blob/f8d943b38bf74eaaa11d396112daf43cb8aa82ae/tests/pkcs12_s2k_pem.c
Alex Stapletonabec8a12014-02-22 16:33:24 +0000410.. _`Botan's ECC private keys`: https://github.com/randombit/botan/tree/4917f26a2b154e841cd27c1bcecdd41d2bdeb6ce/src/tests/data/ecc
Alex Gaynor3efbf492015-03-09 07:13:22 -0400411.. _`GnuTLS example keys`: https://gitlab.com/gnutls/gnutls/commit/ad2061deafdd7db78fd405f9d143b0a7c579da7b
Paul Kehrerb09622c2014-02-16 19:32:04 -0600412.. _`NESSIE IDEA vectors`: https://www.cosic.esat.kuleuven.be/nessie/testvectors/bc/idea/Idea-128-64.verified.test-vectors
413.. _`NESSIE`: https://en.wikipedia.org/wiki/NESSIE
Alex Stapleton833a8ea2014-04-02 14:50:56 +0100414.. _`Ed25519 website`: http://ed25519.cr.yp.to/software.html
Ayrx40afce02014-04-13 19:17:52 +0800415.. _`NIST SP-800-38B`: http://csrc.nist.gov/publications/nistpubs/800-38B/Updated_CMAC_Examples.pdf
Paul Kehrerbab4e392014-11-24 11:48:17 -1000416.. _`NIST PKI Testing`: http://csrc.nist.gov/groups/ST/crypto_apps_infra/pki/pkitesting.html
Paul Kehrerebc26502014-11-26 19:18:56 -1000417.. _`testx509.pem`: https://github.com/openssl/openssl/blob/master/test/testx509.pem
418.. _`DigiCert Global Root G3`: http://cacerts.digicert.com/DigiCertGlobalRootG3.crt
Paul Kehrer2b6ba0c2015-02-14 18:58:20 -0600419.. _`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 -0600420.. _`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 -0500421.. _`Mozilla bug`: https://bugzilla.mozilla.org/show_bug.cgi?id=233586