ページの先頭行へ戻る
Interstage Application Server Java EE運用ガイド(Java EE 6編)
Interstage

9.1.11 セキュリティ

9.1.11.1 change-admin-passwordサブコマンド

形式

change-admin-password

機能説明

fileレルムの管理ユーザーのパスワードを変更します。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように問い合わせが2回行われます。問い合わせにしたがって現在のパスワードと、新しいパスワードを2回入力します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin change-admin-password
Enter admin user name [default: admin]> admin
Enter admin password>
Enter new admin password>
Enter new admin password again>
Command change-admin-password executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin change-admin-password
Enter admin user name [default: admin]> admin
Enter admin password>
Enter new admin password>
Enter new admin password again>
Command change-admin-password executed successfully.

9.1.11.2 create-connector-security-mapサブコマンド

形式

create-connector-security-map --poolname connector_connection_pool_name [--principals principal_name1[,principal_name2]...] [--usergroups usergroup_name1[,usergroup_name2]...] --mappedusername username security_map_name

機能説明

セキュリティーマップを作成します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--poolname

なし

コネクタ接続プールのプール名を指定します。

--principals

なし

Principalを指定します。複数のPrincipalを指定する場合、各Principalを','で区切って指定します。

--usergroups

なし

ユーザーグループを指定します。複数のユーザーグループを指定する場合、各ユーザーグループを','で区切って指定します。

--mappedusername

なし

Backend Principalのユーザー名を指定します。

オペランド

オペランド名

省略

説明

security_map_name

不可

セキュリティーマップの名前を指定します。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin --passwordfile C:\temp\password.txt create-connector-security-map --poolname eis/connectionPool --principals principal1,principal2 --mappedusername backendPrincipal securityMap
Command create-connector-security-map executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin --passwordfile /temp/password.txt create-connector-security-map --poolname eis/connectionPool --principals principal1,principal2 --mappedusername backendPrincipal securityMap
Command create-connector-security-map executed successfully.

9.1.11.3 delete-connector-security-mapサブコマンド

形式

delete-connector-security-map --poolname connector_connection_pool_name security_map_name

機能説明

セキュリティーマップを削除します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--poolname

なし

コネクタ接続プールのプール名を指定します。

オペランド

オペランド名

省略

説明

security_map_name

不可

セキュリティーマップの名前を指定します。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-connector-security-map --poolname eis/connectionPool securityMap
Command delete-connector-security-map executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin delete-connector-security-map --poolname eis/connectionPool securityMap
Command delete-connector-security-map executed successfully.

9.1.11.4 update-connector-security-mapサブコマンド

形式

update-connector-security-map --poolname connector_connection_pool_name [--addprincipals principal_name1[,principal_name2]...] [--addusergroups usergroup_name1[,usergroup_name2]...] [--removeprincipals principal_name1[,principal_name2]...] [--removeusergroups usergroup_name1[,usergroup_name2]...] [--mappedusername username] security_map_name

機能説明

セキュリティーマップを更新します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--poolname

なし

コネクタ接続プールのプール名を指定します。

--addprincipals

なし

追加するPrincipalを指定します。複数のPrincipalを指定する場合、各Principalを','で区切って指定します。

--addusergroups

なし

追加するユーザーグループを指定します。複数のユーザーグループを指定する場合、各ユーザーグループを','で区切って指定します。

--removeprincipals

なし

削除するPrincipalを指定します。複数のPrincipalを指定する場合、各Principalを','で区切って指定します。

--removeusergroups

なし

削除するユーザーグループを指定します。複数のユーザーグループを指定する場合、各ユーザーグループを','で区切って指定します。

--mappedusername

なし

Backend Principalのユーザー名を指定します。

オペランド

オペランド名

省略

説明

security_map_name

不可

セキュリティーマップの名前を指定します。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin --passwordfile C:\temp\password.txt update-connector-security-map --poolname eis/connectionPool --addprincipals principal1,principal2 --mappedusername backendPrincipal securityMap
Command update-connector-security-map executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin --passwordfile /temp/password.txt update-connector-security-map --poolname eis/connectionPool --addprincipals principal1,principal2 --mappedusername backendPrincipal securityMap
Command update-connector-security-map executed successfully.

9.1.11.5 list-connector-security-mapsサブコマンド

形式

list-connector-security-maps connector_connection_pool_name

機能説明

セキュリティーマップの一覧を取得します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オペランド

オペランド名

省略

説明

connector_connection_pool_name

不可

