Hitachi

Cosminexus V11 アプリケーションサーバ 機能解説 セキュリティ管理機能編


modifySSODataメソッド

〈このページの構成〉

説明

シングルサインオン用認証情報を修正します。指定したユーザがない場合は例外が発生します。

このオブジェクトに登録されているすべてのシングルサインオン用認証情報リスナのssoDataModifiedメソッドが呼び出されます。

このメソッドでは,SSODataオブジェクトの生成後,変更された認証情報だけが既存のものに上書きされます。

例えば,リポジトリの既存のシングルサインオン用認証情報が次に示す要素を持っていたとします。

認証情報名

SecretData

PublicData

マッピング

レルム

ユーザID

secret

public

RealmA

user1

RealmB

admin

このとき,次のコードで生成したSSODataオブジェクトをこのメソッドのパラメタに指定します。

SSOData data = new SSOData();
data.setMapping("RealmA", "user2");

すると,リポジトリのシングルサインオン用認証情報は次のように変更されます。

認証情報名

SecretData

PublicData

マッピング

レルム

ユーザID

secret

public

RealmA

user2

(凡例)−:情報がないことを示します。

形式

public void modifySSOData(String uid,
                          SSOData ssoData)
  throws SSODataListenerException, NamingException,
  CryptoException, UnsatisfiedLinkError, SecurityException;

パラメタ

uid:

ユーザIDを指定します。

ssoData:

シングルサインオン用認証情報を格納したSSODataオブジェクトを指定します。

例外

com.cosminexus.admin.auth.api.repository.event.SSODataListenerException:

他システムの認証情報更新に失敗しました。

com.cosminexus.admin.auth.CryptoException:

暗号鍵ファイルの読み込みに失敗しました。または,誤った暗号鍵ファイルを使用したためSecretDataの復号化に失敗しました。

java.lang.UnsatisfiedLinkError:

シングルサインオンライブラリの読み込みに失敗しました。

java.lang.SecurityException:

SecurityManagerが存在し,SecurityManagerのcheckReadメソッドでファイルへの読み込みアクセスが拒否されました。

javax.naming.CommunicationException:

LDAPディレクトリサーバへの接続に失敗しました。

javax.naming.NameNotFoundException:

指定したユーザIDがありません。

その他JNDIの例外:

バインドDNの指定ミスなどです。

戻り値

なし