├── .github └── FUNDING.yml ├── mvn-upload.sh ├── .travis.yml ├── doc ├── Makefile └── user-guide.md ├── .gitignore ├── doc.clj ├── README.md ├── scripts └── repl ├── deps.edn ├── test ├── user.clj └── buddy │ └── hashers_tests.clj ├── CHANGES.md ├── LICENSE └── src ├── clj └── buddy │ └── hashers.clj └── java └── buddy └── impl └── bcrypt └── BCrypt.java /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | github: niwinz 2 | patreon: niwinz 3 | -------------------------------------------------------------------------------- /mvn-upload.sh: -------------------------------------------------------------------------------- 1 | #!/bin/sh 2 | mvn deploy:deploy-file -Dfile=target/buddy-hashers.jar -DpomFile=pom.xml -DrepositoryId=clojars -Durl=https://clojars.org/repo/ 3 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | language: clojure 2 | sudo: false 3 | lein: lein 4 | 5 | script: 6 | - lein test-all 7 | 8 | jdk: 9 | - openjdk8 10 | - openjdk10 11 | - openjdk11 12 | -------------------------------------------------------------------------------- /doc/Makefile: -------------------------------------------------------------------------------- 1 | all: doc 2 | 3 | doc: 4 | mkdir -p dist/latest/ 5 | cd ..; clojure -A:dev:codox -M doc.clj; 6 | 7 | github: doc 8 | ghp-import -m "Generate documentation" -b gh-pages dist/ 9 | git push origin gh-pages 10 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | /target 2 | /classes 3 | /checkouts 4 | .cpcache 5 | .rebel_readline_history 6 | pom.xml 7 | pom.xml.asc 8 | *.jar 9 | *.class 10 | *.swp 11 | /.lein-* 12 | /.nrepl-port 13 | /doc/dist/ 14 | \#*\# 15 | *~ 16 | .\#* 17 | *.iml 18 | .idea 19 | -------------------------------------------------------------------------------- /doc.clj: -------------------------------------------------------------------------------- 1 | (require '[codox.main :as codox]) 2 | 3 | (codox/generate-docs 4 | {:output-path "doc/dist/latest" 5 | :metadata {:doc/format :markdown} 6 | :language :clojure 7 | :name "buddy/buddy-hashers" 8 | :themes [:rdash] 9 | :source-paths ["src/clj"] 10 | :namespaces [#"^buddy\."] 11 | :source-uri "https://github.com/funcool/buddy-hashers/blob/master/{filepath}#L{line}"}) 12 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | [![Clojars Project](http://clojars.org/buddy/buddy-hashers/latest-version.svg)](http://clojars.org/buddy/buddy-hashers) 2 | 3 | # buddy-hashers - password hashers for Clojure 4 | 5 | *buddy-hashers* provides a collection of secure password hashers with 6 | lightweight and extensible abstraction for build powerfull password 7 | authentication processes. 8 | 9 | See the [documentation](https://funcool.github.io/buddy-hashers/latest/) for more detailed 10 | information. 11 | -------------------------------------------------------------------------------- /scripts/repl: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env bash 2 | 3 | export OPTIONS=" 4 | -A:dev \ 5 | -J-XX:-OmitStackTraceInFastThrow \ 6 | -J-Xms50m \ 7 | -J-Xmx512m \ 8 | -J-Djdk.attach.allowAttachSelf \ 9 | -J-XX:+UnlockDiagnosticVMOptions \ 10 | -J-XX:+DebugNonSafepoints"; 11 | 12 | # Disable C2 Compiler 13 | # export OPTIONS="$OPTIONS -J-XX:TieredStopAtLevel=1" 14 | 15 | # Disable all compilers 16 | # export OPTIONS="$OPTIONS -J-Xint" 17 | 18 | # export OPTIONS_EVAL="nil" 19 | export OPTIONS_EVAL="(set! *warn-on-reflection* true)" 20 | 21 | set -ex 22 | exec clojure $OPTIONS -M -e "$OPTIONS_EVAL" -m rebel-readline.main 23 | -------------------------------------------------------------------------------- /deps.edn: -------------------------------------------------------------------------------- 1 | {:deps 2 | {buddy/buddy-core {:mvn/version "1.11.423"} 3 | clojurewerkz/scrypt {:mvn/version "1.2.0"}} 4 | :paths ["src/clj" "target/classes"] 5 | :aliases 6 | {:dev 7 | {:extra-deps 8 | {org.clojure/tools.namespace {:mvn/version "RELEASE"} 9 | org.clojure/test.check {:mvn/version "RELEASE"} 10 | org.clojure/tools.deps.alpha {:mvn/version "RELEASE"} 11 | org.clojure/clojure {:mvn/version "1.11.1"} 12 | com.bhauman/rebel-readline {:mvn/version "RELEASE"} 13 | criterium/criterium {:mvn/version "RELEASE"}} 14 | :extra-paths ["test" "dev"]} 15 | 16 | :codox 17 | {:extra-deps 18 | {codox/codox {:mvn/version "RELEASE"} 19 | org.clojure/tools.reader {:mvn/version "RELEASE"} 20 | codox-theme-rdash/codox-theme-rdash {:mvn/version "RELEASE"}}} 21 | 22 | :test 23 | {:extra-paths ["test"] 24 | :extra-deps 25 | {io.github.cognitect-labs/test-runner 26 | {:git/tag "v0.5.1" :git/sha "dfb30dd"}} 27 | :exec-fn cognitect.test-runner.api/test 28 | :exec-args {:patterns [".*-test.*"]}} 29 | 30 | :build 31 | {:extra-deps 32 | {io.github.clojure/tools.build {:git/tag "v0.9.3" :git/sha "e537cd1"}} 33 | :ns-default build} 34 | 35 | :outdated 36 | {:extra-deps {com.github.liquidz/antq {:mvn/version "RELEASE"} 37 | org.slf4j/slf4j-nop {:mvn/version "RELEASE"}} 38 | :main-opts ["-m" "antq.core"]}}} 39 | -------------------------------------------------------------------------------- /test/user.clj: -------------------------------------------------------------------------------- 1 | ;; This Source Code Form is subject to the terms of the Mozilla Public 2 | ;; License, v. 2.0. If a copy of the MPL was not distributed with this 3 | ;; file, You can obtain one at http://mozilla.org/MPL/2.0/. 4 | ;; 5 | ;; Copyright (c) 2016-2022 Andrey Antukh 6 | 7 | (ns user 8 | (:require 9 | [clojure.spec.alpha :as s] 10 | [clojure.tools.namespace.repl :as repl] 11 | [clojure.walk :refer [macroexpand-all]] 12 | [clojure.pprint :refer [pprint]] 13 | [clojure.test :as test] 14 | [clojure.java.io :as io] 15 | [clojure.repl :refer :all] 16 | [criterium.core :refer [quick-bench bench with-progress-reporting]])) 17 | 18 | (defmacro run-quick-bench 19 | [& exprs] 20 | `(with-progress-reporting (quick-bench (do ~@exprs) :verbose))) 21 | 22 | (defmacro run-quick-bench' 23 | [& exprs] 24 | `(quick-bench (do ~@exprs))) 25 | 26 | (defmacro run-bench 27 | [& exprs] 28 | `(with-progress-reporting (bench (do ~@exprs) :verbose))) 29 | 30 | (defmacro run-bench' 31 | [& exprs] 32 | `(bench (do ~@exprs))) 33 | 34 | (defn run-tests 35 | ([] (run-tests #".*-tests$")) 36 | ([o] 37 | (repl/refresh) 38 | (cond 39 | (instance? java.util.regex.Pattern o) 40 | (test/run-all-tests o) 41 | 42 | (symbol? o) 43 | (if-let [sns (namespace o)] 44 | (do (require (symbol sns)) 45 | (test/test-vars [(resolve o)])) 46 | (test/test-ns o))))) 47 | 48 | -------------------------------------------------------------------------------- /doc/user-guide.md: -------------------------------------------------------------------------------- 1 | # User Guide 2 | 3 | *buddy-hashers* provides a collection of secure password hashers with 4 | lightweight and extensible abstraction for build powerfull password 5 | authentication processes. 6 | 7 | Supported password hashers algorithms: 8 | 9 | | Identifier | Can I use it? | Description | 10 | |---|---|---| 11 | | `:bcrypt+blake2b-512` | Recommended | BCrypt password hasher combined with blake2b-512 | 12 | | `:argon2id` | Recommended | Argon2id password hasher | 13 | | `:pbkdf2+blake2b-512` | Yes | Password-Based Key Derivation Function 2 with blake2b-512| 14 | | `:pbkdf2+sha512` | Yes | Password-Based Key Derivation Function 2 with SHA256 | 15 | | `:pbkdf2+sha3-256` | Yes | Password-Based Key Derivation Function 2 with SHA3-256 | 16 | | `:bcrypt+sha512` | Yes | BCrypt password hasher combined with sha512 (default) | 17 | | `:pbkdf2+sha256` | Yes | Password-Based Key Derivation Function 2 with SHA256 | 18 | | `:bcrypt+sha384` | Yes | BCrypt password hasher combined with sha384 | 19 | | `:pbkdf2+sha1` | Yes | Password-Based Key Derivation Function 2 (as defined in RFC2898) | 20 | | `:scrypt` | Yes | Password-Based Key Derivation Function created by Colin Percival | 21 | | `:argon2id` | Yes | Memory-Hard Key Derivation Function for password hashing and other applications | 22 | 23 | 24 | ## Install 25 | 26 | The simplest way to use _buddy-core_ in a clojure project, is by including it in the 27 | dependency vector on your *_project.clj_* file: 28 | 29 | ```clojure 30 | [buddy/buddy-hashers "2.0.167"] 31 | ``` 32 | 33 | Or deps.edn: 34 | 35 | ```clojure 36 | buddy/buddy-hashers {:mvn/version "2.0.167"} 37 | ``` 38 | 39 | And is tested under JDK >= 8 40 | 41 | 42 | ## Quick Start 43 | 44 | Hashers module consists in two public functions: *derive* and *check* 45 | and both them are located on `buddy.hashers` namespace. 46 | 47 | Let start deriving a password: 48 | 49 | 50 | ```clojure 51 | (require '[buddy.hashers :as hashers]) 52 | 53 | ;; Generate hash from plain password 54 | (hashers/derive "secretpassword") 55 | ;; => "bcrypt+sha512$4i9sd34m..." 56 | 57 | (hashers/verify "secretpassword" "bcrypt+sha512$4i9sd34m...") 58 | ;; => {:valid true :update false} 59 | ``` 60 | 61 | If no algorithm is specified, the `:bcrypt+sha512` will be used by 62 | default. **We highly recommend setting your own default for prevent 63 | any unexpected situations when the library changes the default.** 64 | 65 | If you want to use a specific one, you can specify it using 66 | the optional options parameter: 67 | 68 | ```clojure 69 | ;; Generate hash from plain password 70 | (hashers/derive "secretpassword" {:alg :pbkdf2+sha256}) 71 | ;; => "pbkdf2+sha256$4i9sd34m..." 72 | 73 | (hashers/verify "secretpassword" "pbkdf2+sha256$4i9sd34m...") 74 | ;; => {:valid true :update false} 75 | ``` 76 | 77 | ## Advanced options 78 | 79 | ### Algorithm tunning params 80 | 81 | Each algorithm can be tweaked passing additional parameters on the 82 | second argument to *derive* function. And options vary depending on 83 | the used algorithm. 84 | 85 | Table that details available options and defaults values: 86 | 87 | | Algorithm | Available options | Defaults | 88 | |---|---|---| 89 | | `:bcrypt+blake2b-512` | `:salt`, `:iterations` | iterations=12, salt=(random 16 bytes) | 90 | | `:bcrypt+sha384` | `:salt`, `:iterations` | iterations=12, salt=(random 16 bytes) | 91 | | `:pbkdf2+blake2b-512` | `:salt`, `:iterations` | iterations=50000, salt=(random 12 bytes) | 92 | | `:pbkdf2+sha512` | `:salt`, `:iterations` | iterations=100000, salt=(random 12 bytes) | 93 | | `:pbkdf2+sha3_256` | `:salt`, `:iterations` | iterations=100000, salt=(random 12 bytes) | 94 | | `:pbkdf2+sha1` | `:salt`, `:iterations` | iterations=100000, salt=(random 12 bytes) | 95 | | `:scrypt` | `:salt`, `:cpucost`, `:memcost`, `:parallelism` | salt=(random 12 bytes), cpucost=65536, memcost=8, parallelism=1 | 96 | | `:bcrypt+sha512` | `:salt`, `:iterations` | iterations=12, salt=(random 12 bytes) | 97 | | `:pbkdf2+sha256` | `:salt`, `:iterations` | iterations=100000, salt=(random 12 bytes) | 98 | | `:argon2id` | `:salt`, `:memory`, `:iterations`, `:parallelism` | salt=(random 16 bytes), memory=65536, iterations=2, parallelism=1 | 99 | 100 | 101 | ### Limiting algorithms 102 | 103 | Some times you don't want to use all the supported algorithms and you only want 104 | to use a own set of algorithms in the password check process. That can be done 105 | passing additional parameter to the `check` function: 106 | 107 | ```clojure 108 | (def trusted-algs #{:pbkdf2+sha256 :bcrypt+sha512}) 109 | 110 | (hashers/verify incoming-pwd derived-pwd {:limit trusted-algs}) 111 | ``` 112 | 113 | The `verify` function will return false if the incoming password uses an algorithm 114 | that does not allowed. 115 | 116 | 117 | ### Password updating 118 | 119 | Choice a strong algorithm is important thing, but have a good update 120 | password-hashes policy is also very important and usually completelly 121 | forgotten. The password generated 3 years ago is weaker that one 122 | generated today... 123 | 124 | *buddy-hashers* comes with a solution for make this task easier. The returned 125 | object by the `verify` function contains a prop `:update` that indicates 126 | if the password should be updated or not. 127 | 128 | It there is an example on how it can be used: 129 | 130 | ```clojure 131 | (let [result (hashers/verify incoming-pwd derived-pwd)] 132 | (when (:valid result) 133 | (when (:update result) 134 | (do-db-update (hashers/derive incoming-pwd))))) 135 | ``` 136 | 137 | 138 | ## Source Code 139 | 140 | _buddy-hashers_ is open source and can be found on 141 | [github](https://github.com/funcool/buddy-hashers). 142 | 143 | You can clone the public repository with this command: 144 | 145 | ```bash 146 | git clone https://github.com/funcool/buddy-hashers 147 | ``` 148 | 149 | 150 | ## Run tests 151 | 152 | For running tests just execute this: 153 | 154 | ```bash 155 | lein test 156 | ``` 157 | 158 | 159 | ## License 160 | 161 | _buddy-hashers_ is licensed under Apache 2.0 License. You can see the 162 | complete text of the license on the root of the repository on 163 | `LICENSE` file. 164 | -------------------------------------------------------------------------------- /CHANGES.md: -------------------------------------------------------------------------------- 1 | # Changelog 2 | 3 | ## Version 2.0.167 4 | 5 | Date: 2023-06-30 6 | 7 | - Update dependencies. 8 | 9 | 10 | ## Version 2.0.162 11 | 12 | Date: 2023-05-20 13 | 14 | - Update dependencies. 15 | - **BREAKING CHANGE**: internal must-update? multimethod changed call 16 | signature and make check algorithm more usable. 17 | 18 | 19 | ## Version 1.8.158 20 | 21 | Date: 2022-01-14 22 | 23 | - Update dependencies. 24 | 25 | 26 | ## Version 1.8.1 27 | 28 | Date: 2021-05-02 29 | 30 | - Update buddy-core to 1.10.1 31 | 32 | 33 | ## Version 1.8.0 34 | 35 | Date: 2021-05-01 36 | 37 | - Update buddy-core to 1.10.0 38 | 39 | 40 | ## Version 1.7.0 41 | 42 | Date: 2020-09-15 43 | 44 | - Update buddy-core to 1.9.0 45 | - Add native argon2id. 46 | 47 | 48 | ## Version 1.6.0 49 | 50 | Date: 2020-09-15 51 | 52 | - Add `verify` function as better alternative to `check`. 53 | 54 | 55 | ## Version 1.5.1 56 | 57 | Date: 2020-09-15 58 | 59 | - Revert some breaking changes from previous version. 60 | 61 | 62 | ## Version 1.5.0 63 | 64 | Date: 2020-09-15 65 | 66 | - Update buddy-core to 1.7.1 67 | - Remove unused internal BCrypt impl. 68 | - Remove deprecated `:pbkdf2+sha3_256` alias. 69 | - Fix documentation. 70 | 71 | ## Version 1.4.0 72 | 73 | Date: 2019-06-28 74 | 75 | - Update buddy-core to 1.6.0 76 | 77 | 78 | ## Version 1.3.0 79 | 80 | Date: 2017-08-29 81 | 82 | - Update buddy-core to 1.4.0 83 | 84 | 85 | ## Version 1.2.0 86 | 87 | Date: 2017-01-24 88 | 89 | - Update buddy-core to 1.2.0 90 | 91 | 92 | ## Version 1.1.0 93 | 94 | Date: 2016-11-15 95 | 96 | - Update buddy-core to 1.1.1 97 | 98 | 99 | ## Version 1.0.0 100 | 101 | Date: 2016-09-01 102 | 103 | - Update buddy-core to 1.0.0 104 | - Change versiom scheme to be consistent with buddy-core. 105 | 106 | 107 | ## Version 0.14.0 108 | 109 | Date: 2016-04-09 110 | 111 | - Update buddy-core to 0.12.1. 112 | 113 | 114 | ## Version 0.13.0 115 | 116 | Date: 2016-03-27 117 | 118 | - Update buddy-core to 0.11.0. 119 | 120 | 121 | ## Version 0.12.0 122 | 123 | Date: 2016-03-26 124 | 125 | - The `encrypt` function becomes `derive` (backward compatibile change). 126 | - Update buddy-core to 0.10.0. 127 | 128 | 129 | ## Version 0.11.0 130 | 131 | Date: 2016-01-23 132 | 133 | - The `:algorithm` parameter is now removed (`:alg` should be used). 134 | - The `:sha256` and `:md5` hashers are removed. 135 | - The randomization of default algorithm introduced in 0.9.x is 136 | now reverted and the ` 137 | - Set clojure 1.8.0 as default clojure version. 138 | 139 | 140 | ## Version 0.10.0 141 | 142 | Date: 2016-01-06 143 | 144 | - Update buddy-core dependency to 0.9.0. 145 | 146 | 147 | ## Version 0.9.1 148 | 149 | Date: 2015-11-28 150 | 151 | - Update to buddy-core 0.8.1. 152 | 153 | 154 | ## Version 0.9.0 155 | 156 | Date: 2015-11-09 157 | 158 | Important notes: 159 | 160 | - The `encrypt` function now selects a random algorithm from recommended 161 | algorithms list instead to have default one. This enables to have additional 162 | security layer having more than one algorithm to be broken for recover 163 | all passwords. This behavior is different from previous one and you should 164 | care about it. If you want the previous behavior, just preselect the 165 | prefered cipher passing it explicitly to the `encrypt` function. 166 | - The `bcrypt+sha512` hasher strength is improved. 167 | The previous algorithm is still available for password checking only and 168 | password update setter will be triggered if password with old algorithm 169 | is used for checking process. 170 | - The `pbkdf2+sha256` hasher strength is improved. 171 | A little weakness is discovered in the implementation that decreases the hash 172 | security from 256 bits to 160 bits (output truncation). This means that 173 | the old password are at least secure as `pbkdf2+sha1`, that is still 174 | condsidered secure and widele employed (besides, the sha256 hash output 175 | truncated to 160 bits is more secure than sha1, so you don't be worried 176 | about that). 177 | The hasher algorithm is backward compatible and if you are using the builtin 178 | helpers for password upgrading it will be automatically triggered if old 179 | version of password is checked. 180 | 181 | Other changes: 182 | 183 | - The `pbkdf2+sha3_256` is renamed to `pbkdf2+sha3-256`. This is a backward 184 | compatible change because the previous alias is still conserved until the next 185 | release. 186 | - The `md5` and `sha256` hashers has been deprecated and will be removed in the 187 | next version. 188 | - Add `:pbkdf2+blake2b-512` hasher as part of the recommended password hashers. 189 | - Add `:pbkdf2+sha512` hasher as part of the recommended password hashers. 190 | - Add `:bcrypt+sha384` hasher (for some one that does not like use blake2b-512). 191 | - The `:algorithm` parameter is deprecated in favor of the shorter `:alg`. 192 | 193 | 194 | ## Version 0.8.0 195 | 196 | Date: 2015-10-31 197 | 198 | - Add the ability to limit the set of allowed algorithms 199 | to be used in the check process. 200 | - Add the ability to react in case the password has weak 201 | configuration and rehash it again (and store fresh 202 | encoded password with updated stronger config). 203 | - Decrease the rounds for :pbkdf2-sha3_256 because 204 | the previous one was too heavy. 205 | 206 | 207 | ## Version 0.7.0 208 | 209 | Date: 2015-09-19 210 | 211 | - Set default clojure version to 1.7.0 212 | - Update buddy-core version to 0.7.0 213 | 214 | 215 | ## Version 0.6.0 216 | 217 | Date: 2015-06-28 218 | 219 | - Update to buddy-core 0.6.0 220 | - Remove buddy-hashers 0.2.x hashers implementation. 221 | 222 | 223 | ## Version 0.5.0 224 | 225 | Date: 2015-06-15 226 | 227 | - `check` function is now null pointer safe. 228 | 229 | 230 | ## Version 0.4.2 231 | 232 | Date: 2015-04-03 233 | 234 | - Update buddy-core to 0.5.0 235 | 236 | 237 | ## Version 0.4.1 238 | 239 | Date: 2015-03-14 240 | 241 | - Update buddy-core from 0.4.0 to 0.4.2 242 | 243 | 244 | ## Version 0.4.0 245 | 246 | Date: 2015-02-22 247 | 248 | - Update buddy-core dependency version to 0.4.0 249 | - Adapt the code to buddy-core 0.4.0 250 | 251 | 252 | ## Version 0.3.0 253 | 254 | Date: 2015-01-18 255 | 256 | - First version splitted from monolitic buddy package. 257 | - Add complete refactored version of hashers, more flexible and extensible. 258 | - Add support for pbkdf2+sha256 and pbkdf2+sha3_256 password hasher algorithms. 259 | - Maintain the old namespace for backward compatibility. 260 | -------------------------------------------------------------------------------- /test/buddy/hashers_tests.clj: -------------------------------------------------------------------------------- 1 | ;; Copyright 2014-2016 Andrey Antukh 2 | ;; 3 | ;; Licensed under the Apache License, Version 2.0 (the "License") 4 | ;; you may not use this file except in compliance with the License. 5 | ;; You may obtain a copy of the License at 6 | ;; 7 | ;; http://www.apache.org/licenses/LICENSE-2.0 8 | ;; 9 | ;; Unless required by applicable law or agreed to in writing, software 10 | ;; distributed under the License is distributed on an "AS IS" BASIS, 11 | ;; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 | ;; See the License for the specific language governing permissions and 13 | ;; limitations under the License. 14 | 15 | (ns buddy.hashers-tests 16 | (:require 17 | [clojure.test :as t :refer :all] 18 | [buddy.core.codecs :refer :all] 19 | [buddy.core.nonce :as nonce] 20 | [buddy.core.bytes :as bytes] 21 | [buddy.core.codecs :as codecs] 22 | [buddy.hashers :as hashers])) 23 | 24 | (t/deftest buddy-hashers-check 25 | (let [pwd "my-test-password"] 26 | (are [alg] 27 | (let [result (hashers/encrypt pwd {:alg alg})] 28 | (hashers/check pwd result)) 29 | :pbkdf2+sha1 30 | :pbkdf2+sha256 31 | :pbkdf2+sha512 32 | :pbkdf2+blake2b-512 33 | :bcrypt+sha512 34 | :bcrypt+sha384 35 | :bcrypt+blake2b-512 36 | :scrypt 37 | :argon2id))) 38 | 39 | (t/deftest buddy-hashers-verify 40 | (let [pwd "my-test-password"] 41 | (are [alg] 42 | (let [result (hashers/encrypt pwd {:alg alg})] 43 | (true? (:valid (hashers/verify pwd result)))) 44 | :pbkdf2+sha1 45 | :pbkdf2+sha256 46 | :pbkdf2+sha512 47 | :pbkdf2+blake2b-512 48 | :bcrypt+sha512 49 | :bcrypt+sha384 50 | :bcrypt+blake2b-512 51 | :scrypt 52 | :argon2id))) 53 | 54 | (t/deftest confirm-check-failure 55 | (let [pwd-good "my-test-password" 56 | pwd-bad "my-text-password"] 57 | (are [alg] 58 | (let [result (hashers/encrypt pwd-good {:alg alg})] 59 | (not (hashers/check pwd-bad result))) 60 | :pbkdf2+sha1 61 | :pbkdf2+sha256 62 | :pbkdf2+sha512 63 | :pbkdf2+sha3-256 64 | :pbkdf2+blake2b-512 65 | :bcrypt+sha512 66 | :bcrypt+sha384 67 | :bcrypt+blake2b-512 68 | :scrypt 69 | :argon2id))) 70 | 71 | (t/deftest confirm-verify-failure 72 | (let [pwd-good "my-test-password" 73 | pwd-bad "my-text-password"] 74 | (are [alg] 75 | (let [result (hashers/encrypt pwd-good {:alg alg})] 76 | (not (:valid (hashers/check pwd-bad result)))) 77 | :pbkdf2+sha1 78 | :pbkdf2+sha256 79 | :pbkdf2+sha512 80 | :pbkdf2+sha3-256 81 | :pbkdf2+blake2b-512 82 | :bcrypt+sha512 83 | :bcrypt+sha384 84 | :bcrypt+blake2b-512 85 | :scrypt 86 | :argon2id))) 87 | 88 | (t/deftest buddy-hashers-nil 89 | (let [pwd "my-test-password" 90 | result (hashers/encrypt pwd {:alg :pbkdf2+sha256})] 91 | (t/is (nil? (hashers/check nil result))) 92 | (t/is (nil? (hashers/check pwd nil))) 93 | (t/is (nil? (hashers/check nil nil))))) 94 | 95 | (t/deftest algorithm-embedded-in-hash 96 | (let [pwd "my-test-password"] 97 | (are [alg] 98 | (-> (hashers/encrypt pwd {:alg alg}) 99 | (.startsWith (name alg))) 100 | :pbkdf2+sha1 101 | :pbkdf2+sha256 102 | :pbkdf2+sha512 103 | :pbkdf2+sha3-256 104 | :pbkdf2+blake2b-512 105 | :bcrypt+sha512 106 | :bcrypt+sha384 107 | :bcrypt+blake2b-512 108 | :scrypt 109 | :argon2id))) 110 | 111 | ;; Confirm that the algorithm used is always embedded at the 112 | ;; start of the hash, and that the salt is also appended (after 113 | ;; being converted to their byte values) 114 | 115 | (t/deftest received-salt-embedded-in-hash 116 | (let [pwd "my-test-password" 117 | salt (nonce/random-bytes 16)] 118 | (are [alg] 119 | (-> (hashers/encrypt pwd {:alg alg :salt salt}) 120 | (.startsWith (str (name alg) "$" ( bytes->hex salt)))) 121 | :pbkdf2+sha1 122 | :pbkdf2+sha256 123 | :pbkdf2+sha512 124 | :pbkdf2+sha3-256 125 | :pbkdf2+blake2b-512 126 | :bcrypt+sha512 127 | :bcrypt+sha384 128 | :bcrypt+blake2b-512 129 | :scrypt 130 | :argon2id))) 131 | 132 | (t/deftest limit-available-algorithms-check 133 | (let [pwd (hashers/encrypt "hello" {:alg :scrypt}) 134 | limit #{:pbkdf2+sha256 :bcrypt+sha512}] 135 | (t/is (hashers/check "hello" pwd)) 136 | (t/is (not (hashers/check "hello" pwd {:limit limit}))))) 137 | 138 | (t/deftest limit-available-algorithms-verify 139 | (let [pwd (hashers/encrypt "hello" {:alg :scrypt}) 140 | limit #{:pbkdf2+sha256 :bcrypt+sha512}] 141 | (t/is (:valid (hashers/verify "hello" pwd))) 142 | (t/is (not (:valid (hashers/verify "hello" pwd {:limit limit})))))) 143 | 144 | (t/deftest possible-regressions-checker 145 | (let [pbkdf2+sha1 "pbkdf2+sha1$fcf7c2e5848193f91d8a5a40$100000$b499843df692e02be67e534f8592a0785927843a" 146 | pbkdf2+sha256-legacy "pbkdf2+sha256$7d0994313982465d82372493$100000$98c4b3043b30622917516e97d1c6bd9936337e8c" 147 | pbkdf2+sha256 "pbkdf2+sha256$092c7d26206ae9641d225ca432a9efcf$100000$76417ba855c352750319ae649141082bfa83e18ba3a4937580ae7d0226168c6a" 148 | pbkdf2+sha512 "pbkdf2+sha512$50577ebbbe53552a270598fd$100000$ee0b82c8887fc4bac8e8a28a785e2c7d679fc87a4c42478302ae40acad84aae77fdd2bce57b75595250c1a0226dbbdc4b94954ec61c7d2188d82ea15bce67af5" 149 | pbkdf2+sha3-256 "pbkdf2+sha3-256$1278c96b4e68b98c633041dc$5000$d89f67636fec62cdd8379f8ff9305bece38f09b20659916d41cf91eacd91a85b" 150 | pbkdf2+blake2b-512 "pbkdf2+blake2b-512$1a26daa54a09150de9f5a053$5000$2fe5dde2355a179f88969218466cd587681af2ce7d6de07080d94efab7cec9e091b7b1c3a34311ff72a3a883f261619b67583c1742f661bb3ab65bc4402fd4c1" 151 | scrypt "scrypt$f54d4b5a1e8d8e63c82e1553$65536$8$1$24733024313030383031246850416d5378645243726664336350546b5a4c7330413d3d243448376945454c47395155492f2b477a42735a582f76554f3345495248656c6939734a73516c356e6571413d" 152 | sha256 "sha256$bbac53106f8ce4f8c2d78f86$2182339b43ed1546b21488922c2516b64917025084577b33fc49357d9dd2c673" 153 | bcrypt+blake2b-512 "bcrypt+blake2b-512$95d0488b2b69c79d4f48ab39338c322e$12$40a4ef31b6dd390b27bd6fc3c2fdeabfb1db85c9bef25c22" 154 | bcrypt+sha512-legacy "bcrypt+sha512$680bf9ad0bf9f8249bfebb85$12$243261243132244b4e2e4e456650704558323964686e6c64644f4b73656a6879584f635a4f6b7778596132475036772e6c2e784f49596631556f7679" 155 | bcrypt+sha512 "bcrypt+sha512$b932bf208c7f3ecb563eebe89c39115b$12$bc3633d1f07c47edd91f0e7cf5649b040ea868cec63cda31" 156 | bcrypt+sha384 "bcrypt+sha384$5c3b8cc880e0dd91520a900a8c8c6223$12$fa6e0a810b81b04634b19311e77eb00ba1d0f12c570adafa" 157 | argon2id "argon2id$9682763587dcaf962161d4b24d7246b3$65536$2$1$4181787747eb7330abda8f42b2fb0dfab207e5cf0c0031a2233a00484d739c8c"] 158 | (t/is (hashers/check "test" pbkdf2+sha1)) 159 | (t/is (hashers/check "test" pbkdf2+sha256)) 160 | (t/is (hashers/check "test" pbkdf2+sha256-legacy)) 161 | (t/is (hashers/check "test" pbkdf2+sha512)) 162 | (t/is (hashers/check "test" pbkdf2+sha3-256)) 163 | (t/is (hashers/check "test" scrypt)) 164 | (t/is (hashers/check "test" pbkdf2+blake2b-512)) 165 | (t/is (hashers/check "test" bcrypt+sha512-legacy)) 166 | (t/is (hashers/check "test" bcrypt+sha512)) 167 | (t/is (hashers/check "test" bcrypt+sha384)) 168 | (t/is (hashers/check "test" bcrypt+blake2b-512)) 169 | (t/is (hashers/check "test" argon2id)) 170 | )) 171 | 172 | (t/deftest debug-time-bench 173 | (let [pwd "my-test-password"] 174 | (are [alg] 175 | (do 176 | (time (hashers/encrypt pwd {:alg alg})) 177 | true) 178 | :pbkdf2+sha1 179 | :pbkdf2+sha256 180 | :pbkdf2+sha512 181 | :pbkdf2+sha3-256 182 | :pbkdf2+blake2b-512 183 | :bcrypt+sha512 184 | :bcrypt+sha384 185 | :bcrypt+blake2b-512 186 | :scrypt 187 | :argon2id))) 188 | 189 | (t/deftest must-update-1 190 | (doseq [alg [:pbkdf2+sha1 191 | :pbkdf2+sha256 192 | :pbkdf2+sha512 193 | :pbkdf2+sha3-256 194 | :pbkdf2+blake2b-512 195 | :bcrypt+sha512 196 | :bcrypt+sha384 197 | :bcrypt+blake2b-512]] 198 | (let [password (hashers/derive "test" {:iterations 4 :alg alg}) 199 | result1 (hashers/verify "test" password {:iterations 4 :alg alg}) 200 | result2 (hashers/verify "test" password {:iterations 5 :alg alg})] 201 | (t/is (true? (:valid result1))) 202 | (t/is (false? (:update result1))) 203 | 204 | (t/is (true? (:valid result2))) 205 | (t/is (true? (:update result2)))))) 206 | 207 | (t/deftest must-update-scrypt 208 | (let [password (hashers/derive "test" {:cpucost 4 :alg :scrypt}) 209 | result1 (hashers/verify "test" password {:cpucost 4 :alg :scrypt}) 210 | result2 (hashers/verify "test" password {:cpucost 5 :alg :scrypt})] 211 | (t/is (true? (:valid result1))) 212 | (t/is (false? (:update result1))) 213 | (t/is (true? (:valid result2))) 214 | (t/is (true? (:update result2))))) 215 | 216 | (t/deftest must-update-argon 217 | (let [password (hashers/derive "test" {:iterations 1 :alg :argon2id}) 218 | result1 (hashers/verify "test" password {:iterations 1 :alg :argon2id}) 219 | result2 (hashers/verify "test" password {:iterations 2 :alg :argon2id})] 220 | (t/is (true? (:valid result1))) 221 | (t/is (false? (:update result1))) 222 | (t/is (true? (:valid result2))) 223 | (t/is (true? (:update result2))))) 224 | 225 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | 2 | Apache License 3 | Version 2.0, January 2004 4 | http://www.apache.org/licenses/ 5 | 6 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 7 | 8 | 1. Definitions. 9 | 10 | "License" shall mean the terms and conditions for use, reproduction, 11 | and distribution as defined by Sections 1 through 9 of this document. 12 | 13 | "Licensor" shall mean the copyright owner or entity authorized by 14 | the copyright owner that is granting the License. 15 | 16 | "Legal Entity" shall mean the union of the acting entity and all 17 | other entities that control, are controlled by, or are under common 18 | control with that entity. For the purposes of this definition, 19 | "control" means (i) the power, direct or indirect, to cause the 20 | direction or management of such entity, whether by contract or 21 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 22 | outstanding shares, or (iii) beneficial ownership of such entity. 23 | 24 | "You" (or "Your") shall mean an individual or Legal Entity 25 | exercising permissions granted by this License. 26 | 27 | "Source" form shall mean the preferred form for making modifications, 28 | including but not limited to software source code, documentation 29 | source, and configuration files. 30 | 31 | "Object" form shall mean any form resulting from mechanical 32 | transformation or translation of a Source form, including but 33 | not limited to compiled object code, generated documentation, 34 | and conversions to other media types. 35 | 36 | "Work" shall mean the work of authorship, whether in Source or 37 | Object form, made available under the License, as indicated by a 38 | copyright notice that is included in or attached to the work 39 | (an example is provided in the Appendix below). 40 | 41 | "Derivative Works" shall mean any work, whether in Source or Object 42 | form, that is based on (or derived from) the Work and for which the 43 | editorial revisions, annotations, elaborations, or other modifications 44 | represent, as a whole, an original work of authorship. For the purposes 45 | of this License, Derivative Works shall not include works that remain 46 | separable from, or merely link (or bind by name) to the interfaces of, 47 | the Work and Derivative Works thereof. 48 | 49 | "Contribution" shall mean any work of authorship, including 50 | the original version of the Work and any modifications or additions 51 | to that Work or Derivative Works thereof, that is intentionally 52 | submitted to Licensor for inclusion in the Work by the copyright owner 53 | or by an individual or Legal Entity authorized to submit on behalf of 54 | the copyright owner. For the purposes of this definition, "submitted" 55 | means any form of electronic, verbal, or written communication sent 56 | to the Licensor or its representatives, including but not limited to 57 | communication on electronic mailing lists, source code control systems, 58 | and issue tracking systems that are managed by, or on behalf of, the 59 | Licensor for the purpose of discussing and improving the Work, but 60 | excluding communication that is conspicuously marked or otherwise 61 | designated in writing by the copyright owner as "Not a Contribution." 62 | 63 | "Contributor" shall mean Licensor and any individual or Legal Entity 64 | on behalf of whom a Contribution has been received by Licensor and 65 | subsequently incorporated within the Work. 66 | 67 | 2. Grant of Copyright License. Subject to the terms and conditions of 68 | this License, each Contributor hereby grants to You a perpetual, 69 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 70 | copyright license to reproduce, prepare Derivative Works of, 71 | publicly display, publicly perform, sublicense, and distribute the 72 | Work and such Derivative Works in Source or Object form. 73 | 74 | 3. Grant of Patent License. Subject to the terms and conditions of 75 | this License, each Contributor hereby grants to You a perpetual, 76 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 77 | (except as stated in this section) patent license to make, have made, 78 | use, offer to sell, sell, import, and otherwise transfer the Work, 79 | where such license applies only to those patent claims licensable 80 | by such Contributor that are necessarily infringed by their 81 | Contribution(s) alone or by combination of their Contribution(s) 82 | with the Work to which such Contribution(s) was submitted. If You 83 | institute patent litigation against any entity (including a 84 | cross-claim or counterclaim in a lawsuit) alleging that the Work 85 | or a Contribution incorporated within the Work constitutes direct 86 | or contributory patent infringement, then any patent licenses 87 | granted to You under this License for that Work shall terminate 88 | as of the date such litigation is filed. 89 | 90 | 4. Redistribution. You may reproduce and distribute copies of the 91 | Work or Derivative Works thereof in any medium, with or without 92 | modifications, and in Source or Object form, provided that You 93 | meet the following conditions: 94 | 95 | (a) You must give any other recipients of the Work or 96 | Derivative Works a copy of this License; and 97 | 98 | (b) You must cause any modified files to carry prominent notices 99 | stating that You changed the files; and 100 | 101 | (c) You must retain, in the Source form of any Derivative Works 102 | that You distribute, all copyright, patent, trademark, and 103 | attribution notices from the Source form of the Work, 104 | excluding those notices that do not pertain to any part of 105 | the Derivative Works; and 106 | 107 | (d) If the Work includes a "NOTICE" text file as part of its 108 | distribution, then any Derivative Works that You distribute must 109 | include a readable copy of the attribution notices contained 110 | within such NOTICE file, excluding those notices that do not 111 | pertain to any part of the Derivative Works, in at least one 112 | of the following places: within a NOTICE text file distributed 113 | as part of the Derivative Works; within the Source form or 114 | documentation, if provided along with the Derivative Works; or, 115 | within a display generated by the Derivative Works, if and 116 | wherever such third-party notices normally appear. The contents 117 | of the NOTICE file are for informational purposes only and 118 | do not modify the License. You may add Your own attribution 119 | notices within Derivative Works that You distribute, alongside 120 | or as an addendum to the NOTICE text from the Work, provided 121 | that such additional attribution notices cannot be construed 122 | as modifying the License. 123 | 124 | You may add Your own copyright statement to Your modifications and 125 | may provide additional or different license terms and conditions 126 | for use, reproduction, or distribution of Your modifications, or 127 | for any such Derivative Works as a whole, provided Your use, 128 | reproduction, and distribution of the Work otherwise complies with 129 | the conditions stated in this License. 130 | 131 | 5. Submission of Contributions. Unless You explicitly state otherwise, 132 | any Contribution intentionally submitted for inclusion in the Work 133 | by You to the Licensor shall be under the terms and conditions of 134 | this License, without any additional terms or conditions. 135 | Notwithstanding the above, nothing herein shall supersede or modify 136 | the terms of any separate license agreement you may have executed 137 | with Licensor regarding such Contributions. 138 | 139 | 6. Trademarks. This License does not grant permission to use the trade 140 | names, trademarks, service marks, or product names of the Licensor, 141 | except as required for reasonable and customary use in describing the 142 | origin of the Work and reproducing the content of the NOTICE file. 143 | 144 | 7. Disclaimer of Warranty. Unless required by applicable law or 145 | agreed to in writing, Licensor provides the Work (and each 146 | Contributor provides its Contributions) on an "AS IS" BASIS, 147 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 148 | implied, including, without limitation, any warranties or conditions 149 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 150 | PARTICULAR PURPOSE. You are solely responsible for determining the 151 | appropriateness of using or redistributing the Work and assume any 152 | risks associated with Your exercise of permissions under this License. 153 | 154 | 8. Limitation of Liability. In no event and under no legal theory, 155 | whether in tort (including negligence), contract, or otherwise, 156 | unless required by applicable law (such as deliberate and grossly 157 | negligent acts) or agreed to in writing, shall any Contributor be 158 | liable to You for damages, including any direct, indirect, special, 159 | incidental, or consequential damages of any character arising as a 160 | result of this License or out of the use or inability to use the 161 | Work (including but not limited to damages for loss of goodwill, 162 | work stoppage, computer failure or malfunction, or any and all 163 | other commercial damages or losses), even if such Contributor 164 | has been advised of the possibility of such damages. 165 | 166 | 9. Accepting Warranty or Additional Liability. While redistributing 167 | the Work or Derivative Works thereof, You may choose to offer, 168 | and charge a fee for, acceptance of support, warranty, indemnity, 169 | or other liability obligations and/or rights consistent with this 170 | License. However, in accepting such obligations, You may act only 171 | on Your own behalf and on Your sole responsibility, not on behalf 172 | of any other Contributor, and only if You agree to indemnify, 173 | defend, and hold each Contributor harmless for any liability 174 | incurred by, or claims asserted against, such Contributor by reason 175 | of your accepting any such warranty or additional liability. 176 | 177 | END OF TERMS AND CONDITIONS 178 | -------------------------------------------------------------------------------- /src/clj/buddy/hashers.clj: -------------------------------------------------------------------------------- 1 | ;; Copyright 2013-2020 Andrey Antukh 2 | ;; 3 | ;; Licensed under the Apache License, Version 2.0 (the "License") 4 | ;; you may not use this file except in compliance with the License. 5 | ;; You may obtain a copy of the License at 6 | ;; 7 | ;; http://www.apache.org/licenses/LICENSE-2.0 8 | ;; 9 | ;; Unless required by applicable law or agreed to in writing, software 10 | ;; distributed under the License is distributed on an "AS IS" BASIS, 11 | ;; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 | ;; See the License for the specific language governing permissions and 13 | ;; limitations under the License. 14 | 15 | (ns buddy.hashers 16 | (:refer-clojure :exclude [derive]) 17 | (:require 18 | [buddy.core.codecs :as codecs] 19 | [buddy.core.hash :as hash] 20 | [buddy.core.nonce :as nonce] 21 | [buddy.core.bytes :as bytes] 22 | [clojure.string :as str] 23 | [clojurewerkz.scrypt.core :as scrypt]) 24 | (:import 25 | java.security.Security 26 | org.bouncycastle.crypto.Digest 27 | org.bouncycastle.crypto.digests.SHA1Digest 28 | org.bouncycastle.crypto.digests.SHA256Digest 29 | org.bouncycastle.crypto.digests.SHA3Digest 30 | org.bouncycastle.crypto.generators.Argon2BytesGenerator 31 | org.bouncycastle.crypto.generators.BCrypt 32 | org.bouncycastle.crypto.generators.PKCS5S2ParametersGenerator 33 | org.bouncycastle.crypto.params.Argon2Parameters 34 | org.bouncycastle.crypto.params.Argon2Parameters$Builder 35 | org.bouncycastle.crypto.params.KeyParameter)) 36 | 37 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 38 | ;; Constants 39 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 40 | 41 | (def ^:no-doc default-params 42 | {:pbkdf2+sha1 {:iterations 100000} 43 | :pbkdf2+sha256 {:iterations 100000} 44 | :pbkdf2+sha512 {:iterations 100000} 45 | :pbkdf2+blake2b-512 {:iterations 50000} 46 | :pbkdf2+sha3-256 {:iterations 5000} 47 | :bcrypt+sha512 {:iterations 12} 48 | :bcrypt+sha384 {:iterations 12} 49 | :bcrypt+blake2b-512 {:iterations 12} 50 | :scrypt {:cpucost 65536 51 | :memcost 8} 52 | :argon2id {:memory 65536 53 | :iterations 2}}) 54 | 55 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 56 | ;; Impl Interface 57 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 58 | 59 | (defmulti parse-password 60 | "Parse password from string to parts." 61 | (fn [encryptedpassword] 62 | (-> encryptedpassword 63 | (str/split #"\$") 64 | (first) 65 | (keyword)))) 66 | 67 | (defn- dispatch 68 | [opts & args] 69 | (:alg opts)) 70 | 71 | (defmulti derive-password 72 | "Derive key depending on algorithm." 73 | dispatch) 74 | 75 | (defmulti check-password 76 | "Password verification implementation." 77 | dispatch) 78 | 79 | (defmulti format-password 80 | "Format password depending on algorithm." 81 | dispatch) 82 | 83 | (defmulti must-update? 84 | "Check if the current password configuration 85 | is succeptible to be updatable." 86 | dispatch) 87 | 88 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 89 | ;; Key Derivation 90 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 91 | 92 | (defmethod derive-password :pbkdf2 93 | [{:keys [alg password salt iterations digest] :as pwdparams}] 94 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 12))) 95 | alg (keyword (str "pbkdf2+" (name digest))) 96 | iterations (or iterations (get-in default-params [alg :iterations])) 97 | digest (hash/resolve-digest-engine digest) 98 | dsize (* 8 (.getDigestSize ^Digest digest)) 99 | pgen (doto (PKCS5S2ParametersGenerator. digest) 100 | (.init password salt iterations)) 101 | cparams (.generateDerivedParameters pgen dsize) 102 | password (.getKey ^KeyParameter cparams)] 103 | {:alg alg 104 | :password password 105 | :salt salt 106 | :iterations iterations})) 107 | 108 | (defmethod derive-password :pbkdf2+sha1 109 | [options] 110 | (derive-password (assoc options :alg :pbkdf2 :digest :sha1))) 111 | 112 | (defmethod derive-password :pbkdf2+sha256 113 | [options] 114 | (derive-password (assoc options :alg :pbkdf2 :digest :sha256))) 115 | 116 | (defmethod derive-password :pbkdf2+sha512 117 | [options] 118 | (derive-password (assoc options :alg :pbkdf2 :digest :sha512))) 119 | 120 | (defmethod derive-password :pbkdf2+blake2b-512 121 | [options] 122 | (derive-password (assoc options :alg :pbkdf2 :digest :blake2b-512))) 123 | 124 | (defmethod derive-password :pbkdf2+sha3-256 125 | [options] 126 | (derive-password (assoc options :alg :pbkdf2 :digest :sha3-256))) 127 | 128 | (defmethod derive-password :bcrypt+sha512 129 | [{:keys [alg password salt iterations]}] 130 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 16))) 131 | iterations (or iterations (get-in default-params [alg :iterations])) 132 | password (-> (hash/sha512 password) 133 | (BCrypt/generate salt iterations))] 134 | {:alg alg 135 | :iterations iterations 136 | :salt salt 137 | :password password})) 138 | 139 | (defmethod derive-password :bcrypt+blake2b-512 140 | [{:keys [alg password salt iterations] :as pwdparams}] 141 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 16))) 142 | iterations (or iterations (get-in default-params [alg :iterations])) 143 | password (-> (hash/blake2b-512 password) 144 | (BCrypt/generate salt iterations))] 145 | {:alg alg 146 | :iterations iterations 147 | :salt salt 148 | :password password})) 149 | 150 | (defmethod derive-password :bcrypt+sha384 151 | [{:keys [alg password salt iterations] :as pwdparams}] 152 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 16))) 153 | iterations (or iterations (get-in default-params [alg :iterations])) 154 | password (-> (hash/sha384 password) 155 | (BCrypt/generate salt iterations))] 156 | {:alg alg 157 | :iterations iterations 158 | :salt salt 159 | :password password})) 160 | 161 | (defmethod derive-password :scrypt 162 | [{:keys [alg password salt cpucost memcost parallelism] :as pwdparams}] 163 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 12))) 164 | cpucost (or cpucost (get-in default-params [:scrypt :cpucost])) 165 | memcost (or memcost (get-in default-params [:scrypt :memcost])) 166 | parallelism (or parallelism 1) 167 | password (-> (bytes/concat salt password salt) 168 | (codecs/bytes->hex) 169 | (scrypt/encrypt cpucost memcost parallelism) 170 | (codecs/str->bytes))] 171 | {:alg alg 172 | :cpucost cpucost 173 | :memcost memcost 174 | :parallelism parallelism 175 | :password password 176 | :salt salt})) 177 | 178 | (defmethod derive-password :argon2id 179 | [{:keys [alg password salt memory iterations parallelism] :as pwdparams}] 180 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 16))) 181 | memory (or memory (get-in default-params [:argon2id :memory])) ;; KiB 182 | iterations (or iterations (get-in default-params [:argon2id :iterations])) 183 | parallelism (or parallelism 1) 184 | params (-> (Argon2Parameters$Builder. Argon2Parameters/ARGON2_id) 185 | (.withSalt salt) 186 | (.withMemoryAsKB memory) 187 | (.withIterations iterations) 188 | (.withParallelism parallelism) 189 | (.build)) 190 | generator (Argon2BytesGenerator.) 191 | hash (byte-array 32)] 192 | (.init generator params) 193 | (.generateBytes generator ^bytes password hash) 194 | {:alg alg 195 | :memory memory 196 | :iterations iterations 197 | :parallelism parallelism 198 | :password hash 199 | :salt salt})) 200 | 201 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 202 | ;; Key Verification 203 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 204 | 205 | (defmethod check-password :bcrypt+sha512 206 | [params attempt] 207 | (let [pwdbytes (:password params)] 208 | (if (= (count pwdbytes) 24) 209 | (let [params' (assoc params :password attempt) 210 | candidate (derive-password params')] 211 | (bytes/equals? (:password params) 212 | (:password candidate))) 213 | 214 | ;; Backward compatibility for password checking 215 | ;; for old algorithm 216 | (let [candidate (-> (bytes/concat attempt (:salt params)) 217 | (hash/sha512))] 218 | (buddy.impl.bcrypt.BCrypt/checkpw 219 | (codecs/bytes->hex candidate) 220 | (codecs/bytes->str (:password params))))))) 221 | 222 | (defmethod check-password :scrypt 223 | [pwdparams attempt] 224 | (let [salt (:salt pwdparams) 225 | candidate (bytes/concat salt attempt salt)] 226 | (scrypt/verify (codecs/bytes->hex candidate) 227 | (codecs/bytes->str (:password pwdparams))))) 228 | 229 | (defn- derive-password-for-legacy-pbkdf2+sha256 230 | [{:keys [alg password salt saltsize iterations]}] 231 | (let [salt (codecs/to-bytes (or salt (nonce/random-bytes 12))) 232 | iterations (or iterations (get-in default-params [alg :iterations])) 233 | pgen (doto (PKCS5S2ParametersGenerator. (SHA256Digest.)) 234 | (.init password salt iterations)) 235 | cparams (.generateDerivedParameters pgen 160) 236 | password (.getKey ^KeyParameter cparams)] 237 | {:alg alg 238 | :password password 239 | :salt salt 240 | :iterations iterations})) 241 | 242 | (defmethod check-password :pbkdf2+sha256 243 | [params attempt] 244 | (let [pwdbytes (:password params)] 245 | (if (= (count pwdbytes) 20) 246 | ;; Backward compatibility with older passwords 247 | (let [params' (assoc params :password attempt) 248 | candidate (derive-password-for-legacy-pbkdf2+sha256 params')] 249 | (bytes/equals? (:password params) 250 | (:password candidate))) 251 | (let [params' (assoc params :password attempt) 252 | candidate (derive-password params')] 253 | (bytes/equals? (:password params) 254 | (:password candidate)))))) 255 | 256 | (defmethod check-password :default 257 | [pwdparams attempt] 258 | (let [candidate (-> (assoc pwdparams :password attempt) 259 | (derive-password))] 260 | (bytes/equals? (:password pwdparams) 261 | (:password candidate)))) 262 | 263 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 264 | ;; Key Formatting 265 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 266 | 267 | (defmethod format-password :scrypt 268 | [{:keys [password salt cpucost memcost parallelism]}] 269 | (let [salt (codecs/bytes->hex salt) 270 | password (codecs/bytes->hex password)] 271 | (format "scrypt$%s$%s$%s$%s$%s" salt cpucost memcost parallelism password))) 272 | 273 | (defmethod format-password :argon2id 274 | [{:keys [password salt memory iterations parallelism]}] 275 | (let [salt (codecs/bytes->hex salt) 276 | password (codecs/bytes->hex password)] 277 | (format "argon2id$%s$%s$%s$%s$%s" salt memory iterations parallelism password))) 278 | 279 | (defmethod format-password :default 280 | [{:keys [alg password salt iterations]}] 281 | (let [algname (name alg) 282 | salt (codecs/bytes->hex salt) 283 | password (codecs/bytes->hex password)] 284 | (if (nil? iterations) 285 | (format "%s$%s$%s" algname salt password) 286 | (format "%s$%s$%s$%s" algname salt iterations password)))) 287 | 288 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 289 | ;; Key Parsing 290 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 291 | 292 | (defmethod parse-password :scrypt 293 | [encryptedpassword] 294 | (let [[alg salt cc mc pll password] (str/split encryptedpassword #"\$") 295 | alg (keyword alg)] 296 | (when (some nil? [salt cc mc pll password]) 297 | (throw (ex-info "Malformed hash" {:type ::validation 298 | :code :malformed-hash 299 | :hint "Malformed Hash"}))) 300 | {:alg alg 301 | :salt (codecs/hex->bytes salt) 302 | :password (codecs/hex->bytes password) 303 | :cpucost (Integer/parseInt cc) 304 | :memcost (Integer/parseInt mc) 305 | :parallelism (Integer/parseInt pll)})) 306 | 307 | (defmethod parse-password :argon2id 308 | [encryptedpassword] 309 | (let [[alg salt mem iters pll password] (str/split encryptedpassword #"\$") 310 | alg (keyword alg)] 311 | (if (some nil? [salt mem iters pll password]) 312 | (throw (ex-info "Malformed hash" {:type ::validation 313 | :code :malformed-hash 314 | :hint "Malformed Hash"}))) 315 | {:alg alg 316 | :salt (codecs/hex->bytes salt) 317 | :password (codecs/hex->bytes password) 318 | :memory (Integer/parseInt mem) 319 | :iterations (Integer/parseInt iters) 320 | :parallelism (Integer/parseInt pll)})) 321 | 322 | (defmethod parse-password :default 323 | [encryptedpassword] 324 | (let [[alg salt iterations password] (str/split encryptedpassword #"\$") 325 | alg (keyword alg)] 326 | (when (some nil? [salt iterations password]) 327 | (throw (ex-info "Malformed hash" {:type ::validation 328 | :code :malformed-hash 329 | :hint "Malformed Hash"}))) 330 | {:alg alg 331 | :salt (codecs/hex->bytes salt) 332 | :password (codecs/hex->bytes password) 333 | :iterations (Integer/parseInt iterations)})) 334 | 335 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 336 | ;; Update Algorithm 337 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 338 | 339 | (defmethod must-update? :default 340 | [{:keys [alg] :as current-params} options] 341 | (let [options (merge (get default-params alg) options)] 342 | (when (contains? options :iterations) 343 | (not= (:iterations current-params) (:iterations options))))) 344 | 345 | (defmethod must-update? :scrypt 346 | [{:keys [alg] :as current-params} options] 347 | (let [options (merge (get default-params alg) options)] 348 | (when (and (contains? options :cpucost) 349 | (contains? options :memcost)) 350 | (or (not= (:cpucost current-params) (:cpucost options)) 351 | (not= (:memcost current-params) (:memcost options)))))) 352 | 353 | (defmethod must-update? :argon2id 354 | [{:keys [alg] :as current-params} options] 355 | (let [options (merge (get default-params alg) options)] 356 | (when (and (contains? options :memory) 357 | (contains? options :iterations)) 358 | (or (not= (:memory current-params) (:memory options)) 359 | (not= (:iterations current-params) (:iterations options)))))) 360 | 361 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 362 | ;; Public Api 363 | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; 364 | 365 | (defn derive 366 | "Encrypts a raw string password." 367 | ([password] (derive password {})) 368 | ([password options] 369 | (-> options 370 | (assoc :alg (:alg options :bcrypt+sha512)) 371 | (assoc :password (codecs/to-bytes password)) 372 | (derive-password) 373 | (format-password)))) 374 | 375 | (defn encrypt 376 | "Backward compatibility alias for `derive`. 377 | 378 | Should be consiered as DEPRECATED. 379 | " 380 | [& params] 381 | (apply derive params)) 382 | 383 | (defn check 384 | "Check if a unencrypted password matches with another encrypted 385 | password. 386 | 387 | Should be considered as DEPRECATED. 388 | " 389 | ([attempt encrypted] 390 | (check attempt encrypted {})) 391 | ([attempt encrypted {:keys [limit setter prefered] :as options}] 392 | (when (and attempt encrypted) 393 | (let [pwdparams (parse-password encrypted)] 394 | (if (and (set? limit) (not (contains? limit (:alg pwdparams)))) 395 | false 396 | (let [attempt' (codecs/to-bytes attempt) 397 | result (check-password pwdparams attempt')] 398 | (when (and result (fn? setter) (must-update? pwdparams options)) 399 | (setter attempt)) 400 | result)))))) 401 | 402 | (defn verify 403 | "Check if a unencrypted password matches with another encrypted 404 | password. Analogous to `check` with different call signature. Prefer 405 | this method over `check`." 406 | ([attempt encrypted] 407 | (verify attempt encrypted {})) 408 | ([attempt encrypted {:keys [limit prefered] :as options}] 409 | (assert (some? attempt) "expected `attempt` param to be provided") 410 | (assert (some? encrypted) "expected `encrypted` param to be provided") 411 | 412 | (let [pparams (parse-password encrypted) 413 | attempt (codecs/to-bytes attempt) 414 | result (check-password pparams attempt)] 415 | (if (and (set? limit) 416 | (not (limit (:alg pparams)))) 417 | {:valid false 418 | :update false} 419 | {:valid result 420 | :update (and result (must-update? pparams options))})))) 421 | -------------------------------------------------------------------------------- /src/java/buddy/impl/bcrypt/BCrypt.java: -------------------------------------------------------------------------------- 1 | // Copyright (c) 2006 Damien Miller 2 | // 3 | // Permission to use, copy, modify, and distribute this software for any 4 | // purpose with or without fee is hereby granted, provided that the above 5 | // copyright notice and this permission notice appear in all copies. 6 | // 7 | // THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 8 | // WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 9 | // MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 10 | // ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 11 | // WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 12 | // ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 13 | // OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 14 | 15 | package buddy.impl.bcrypt; 16 | 17 | import java.io.UnsupportedEncodingException; 18 | import java.security.SecureRandom; 19 | 20 | /** 21 | * BCrypt implements OpenBSD-style Blowfish password hashing using 22 | * the scheme described in "A Future-Adaptable Password Scheme" by 23 | * Niels Provos and David Mazieres. 24 | *