コネクタ接続プールのプール名を指定します。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-connector-security-maps eis/connectionPool
securityMap1
securityMap2
Command list-connector-security-maps executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin list-connector-security-maps eis/connectionPool
securityMap1
securityMap2
Command list-connector-security-maps executed successfully.

9.1.11.6 create-password-aliasサブコマンド

形式

create-password-alias aliasname

機能説明

パスワードエイリアスを作成します。管理者パスワードのエイリアスは作成できません。
作成したパスワードエイリアスは、以下においてパスワードの代りに指定できます。

上記でパスワード項目を定義する際、パスワードエイリアスを以下のフォーマットで指定します。

${ALIAS=aliasname}

コマンドを実行すると以下のプロンプトが表示されますのでパスワードを入力してください。

Please enter the alias password

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オペランド

オペランド名

省略

説明

aliasname

不可

パスワードエイリアス名を指定します。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin create-password-alias alias1
Please enter the alias password>
Please enter the alias password again>
Command create-password-alias executed successfully.

domain.xml ファイル内のパスワードを暗号化するには、以下のように実行します。
(コネクションプール eis/connectionPool、セキュリティマップ securityMap は事前に作成)

C:\Interstage\F3FMisje6\glassfish\bin\asadmin set --user admin
resources.connector-connection-pool.eis/connectionPool.security-map.securityMap.backend-principal.password=${ALIAS=alias1}

/opt/FJSVisje6/glassfish/bin/asadmin create-password-alias alias1
Please enter the alias password>
Please enter the alias password again>
Command create-password-alias executed successfully.

domain.xml ファイル内のパスワードを暗号化するには、以下のように実行します。
(コネクションプール eis/connectionPool、セキュリティマップ securityMap は事前に作成)

/opt/FJSVisje6/glassfish/bin/asadmin set --user admin
resources.connector-connection-pool.eis/connectionPool.security-map.securityMap.backend-principal.password=${ALIAS=alias1}

9.1.11.7 delete-password-aliasサブコマンド

形式

delete-password-alias aliasname

機能説明

パスワードエイリアスを削除します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オペランド

オペランド名

省略

説明

aliasname

不可

パスワードエイリアス名を指定します。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-password-alias alias1
Command delete-password-alias executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin delete-password-alias alias1
Command delete-password-alias executed successfully.

9.1.11.8 list-password-aliasesサブコマンド

形式

list-password-aliases

機能説明

パスワードエイリアスの一覧を表示します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-password-aliases
alias1
alias2
Command list-password-aliases executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin list-password-aliases
alias1
alias2
Command list-password-aliases executed successfully.

9.1.11.9 update-password-aliasサブコマンド

形式

update-password-alias aliasname

機能説明

パスワードエイリアスを更新します。
コマンドを実行すると以下のプロンプトが表示されますのでパスワードを入力してください。

Please enter the alias password

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オペランド

オペランド名

省略

説明

aliasname

不可

パスワードエイリアス名を指定します。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin update-password-alias alias1
Please enter the alias password>
Please enter the alias password again>
Command update-password-alias executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin update-password-alias alias1
Please enter the alias password>
Please enter the alias password again>
Command update-password-alias executed successfully.

9.1.11.10 create-auth-realmサブコマンド

形式

create-auth-realm --classname realm_class [--property name=value[:name=value]...] auth_realm_name

機能説明

指定された認証方法のレルムを追加します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--classname

なし

レルムの実装クラスを指定します。以下のクラスを指定してください。

  • fileレルムを作成する場合
    com.sun.enterprise.security.auth.realm.file.FileRealm

指定を省略すると、入力を求めるプロンプトが表示されます。

--property

なし

「レルムの追加プロパティ」を指定します。
指定するプロパティは、「8.4.10 セキュリティの定義項目」を参照してください。

オペランド

オペランド名

省略

説明

auth_realm_name

不可

レルム名を指定します。
指定を省略すると、入力を求めるプロンプトが表示されます。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin create-auth-realm --classname com.sun.enterprise.security.auth.realm.file.FileRealm
--property jaas-context=fileRealm:file=keyfile fileRealm
Command create-auth-realm executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin create-auth-realm --classname com.sun.enterprise.security.auth.realm.file.FileRealm
--property jaas-context=fileRealm:file=keyfile fileRealm
Command create-auth-realm executed successfully.

9.1.11.11 delete-auth-realmサブコマンド

形式

delete-auth-realm auth_realm_name

機能説明

指定されたレルムを削除します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オペランド

オペランド名

省略

説明

auth_realm_name

不可

レルム名を指定します。
指定を省略すると、入力を求めるプロンプトが表示されます。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-auth-realm fileRealm
Command delete-auth-realm executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin delete-auth-realm fileRealm
Command delete-auth-realm executed successfully.

