[couchdb-documentation] 01/01: Document new hash_algorithms config key

[ro...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

ronny pushed a commit to branch hash_algorithms-config
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git

commit 9206e0e6ff31fa7dcc4ee92b64b7aca6d39f29a5
Author: Ronny Berndt <ro...@apache.org>
AuthorDate: Thu Aug 25 20:43:10 2022 +0200

    Document new hash_algorithms config key
---
 src/config/auth.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/src/config/auth.rst b/src/config/auth.rst
index 40a7a8f..38e5e8a 100644
--- a/src/config/auth.rst
+++ b/src/config/auth.rst
@@ -194,6 +194,24 @@ Authentication Configuration
             [chttpd_auth]
             authentication_redirect = /_utils/session.html
 
+    .. config:option:: hash_algorithms :: Supported hash algorithms for cookie auth
+
+        .. versionadded:: 3.3
+
+        Sets the HMAC hash algorithm used for cookie authentication. You can provide a
+        comma-separated list of hash algorithms. New cookie sessions or
+        session updates are calculated with the first hash algorithm. All values in the
+        list can be used to decode the cookie session. ::
+
+            [chttpd_auth]
+            hash_algorithms = sha256, sha
+
+        .. note::
+            The following hash algorithms are supported: ::
+
+                sha, sha224, sha256, sha384, sha512, sha3_224, sha3_256, sha3_384, sha3_512,
+                blake2b, blake2s, md4, md5, ripemd160
+
     .. config:option:: iterations :: PBKDF2 iterations count
 
         .. versionadded:: 1.3