6.4. パスワードハッシュ化¶

Caution

本バージョンの内容は既に古くなっています。最新のガイドラインはこちらからご参照ください。

Overview
How to use
How to extend
- ShaPasswordEncoderを使用した例
Appendix

6.4.1. Overview ¶

パスワードのハッシュ化は、セキュアなアプリケーションを設計する上で考慮しなければならない点の一つである。
通常のシステムでパスワードを平文で登録することはありえなく、ハッシュ化は必須であるが、
強度が弱いアルゴリズムを選択した場合は「オフライン総あたり攻撃」や「レインボークラック」などにより
容易にハッシュ化元データを解析されてしまう。

Spring Securityは、パスワードのハッシュ化の仕組みとしてorg.springframework.security.crypto.password.PasswordEncoderインタフェースが用意している。
その実装クラスとして、

org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder
org.springframework.security.crypto.password.StandardPasswordEncoder

などが、提供されている。

PasswordEncoderの仕組みとして、encode(String rawPassword)メソッドでハッシュ化を行い、
matches(String rawPassword, String encodedPassword)メソッドで照合を行う。

Picture - PasswordEncoder Class Diagram

How to extendで後述するが、DaoAuthenticationProvider は、org.springframework.security.crypto.password.PasswordEncoderの実装クラス、 org.springframework.security.authentication.encoding.PasswordEncoderの実装クラス両方を設定することができる。そのため、従来のPasswordEncoder(authenticationパッケージ)から、新PasswordEncoderに移行する際も、ユーザのパスワード移行が完了後、 DaoAuthenticationProviderのpasswordEncoderを変更するだけで対応できる。

Warning

DaoAuthenticationProviderを認証プロバイダで設定している場合、UsernameNotFoundExceptionがスローされた場合、利用者にユーザが存在しないことを悟らせないために、 UsernameNotFoundExceptionがスローされた後、意図的にパスワードをハッシュ化している。(サイドチャネル攻撃対策)

上記のハッシュ化に用いる値を作成するために、アプリケーション起動時に、encodeメソッドを内部で1回実行している。

Warning

Linux環境でSecureRandomを使用している場合、処理の遅延や、タイムアウトが発生する場合がある。本問題の原因は乱数生成に関わるものであり、以下のJava Bug Databaseに説明がある。

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6202721

JDK 7のb20以降のバージョンでは、修正されている。

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6521844

本問題が発生する場合、JVMの起動引数に以下を設定することで、回避することができる。

-Djava.security.egd=file:///dev/urandom

Javaクラス

@Inject
protected PasswordEncoder passwordEncoder;  // (1)

public String register(Customer customer, String rawPassword) {
    // omitted
    // Password Hashing
    String password = passwordEncoder.encode(rawPassword); // (2)
    customer.setPassword(password);
    // omitted
}

public boolean matches(Customer customer, String rawPassword) {
    return passwordEncoder.matches(rawPassword, customer.getPassword()); // (3)
}

項番	説明
(1)	Bean定義した、StandardPasswordEncoderをインジェクションする。
(2)	パスワードをハッシュ化する例 encodeメソッドの引数に平文のパスワードを指定することで、ハッシュ化されたパスワードが戻り値となる。
(3)	パスワードを照合する例 matchesメソッドは、第1引数に平文のパスワード、第2引数にハッシュ化されたパスワードを指定することで、一致しているかチェックできるメソッドである。

6.4.2.2. StandardPasswordEncoder ¶

StandardPasswordEncoderはハッシュ化のアルゴリズムとして、SHA-256を利用し、1024回のストレッチを行う。

また、ランダムに生成される8バイトのソルトを付与している。

以下に、StandardPasswordEncoderのencode(String rawPassword)メソッド、

matches(String rawPassword, String encodedPassword)メソッドの仕組みを説明する。

encode(String rawPassword)メソッド

Picture - encode method

ランダムに生成される8バイトのソルト + 秘密鍵 + 引数に指定された、パスワードでハッシュ化される。

上記でハッシュ化された値に、ハッシュ化に用いたソルトを先頭に付与した値が、メソッドの戻り値となる。

matches(String rawPassword, String encodedPassword)メソッド

Picture - matches method