9.1.11.12 list-auth-realmsサブコマンド

形式

list-auth-realms

機能説明

Interstage Java EE 6 DASサービス内のレルムの一覧を表示します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-auth-realms
admin-realm
file
certificate
Command list-auth-realms executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin list-auth-realms
admin-realm
file
certificate
Command list-auth-realms executed successfully.

9.1.11.13 create-file-userサブコマンド

形式

create-file-user [--groups user_groups[:user_groups]...] [--authrealmname authrealm_name] username

機能説明

fileレルムのユーザを作成します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--groups

なし

ユーザが属するグループのリストを指定します。(注)
複数のグループを指定する場合、各グループを':'で区切って指定します。省略した場合は設定されません。

--authrealmname

なし

fileレルムの名前を指定します。
fileレルムとして設定したレルム名を指定してください。省略した場合はデフォルトレルムが選択されます。


注) 詳細は、「6.3.5 fileレルムの設定」を参照してください。

オペランド

オペランド名

省略

説明

username

不可

ユーザ名を指定します。(注)
指定を省略すると、入力を求めるプロンプトが表示されます。


注) 詳細は、「6.3.5 fileレルムの設定」を参照してください。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin create-file-user user1
Enter the user password>
Enter the user password again>
Command create-file-user executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin create-file-user user1
Enter the user password>
Enter the user password again>
Command create-file-user executed successfully.

9.1.11.14 delete-file-userサブコマンド

形式

delete-file-user [--authrealmname authrealm_name] username

機能説明

fileレルムのユーザを削除します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--authrealmname

なし

fileレルムの名前を指定します。
fileレルムとして設定したレルム名を指定してください。省略した場合はデフォルトレルムが選択されます。

オペランド

オペランド名

省略

説明

username

不可

ユーザ名を指定します。
指定を省略すると、入力を求めるプロンプトが表示されます。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin delete-file-user user1
Command delete-file-user executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin delete-file-user user1
Command delete-file-user executed successfully.

9.1.11.15 update-file-userサブコマンド

形式

update-file-user [--groups user_groups[:user_groups]...] [--authrealmname authrealm_name] username

機能説明

fileレルムのユーザを更新します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--groups

なし

ユーザが属するグループのリストを指定します。(注)
複数のグループを指定する場合、各グループを':'で区切って指定します。
本オプションを省略した場合、グループのリストは更新されません。

--authrealmname

なし

fileレルムの名前を指定します。
fileレルムとして設定したレルム名を指定してください。省略した場合はデフォルトレルムが選択されます。


注) 詳細は、「6.3.5 fileレルムの設定」を参照してください。

オペランド

オペランド名

省略

説明

username

不可

ユーザ名を指定します。(注)
指定を省略すると、入力を求めるプロンプトが表示されます。


注) 詳細は、「6.3.5 fileレルムの設定」を参照してください。

戻り値

0: 正常終了
1: 異常終了

注意事項

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin --passwordfile c:\temp\password.txt update-file-user --groups group1 user1
Command update-file-user executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin --passwordfile /tmp/password.txt update-file-user --groups group1 user1
Command update-file-user executed successfully.

9.1.11.16 list-file-usersサブコマンド

形式

list-file-users [--authrealmname authrealm_name]

機能説明

fileレルムのユーザの一覧を表示します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--authrealmname

なし

fileレルムの名前を指定します。
fileレルムとして設定したレルム名を指定してください。省略した場合はデフォルトレルムが選択されます。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-file-users
user1
user2
Command list-file-users executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin list-file-users
user1
user2
Command list-file-users executed successfully.

9.1.11.17 list-file-groupsサブコマンド

形式

list-file-groups [--name username] [--authrealmname authrealm_name]

機能説明

fileレルムのグループの一覧を表示します。

asadminコマンドの利用方法・注意事項については、「9.1 asadmin」も参照してください。

また共通オプションについては、「9.1.2 asadminコマンドの共通オプション」を参照してください。

オプション

オプション名

簡略名

説明

--name

なし

fileレルムのユーザを指定します。

--authrealmname

なし

fileレルムの名前を指定します。
fileレルムとして設定したレルム名を指定してください。省略した場合はデフォルトレルムが選択されます。

戻り値

0: 正常終了
1: 異常終了

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\asadmin list-file-groups
list-file-groups successful
file-group : group1
file-group : group2
Command list-file-groups executed successfully.

/opt/FJSVisje6/glassfish/bin/asadmin list-file-groups
list-file-groups successful
file-group : group1
file-group : group2
Command list-file-groups executed successfully.