Beginning with version 1.3, Cactus is able to unit test Servlet code that uses the Servlet Security API (getRemoteUser(), isUserInRole(), getUserPrincipal()).

バージョン 1.3 より、 Servlet Security API (getRemoteUser(), isUserInRole(), getUserPrincipal())を使った Servlet コードの単体テストができるようになりました。

The way to perform this is by securing a Servlet Redirector defined in your web.xml and then to specify user credentials in your beginXXX(), as defined below.

これを行う方法は、下で示すように、 web.xml で定義された Servlet Redirector を保障されたものとし、 beginXXX() において セキュリティ属性(credential)を指定するというものです。

Let's start with an example :

例から始めましょう :

There are several things to understand here :

ここで幾つか理解しておくべきことがあります :

• The Servlet that is called on the server side is the Cactus redirector servlet and thus we'll need to secure it in our web.xml (see step 2 below).
• サーバ側で呼ばれるサーブレットは Cactus リダイレクタサーブレットなので、 web.xml において、ユーザー認証に対応したものにしておく必要があります。 (ステップ 2 参照)
• WebRequest.setRedirectorName() is an API that lets you override the redirector defined in cactus.properties. This is needed here because we want to test both code that is not secured (i.e. for which we don't want to have to pass credentials) and code that is secured and thus we need 2 redirectors. The ServletRedirectorSecure redirector will be secured in step 2 below.
• WebRequest.setRedirectorName() は cactus.properties で定義されたリダイレクタを上書きさせる API です。 これは、ここで必要です。 なぜなら、ユーザ認証に対応していないコード (即ち、セキュリティ属性を渡す必要の無いもの)も、 ユーザ認証に対応したコードも両方テストしたいからです。 ですから、2 つのリダイレクタが必要です。 ServletRedirectorSecure リダイレクタは 下のステップ 2 において、ユーザ認証に対応できます。
• WebRequest.setAuthentication() is used to pass credentials to the server. It takes a parameter which is a BasicAuthentication object (the only type of authentication currently supported by Cactus).
• WebRequest.setAuthentication() は、サーバーへのセキュリティ属性を渡すために使われます。 これは、 BasicAuthentication オブジェクト (現在 Cactus がサポートしている唯一の認証のタイプ) のパラメーターをとります。

All calls to the server side go through the Cactus Servlet Redirector and thus it is that servlet that needs to be secured in web.xml. It is performed as follows (example) :

サーバ側への全ての呼び出しは、 Cactus サーブレットリダイレクタを通じて行われるので、 web.xmlでユーザ認証に対応する必要があるのは、そのサーブレットなのです。

This step consists in defining authorized users and mapping them to the role defined in web.xml (e.g. in the example above, we have defined a test role).

この段階では、権限をもつユーザの定義とweb.xml で定義されたロール(役割)との関連付けが含まれています。 (例えば、上の例では test ロールを定義しました)

This step is completely container-dependent and there is no standard way of doing it. You'll have to learn how to do it for your container. For example, here is how you would do it for Tomcat 4.0 :

このステップは、完全にコンテナに依存し、 これを行う標準的な方法はありません。 使っているコンテナで行うやり方を勉強しなければなりません。 例として、Tomcat 4.0 での設定法を示します :

• Create a tomcat-users.xml file that you put in your Tomcat configuration directory (where you have server.xml defined).
• Tomcat 設定ディレクトリに tomcat-users.xml ファイルを作成します。 (ここでは server.xml が定義されています。)

Here is an example of tomcat-users.xml that matches the test we have defined in step 1 :

ここに、ステップ 1 で定義した test とマッチする tomcat-users.xml の例を示します :