引数で渡された、encodedPasswordの先頭のsaltをsplitし、salt + secret + rawPassword でハッシュ化した値と

encodedPasswordの先頭saltを除いた値とで比較処理を行う。

6.4.2.2.1. StandardPasswordEncoderの設定例 ¶

applicationContext.xml

<bean id="passwordEncoder"
  class="org.springframework.security.crypto.password.StandardPasswordEncoder">
  <!-- from properties file -->
  <constructor-arg value="${passoword.encoder.secret}"/> <!-- (1) -->
</bean>

項番

説明

(1)

ハッシュ化用の秘密鍵(secret)を指定する。
指定した場合、ハッシュ化処理において、「内部で生成されるソルト」 + 「指定した秘密鍵」 +「パスワード」でハッシュ化される。
秘密鍵(secret)を指定しない場合、レインボーテーブルを用いた攻撃方法に対する強度が下がるため、指定することを推奨する。

秘密鍵(secret)について
秘密鍵(secret)は、機密情報として扱うこと。
そのため、Spring Securityの設定ファイルに直接指定せずプロパティファイルや、環境変数などから取得する。
本例では、プロパティファイルから取得する例が有効になっている。また本番環境ではプロパティファイルの格納場所にも注意する。

Tip

秘密鍵(secret)を環境変数から取得する場合

StandardPasswordEncoderのbean定義の、<constructor-arg>に以下の設定を行うことで取得できる。

<bean id="passwordEncoder"
  class="org.springframework.security.crypto.password.StandardPasswordEncoder">
  <!-- from environment variable -->
  <constructor-arg value="#{systemEnvironment['PASSWORD_ENCODER_SECRET']}" /> <!-- (1) -->
</bean>

項番	説明
(1)	環境変数:PASSWORD_ENCODER_SECRETから値を取得する。

Javaクラス例はBCryptPasswordEncoderと同様のため、BCryptPasswordEncoderの設定例を参照されたい。

6.4.2.3. NoOpPasswordEncoder ¶

NoOpPasswordEncoderは、指定した値をそのままの文字列で返却するエンコーダーである。

単体テスト時など、ハッシュ化されていない文字列を使用したい場合以外に使用してはいけない。

設定例は、BCryptPasswordEncoderと同様のため、省略する。

6.4.3. How to extend ¶

業務要件によっては、前述したPasswordEncoderを実装したクラスでは実現できない場合がある。

特に、既存のアカウント情報で使用しているハッシュ化方式を踏襲したい場合などは、前述のPasswordEncoderでは要件を満たせないことが多い。

たとえば、既存のハッシュ方式が、以下のような場合が考えられる。

アルゴリズムがSHA-512である。
ストレッチ回数が1000回である。
ソルトはアカウントテーブルのカラムに格納されており、PasswordEncoderの外から渡す必要がある。

その場合、org.springframework.security.crypto.password.PasswordEncoderを実装したクラスではなく、

異なるパッケージのorg.springframework.security.authentication.encoding.PasswordEncoderを実装したクラスの使用を推奨する。

: Warning

Spring Security 3.1.4以前では、org.springframework.security.authentication.encoding.PasswordEncoderを実装したクラスをハッシュ化に使用していたが、3.1.4以降ではDeprecatedとなっている。そのため、Springが推奨しているパターンとは異なる。

6.4.3.1. ShaPasswordEncoderを使用した例 ¶

業務要件が以下の場合、
アルゴリズムはSHA-512を使用し、ストレッチを1000回を行う。
認証で説明した、
DaoAuthenticationProviderを使用した、認証処理を例に説明する。

applicationContext.xml

<bean id ="passwordEncoder"
    class="org.springframework.security.authentication.encoding.ShaPasswordEncoder"> <!-- (1) -->
    <constructor-arg value="512" /> <!-- (2) -->
    <property name="iterations" value="1000" /> <!-- (3) -->
</bean>

項番	説明
(1)	passwordEncoderには、`org.springframework.security.authentication.encoding.ShaPasswordEncoder`を指定する。 passwordEncoderに指定する、クラスは使用するアルゴリズムに合わせて変更すること。
(2)	コンストラクタの引数に、SHAアルゴリズムの種類を設定する指定可能な値は、「1、256、384、512」である。省略した場合は、「1」が設定される。
(3)	ハッシュ化時のストレッチングの回数を指定する。省略した場合は、0回となる。

