From 8c47a7657d03777a03a6838c7ec937b6347d07f8 Mon Sep 17 00:00:00 2001 From: Hans Nilsson Date: Tue, 18 Sep 2018 12:13:42 +0200 Subject: crypto: Add warnings in RefMan and User's Guide for experimental RSA opts --- lib/crypto/doc/src/algorithm_details.xml | 8 +++++++- lib/crypto/doc/src/crypto.xml | 14 ++++++++++++++ 2 files changed, 21 insertions(+), 1 deletion(-) (limited to 'lib/crypto/doc') diff --git a/lib/crypto/doc/src/algorithm_details.xml b/lib/crypto/doc/src/algorithm_details.xml index 2d02422cb6..19a19b1ece 100644 --- a/lib/crypto/doc/src/algorithm_details.xml +++ b/lib/crypto/doc/src/algorithm_details.xml @@ -213,7 +213,13 @@ list with the public_keys tag in the return value of crypto:supports().

- + + +

The RSA options are experimental. +

+

The exact set of options and there syntax may be changed + without prior notice.

+ Option sign/verify encrypt/decrypt Supported with
OpenSSL versions {rsa_mgf1_md,atom()} x x 1.0.1 diff --git a/lib/crypto/doc/src/crypto.xml b/lib/crypto/doc/src/crypto.xml index e6811a9a93..b7447cb9a3 100644 --- a/lib/crypto/doc/src/crypto.xml +++ b/lib/crypto/doc/src/crypto.xml @@ -284,6 +284,13 @@

Options for public key encrypt/decrypt. Only RSA is supported.

+ + +

The RSA options are experimental. +

+

The exact set of options and there syntax may be changed + without prior notice.

+ @@ -309,6 +316,13 @@

Options for sign and verify.

+ + +

The RSA options are experimental. +

+

The exact set of options and there syntax may be changed + without prior notice.

+ -- cgit v1.2.3 From 3a23cabe452837a28feed3860f3c257ded5948cd Mon Sep 17 00:00:00 2001 From: Hans Nilsson Date: Tue, 18 Sep 2018 16:22:57 +0200 Subject: crypto: Re-work the 'Description' section Links and contents needs update. --- lib/crypto/doc/src/crypto.xml | 179 +++++++++++++++++++++++++++++++++--------- 1 file changed, 144 insertions(+), 35 deletions(-) (limited to 'lib/crypto/doc') diff --git a/lib/crypto/doc/src/crypto.xml b/lib/crypto/doc/src/crypto.xml index b7447cb9a3..651b647e1c 100644 --- a/lib/crypto/doc/src/crypto.xml +++ b/lib/crypto/doc/src/crypto.xml @@ -28,41 +28,150 @@

This module provides a set of cryptographic functions.

- - -

Hash functions - - Secure Hash Standard, - The MD5 Message Digest Algorithm (RFC 1321) and - The MD4 Message Digest Algorithm (RFC 1320) -

- - -

Hmac functions - Keyed-Hashing for Message Authentication (RFC 2104)

- - -

Cmac functions - The AES-CMAC Algorithm (RFC 4493)

- - -

Block ciphers - DES and AES in - Block Cipher Modes - ECB, CBC, CFB, OFB, CTR and GCM

- - -

GCM: Dworkin, M., - "Recommendation for Block Cipher Modes of Operation: Galois/Counter Mode (GCM) and GMAC", - National Institute of Standards and Technology SP 800-38D, November 2007. -

- - -

RSA encryption RFC 1321

- - -

Digital signatures Digital Signature Standard (DSS) and Elliptic Curve Digital - Signature Algorithm (ECDSA)

- - -

Secure Remote Password Protocol (SRP - RFC 2945)

- - + + Hash functions + +

+ + SHA1, SHA2 + + + Secure Hash Standard [FIPS PUB 180-4] + + + SHA3 + + + SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions [FIPS PUB 202] + + + MD5 + + The MD5 Message Digest Algorithm [RFC 1321] + + MD4 + + The MD4 Message Digest Algorithm [RFC 1320] + + +

+ + + MACs - Message Authentication Codes + +

+ + Hmac functions + + + Keyed-Hashing for Message Authentication [RFC 2104] + + + Cmac functions + + + The AES-CMAC Algorithm [RFC 4493] + + + POLY1305 + + + ChaCha20 and Poly1305 for IETF Protocols [RFC 7539] + + + +

+ + + Symmetric Ciphers + +

+ + DES, 3DES and AES + + Block Cipher Techniques [NIST] + + Blowfish + + + Fast Software Encryption, Cambridge Security Workshop Proceedings (December 1993), Springer-Verlag, 1994, pp. 191-204. + + + Chacha20 + + + ChaCha20 and Poly1305 for IETF Protocols [RFC 7539] + + + Chacha20_poly1305 + + + ChaCha20 and Poly1305 for IETF Protocols [RFC 7539] + + + +

+ + + Modes + +

+ + ECB, CBC, CFB, OFB and CTR + + + Recommendation for Block Cipher Modes of Operation: Methods and Techniques [NIST SP 800-38A] + + + GCM + + + Recommendation for Block Cipher Modes of Operation: Galois/Counter Mode (GCM) and GMAC [NIST SP 800-38D] + + + CCM + + + Recommendation for Block Cipher Modes of Operation: + The CCM Mode for Authentication and Confidentiality [NIST SP 800-38C] + + + +

+ + + Asymetric Ciphers - Public Key Techniques + +

+ + RSA + + + PKCS #1: RSA Cryptography Specifications [RFC 3447] + + + DSS + + + Digital Signature Standard (DSS) [FIPS 186-4] + + + ECDSA + + + Elliptic Curve Digital Signature Algorithm [ECDSA] + + + SRP + + + The SRP Authentication and Key Exchange System [RFC 2945] + + + +

+ +

The actual supported algorithms and features depends on their availability in the actual libcrypto used. -- cgit v1.2.3