Tomcatのフォーム認証が失敗した際のトラブルシューティングメモ

具体的にはserver.xmlの下記の２カ所で、いずれもRealm（TomcatにおいてユーザID、パスワード、ロール等を保持するデータベースの意）の方式の１つである「UserDatabaseRealm」、つまりTomcatのデフォルトである「tomcat-users.xml」にユーザ情報やロール情報を追記して認証する方式に必要な記述であり、コメントアウトすると動作しなくなるものです。

①<Resouce>タグ

ユーザ認証の情報を保持するファイルとして「tomcat-users.xml」を指定しています。

<Resource auth="Container" description="User database that can be updated and saved" factory="org.apache.catalina.users.MemoryUserDatabaseFactory" name="UserDatabase" pathname="conf/tomcat-users.xml" type="org.apache.catalina.UserDatabase"/>

②<Realm>タグ

UserDatabaseRealm（JNDIのリソース）に保持したユーザ情報を使って認証する設定です。

<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase" />

＜事象の流れ＞

１．Login.jspを要求

２．Login.jspに遷移するので、認証情報を入力

３．要求したLogin.jspに遷移する

４．再度認証情報を入力

５．404エラー

 

（動画）

（図１２１）

 

そもそもフォーム認証の基本的な流れとして「[①要求ページ]→[②認証画面]→(認証成功)→[③要求ページ]」のような流れを辿ります。

（図１２２）- A

 

なので、もし[①要求ページ]としてログイン画面自体（Login.jsp）を要求した場合はログインしたのに、再びログイン画面が出てきたように見えてしまいます・・。

（図１２２）

では、なぜログイン画面を開くと再びログイン画面に遷移してしまったのか？の原因は今回は認証範囲、つまりweb.xmlの<url-pattern>が「/*」と設定していたため、ログイン画面自体も認証の範囲となってしまっていました。

（図１２３）

 

２回目のログインに関しては、そもそも[①要求ページ]が無い状態で認証をしているため、404エラーになっています（何も要求されていない）。

 

＞目次にもどる

上述の通り、[①要求ページ]→[②認証画面]→(認証成功)→[③要求ページ]がフォーム認証の基本的な流れなので、そもそも[①要求ページ]でログイン画面自体を要求する事自体が、フォーム認証の使い方として誤っているという事になります（この動きは仕様通り）。

（図１２４）

(１-３) DataSourceRealm系のエラー

DataSourceRealmに関するエラーについては下記の記事でもご紹介していますので、併せてご参照頂けたらと思います。

⇒（参考）Tomcatのフォーム認証（DataSourceRealm）で403エラー等が発生した場合の対処

＞目次にもどる