7.7.12 セキュリティの定義項目

定義項目

カテゴリ	プロパティ	プロパティ名	get	set	list	再起動
■セキュリティ			×	×	○	－
	デフォルトレルム	default-realm	○	○	×	不要
	JACC	jacc	○	×	×	－
■レルム			×	×	○	－
	レルム名	name	○	×	×	－
	レルムクラス名	classname	○	×	×	－
レルムの追加プロパティ
	JAASコンテキスト	jaas-context	○	×	×	－
	グループ割り当て	assign-groups	○	○	×	必要
	キーファイル	file	○	×	×	－

■セキュリティ

定義項目名: ${clusterName_instanceName_configName}.security-service

デフォルトレルム

定義項目名: ${clusterName_instanceName_configName}.security-service.default-realm

説明: deployment descriptorにレルムを指定していない場合に、認証に使用されるレルムです。

範囲: 定義済みのレルム名を指定してください。

省略値: file

JACC

定義項目名: ${clusterName_instanceName_configName}.security-service.jacc

説明: 設定されているJACCプロバイダのクラス名です。

省略値: default

■レルム

定義項目名: ${clusterName_instanceName_configName}.security-service.auth-realm.${name}

レルム名

定義項目名: ${clusterName_instanceName_configName}.security-service.auth-realm.${name}.name

説明: レルムの名前です。

範囲

asadmin create-auth-realmサブコマンドでレルムを新規に作成する場合、レルム名は以下で構成してください。

英数字、または特殊文字(‘-’、‘_’、‘.’、‘/’、‘;’、‘#’)
先頭には、英数字または‘_’だけ指定可能

省略値

本定義項目は省略できません。

本製品には、以下のレルムが事前に準備されています。

admin-realm： asadminコマンドのログイン認証時に使用するための専用のレルム
file：Java EE 6アプリケーションで使用するfileレルム

レルムクラス名

定義項目名: ${clusterName_instanceName_configName}.security-service.auth-realm.${name}.classname

説明: レルムクラスの名前です。

範囲

asadmin create-auth-realmサブコマンドでfileレルムを新規に作成する場合、以下の値を設定してください。

com.sun.enterprise.security.auth.realm.file.FileRealm

省略値

本定義項目は省略できません。

fileレルムを使用する場合、com.sun.enterprise.security.auth.realm.file.FileRealmが指定されている必要があります。

JAASコンテキスト

定義項目名: ${clusterName_instanceName_configName}.security-service.auth-realm.${name}.property.jaas-context

説明: レルムが使用するログインモジュールのタイプを指定します。

範囲: asadmin create-auth-realmサブコマンドで新規にfileレルムを作る場合、--propertyオプションに以下の値を設定してください。
fileRealm

省略値

本定義項目は省略できません。asadmin setサブコマンドで値を省略して定義項目名と「=」だけを指定した場合、エラーとなります。

fileレルムを使用する場合、fileRealmが指定されている必要があります。

グループ割り当て

定義項目名: ${clusterName_instanceName_configName}.security-service.auth-realm.${name}.property.assign-groups

説明: 認証済みのユーザすべてに対して割り当てるグループを指定します。複数のグループを指定する場合はカンマ(,)で区切って指定します。

範囲

グループ名は、1文字以上、255文字以内とし、以下の文字で構成してください。

英数字
アンダースコア「 _ 」
ハイフン「 - 」
ピリオド「 . 」

複数グループを指定する場合は、カンマ「,」で区切って指定してください。

省略値

認証済みのユーザすべてに対して割り当てるグループは、存在しません。

setサブコマンドで値を省略して定義項目名と「=」だけを指定した場合、本定義項目は削除され、認証済みのユーザすべてに対して割り当てるグループは削除されます。

キーファイル

${clusterName_instanceName_configName}.security-service.auth-realm.${name}.property.file

説明

fileレルムのキーファイルの格納場所（ファイル名含む）を絶対パスで設定します。

${com.sun.aas.instanceRoot}/config配下のファイルを指定してください。

asadmin create-auth-realmサブコマンドで新規にfileレルムを作る場合、--propertyオプションでキーファイルを指定してください。

範囲: ${com.sun.aas.instanceRoot}/configから始まるパス

省略値

本製品に、事前に準備されているレルムのキーファイルは、以下の通りです。

admin-realm: ${com.sun.aas.instanceRoot}/config/admin-keyfile

file: ${com.sun.aas.instanceRoot}/config/keyfile

なお、fileレルムを使用している場合、本定義項目が設定されていることは必須です。

内容	参照先
機能説明	5.3 Java EE 6アプリケーションのセキュリティ機能 5.4 セキュリティ機能を利用した運用方法
チューニング方法
コマンド	asadminコマンドの以下のサブコマンド getサブコマンド setサブコマンド listサブコマンド create-auth-realmサブコマンド