25 | * This password hashing system tries to thwart off-line password 26 | * cracking using a computationally-intensive hashing algorithm, 27 | * based on Bruce Schneier's Blowfish cipher. The work factor of 28 | * the algorithm is parameterised, so it can be increased as 29 | * computers get faster. 30 | *

31 | * Usage is really simple. To hash a password for the first time, 32 | * call the hashpw method with a random salt, like this: 33 | *

34 | * 35 | * String pw_hash = BCrypt.hashpw(plain_password, BCrypt.gensalt());
36 | * 37 | *

38 | * To check whether a plaintext password matches one that has been 39 | * hashed previously, use the checkpw method: 40 | *

41 | * 42 | * if (BCrypt.checkpw(candidate_password, stored_hash))
43 | *     System.out.println("It matches");
44 | * else
45 | *     System.out.println("It does not match");
46 | * 47 | *

48 | * The gensalt() method takes an optional parameter (log_rounds) 49 | * that determines the computational complexity of the hashing: 50 | *

51 | * 52 | * String strong_salt = BCrypt.gensalt(10)
53 | * String stronger_salt = BCrypt.gensalt(12)
54 | * 55 | *

56 | * The amount of work increases exponentially (2**log_rounds), so 57 | * each increment is twice as much work. The default log_rounds is 58 | * 10, and the valid range is 4 to 30. 59 | * 60 | * @author Damien Miller 61 | * @version 0.4 62 | */ 63 | public class BCrypt { 64 | // BCrypt parameters 65 | private static final int GENSALT_DEFAULT_LOG2_ROUNDS = 10; 66 | private static final int BCRYPT_SALT_LEN = 16; 67 | 68 | // Blowfish parameters 69 | private static final int BLOWFISH_NUM_ROUNDS = 16; 70 | 71 | // Initial contents of key schedule 72 | private static final int P_orig[] = { 73 | 0x243f6a88, 0x85a308d3, 0x13198a2e, 0x03707344, 74 | 0xa4093822, 0x299f31d0, 0x082efa98, 0xec4e6c89, 75 | 0x452821e6, 0x38d01377, 0xbe5466cf, 0x34e90c6c, 76 | 0xc0ac29b7, 0xc97c50dd, 0x3f84d5b5, 0xb5470917, 77 | 0x9216d5d9, 0x8979fb1b 78 | }; 79 | private static final int S_orig[] = { 80 | 0xd1310ba6, 0x98dfb5ac, 0x2ffd72db, 0xd01adfb7, 81 | 0xb8e1afed, 0x6a267e96, 0xba7c9045, 0xf12c7f99, 82 | 0x24a19947, 0xb3916cf7, 0x0801f2e2, 0x858efc16, 83 | 0x636920d8, 0x71574e69, 0xa458fea3, 0xf4933d7e, 84 | 0x0d95748f, 0x728eb658, 0x718bcd58, 0x82154aee, 85 | 0x7b54a41d, 0xc25a59b5, 0x9c30d539, 0x2af26013, 86 | 0xc5d1b023, 0x286085f0, 0xca417918, 0xb8db38ef, 87 | 0x8e79dcb0, 0x603a180e, 0x6c9e0e8b, 0xb01e8a3e, 88 | 0xd71577c1, 0xbd314b27, 0x78af2fda, 0x55605c60, 89 | 0xe65525f3, 0xaa55ab94, 0x57489862, 0x63e81440, 90 | 0x55ca396a, 0x2aab10b6, 0xb4cc5c34, 0x1141e8ce, 91 | 0xa15486af, 0x7c72e993, 0xb3ee1411, 0x636fbc2a, 92 | 0x2ba9c55d, 0x741831f6, 0xce5c3e16, 0x9b87931e, 93 | 0xafd6ba33, 0x6c24cf5c, 0x7a325381, 0x28958677, 94 | 0x3b8f4898, 0x6b4bb9af, 0xc4bfe81b, 0x66282193, 95 | 0x61d809cc, 0xfb21a991, 0x487cac60, 0x5dec8032, 96 | 0xef845d5d, 0xe98575b1, 0xdc262302, 0xeb651b88, 97 | 0x23893e81, 0xd396acc5, 0x0f6d6ff3, 0x83f44239, 98 | 0x2e0b4482, 0xa4842004, 0x69c8f04a, 0x9e1f9b5e, 99 | 0x21c66842, 0xf6e96c9a, 0x670c9c61, 0xabd388f0, 100 | 0x6a51a0d2, 0xd8542f68, 0x960fa728, 0xab5133a3, 101 | 0x6eef0b6c, 0x137a3be4, 0xba3bf050, 0x7efb2a98, 102 | 0xa1f1651d, 0x39af0176, 0x66ca593e, 0x82430e88, 103 | 0x8cee8619, 0x456f9fb4, 0x7d84a5c3, 0x3b8b5ebe, 104 | 0xe06f75d8, 0x85c12073, 0x401a449f, 0x56c16aa6, 105 | 0x4ed3aa62, 0x363f7706, 0x1bfedf72, 0x429b023d, 106 | 0x37d0d724, 0xd00a1248, 0xdb0fead3, 0x49f1c09b, 107 | 0x075372c9, 0x80991b7b, 0x25d479d8, 0xf6e8def7, 108 | 0xe3fe501a, 0xb6794c3b, 0x976ce0bd, 0x04c006ba, 109 | 0xc1a94fb6, 0x409f60c4, 0x5e5c9ec2, 0x196a2463, 110 | 0x68fb6faf, 0x3e6c53b5, 0x1339b2eb, 0x3b52ec6f, 111 | 0x6dfc511f, 0x9b30952c, 0xcc814544, 0xaf5ebd09, 112 | 0xbee3d004, 0xde334afd, 0x660f2807, 0x192e4bb3, 113 | 0xc0cba857, 0x45c8740f, 0xd20b5f39, 0xb9d3fbdb, 114 | 0x5579c0bd, 0x1a60320a, 0xd6a100c6, 0x402c7279, 115 | 0x679f25fe, 0xfb1fa3cc, 0x8ea5e9f8, 0xdb3222f8, 116 | 0x3c7516df, 0xfd616b15, 0x2f501ec8, 0xad0552ab, 117 | 0x323db5fa, 0xfd238760, 0x53317b48, 0x3e00df82, 118 | 0x9e5c57bb, 0xca6f8ca0, 0x1a87562e, 0xdf1769db, 119 | 0xd542a8f6, 0x287effc3, 0xac6732c6, 0x8c4f5573, 120 | 0x695b27b0, 0xbbca58c8, 0xe1ffa35d, 0xb8f011a0, 121 | 0x10fa3d98, 0xfd2183b8, 0x4afcb56c, 0x2dd1d35b, 122 | 0x9a53e479, 0xb6f84565, 0xd28e49bc, 0x4bfb9790, 123 | 0xe1ddf2da, 0xa4cb7e33, 0x62fb1341, 0xcee4c6e8, 124 | 0xef20cada, 0x36774c01, 0xd07e9efe, 0x2bf11fb4, 125 | 0x95dbda4d, 0xae909198, 0xeaad8e71, 0x6b93d5a0, 126 | 0xd08ed1d0, 0xafc725e0, 0x8e3c5b2f, 0x8e7594b7, 127 | 0x8ff6e2fb, 0xf2122b64, 0x8888b812, 0x900df01c, 128 | 0x4fad5ea0, 0x688fc31c, 0xd1cff191, 0xb3a8c1ad, 129 | 0x2f2f2218, 0xbe0e1777, 0xea752dfe, 0x8b021fa1, 130 | 0xe5a0cc0f, 0xb56f74e8, 0x18acf3d6, 0xce89e299, 131 | 0xb4a84fe0, 0xfd13e0b7, 0x7cc43b81, 0xd2ada8d9, 132 | 0x165fa266, 0x80957705, 0x93cc7314, 0x211a1477, 133 | 0xe6ad2065, 0x77b5fa86, 0xc75442f5, 0xfb9d35cf, 134 | 0xebcdaf0c, 0x7b3e89a0, 0xd6411bd3, 0xae1e7e49, 135 | 0x00250e2d, 0x2071b35e, 0x226800bb, 0x57b8e0af, 136 | 0x2464369b, 0xf009b91e, 0x5563911d, 0x59dfa6aa, 137 | 0x78c14389, 0xd95a537f, 0x207d5ba2, 0x02e5b9c5, 138 | 0x83260376, 0x6295cfa9, 0x11c81968, 0x4e734a41, 139 | 0xb3472dca, 0x7b14a94a, 0x1b510052, 0x9a532915, 140 | 0xd60f573f, 0xbc9bc6e4, 0x2b60a476, 0x81e67400, 141 | 0x08ba6fb5, 0x571be91f, 0xf296ec6b, 0x2a0dd915, 142 | 0xb6636521, 0xe7b9f9b6, 0xff34052e, 0xc5855664, 143 | 0x53b02d5d, 0xa99f8fa1, 0x08ba4799, 0x6e85076a, 144 | 0x4b7a70e9, 0xb5b32944, 0xdb75092e, 0xc4192623, 145 | 0xad6ea6b0, 0x49a7df7d, 0x9cee60b8, 0x8fedb266, 146 | 0xecaa8c71, 0x699a17ff, 0x5664526c, 0xc2b19ee1, 147 | 0x193602a5, 0x75094c29, 0xa0591340, 0xe4183a3e, 148 | 0x3f54989a, 0x5b429d65, 0x6b8fe4d6, 0x99f73fd6, 149 | 0xa1d29c07, 0xefe830f5, 0x4d2d38e6, 0xf0255dc1, 150 | 0x4cdd2086, 0x8470eb26, 0x6382e9c6, 0x021ecc5e, 151 | 0x09686b3f, 0x3ebaefc9, 0x3c971814, 0x6b6a70a1, 152 | 0x687f3584, 0x52a0e286, 0xb79c5305, 0xaa500737, 153 | 0x3e07841c, 0x7fdeae5c, 0x8e7d44ec, 0x5716f2b8, 154 | 0xb03ada37, 0xf0500c0d, 0xf01c1f04, 0x0200b3ff, 155 | 0xae0cf51a, 0x3cb574b2, 0x25837a58, 0xdc0921bd, 156 | 0xd19113f9, 0x7ca92ff6, 0x94324773, 0x22f54701, 157 | 0x3ae5e581, 0x37c2dadc, 0xc8b57634, 0x9af3dda7, 158 | 0xa9446146, 0x0fd0030e, 0xecc8c73e, 0xa4751e41, 159 | 0xe238cd99, 0x3bea0e2f, 0x3280bba1, 0x183eb331, 160 | 0x4e548b38, 0x4f6db908, 0x6f420d03, 0xf60a04bf, 161 | 0x2cb81290, 0x24977c79, 0x5679b072, 0xbcaf89af, 162 | 0xde9a771f, 0xd9930810, 0xb38bae12, 0xdccf3f2e, 163 | 0x5512721f, 0x2e6b7124, 0x501adde6, 0x9f84cd87, 164 | 0x7a584718, 0x7408da17, 0xbc9f9abc, 0xe94b7d8c, 165 | 0xec7aec3a, 0xdb851dfa, 0x63094366, 0xc464c3d2, 166 | 0xef1c1847, 0x3215d908, 0xdd433b37, 0x24c2ba16, 167 | 0x12a14d43, 0x2a65c451, 0x50940002, 0x133ae4dd, 168 | 0x71dff89e, 0x10314e55, 0x81ac77d6, 0x5f11199b, 169 | 0x043556f1, 0xd7a3c76b, 0x3c11183b, 0x5924a509, 170 | 0xf28fe6ed, 0x97f1fbfa, 0x9ebabf2c, 0x1e153c6e, 171 | 0x86e34570, 0xeae96fb1, 0x860e5e0a, 0x5a3e2ab3, 172 | 0x771fe71c, 0x4e3d06fa, 0x2965dcb9, 0x99e71d0f, 173 | 0x803e89d6, 0x5266c825, 0x2e4cc978, 0x9c10b36a, 174 | 0xc6150eba, 0x94e2ea78, 0xa5fc3c53, 0x1e0a2df4, 175 | 0xf2f74ea7, 0x361d2b3d, 0x1939260f, 0x19c27960, 176 | 0x5223a708, 0xf71312b6, 0xebadfe6e, 0xeac31f66, 177 | 0xe3bc4595, 0xa67bc883, 0xb17f37d1, 0x018cff28, 178 | 0xc332ddef, 0xbe6c5aa5, 0x65582185, 0x68ab9802, 179 | 0xeecea50f, 0xdb2f953b, 0x2aef7dad, 0x5b6e2f84, 180 | 0x1521b628, 0x29076170, 0xecdd4775, 0x619f1510, 181 | 0x13cca830, 0xeb61bd96, 0x0334fe1e, 0xaa0363cf, 182 | 0xb5735c90, 0x4c70a239, 0xd59e9e0b, 0xcbaade14, 183 | 0xeecc86bc, 0x60622ca7, 0x9cab5cab, 0xb2f3846e, 184 | 0x648b1eaf, 0x19bdf0ca, 0xa02369b9, 0x655abb50, 185 | 0x40685a32, 0x3c2ab4b3, 0x319ee9d5, 0xc021b8f7, 186 | 0x9b540b19, 0x875fa099, 0x95f7997e, 0x623d7da8, 187 | 0xf837889a, 0x97e32d77, 0x11ed935f, 0x16681281, 188 | 0x0e358829, 0xc7e61fd6, 0x96dedfa1, 0x7858ba99, 189 | 0x57f584a5, 0x1b227263, 0x9b83c3ff, 0x1ac24696, 190 | 0xcdb30aeb, 0x532e3054, 0x8fd948e4, 0x6dbc3128, 191 | 0x58ebf2ef, 0x34c6ffea, 0xfe28ed61, 0xee7c3c73, 192 | 0x5d4a14d9, 0xe864b7e3, 0x42105d14, 0x203e13e0, 193 | 0x45eee2b6, 0xa3aaabea, 0xdb6c4f15, 0xfacb4fd0, 194 | 0xc742f442, 0xef6abbb5, 0x654f3b1d, 0x41cd2105, 195 | 0xd81e799e, 0x86854dc7, 0xe44b476a, 0x3d816250, 196 | 0xcf62a1f2, 0x5b8d2646, 0xfc8883a0, 0xc1c7b6a3, 197 | 0x7f1524c3, 0x69cb7492, 0x47848a0b, 0x5692b285, 198 | 0x095bbf00, 0xad19489d, 0x1462b174, 0x23820e00, 199 | 0x58428d2a, 0x0c55f5ea, 0x1dadf43e, 0x233f7061, 200 | 0x3372f092, 0x8d937e41, 0xd65fecf1, 0x6c223bdb, 201 | 0x7cde3759, 0xcbee7460, 0x4085f2a7, 0xce77326e, 202 | 0xa6078084, 0x19f8509e, 0xe8efd855, 0x61d99735, 203 | 0xa969a7aa, 0xc50c06c2, 0x5a04abfc, 0x800bcadc, 204 | 0x9e447a2e, 0xc3453484, 0xfdd56705, 0x0e1e9ec9, 205 | 0xdb73dbd3, 0x105588cd, 0x675fda79, 0xe3674340, 206 | 0xc5c43465, 0x713e38d8, 0x3d28f89e, 0xf16dff20, 207 | 0x153e21e7, 0x8fb03d4a, 0xe6e39f2b, 0xdb83adf7, 208 | 0xe93d5a68, 0x948140f7, 0xf64c261c, 0x94692934, 209 | 0x411520f7, 0x7602d4f7, 0xbcf46b2e, 0xd4a20068, 210 | 0xd4082471, 0x3320f46a, 0x43b7d4b7, 0x500061af, 211 | 0x1e39f62e, 0x97244546, 0x14214f74, 0xbf8b8840, 212 | 0x4d95fc1d, 0x96b591af, 0x70f4ddd3, 0x66a02f45, 213 | 0xbfbc09ec, 0x03bd9785, 0x7fac6dd0, 0x31cb8504, 214 | 0x96eb27b3, 0x55fd3941, 0xda2547e6, 0xabca0a9a, 215 | 0x28507825, 0x530429f4, 0x0a2c86da, 0xe9b66dfb, 216 | 0x68dc1462, 0xd7486900, 0x680ec0a4, 0x27a18dee, 217 | 0x4f3ffea2, 0xe887ad8c, 0xb58ce006, 0x7af4d6b6, 218 | 0xaace1e7c, 0xd3375fec, 0xce78a399, 0x406b2a42, 219 | 0x20fe9e35, 0xd9f385b9, 0xee39d7ab, 0x3b124e8b, 220 | 0x1dc9faf7, 0x4b6d1856, 0x26a36631, 0xeae397b2, 221 | 0x3a6efa74, 0xdd5b4332, 0x6841e7f7, 0xca7820fb, 222 | 0xfb0af54e, 0xd8feb397, 0x454056ac, 0xba489527, 223 | 0x55533a3a, 0x20838d87, 0xfe6ba9b7, 0xd096954b, 224 | 0x55a867bc, 0xa1159a58, 0xcca92963, 0x99e1db33, 225 | 0xa62a4a56, 0x3f3125f9, 0x5ef47e1c, 0x9029317c, 226 | 0xfdf8e802, 0x04272f70, 0x80bb155c, 0x05282ce3, 227 | 0x95c11548, 0xe4c66d22, 0x48c1133f, 0xc70f86dc, 228 | 0x07f9c9ee, 0x41041f0f, 0x404779a4, 0x5d886e17, 229 | 0x325f51eb, 0xd59bc0d1, 0xf2bcc18f, 0x41113564, 230 | 0x257b7834, 0x602a9c60, 0xdff8e8a3, 0x1f636c1b, 231 | 0x0e12b4c2, 0x02e1329e, 0xaf664fd1, 0xcad18115, 232 | 0x6b2395e0, 0x333e92e1, 0x3b240b62, 0xeebeb922, 233 | 0x85b2a20e, 0xe6ba0d99, 0xde720c8c, 0x2da2f728, 234 | 0xd0127845, 0x95b794fd, 0x647d0862, 0xe7ccf5f0, 235 | 0x5449a36f, 0x877d48fa, 0xc39dfd27, 0xf33e8d1e, 236 | 0x0a476341, 0x992eff74, 0x3a6f6eab, 0xf4f8fd37, 237 | 0xa812dc60, 0xa1ebddf8, 0x991be14c, 0xdb6e6b0d, 238 | 0xc67b5510, 0x6d672c37, 0x2765d43b, 0xdcd0e804, 239 | 0xf1290dc7, 0xcc00ffa3, 0xb5390f92, 0x690fed0b, 240 | 0x667b9ffb, 0xcedb7d9c, 0xa091cf0b, 0xd9155ea3, 241 | 0xbb132f88, 0x515bad24, 0x7b9479bf, 0x763bd6eb, 242 | 0x37392eb3, 0xcc115979, 0x8026e297, 0xf42e312d, 243 | 0x6842ada7, 0xc66a2b3b, 0x12754ccc, 0x782ef11c, 244 | 0x6a124237, 0xb79251e7, 0x06a1bbe6, 0x4bfb6350, 245 | 0x1a6b1018, 0x11caedfa, 0x3d25bdd8, 0xe2e1c3c9, 246 | 0x44421659, 0x0a121386, 0xd90cec6e, 0xd5abea2a, 247 | 0x64af674e, 0xda86a85f, 0xbebfe988, 0x64e4c3fe, 248 | 0x9dbc8057, 0xf0f7c086, 0x60787bf8, 0x6003604d, 249 | 0xd1fd8346, 0xf6381fb0, 0x7745ae04, 0xd736fccc, 250 | 0x83426b33, 0xf01eab71, 0xb0804187, 0x3c005e5f, 251 | 0x77a057be, 0xbde8ae24, 0x55464299, 0xbf582e61, 252 | 0x4e58f48f, 0xf2ddfda2, 0xf474ef38, 0x8789bdc2, 253 | 0x5366f9c3, 0xc8b38e74, 0xb475f255, 0x46fcd9b9, 254 | 0x7aeb2661, 0x8b1ddf84, 0x846a0e79, 0x915f95e2, 255 | 0x466e598e, 0x20b45770, 0x8cd55591, 0xc902de4c, 256 | 0xb90bace1, 0xbb8205d0, 0x11a86248, 0x7574a99e, 257 | 0xb77f19b6, 0xe0a9dc09, 0x662d09a1, 0xc4324633, 258 | 0xe85a1f02, 0x09f0be8c, 0x4a99a025, 0x1d6efe10, 259 | 0x1ab93d1d, 0x0ba5a4df, 0xa186f20f, 0x2868f169, 260 | 0xdcb7da83, 0x573906fe, 0xa1e2ce9b, 0x4fcd7f52, 261 | 0x50115e01, 0xa70683fa, 0xa002b5c4, 0x0de6d027, 262 | 0x9af88c27, 0x773f8641, 0xc3604c06, 0x61a806b5, 263 | 0xf0177a28, 0xc0f586e0, 0x006058aa, 0x30dc7d62, 264 | 0x11e69ed7, 0x2338ea63, 0x53c2dd94, 0xc2c21634, 265 | 0xbbcbee56, 0x90bcb6de, 0xebfc7da1, 0xce591d76, 266 | 0x6f05e409, 0x4b7c0188, 0x39720a3d, 0x7c927c24, 267 | 0x86e3725f, 0x724d9db9, 0x1ac15bb4, 0xd39eb8fc, 268 | 0xed545578, 0x08fca5b5, 0xd83d7cd3, 0x4dad0fc4, 269 | 0x1e50ef5e, 0xb161e6f8, 0xa28514d9, 0x6c51133c, 270 | 0x6fd5c7e7, 0x56e14ec4, 0x362abfce, 0xddc6c837, 271 | 0xd79a3234, 0x92638212, 0x670efa8e, 0x406000e0, 272 | 0x3a39ce37, 0xd3faf5cf, 0xabc27737, 0x5ac52d1b, 273 | 0x5cb0679e, 0x4fa33742, 0xd3822740, 0x99bc9bbe, 274 | 0xd5118e9d, 0xbf0f7315, 0xd62d1c7e, 0xc700c47b, 275 | 0xb78c1b6b, 0x21a19045, 0xb26eb1be, 0x6a366eb4, 276 | 0x5748ab2f, 0xbc946e79, 0xc6a376d2, 0x6549c2c8, 277 | 0x530ff8ee, 0x468dde7d, 0xd5730a1d, 0x4cd04dc6, 278 | 0x2939bbdb, 0xa9ba4650, 0xac9526e8, 0xbe5ee304, 279 | 0xa1fad5f0, 0x6a2d519a, 0x63ef8ce2, 0x9a86ee22, 280 | 0xc089c2b8, 0x43242ef6, 0xa51e03aa, 0x9cf2d0a4, 281 | 0x83c061ba, 0x9be96a4d, 0x8fe51550, 0xba645bd6, 282 | 0x2826a2f9, 0xa73a3ae1, 0x4ba99586, 0xef5562e9, 283 | 0xc72fefd3, 0xf752f7da, 0x3f046f69, 0x77fa0a59, 284 | 0x80e4a915, 0x87b08601, 0x9b09e6ad, 0x3b3ee593, 285 | 0xe990fd5a, 0x9e34d797, 0x2cf0b7d9, 0x022b8b51, 286 | 0x96d5ac3a, 0x017da67d, 0xd1cf3ed6, 0x7c7d2d28, 287 | 0x1f9f25cf, 0xadf2b89b, 0x5ad6b472, 0x5a88f54c, 288 | 0xe029ac71, 0xe019a5e6, 0x47b0acfd, 0xed93fa9b, 289 | 0xe8d3c48d, 0x283b57cc, 0xf8d56629, 0x79132e28, 290 | 0x785f0191, 0xed756055, 0xf7960e44, 0xe3d35e8c, 291 | 0x15056dd4, 0x88f46dba, 0x03a16125, 0x0564f0bd, 292 | 0xc3eb9e15, 0x3c9057a2, 0x97271aec, 0xa93a072a, 293 | 0x1b3f6d9b, 0x1e6321f5, 0xf59c66fb, 0x26dcf319, 294 | 0x7533d928, 0xb155fdf5, 0x03563482, 0x8aba3cbb, 295 | 0x28517711, 0xc20ad9f8, 0xabcc5167, 0xccad925f, 296 | 0x4de81751, 0x3830dc8e, 0x379d5862, 0x9320f991, 297 | 0xea7a90c2, 0xfb3e7bce, 0x5121ce64, 0x774fbe32, 298 | 0xa8b6e37e, 0xc3293d46, 0x48de5369, 0x6413e680, 299 | 0xa2ae0810, 0xdd6db224, 0x69852dfd, 0x09072166, 300 | 0xb39a460a, 0x6445c0dd, 0x586cdecf, 0x1c20c8ae, 301 | 0x5bbef7dd, 0x1b588d40, 0xccd2017f, 0x6bb4e3bb, 302 | 0xdda26a7e, 0x3a59ff45, 0x3e350a44, 0xbcb4cdd5, 303 | 0x72eacea8, 0xfa6484bb, 0x8d6612ae, 0xbf3c6f47, 304 | 0xd29be463, 0x542f5d9e, 0xaec2771b, 0xf64e6370, 305 | 0x740e0d8d, 0xe75b1357, 0xf8721671, 0xaf537d5d, 306 | 0x4040cb08, 0x4eb4e2cc, 0x34d2466a, 0x0115af84, 307 | 0xe1b00428, 0x95983a1d, 0x06b89fb4, 0xce6ea048, 308 | 0x6f3f3b82, 0x3520ab82, 0x011a1d4b, 0x277227f8, 309 | 0x611560b1, 0xe7933fdc, 0xbb3a792b, 0x344525bd, 310 | 0xa08839e1, 0x51ce794b, 0x2f32c9b7, 0xa01fbac9, 311 | 0xe01cc87e, 0xbcc7d1f6, 0xcf0111c3, 0xa1e8aac7, 312 | 0x1a908749, 0xd44fbd9a, 0xd0dadecb, 0xd50ada38, 313 | 0x0339c32a, 0xc6913667, 0x8df9317c, 0xe0b12b4f, 314 | 0xf79e59b7, 0x43f5bb3a, 0xf2d519ff, 0x27d9459c, 315 | 0xbf97222c, 0x15e6fc2a, 0x0f91fc71, 0x9b941525, 316 | 0xfae59361, 0xceb69ceb, 0xc2a86459, 0x12baa8d1, 317 | 0xb6c1075e, 0xe3056a0c, 0x10d25065, 0xcb03a442, 318 | 0xe0ec6e0e, 0x1698db3b, 0x4c98a0be, 0x3278e964, 319 | 0x9f1f9532, 0xe0d392df, 0xd3a0342b, 0x8971f21e, 320 | 0x1b0a7441, 0x4ba3348c, 0xc5be7120, 0xc37632d8, 321 | 0xdf359f8d, 0x9b992f2e, 0xe60b6f47, 0x0fe3f11d, 322 | 0xe54cda54, 0x1edad891, 0xce6279cf, 0xcd3e7e6f, 323 | 0x1618b166, 0xfd2c1d05, 0x848fd2c5, 0xf6fb2299, 324 | 0xf523f357, 0xa6327623, 0x93a83531, 0x56cccd02, 325 | 0xacf08162, 0x5a75ebb5, 0x6e163697, 0x88d273cc, 326 | 0xde966292, 0x81b949d0, 0x4c50901b, 0x71c65614, 327 | 0xe6c6c7bd, 0x327a140a, 0x45e1d006, 0xc3f27b9a, 328 | 0xc9aa53fd, 0x62a80f00, 0xbb25bfe2, 0x35bdd2f6, 329 | 0x71126905, 0xb2040222, 0xb6cbcf7c, 0xcd769c2b, 330 | 0x53113ec0, 0x1640e3d3, 0x38abbd60, 0x2547adf0, 331 | 0xba38209c, 0xf746ce76, 0x77afa1c5, 0x20756060, 332 | 0x85cbfe4e, 0x8ae88dd8, 0x7aaaf9b0, 0x4cf9aa7e, 333 | 0x1948c25c, 0x02fb8a8c, 0x01c36ae4, 0xd6ebe1f9, 334 | 0x90d4f869, 0xa65cdea0, 0x3f09252d, 0xc208e69f, 335 | 0xb74e6132, 0xce77e25b, 0x578fdfe3, 0x3ac372e6 336 | }; 337 | 338 | // bcrypt IV: "OrpheanBeholderScryDoubt". The C implementation calls 339 | // this "ciphertext", but it is really plaintext or an IV. We keep 340 | // the name to make code comparison easier. 341 | static private final int bf_crypt_ciphertext[] = { 342 | 0x4f727068, 0x65616e42, 0x65686f6c, 343 | 0x64657253, 0x63727944, 0x6f756274 344 | }; 345 | 346 | // Table for Base64 encoding 347 | static private final char base64_code[] = { 348 | '.', '/', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 349 | 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 350 | 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 351 | 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 352 | 'u', 'v', 'w', 'x', 'y', 'z', '0', '1', '2', '3', '4', '5', 353 | '6', '7', '8', '9' 354 | }; 355 | 356 | // Table for Base64 decoding 357 | static private final byte index_64[] = { 358 | -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 359 | -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 360 | -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 361 | -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, 362 | -1, -1, -1, -1, -1, -1, 0, 1, 54, 55, 363 | 56, 57, 58, 59, 60, 61, 62, 63, -1, -1, 364 | -1, -1, -1, -1, -1, 2, 3, 4, 5, 6, 365 | 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 366 | 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 367 | -1, -1, -1, -1, -1, -1, 28, 29, 30, 368 | 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 369 | 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 370 | 51, 52, 53, -1, -1, -1, -1, -1 371 | }; 372 | 373 | // Expanded Blowfish key 374 | private int P[]; 375 | private int S[]; 376 | 377 | /** 378 | * Encode a byte array using bcrypt's slightly-modified base64 379 | * encoding scheme. Note that this is *not* compatible with 380 | * the standard MIME-base64 encoding. 381 | * 382 | * @param d the byte array to encode 383 | * @param len the number of bytes to encode 384 | * @return base64-encoded string 385 | * @exception IllegalArgumentException if the length is invalid 386 | */ 387 | private static String encode_base64(byte d[], int len) 388 | throws IllegalArgumentException { 389 | int off = 0; 390 | StringBuffer rs = new StringBuffer(); 391 | int c1, c2; 392 | 393 | if (len <= 0 || len > d.length) 394 | throw new IllegalArgumentException ("Invalid len"); 395 | 396 | while (off < len) { 397 | c1 = d[off++] & 0xff; 398 | rs.append(base64_code[(c1 >> 2) & 0x3f]); 399 | c1 = (c1 & 0x03) << 4; 400 | if (off >= len) { 401 | rs.append(base64_code[c1 & 0x3f]); 402 | break; 403 | } 404 | c2 = d[off++] & 0xff; 405 | c1 |= (c2 >> 4) & 0x0f; 406 | rs.append(base64_code[c1 & 0x3f]); 407 | c1 = (c2 & 0x0f) << 2; 408 | if (off >= len) { 409 | rs.append(base64_code[c1 & 0x3f]); 410 | break; 411 | } 412 | c2 = d[off++] & 0xff; 413 | c1 |= (c2 >> 6) & 0x03; 414 | rs.append(base64_code[c1 & 0x3f]); 415 | rs.append(base64_code[c2 & 0x3f]); 416 | } 417 | return rs.toString(); 418 | } 419 | 420 | /** 421 | * Look up the 3 bits base64-encoded by the specified character, 422 | * range-checking againt conversion table 423 | * @param x the base64-encoded value 424 | * @return the decoded value of x 425 | */ 426 | private static byte char64(char x) { 427 | if ((int)x < 0 || (int)x > index_64.length) 428 | return -1; 429 | return index_64[(int)x]; 430 | } 431 | 432 | /** 433 | * Decode a string encoded using bcrypt's base64 scheme to a 434 | * byte array. Note that this is *not* compatible with 435 | * the standard MIME-base64 encoding. 436 | * @param s the string to decode 437 | * @param maxolen the maximum number of bytes to decode 438 | * @return an array containing the decoded bytes 439 | * @throws IllegalArgumentException if maxolen is invalid 440 | */ 441 | private static byte[] decode_base64(String s, int maxolen) 442 | throws IllegalArgumentException { 443 | StringBuffer rs = new StringBuffer(); 444 | int off = 0, slen = s.length(), olen = 0; 445 | byte ret[]; 446 | byte c1, c2, c3, c4, o; 447 | 448 | if (maxolen <= 0) 449 | throw new IllegalArgumentException ("Invalid maxolen"); 450 | 451 | while (off < slen - 1 && olen < maxolen) { 452 | c1 = char64(s.charAt(off++)); 453 | c2 = char64(s.charAt(off++)); 454 | if (c1 == -1 || c2 == -1) 455 | break; 456 | o = (byte)(c1 << 2); 457 | o |= (c2 & 0x30) >> 4; 458 | rs.append((char)o); 459 | if (++olen >= maxolen || off >= slen) 460 | break; 461 | c3 = char64(s.charAt(off++)); 462 | if (c3 == -1) 463 | break; 464 | o = (byte)((c2 & 0x0f) << 4); 465 | o |= (c3 & 0x3c) >> 2; 466 | rs.append((char)o); 467 | if (++olen >= maxolen || off >= slen) 468 | break; 469 | c4 = char64(s.charAt(off++)); 470 | o = (byte)((c3 & 0x03) << 6); 471 | o |= c4; 472 | rs.append((char)o); 473 | ++olen; 474 | } 475 | 476 | ret = new byte[olen]; 477 | for (off = 0; off < olen; off++) 478 | ret[off] = (byte)rs.charAt(off); 479 | return ret; 480 | } 481 | 482 | /** 483 | * Blowfish encipher a single 64-bit block encoded as 484 | * two 32-bit halves 485 | * @param lr an array containing the two 32-bit half blocks 486 | * @param off the position in the array of the blocks 487 | */ 488 | private final void encipher(int lr[], int off) { 489 | int i, n, l = lr[off], r = lr[off + 1]; 490 | 491 | l ^= P[0]; 492 | for (i = 0; i <= BLOWFISH_NUM_ROUNDS - 2;) { 493 | // Feistel substitution on left word 494 | n = S[(l >> 24) & 0xff]; 495 | n += S[0x100 | ((l >> 16) & 0xff)]; 496 | n ^= S[0x200 | ((l >> 8) & 0xff)]; 497 | n += S[0x300 | (l & 0xff)]; 498 | r ^= n ^ P[++i]; 499 | 500 | // Feistel substitution on right word 501 | n = S[(r >> 24) & 0xff]; 502 | n += S[0x100 | ((r >> 16) & 0xff)]; 503 | n ^= S[0x200 | ((r >> 8) & 0xff)]; 504 | n += S[0x300 | (r & 0xff)]; 505 | l ^= n ^ P[++i]; 506 | } 507 | lr[off] = r ^ P[BLOWFISH_NUM_ROUNDS + 1]; 508 | lr[off + 1] = l; 509 | } 510 | 511 | /** 512 | * Cycically extract a word of key material 513 | * @param data the string to extract the data from 514 | * @param offp a "pointer" (as a one-entry array) to the 515 | * current offset into data 516 | * @return the next word of material from data 517 | */ 518 | private static int streamtoword(byte data[], int offp[]) { 519 | int i; 520 | int word = 0; 521 | int off = offp[0]; 522 | 523 | for (i = 0; i < 4; i++) { 524 | word = (word << 8) | (data[off] & 0xff); 525 | off = (off + 1) % data.length; 526 | } 527 | 528 | offp[0] = off; 529 | return word; 530 | } 531 | 532 | /** 533 | * Initialise the Blowfish key schedule 534 | */ 535 | private void init_key() { 536 | P = (int[])P_orig.clone(); 537 | S = (int[])S_orig.clone(); 538 | } 539 | 540 | /** 541 | * Key the Blowfish cipher 542 | * @param key an array containing the key 543 | */ 544 | private void key(byte key[]) { 545 | int i; 546 | int koffp[] = { 0 }; 547 | int lr[] = { 0, 0 }; 548 | int plen = P.length, slen = S.length; 549 | 550 | for (i = 0; i < plen; i++) 551 | P[i] = P[i] ^ streamtoword(key, koffp); 552 | 553 | for (i = 0; i < plen; i += 2) { 554 | encipher(lr, 0); 555 | P[i] = lr[0]; 556 | P[i + 1] = lr[1]; 557 | } 558 | 559 | for (i = 0; i < slen; i += 2) { 560 | encipher(lr, 0); 561 | S[i] = lr[0]; 562 | S[i + 1] = lr[1]; 563 | } 564 | } 565 | 566 | /** 567 | * Perform the "enhanced key schedule" step described by 568 | * Provos and Mazieres in "A Future-Adaptable Password Scheme" 569 | * http://www.openbsd.org/papers/bcrypt-paper.ps 570 | * @param data salt information 571 | * @param key password information 572 | */ 573 | private void ekskey(byte data[], byte key[]) { 574 | int i; 575 | int koffp[] = { 0 }, doffp[] = { 0 }; 576 | int lr[] = { 0, 0 }; 577 | int plen = P.length, slen = S.length; 578 | 579 | for (i = 0; i < plen; i++) 580 | P[i] = P[i] ^ streamtoword(key, koffp); 581 | 582 | for (i = 0; i < plen; i += 2) { 583 | lr[0] ^= streamtoword(data, doffp); 584 | lr[1] ^= streamtoword(data, doffp); 585 | encipher(lr, 0); 586 | P[i] = lr[0]; 587 | P[i + 1] = lr[1]; 588 | } 589 | 590 | for (i = 0; i < slen; i += 2) { 591 | lr[0] ^= streamtoword(data, doffp); 592 | lr[1] ^= streamtoword(data, doffp); 593 | encipher(lr, 0); 594 | S[i] = lr[0]; 595 | S[i + 1] = lr[1]; 596 | } 597 | } 598 | 599 | /** 600 | * Perform the central password hashing step in the 601 | * bcrypt scheme 602 | * @param password the password to hash 603 | * @param salt the binary salt to hash with the password 604 | * @param log_rounds the binary logarithm of the number 605 | * of rounds of hashing to apply 606 | * @param cdata the plaintext to encrypt 607 | * @return an array containing the binary hashed password 608 | */ 609 | public byte[] crypt_raw(byte password[], byte salt[], int log_rounds, 610 | int cdata[]) { 611 | int rounds, i, j; 612 | int clen = cdata.length; 613 | byte ret[]; 614 | 615 | if (log_rounds < 4 || log_rounds > 30) 616 | throw new IllegalArgumentException ("Bad number of rounds"); 617 | rounds = 1 << log_rounds; 618 | if (salt.length != BCRYPT_SALT_LEN) 619 | throw new IllegalArgumentException ("Bad salt length"); 620 | 621 | init_key(); 622 | ekskey(salt, password); 623 | for (i = 0; i != rounds; i++) { 624 | key(password); 625 | key(salt); 626 | } 627 | 628 | for (i = 0; i < 64; i++) { 629 | for (j = 0; j < (clen >> 1); j++) 630 | encipher(cdata, j << 1); 631 | } 632 | 633 | ret = new byte[clen * 4]; 634 | for (i = 0, j = 0; i < clen; i++) { 635 | ret[j++] = (byte)((cdata[i] >> 24) & 0xff); 636 | ret[j++] = (byte)((cdata[i] >> 16) & 0xff); 637 | ret[j++] = (byte)((cdata[i] >> 8) & 0xff); 638 | ret[j++] = (byte)(cdata[i] & 0xff); 639 | } 640 | return ret; 641 | } 642 | 643 | /** 644 | * Hash a password using the OpenBSD bcrypt scheme 645 | * @param password the password to hash 646 | * @param salt the salt to hash with (perhaps generated 647 | * using BCrypt.gensalt) 648 | * @return the hashed password 649 | */ 650 | public static String hashpw(String password, String salt) { 651 | BCrypt B; 652 | String real_salt; 653 | byte passwordb[], saltb[], hashed[]; 654 | char minor = (char)0; 655 | int rounds, off = 0; 656 | StringBuffer rs = new StringBuffer(); 657 | 658 | if (salt.charAt(0) != '$' || salt.charAt(1) != '2') 659 | throw new IllegalArgumentException ("Invalid salt version"); 660 | if (salt.charAt(2) == '$') 661 | off = 3; 662 | else { 663 | minor = salt.charAt(2); 664 | if (minor != 'a' || salt.charAt(3) != '$') 665 | throw new IllegalArgumentException ("Invalid salt revision"); 666 | off = 4; 667 | } 668 | 669 | // Extract number of rounds 670 | if (salt.charAt(off + 2) > '$') 671 | throw new IllegalArgumentException ("Missing salt rounds"); 672 | rounds = Integer.parseInt(salt.substring(off, off + 2)); 673 | 674 | real_salt = salt.substring(off + 3, off + 25); 675 | try { 676 | passwordb = (password + (minor >= 'a' ? "\000" : "")).getBytes("UTF-8"); 677 | } catch (UnsupportedEncodingException uee) { 678 | throw new AssertionError("UTF-8 is not supported"); 679 | } 680 | 681 | saltb = decode_base64(real_salt, BCRYPT_SALT_LEN); 682 | 683 | B = new BCrypt(); 684 | hashed = B.crypt_raw(passwordb, saltb, rounds, 685 | (int[])bf_crypt_ciphertext.clone()); 686 | 687 | rs.append("$2"); 688 | if (minor >= 'a') 689 | rs.append(minor); 690 | rs.append("$"); 691 | if (rounds < 10) 692 | rs.append("0"); 693 | if (rounds > 30) { 694 | throw new IllegalArgumentException( 695 | "rounds exceeds maximum (30)"); 696 | } 697 | rs.append(Integer.toString(rounds)); 698 | rs.append("$"); 699 | rs.append(encode_base64(saltb, saltb.length)); 700 | rs.append(encode_base64(hashed, 701 | bf_crypt_ciphertext.length * 4 - 1)); 702 | return rs.toString(); 703 | } 704 | 705 | /** 706 | * Generate a salt for use with the BCrypt.hashpw() method 707 | * @param log_rounds the log2 of the number of rounds of 708 | * hashing to apply - the work factor therefore increases as 709 | * 2**log_rounds. 710 | * @param random an instance of SecureRandom to use 711 | * @return an encoded salt value 712 | */ 713 | public static String gensalt(int log_rounds, SecureRandom random) { 714 | StringBuffer rs = new StringBuffer(); 715 | byte rnd[] = new byte[BCRYPT_SALT_LEN]; 716 | 717 | random.nextBytes(rnd); 718 | 719 | rs.append("$2a$"); 720 | if (log_rounds < 10) 721 | rs.append("0"); 722 | if (log_rounds > 30) { 723 | throw new IllegalArgumentException( 724 | "log_rounds exceeds maximum (30)"); 725 | } 726 | rs.append(Integer.toString(log_rounds)); 727 | rs.append("$"); 728 | rs.append(encode_base64(rnd, rnd.length)); 729 | return rs.toString(); 730 | } 731 | 732 | /** 733 | * Generate a salt for use with the BCrypt.hashpw() method 734 | * @param log_rounds the log2 of the number of rounds of 735 | * hashing to apply - the work factor therefore increases as 736 | * 2**log_rounds. 737 | * @return an encoded salt value 738 | */ 739 | public static String gensalt(int log_rounds) { 740 | return gensalt(log_rounds, new SecureRandom()); 741 | } 742 | 743 | /** 744 | * Generate a salt for use with the BCrypt.hashpw() method, 745 | * selecting a reasonable default for the number of hashing 746 | * rounds to apply 747 | * @return an encoded salt value 748 | */ 749 | public static String gensalt() { 750 | return gensalt(GENSALT_DEFAULT_LOG2_ROUNDS); 751 | } 752 | 753 | /** 754 | * Check that a plaintext password matches a previously hashed 755 | * one 756 | * @param plaintext the plaintext password to verify 757 | * @param hashed the previously-hashed password 758 | * @return true if the passwords match, false otherwise 759 | */ 760 | public static boolean checkpw(String plaintext, String hashed) { 761 | byte hashed_bytes[]; 762 | byte try_bytes[]; 763 | try { 764 | String try_pw = hashpw(plaintext, hashed); 765 | hashed_bytes = hashed.getBytes("UTF-8"); 766 | try_bytes = try_pw.getBytes("UTF-8"); 767 | } catch (UnsupportedEncodingException uee) { 768 | return false; 769 | } 770 | if (hashed_bytes.length != try_bytes.length) 771 | return false; 772 | byte ret = 0; 773 | for (int i = 0; i < try_bytes.length; i++) 774 | ret |= hashed_bytes[i] ^ try_bytes[i]; 775 | return ret == 0; 776 | } 777 | } 778 | --------------------------------------------------------------------------------