zxcvbn4j は、JavaScriptのパスワード強度ジェネレータであるzxcvbnをJavaにポーティングしたものです。
以下のバージョンはzxcvbn 4.4.2をポーティング
- 2021/06/08 1.5.2 リリース.
- 2021/06/05 1.5.1 リリース.
- 2021/04/26 1.5.0 リリース.
- 2021/03/22 1.4.1 リリース.
- 2021/02/19 1.4.0 リリース.
- 2021/02/09 1.3.6 リリース.
- 2021/02/02 1.3.5 リリース.
- 2021/01/26 1.3.4 リリース.
- 2021/01/19 1.3.3 リリース.
- 2021/01/19 1.3.2 リリース.
- 2020/10/28 1.3.1 リリース.
- 2019/10/19 1.3.0 リリース.
- 2019/07/23 1.2.7 リリース.
- 2019/07/16 1.2.6 リリース.
- 2018/03/30 1.2.5 リリース.
- 2018/02/27 1.2.4 リリース.
- 2017/03/27 1.2.3 リリース.
以下のバージョンはzxcvbn 4.4.1をポーティング
- 2016/12/07 1.2.2 リリース.
- 2016/12/03 1.2.1 リリース.
以下のバージョンはzxcvbn 4.4.0をポーティング
- 2016/10/29 1.2.0 リリース.
以下のバージョンはzxcvbn 4.3.0をポーティング
- 2016/10/01 1.1.6 リリース.
- 2016/09/27 1.1.5 リリース.
- 2016/07/08 1.1.4 リリース.
- 2016/05/27 1.1.3 リリース.
- 2016/05/25 1.1.2 リリース.
- 2016/03/19 1.1.1 リリース.
- 2016/03/06 1.1.0 リリース.
以下のバージョンはzxcvbn 4.2.0をポーティング
- 2016/01/28 1.0.2 リリース.
- 2016/01/27 1.0.1 リリース.
- 2015/12/24 1.0.0 リリース.
- 隣接したキー配列の照合処理にJISキーボードを対応。
- フィードバックメッセージのローカライズに対応。
- パスワードの引数はStringだけでなくCharSequenceも受付可能。
- これによりパスワードのフォーマットを柔軟に変更可能。
- センシティブな中間オブジェクトにも文字列を使用しない。
compile 'com.nulab-inc:zxcvbn:1.5.2'
<dependency>
<groupId>com.nulab-inc</groupId>
<artifactId>zxcvbn</artifactId>
<version>1.5.2</version>
</dependency>
ビルド方法:
$ git clone [email protected]:nulab/zxcvbn4j.git
$ cd zxcvbn4j/
$ ./gradlew build
基本的な使い方です。Androidも同じようにご利用できます。
Zxcvbn zxcvbn = new Zxcvbn();
Strength strength = zxcvbn.measure("This is password");独自の辞書を追加したい場合は、第二引数にリスト<文字列>のタイプのキーワード一覧を渡します。
List<String> sanitizedInputs = new ArrayList();
sanitizedInputs.add("nulab");
sanitizedInputs.add("backlog");
sanitizedInputs.add("cacoo");
sanitizedInputs.add("typetalk");
Zxcvbn zxcvbn = new Zxcvbn();
Strength strength = zxcvbn.measure("This is password", sanitizedInputs);返却する結果は、"Strength"インスタンスです。zxcvbn が返却する結果とほぼ同じものです。
# パスワードの「乱雑さ」「複雑さ」を表す指標
strength.guesses
strength.guessesLog10
# いくつかのシナリオに基づいたクラック時間の推測
strength.crackTimeSeconds
{
# オンライン攻撃でパスワード認証に回数制限が有る場合
onlineThrottling100PerHour
# オンライン攻撃でパスワード認証に回数制限が無い場合
onlineNoThrottling10PerSecond
# オフライン攻撃で、bcrypt、scrypt、PBKDF2等を使ってハッシュ化している場合
offlineSlowHashing1e4PerSecond
# オフライン攻撃で、SHA-1、SHA-256またはMD5等を使ってハッシュ化している場合
offlineFastHashing1e10PerSecond
}
# strength.crackTimeSecondsを表示するために文字列化した値(秒未満、3時間、世紀 等)
strength.crackTimeDisplay
# 0から4の整数
# 0 弱い （guesses < ^ 3 10）
# 1 やや弱い （guesses <^ 6 10）
# 2 普通 （guesses <^ 8 10）
# 3 強い （guesses < 10 ^ 10）
# 4 とても強い （guesses >= 10 ^ 10）
strength.score
# 安全なパスワード作成に役立つフィードバック。(score <= 2 のみ表示)
{
# 警告文
warning
# 提案
suggestions
}
# 測定に用いたパターンのリスト
strength.sequence
# 測定にかかった時間
strength.calc_time
zxcvbn4jは英語で返却されるフィードバックメッセージを他の言語に変更可能です。
// パスワード強度を測定して Strength を取得します。
Zxcvbn zxcvbn = new Zxcvbn();
Strength strength = zxcvbn.measure("This is password");
// 事前に用意したプロパティファイル(※)の名前とロケールを指定して、ResourceBundle を取得します。
ResourceBundle resourceBundle = ResourceBundle.getBundle("This is bundle name", Locale.JAPAN);
// FeedbackにResourceBundleを渡して、ローカライズされたFeedbackを生成します。
Feedback feedback = strength.getFeedback();
Feedback localizedFeedback = feedback.withResourceBundle(resourceBundle);
// getSuggestions()、getWarning()で取得するフィードバックメッセージはローカライズ済みです。
List<String> localizedSuggestions = localizedFeedback.getSuggestions();
String localizedWarning = localizedFeedback.getWarning();プロパティファイルに定義するキーとメッセージは、messages.properties を参考に作成してください。
デフォルトでサポートしている言語:
バグ報告, ご意見、ご質問等は Github Issues にお願い致します。
MIT License
- Java 1.7以上