You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by ji...@apache.org on 2025/12/07 04:48:34 UTC

(couchdb) branch fix-password-hasher updated (7d1e95c1d -> 4ed6cc5f6)

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

jiahuili430 pushed a change to branch fix-password-hasher
in repository https://gitbox.apache.org/repos/asf/couchdb.git


 discard 7d1e95c1d Add tests for couch_password_hasher.erl
 discard 3de50fe6c Avoid updating the user file with every request
     add d103a7f82 Fix bulk_get error handling
     add 137df0e1e chore: rename `couch` make target to `couch-core`
     add 29e3fb90f feat: allow for parallel execution of `make eunit` sub-targets
     add f5e145d6d chore: move nouveau to extra/nouveau to avoid parallel make target clobbering
     add ab3c92e1f doc: explain parallel make feature
     add 40752fce1 chore: simplify test setup calls
     add d22339215 feat: make fabric test setup more reliable by just asserting the deletion of a shards db
     add f6a5c3a5f feat: allow parallel execution of eunit tests
     add 88fcdce98 chore: lint
     new 4ed6cc5f6 Avoid updating password hash when request with simple password scheme

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (7d1e95c1d)
            \
             N -- N -- N   refs/heads/fix-password-hasher (4ed6cc5f6)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 Makefile                                           |  63 ++++---
 README-DEV.rst                                     |  16 ++
 dev/run                                            |   4 +-
 {nouveau => extra/nouveau}/.gitignore              |   0
 {nouveau => extra/nouveau}/LICENSE                 |   0
 {nouveau => extra/nouveau}/README.md               |   0
 {nouveau => extra/nouveau}/TODO                    |   0
 {nouveau => extra/nouveau}/build.gradle            |   0
 .../nouveau}/gradle/wrapper/gradle-wrapper.jar     | Bin
 .../gradle/wrapper/gradle-wrapper.properties       |   0
 {nouveau => extra/nouveau}/gradlew                 |   0
 {nouveau => extra/nouveau}/gradlew.bat             | 184 ++++++++++-----------
 {nouveau => extra/nouveau}/settings.gradle         |   0
 .../apache/couchdb/nouveau/NouveauApplication.java |   0
 .../nouveau/NouveauApplicationConfiguration.java   |   0
 .../apache/couchdb/nouveau/api/AnalyzeRequest.java |   0
 .../couchdb/nouveau/api/AnalyzeResponse.java       |   0
 .../couchdb/nouveau/api/DocumentDeleteRequest.java |   0
 .../couchdb/nouveau/api/DocumentUpdateRequest.java |   0
 .../apache/couchdb/nouveau/api/DoubleField.java    |   0
 .../apache/couchdb/nouveau/api/DoubleRange.java    |   0
 .../java/org/apache/couchdb/nouveau/api/Field.java |   0
 .../couchdb/nouveau/api/IndexDefinition.java       |   0
 .../org/apache/couchdb/nouveau/api/IndexInfo.java  |   0
 .../couchdb/nouveau/api/IndexInfoRequest.java      |   0
 .../java/org/apache/couchdb/nouveau/api/Ok.java    |   0
 .../java/org/apache/couchdb/nouveau/api/Range.java |   0
 .../org/apache/couchdb/nouveau/api/SearchHit.java  |   0
 .../apache/couchdb/nouveau/api/SearchRequest.java  |   0
 .../apache/couchdb/nouveau/api/SearchResults.java  |   0
 .../apache/couchdb/nouveau/api/StoredField.java    |   0
 .../apache/couchdb/nouveau/api/StringField.java    |   0
 .../org/apache/couchdb/nouveau/api/TextField.java  |   0
 .../org/apache/couchdb/nouveau/core/IOUtils.java   |   0
 .../org/apache/couchdb/nouveau/core/Index.java     |   0
 .../apache/couchdb/nouveau/core/IndexFunction.java |   0
 .../apache/couchdb/nouveau/core/IndexManager.java  |   0
 .../couchdb/nouveau/core/StaleIndexException.java  |   0
 .../apache/couchdb/nouveau/core/StripedLock.java   |   0
 .../nouveau/core/UpdatesOutOfOrderException.java   |   0
 .../couchdb/nouveau/core/UserAgentFilter.java      |   0
 .../couchdb/nouveau/core/ser/ByteArrayWrapper.java |   0
 .../couchdb/nouveau/core/ser/DoubleWrapper.java    |   0
 .../couchdb/nouveau/core/ser/FloatWrapper.java     |   0
 .../couchdb/nouveau/core/ser/IntWrapper.java       |   0
 .../couchdb/nouveau/core/ser/LongWrapper.java      |   0
 .../couchdb/nouveau/core/ser/NullWrapper.java      |   0
 .../couchdb/nouveau/core/ser/PrimitiveWrapper.java |   0
 .../couchdb/nouveau/core/ser/StringWrapper.java    |   0
 .../couchdb/nouveau/health/AnalyzeHealthCheck.java |   0
 .../couchdb/nouveau/health/IndexHealthCheck.java   |   0
 .../nouveau/lucene9/Lucene9AnalyzerFactory.java    |   0
 .../couchdb/nouveau/lucene9/Lucene9Index.java      |   0
 .../nouveau/lucene9/Lucene9IndexSchema.java        |   0
 .../couchdb/nouveau/lucene9/Lucene9Module.java     |   0
 .../nouveau/lucene9/NouveauQueryParser.java        |   0
 .../nouveau/lucene9/ParallelSearcherFactory.java   |   0
 .../couchdb/nouveau/lucene9/QueryDeserializer.java |   0
 .../couchdb/nouveau/lucene9/QuerySerializer.java   |   0
 .../lucene9/SimpleAsciiFoldingAnalyzer.java        |   0
 .../couchdb/nouveau/resources/AnalyzeResource.java |   0
 .../couchdb/nouveau/resources/IndexResource.java   |   0
 .../couchdb/nouveau/tasks/CloseAllIndexesTask.java |   0
 .../nouveau}/src/main/resources/banner.txt         |   0
 .../nouveau}/src/main/resources/openapi.yaml       |   0
 .../couchdb/nouveau/api/SearchRequestTest.java     |   0
 .../couchdb/nouveau/core/IndexManagerTest.java     |   0
 .../nouveau/health/AnalyzeHealthCheckTest.java     |   0
 .../nouveau/health/IndexHealthCheckTest.java       |   0
 .../lucene9/Lucene9AnalyzerFactoryTest.java        |   0
 .../couchdb/nouveau/lucene9/Lucene9IndexTest.java  |   0
 .../nouveau/lucene9/NouveauQueryParserTest.java    |   0
 .../nouveau/lucene9/QuerySerializationTest.java    |   0
 .../resources/fixtures/DocumentUpdateRequest.json  |   0
 .../src/test/resources/fixtures/SearchRequest.json |   0
 src/chttpd/src/chttpd_test_util.erl                |   2 +-
 src/couch/src/couch_password_hasher.erl            |  15 +-
 src/couch/src/test_util.erl                        |  50 +++++-
 .../test/eunit/couch_passwords_hasher_tests.erl    | 177 ++++++++------------
 src/ddoc_cache/test/eunit/ddoc_cache_tutil.erl     |   2 +-
 src/fabric/src/fabric_open_revs.erl                |  52 +++++-
 src/fabric/test/eunit/fabric_tests.erl             |   6 +-
 .../test/eunit/mem3_reshard_changes_feed_test.erl  |   2 +-
 src/mem3/test/eunit/mem3_reshard_test.erl          |   2 +-
 src/mem3/test/eunit/mem3_shards_test.erl           |   2 +-
 85 files changed, 323 insertions(+), 254 deletions(-)
 rename {nouveau => extra/nouveau}/.gitignore (100%)
 rename {nouveau => extra/nouveau}/LICENSE (100%)
 rename {nouveau => extra/nouveau}/README.md (100%)
 rename {nouveau => extra/nouveau}/TODO (100%)
 rename {nouveau => extra/nouveau}/build.gradle (100%)
 rename {nouveau => extra/nouveau}/gradle/wrapper/gradle-wrapper.jar (100%)
 rename {nouveau => extra/nouveau}/gradle/wrapper/gradle-wrapper.properties (100%)
 rename {nouveau => extra/nouveau}/gradlew (100%)
 rename {nouveau => extra/nouveau}/gradlew.bat (96%)
 rename {nouveau => extra/nouveau}/settings.gradle (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/NouveauApplication.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/NouveauApplicationConfiguration.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/AnalyzeRequest.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/AnalyzeResponse.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/DocumentDeleteRequest.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/DocumentUpdateRequest.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/DoubleField.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/DoubleRange.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/Field.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/IndexDefinition.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/IndexInfo.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/IndexInfoRequest.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/Ok.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/Range.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/SearchHit.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/SearchRequest.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/SearchResults.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/StoredField.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/StringField.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/api/TextField.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/IOUtils.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/Index.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/IndexFunction.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/IndexManager.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/StaleIndexException.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/StripedLock.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/UpdatesOutOfOrderException.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/UserAgentFilter.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/ByteArrayWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/DoubleWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/FloatWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/IntWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/LongWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/NullWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/PrimitiveWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/core/ser/StringWrapper.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/health/AnalyzeHealthCheck.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/health/IndexHealthCheck.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/Lucene9AnalyzerFactory.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/Lucene9Index.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/Lucene9IndexSchema.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/Lucene9Module.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/NouveauQueryParser.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/ParallelSearcherFactory.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/QueryDeserializer.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/QuerySerializer.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/lucene9/SimpleAsciiFoldingAnalyzer.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/resources/AnalyzeResource.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/resources/IndexResource.java (100%)
 rename {nouveau => extra/nouveau}/src/main/java/org/apache/couchdb/nouveau/tasks/CloseAllIndexesTask.java (100%)
 rename {nouveau => extra/nouveau}/src/main/resources/banner.txt (100%)
 rename {nouveau => extra/nouveau}/src/main/resources/openapi.yaml (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/api/SearchRequestTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/core/IndexManagerTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/health/AnalyzeHealthCheckTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/health/IndexHealthCheckTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/lucene9/Lucene9AnalyzerFactoryTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/lucene9/Lucene9IndexTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/lucene9/NouveauQueryParserTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/java/org/apache/couchdb/nouveau/lucene9/QuerySerializationTest.java (100%)
 rename {nouveau => extra/nouveau}/src/test/resources/fixtures/DocumentUpdateRequest.json (100%)
 rename {nouveau => extra/nouveau}/src/test/resources/fixtures/SearchRequest.json (100%)


(couchdb) 01/01: Avoid updating password hash when request with simple password scheme

Posted by ji...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

jiahuili430 pushed a commit to branch fix-password-hasher
in repository https://gitbox.apache.org/repos/asf/couchdb.git

commit 4ed6cc5f6dca4807f6a34880b1332eed86b23ce4
Author: Jiahui Li <li...@gmail.com>
AuthorDate: Sat Dec 6 19:12:32 2025 -0600

    Avoid updating password hash when request with simple password scheme
    
    When using the `simple` password scheme, the number of iterations
    is `undefined`, so the user's password hash is updated every time
    when a new request is made using user's authentication credentials.
    
    Add a case statement to avoid this situation.
---
 src/couch/src/couch_password_hasher.erl            |  11 +-
 .../test/eunit/couch_passwords_hasher_tests.erl    | 196 +++++++++++++++++++++
 2 files changed, 204 insertions(+), 3 deletions(-)

diff --git a/src/couch/src/couch_password_hasher.erl b/src/couch/src/couch_password_hasher.erl
index 677d1c2f5..eb50c341c 100644
--- a/src/couch/src/couch_password_hasher.erl
+++ b/src/couch/src/couch_password_hasher.erl
@@ -28,6 +28,9 @@
 
 -export([worker_loop/1]).
 
+% For testing
+-export([is_doc/1, upgrade_password_hash/6]).
+
 -define(IN_PROGRESS_ETS, couch_password_hasher_in_progress).
 
 -record(state, {
@@ -40,7 +43,7 @@
 
 maybe_upgrade_password_hash(Req, UserName, Password, UserProps, AuthModule, AuthCtx) ->
     UpgradeEnabled = config:get_boolean("chttpd_auth", "upgrade_hash_on_auth", true),
-    IsDoc = is_doc(UserProps),
+    IsDoc = couch_password_hasher:is_doc(UserProps),
     NeedsUpgrade = needs_upgrade(UserProps),
     InProgress = in_progress(AuthModule, UserName),
     if
@@ -122,7 +125,7 @@ needs_upgrade(UserProps) ->
         "iterations", 600000
     ),
     case {TargetScheme, TargetIterations, TargetPRF} of
-        {CurrentScheme, CurrentIterations, _} when CurrentScheme == <<"simple">> ->
+        {CurrentScheme, _, _} when CurrentScheme == <<"simple">>, CurrentIterations =:= undefined ->
             false;
         {CurrentScheme, CurrentIterations, CurrentPRF} when CurrentScheme == <<"pbkdf2">> ->
             false;
@@ -141,7 +144,9 @@ worker_loop(Parent) ->
     receive
         {upgrade_password_hash, Req, UserName, Password, UserProps, AuthModule, AuthCtx} ->
             couch_log:notice("upgrading stored password hash for '~s' (~p)", [UserName, AuthCtx]),
-            upgrade_password_hash(Req, UserName, Password, UserProps, AuthModule, AuthCtx),
+            couch_password_hasher:upgrade_password_hash(
+                Req, UserName, Password, UserProps, AuthModule, AuthCtx
+            ),
             erlang:send_after(5000, Parent, {done, AuthModule, UserName});
         _Msg ->
             ignore
diff --git a/src/couch/test/eunit/couch_passwords_hasher_tests.erl b/src/couch/test/eunit/couch_passwords_hasher_tests.erl
new file mode 100644
index 000000000..acb105eec
--- /dev/null
+++ b/src/couch/test/eunit/couch_passwords_hasher_tests.erl
@@ -0,0 +1,196 @@
+% Licensed under the Apache License, Version 2.0 (the "License"); you may not
+% use this file except in compliance with the License. You may obtain a copy of
+% the License at
+%
+%   http://www.apache.org/licenses/LICENSE-2.0
+%
+% Unless required by applicable law or agreed to in writing, software
+% distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+% WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+% License for the specific language governing permissions and limitations under
+% the License.
+
+-module(couch_passwords_hasher_tests).
+
+-include_lib("couch/include/couch_db.hrl").
+-include_lib("couch/include/couch_eunit.hrl").
+
+-define(USER, "couch_passowrds_hash_test_admin").
+-define(PASS, "pass").
+-define(AUTH, {basic_auth, {?USER, ?PASS}}).
+-define(CONTENT_JSON, {"Content-Type", "application/json"}).
+-define(RANDOM_USER, "user-" ++ ?b2l(couch_uuids:random())).
+
+setup(Scheme) ->
+    update_hash(?USER, ?PASS),
+    Db = ?b2l(?tempdb()),
+    create_db(Db),
+    config:set("couch_httpd_auth", "authentication_db", Db, false),
+    config:set("couch_httpd_auth", "password_scheme", Scheme, false),
+    meck:new(couch_password_hasher, [passthrough]),
+    Db.
+
+teardown(_, Db) ->
+    delete_db(Db),
+    config:delete("admins", ?USER, false),
+    config:delete("couch_httpd_auth", "authentication_db", false),
+    config:delete("couch_httpd_auth", "password_scheme", false),
+    meck:unload().
+
+couch_password_hasher_test_() ->
+    {
+        "couch_password_hasher tests",
+        {
+            setup,
+            fun() -> test_util:start_couch([chttpd]) end,
+            fun test_util:stop_couch/1,
+            [
+                upgrade_password_hash_tests("simple"),
+                upgrade_password_hash_tests("pbkdf2")
+            ]
+        }
+    }.
+
+upgrade_password_hash_tests(Scheme) ->
+    {
+        "password scheme " ++ Scheme ++ " tests",
+        foreachx,
+        fun setup/1,
+        fun teardown/2,
+        [
+            {Scheme, Test}
+         || Test <-
+                [
+                    fun create_user_by_admin_should_not_upgrade_password_hash/2,
+                    fun request_by_user_should_not_upgrade_password_hash/2,
+                    fun update_user_password_by_user_should_not_upgrade_password_hash/2
+                ]
+        ]
+    }.
+
+create_user_by_admin_should_not_upgrade_password_hash(_, Db) ->
+    ?_test(begin
+        reset(),
+        create_user(Db, ?RANDOM_USER, ?PASS),
+        ?assertEqual(0, num_calls())
+    end).
+
+request_by_user_should_not_upgrade_password_hash(_, Db) ->
+    ?_test(begin
+        User = ?RANDOM_USER,
+        create_user(Db, User, ?PASS),
+        {200, _} = req(get, url(Db, "org.couchdb.user:" ++ User)),
+        ?_assertEqual(0, num_calls()),
+
+        update_hash(User, ?PASS),
+        reset(),
+        meck:expect(couch_password_hasher, is_doc, fun(_) -> true end),
+        Headers = [{basic_auth, {User, ?PASS}}],
+        {200, _} = req(get, url(), Headers, []),
+        ?_assertEqual(0, num_calls()),
+        config:delete("admins", User, false)
+    end).
+
+update_user_password_by_user_should_not_upgrade_password_hash(_, Db) ->
+    ?_test(begin
+        User = ?RANDOM_USER,
+        create_user(Db, User, ?PASS),
+        {200, #{<<"_rev">> := Rev}} = req(get, url(Db, "org.couchdb.user:" ++ User)),
+        ?_assertEqual(0, num_calls()),
+
+        update_hash(User, ?PASS),
+        reset(),
+        meck:expect(couch_password_hasher, is_doc, fun(_) -> true end),
+        NewPass = "new_password",
+        update_password(Db, User, ?PASS, NewPass, ?b2l(Rev)),
+        ?_assertEqual(0, num_calls()),
+
+        update_hash(User, NewPass),
+        OldAuth = [{basic_auth, {User, ?PASS}}],
+        {401, _} = req(get, url(), OldAuth, []),
+        ?_assertEqual(0, num_calls()),
+        NewAuth = [{basic_auth, {User, NewPass}}],
+        {200, _} = req(get, url(), NewAuth, []),
+        ?_assertEqual(0, num_calls()),
+        config:delete("admins", User, false)
+    end).
+
+%%%%%%%%%%%%%%%%%%%% Utility Functions %%%%%%%%%%%%%%%%%%%%
+update_hash(User, Pass) ->
+    Hashed = couch_passwords:hash_admin_password(Pass),
+    config:set("admins", User, ?b2l(Hashed), false).
+
+url() ->
+    Addr = config:get("chttpd", "bind_address", "127.0.0.1"),
+    Port = mochiweb_socket_server:get(chttpd, port),
+    lists:concat(["http://", Addr, ":", Port]).
+
+url(Db) ->
+    url() ++ "/" ++ Db.
+
+url(Db, Path) ->
+    url(Db) ++ "/" ++ Path.
+
+create_db(Db) ->
+    case req(put, url(Db)) of
+        {201, #{}} -> ok;
+        Error -> error({failed_to_create_test_db, Db, Error})
+    end.
+
+delete_db(Db) ->
+    case req(delete, url(Db)) of
+        {200, #{}} -> ok;
+        Error -> error({failed_to_delete_test_db, Db, Error})
+    end.
+
+create_user(Db, UserName, Password) ->
+    ok = couch_auth_cache:ensure_users_db_exists(),
+    User = ?l2b(UserName),
+    Pass = ?l2b(Password),
+    Body =
+        {[
+            {<<"name">>, User},
+            {<<"password">>, Pass},
+            {<<"roles">>, []},
+            {<<"type">>, <<"user">>}
+        ]},
+    case req(put, url(Db, "org.couchdb.user:" ++ UserName), jiffy:encode(Body)) of
+        {201, #{}} -> ok;
+        Error -> error({failed_to_create_user, UserName, Error})
+    end.
+
+update_password(Db, UserName, Password, NewPassword, Rev) ->
+    User = ?l2b(UserName),
+    NewPass = ?l2b(NewPassword),
+    Body =
+        {[
+            {<<"name">>, User},
+            {<<"password">>, NewPass},
+            {<<"roles">>, []},
+            {<<"type">>, <<"user">>}
+        ]},
+    Headers = [{basic_auth, {UserName, Password}}, {"If-Match", Rev}],
+    case req(put, url(Db, "org.couchdb.user:" ++ UserName), Headers, jiffy:encode(Body)) of
+        {201, #{}} -> ok;
+        Error -> error({failed_to_update_password, UserName, Error})
+    end.
+
+req(Method, Url) ->
+    Headers = [?CONTENT_JSON, ?AUTH],
+    {ok, Code, _, Res} = test_request:request(Method, Url, Headers),
+    {Code, jiffy:decode(Res, [return_maps])}.
+
+req(Method, Url, Body) ->
+    Headers = [?CONTENT_JSON, ?AUTH],
+    {ok, Code, _, Res} = test_request:request(Method, Url, Headers, Body),
+    {Code, jiffy:decode(Res, [return_maps])}.
+
+req(Method, Url, Headers, Body) ->
+    {ok, Code, _, Res} = test_request:request(Method, Url, Headers, Body),
+    {Code, jiffy:decode(Res, [return_maps])}.
+
+reset() ->
+    meck:reset(couch_password_hasher).
+
+num_calls() ->
+    meck:num_calls(couch_password_hasher, upgrade_password_hash, ['_', '_', '_', '_', '_', '_']).