8.8.2. REST エンドポイントのセキュリティーの有効化
前提条件
JBoss Data Grid では、/docs/examples/configs) にある JBoss Data Grid ディレクトリー内に standalone-rest-auth.xml サンプルファイルがあります。
このファイルを
$JDG_HOME/standalone/configuration ディレクトリーにコピーして設定を使用します。$JDG_HOME から、以下のコマンドを入力して適切な場所に standalone-rest-auth.xml を作成します。
cp docs/examples/configs/standalone-rest-auth.xml standalone/configuration/standalone.xml
$ cp docs/examples/configs/standalone-rest-auth.xml standalone/configuration/standalone.xml
必要な場合は、新しい設定テンプレートで使用するサンプル
standalone-rest-auth.xml の新しいコピーを作成します。
手順8.1 REST エンドポイントのセキュリティーの有効化
REST インターフェースを使用する場合に JBoss Data Grid のセキュリティーを有効にするには、
standalone.xml に以下の変更を行います。
セキュリティーパラメーターの指定
rest エンドポイントでsecurity-domainパラメーターおよびauth-methodパラメーターの有効な値を指定するようにします。これらのパラメーターの推奨設定は以下のとおりです。Copy to Clipboard Copied! Toggle word wrap Toggle overflow セキュリティードメイン宣言のチェック
セキュリティーサブシステムに、対応するセキュリティードメイン宣言が含まれるようにします。セキュリティードメイン宣言の設定の詳細については、JBoss Application Server 7 または JBoss Enterprise Application Platform 6 ドキュメンテーションを参照してください。アプリケーションユーザーの追加
該当するスクリプトを実行し、アプリケーションユーザーを追加する設定を入力します。adduser.shスクリプト ($JDG_HOME/binに存在) を実行します。- Windows システムでは、
adduser.batファイル ($JDG_HOME/binに存在) を代わりに実行します。
- 追加するユーザーのタイプについて尋ねられたら、
bを入力してApplication User (application-users.properties)を選択します。 - リターンキーを押して、レルム (
ApplicationRealm) のデフォルト値を使用します。 - ユーザー名とパスワードを指定します。
- 作成されたユーザーのロールを尋ねられたら、
RESTと入力します。 - プロンプトが表示されたら、ユーザー名とアプリケーションレルム情報が正しいことを確認し、"yes" と入力して作業を続行します。
作成されたアプリケーションユーザーの確認
作成されたアプリケーションユーザーが正しく設定されていることを確認します。application-users.propertiesファイル ($JDG_HOME/standalone/configuration/に存在) にリストされた設定を確認します。以下は、このファイルの正しい設定の例です。user1=2dc3eacfed8cf95a4a31159167b936fc
user1=2dc3eacfed8cf95a4a31159167b936fcCopy to Clipboard Copied! Toggle word wrap Toggle overflow application-roles.propertiesファイル ($JDG_HOME/standalone/configuration/に存在) にリストされた設定を確認します。以下は、このファイルの正しい設定の例です。user1=REST
user1=RESTCopy to Clipboard Copied! Toggle word wrap Toggle overflow
サーバーのテスト
サーバーを起動し、ブラウザーウィンドウに以下のリンクを入力して REST エンドポイントにアクセスします。http://localhost:8080/rest/namedCache
http://localhost:8080/rest/namedCacheCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注記
GET 要求の使用をテストする場合は、405応答コードが期待され、サーバーが正常に認証されたことが示されます。