Interstage Application Server シングル・サインオン運用ガイド

5.1.2.4 利用者情報の取得

　認証に成功した場合、LoginContextをインスタンス化する際に指定したSubjectオブジェクトに対して以下のオブジェクトが関連付けられます。

• 認証情報を表すオブジェクト
• 認証された利用者のユーザIDを表すプリンシパルオブジェクト
• 利用者が属するロール名を表すプリンシパルオブジェクト
• SSOリポジトリ内の一意の識別名を表すプリンシパルオブジェクト

　認証情報を表すオブジェクトはSubjectオブジェクトの以下のメソッドで取得することができます。

• public Set getPrivateCredentials()
• public Set getPrivateCredentials(Class c)

　getPrivateCredentials()メソッドはSubjectオブジェクトに関連付けられているすべてのプリンシパルオブジェクトの集合を取得できます。getPrivateCredentials(Class c)メソッドは、Subjectオブジェクトに関連付けられているすべてのプリンシパルオブジェクトのうち、クラスclassまたはそのサブクラスのオブジェクトの集合を取得できます。関連付けられるオブジェクトのクラスと説明を以下に示します。

クラス名	説明
com.fujitsu.interstage.sso.auth.ISAuthenticationCredential	認証サーバから返却される認証情報を表します。サーブレットアプリケーションの場合このオブジェクトは含まれません。
com.fujitsu.interstage.sso.auth.ISAuthorizationCredential	認証情報および認証情報内の情報を保持します。

　コードを以下に示します。

Set credentials = subject.getPrivateCredentials();
// display credential information
Iterator iterator = credentials.iterator();
while (iterator.hasNext()) {
  // 認証情報を参照する処理
}

　プリンシパルオブジェクトはSubjectオブジェクトの以下のメソッドで取得することができます。

• public Set getPrincipals();
• public Set getPrincipals(Class c);

　この2つのメソッドの違いはgetPrivateCredentialsメソッドと同様です。関連付けられるオブジェクトのクラスと説明を以下に示します。

クラス名	説明
com.fujitsu.interstage.sso.auth.ISUserPrincipal	認証された利用者のユーザIDを表します。
com.fujitsu.interstage.sso.auth.ISRolePrincipal	利用者が属するロール名を表します。利用者がロールセットに属する場合、ロールセットに含まれるロールがそれぞれISRolePrincipalのオブジェクトとして関連付けられます。このオブジェクトは0個以上含まれます。
JDK1.3の場合 com.sun.security.auth.X500Principal または JDK1.4の場合 javax.security.auth.x500.X500Principal	利用者のSSOリポジトリ内の一意の識別名を表します。

　コードを以下に示します。

Set principals = subject.getPrincipals();
iterator = principals.iterator();
while (iterator.hasNext()) {
  Principal principal = (Principal)iterator.next();
  System.out.println("Principal=" + principal.getName());
}

• サーブレットアプリケーションの場合、ISAuthorizationCredentialオブジェクト内に保持する情報は業務サーバの定義ファイル内の“HTTPヘッダオプション”の設定に依存します。この設定の詳細については、“業務サーバの定義ファイルの設定”を参照してください。業務サーバの定義ファイルを更新した場合、サーブレットサービスを再起動してください。
• JDK1.3の場合、かつSSOリポジトリ内の一意の識別名に英数字と記号以外の文字が含まれる場合、X500Principalオブジェクトは使用できません。ISAuthorizationCredentialオブジェクトのgetDNメソッドを使ってSSOリポジトリ内の一意の識別名を表す文字列オブジェクトを取得するか、JDK1.4を使用してください。
• ISAuthorizationCredentialオブジェクトのgetExtraDataメソッドで取得できるSSOユーザ属性はリポジトリサーバの環境定義ファイル内のcredential-additional-attributeおよび、SSOリポジトリのユーザ情報の内容に依存します。SSOリポジトリのパス定義に設定するSSOユーザ属性の設定には依存しません。
• リポジトリサーバの環境定義ファイル内のcredential-additional-attributeに設定するSSOユーザ属性には、UTF-8の値を持つ属性以外は設定しないでください。UTF-8の値を持つ属性以外を設定した場合、ISAuthorizationCredentialオブジェクトのgetExtraDataメソッドでは正しい値を取得することはできません。