spring-mvc.xml

<bean id="authenticationProvider"
    class="org.springframework.security.authentication.dao.DaoAuthenticationProvider">
    <!-- omitted -->
    <property name="saltSource" ref="saltSource" /> <!-- (1) -->
    <property name="userDetailsService" ref="userDetailsService" />
    <property name="passwordEncoder" ref="passwordEncoder" /> <!-- (2) -->
</bean>

<bean id="saltSource"
    class="org.springframework.security.authentication.dao.ReflectionSaltSource"> <!-- (3) -->
    <property name="userPropertyToUse" value="username" /> <!-- (4) -->
</bean>

項番	説明
(1)	ソルトを外部定義したい場合、`org.springframework.security.authentication.dao.SaltSource`を実装したクラスのBeanIdを設定する。本例では、ユーザ情報クラスに設定された値をリフレクションで取得する、 `org.springframework.security.authentication.dao.ReflectionSaltSource`を定義している。
(2)	passwordEncoderには、`org.springframework.security.authentication.encoding.ShaPasswordEncoder`を指定する。 passwordEncoderに指定する、クラスは使用するアルゴリズムに合わせて変更すること。
(3)	ソルトの作成方法を決める`org.springframework.security.authentication.dao.SaltSource`を指定する。ここでは`UserDetails`オブジェクトのプロパティをリフレクションで取得する`ReflectionSaltSource`を使用する。
(4)	`UserDetails`オブジェクトの`usernamte`プロパティをsaltとして使用する。

Javaクラス

@Inject
protected PasswordEncoder passwordEncoder;

public String register(Customer customer, String rawPassword, String userSalt) {
    // omitted
    String password = passwordEncoder.encodePassword(rawPassword,
            userSalt); // (1)
    customer.setPassword(password);
    // omitted
}

public boolean matches(Customer customer, String rawPassword, String userSalt) {
    return passwordEncoder.isPasswordValid(customer.getPassword(),
               rawPassword, userSalt); // (2)
}

項番	説明
(1)	パスワードをハッシュ化する場合、 `org.springframework.security.authentication.encoding.PasswordEncoder`を実装したクラスでは、 `encodePassword`メソッドの引数にパスワードと、ソルト文字列を指定する。
(2)	パスワードを照合する場合、 `isPasswordValid`メソッドを使用し、引数にハッシュ化されたパスワード、平文のパスワード、ソルト文字列を指定することで、ハッシュ化されたパスワードと平文のパスワードを比較する。

6.4.4. Appendix ¶

Note

ストレッチとは

ハッシュ関数の計算を繰り返し行うことで、保管するパスワードに関する情報を繰り返し暗号化することである。パスワードの総当たり攻撃への対策として、パスワード解析に必要な時間を延ばすために行う。しかし、ストレッチはシステムの性能に影響を与えるので、システムの性能を考慮してストレッチ回数を決める必要がある。

Note

ソルトとは

暗号化する元となるデータに追加する文字列である。ソルトをパスワードに付与することで、見かけ上、パスワード長を長くし、レインボークラックなどのパスワード解析を困難にするために利用する。なお、複数のユーザに対して同一のソルトを利用していると、同一パスワードを設定しているユーザが存在した時に、ハッシュ値から同一のパスワードである事が分かってしまう。そのため、ソルトはユーザごとに異なる値（ランダム値等）を設定することを推奨する。

PasswordEncoderの実装クラス	概要
`org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder`	“bcrypt”アルゴリズムでハッシュ化を行うエンコーダ
`org.springframework.security.crypto.password.StandardPasswordEncoder`	“SHA-256”アルゴリズム + 1024回のストレッチでハッシュ化を行うエンコーダ
`org.springframework.security.crypto.password.NoOpPasswordEncoder`	ハッシュ化を行わないエンコーダ（テスト用）

Table Of Contents

Previous topic

Next topic

This Page

6.4. パスワードハッシュ化¶

6.4.1. Overview ¶

6.4.2. How to use ¶

6.4.2.1. BCryptPasswordEncoder ¶

6.4.2.1.1. BCryptPasswordEncoderの設定例 ¶