Java 認証・承認サービス (JAAS) 1.0

開発者用ガイド

• 概説
• この資料の対象読者
• 関連資料
• 紹介
• コア・クラス
• 共通クラス
  • Subject
  • Principals
  • Credentials
• 認証クラス
• LoginContext
• LoginModule
• CallbackHandler
• Callback
• 権限クラス
• Policy
• AuthPermission
• PrivateCredentialPermission

リファレンス

• インプリメンテーション
• "Hello World"、JAAS スタイル!
• 付録 A: java.security セキュリティー・プロパティー・ファイルでの JAAS 設定
• 付録 B: ログイン構成ファイル
• 付録 C: 権限ポリシー・ファイル

概説

Java認証・承認サービス (JAAS) は、Java 2 Software Development Kit、バージョン 1.3 の標準拡張機能です。 現在、Java 2 は、コード・ソースに基づくアクセス制御 (コードの発信元 およびコードの署名者 に基づいたアクセス制御) を提供しています。 ただし、コードの実行者 に基づく追加のアクセス制御を実施する機能に欠けています。 JAAS が提供するフレームワークでは、このサポートとともに Java 2 セキュリティー・モデルを拡大しています。

この資料は、2000 年 3 月 17 日に最終更新されました。

この資料の対象読者

この資料は、コード・ソース・ベースのセキュリティー・モデルと Subject ベースのセキュリティー・モデルによって制限されたアプリケーションを作成しようとしている、経験を積んだプログラマーを対象としています。

関連資料

この資料は、読者が以下の資料をすでに読み終えていることを前提としています。

• Java 2 Software Development Kit API Specification
• JAAS API 仕様
• Security and the Java platform

このガイドの補足は、Sun Microsystems, Inc. が提供する LoginModule Developer's Guide です。

紹介

JAAS インフラストラクチャーは、2 つのメイン・コンポーネント、すなわち認証コンポーネントと権限 (承認) コンポーネントに分割できます。 JAAS 認証コンポーネントは、Java がアプリケーション、アプレット、Bean、またはサーブレットとして稼働しているかどうかにかかわりなく、現在だれがそのコードを処理しているかについて確実かつ安全に判別する機能を提供します。 JAAS 権限 (承認) コンポーネントは、そのコード・ソース (Java 2 で実行される) に応じて、また認証された人物に応じて、処理中の Java コードが機密タスクを実行するのを制約することにより、既存の Java 2 セキュリティー・フレームワークを補足します。

JAAS 認証は、プラグ可能 形式で実行されます。 これにより、Java アプリケーションは、基礎となる認証テクノロジーからの独立を保つことが可能になります。 したがって、アプリケーションそのものに変更を加えなくても、新規または更新された認証テクノロジーをアプリケーションの下で接続することができます。 アプリケーションは、

LoginContext

Configuration

LoginModule

コードを処理するユーザーが認証されると、JAAS 権限 (承認) コンポーネントが既存の Java 2 アクセス制御モデルとともに機能して、重要なリソースへのアクセスを保護します。

CodeSource

CodeSource

Subject

java.io.FilePermission

java.net.SocketPermission

コア・クラス

• 共通クラス
  • Subject、Principals、Credentials
• 認証クラス
  • LoginContext、LoginModule、CallbackHandler、Callback
• 権限クラス
  • Policy、AuthPermission、PrivateCredentialPermission

共通クラス

Subject

java.security.Principal

Subject

また、

Subject

Set

Set

サブジェクトは次のコンストラクターを使用して作成されます。

    public Subject();

    public Subject(boolean readOnly, Set principals,
                   Set pubCredentials, Set privCredentials);

これらのコンストラクターを使用しないで、認証済みサブジェクトへの参照を取得する代わりの方法が、LoginContext セクションに示されています。

サブジェクトが読み取り専用状態になるようにインスタンス化されなかった場合、次のメソッドを呼び出すことによって、読み取り専用状態に設定することができます。

    public void setReadOnly();

AuthPermission("setReadOnly")

IllegalStateException

サブジェクトの読み取り専用状態をテストするには、次のメソッドを呼び出すことができます。

    public boolean isReadOnly();

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

サブジェクトに関連した公開信任状を検索するには、次のメソッドが使用可能です。

    public Set getPublicCredentials();
    public Set getPublicCredentials(Class c);

getPrincipals

サブジェクトに関連した秘密信任状を検索するには、次のメソッドが使用可能です。

    public Set getPrivateCredentials();
    public Set getPrivateCredentials(Class c);

getPrincipals

getPublicCredentials

java.util.Set

    Subject subject;
    Principal principal;
    Object credential;

    // add a Principal and credential to the Subject
    subject.getPrincipals().add(principal);
    subject.getPublicCredentials().add(credential);

AuthPermission("modifyPrincipals")

AuthPermission("modifyPublicCredentials")

AuthPermission("modifyPrivateCredentials")

getPrincipals

getPublicCredentials

getPrivateCredentials

getPrincipals(Class c)

getPublicCredentials(Class c)

getPrivateCredentials(Class c)

AccessControlContext

AccessControlContext

    public static Subject getSubject(final AccessControlContext acc);

Subject.getSubject

AuthPermission("getSubject")

java.lang.Object

    public boolean equals(Object o);
    public String toString();
    public int hashCode();

特定のサブジェクトとして処理を実行するために、次の静的メソッドを呼び出すことができます。

    public static Object doAs(final Subject subject,
                         final java.security.PrivilegedAction action);

    public static Object doAs(final Subject subject,
                         final java.security.PrivilegedExceptionAction action)
                         throws java.security.PrivilegedActionException;

AccessControlContext

PrivilegedExceptionAction 

 AuthPermission("doAs")

doAs

doAs

com.ibm.security.Principal

Subject

LoginContext

   // Grant "BOB" permission to read the file "foo.txt"
   grant Principal com.ibm.security.Principal "BOB" {
      permission java.io.FilePermission "foo.txt", "read";
};

Subject.doAs の例 1

    class ExampleAction implements java.security.PrivilegedAction {
        public Object run() {
            java.io.File f = new java.io.File("foo.txt");

            // exists() invokes a security check
            if (f.exists()) {
                System.out.println("File foo.txt exists.");
            }
            return null;
        }
    }

    public class Example1 {
        public static void main(String[] args) {

            // Authenticate the subject, "BOB".
            // This process is described in the
            // LoginContext section.

            Subject bob;
            ...

            // perform "ExampleAction" as "BOB":
            Subject.doAs(bob, new ExampleAction());
        }
    }

ExampleAction

f.exists()

ExampleAction

FilePermission

ExampleAction

例 2 は、例 1 と同じシナリオを使用します。

Subject.doAs の例 2

    public class Example2 {
        // Example of using an anonymous action class.
        public static void main(String[] args) {
            // Authenticate the subject, "BOB".
            // This process is described in the
            // LoginContext section.

            Subject bob;
            ...

            // perform "ExampleAction" as "BOB":
            Subject.doAs(bob, new ExampleAction() {
                public Object run() {
                    java.io.File f = new java.io.File("foo.txt");
                    if (f.exists()) {
                        System.out.println("File foo.txt exists.");
                    }
                    return null;
                }
            });
        }
    }

SecurityException

SecurityException

doAs

さらに、次のメソッドも特定のサブジェクトとして処理を実行します。

doAsPrivileged

AccessControlContext

    public static Object doAsPrivileged(final Subject subject,
                         final java.security.PrivilegedAction action,
                         final java.security.AccessControlContext acc);

    public static Object doAsPrivileged(final Subject subject,
                         final java.security.PrivilegedExceptionAction action,
                         final java.security.AccessControlContext acc)
                         throws java.security.PrivilegedActionException;

doAsPrivileged

doAs

doAsPrivileged

AccessControlContext

AuthPermission("doAsPrivileged")

doAsPrivileged

Principals

java.security.Principal

java.io.Serializable

Credentials

Refreshable

    boolean isCurrent();

    void refresh() throws RefreshFailedException;

AuthPermission("refreshCredential")

Destroyable

    boolean isDestroyed();

    void destroy() throws DestroyFailedException;

IllegalStateException

AuthPermission("destroyCredential")

認証クラス

Subject

1. アプリケーションは、

   LoginContext

   をインスタンス化します。

2. LoginContext

   は構成を調べて、そのアプリケーション用に構成されたすべての LoginModules をロードします。
3. アプリケーションは LoginContext の login メソッドを呼び出します。
4. login メソッドは、ロードされたすべての LoginModules を呼び出します。 それぞれの

   LoginModule

   は、

   Subject

   の認証を試みます。 成功すると、LoginModules は関係のあるプリンシパルおよび信任状を

   Subject

   に関連付けます。

5. LoginContext

   は認証状況をアプリケーションに戻します。
6. 認証が成功すると、アプリケーションは認証済みの

   Subject

   を

   LoginContext

   から取得します。

LoginContext

LoginContext

LoginContext

Configuration

LoginContext

    public LoginContext(String name) throws LoginException;

    public LoginContext(String name, Subject subject) throws LoginException;

    public LoginContext(String name, CallbackHandler callbackHandler)
           throws LoginException

    public LoginContext(String name, Subject subject,
           CallbackHandler callbackHandler) throws LoginException

LoginContext

Subject

Subject

AuthPermission("createLoginContext")

LoginContext

実際の認証は、次のメソッドの呼び出しとともに行われます。

    public void login() throws LoginException;

Subject

    public Subject getSubject();

Subject

    public void logout() throws LoginException;

アプリケーション内の次のコードの断片は、"moduleFoo" という名前の構成項目を持つ構成ファイルにアクセスした後で、"bob" と呼ばれるサブジェクトを認証します。

    Subject bob = new Subject();
    LoginContext lc = new LoginContext("moduleFoo", bob);
    try {
        lc.login();
        System.out.println("authentication successful");
    } catch (LoginException le) {
        System.out.println("authentication unsuccessful"+le.printStackTrace());
    }

    LoginContext lc = new LoginContext("moduleFoo");
    try {
        lc.login();
        System.out.println("authentication successful");
    } catch (LoginException le) {
        System.out.println("authentication unsuccessful"+le.printStackTrace());
    }
    Subject subject = lc.getSubject();

Subject.getSubject

AuthPermission("getSubject")

LoginModule

LoginModule

LoginModule Developer's Guide は、LoginModules をインプリメントするための段階的な説明を開発者に与える詳しい資料です。

LoginModule

LoginContext

LoginModule

LoginModule

LoginContext

initialize

   void initialize(Subject subject, CallbackHandler callbackHandler,
        Map sharedState, Map options);

     boolean login() throws LoginException;

次のメソッドは、認証プロセスを完了し、終了させます。

     boolean commit() throws LoginException;

次のメソッドは、フェーズ 1 が成功しなかった場合に認証プロセスを停止します。

    boolean abort() throws LoginException;

    boolean logout() throws LoginException;

Subject

commit

CallbackHandler

場合によっては、LoginModule は、認証情報を取得するためにユーザーと通信しなければなりません。 LoginModules はこのために CallbackHandler を使用します。 アプリケーションは CallbackHandler インターフェースをインプリメントし、それを LoginContext に渡します。そして、基礎となる LoginModules に直接転送します。 LoginModules は、ユーザーからの入力 (パスワードまたはスマート・カード・ピン番号など) を収集することと、ユーザーに情報 (状況情報など) を提供することの両方のために、CallbackHandler を使用します。 アプリケーションが CallbackHandler を指定できるようにすることにより、基礎となる LoginModules は、アプリケーションがユーザーと対話する様々な方法からは独立したままでいられます。 たとえば、GUI アプリケーション用の CallbackHandler をインプリメントすると、ユーザーからの入力を送信請求するためにウィンドウが表示されます。 非 GUI ツール用の CallbackHandler をインプリメントすると、ユーザーはコマンド行から直接入力するように促されます。

CallbackHandler

     void handle(Callback[] callbacks)
     throws java.io.IOException, UnsupportedCallbackException;

Callback

使用法の詳細については、各種の Callback API を調べてください。

権限クラス

Subject

Subject

Subject

Policy

Policy

Policy

    public abstract java.security.PermissionCollection getPermissions
                    (Subject subject,
                    java.security.CodeSource cs);
    public abstract void refresh();

getPermissions

Subject

CodeSource

refresh

Policy

refresh

AuthPermission("refreshPolicy")

Policy

AuthPermission("getPolicy")

    public static Policy getPolicy();

Policy

Subject

CodeSource

    policy = Policy.getPolicy();
    PermissionCollection perms = policy.getPermissions(subject, codeSource);

Policy

Policy.setPolicy

AuthPermission("setPolicy")

    public static void setPolicy(Policy policy);

ポリシー・ファイルのサンプル項目:

これらの例は、デフォルトの PolicyFile インプリメンテーションにのみ関係があります。

Policy

Subject

Principal

Subject

    grant CodeBase ["URL"],
          Signedby ["signers"],
          Principal [Principal_Class] "Principal_Name",
          Principal ... {
        permission Permission_Class ["Target_Name"]
                                    [, "Permission_Actions"]
                                    [, signedBy "SignerName"];
    };

    // example grant entry
    grant CodeBase "http://griffin.ibm.com", Signedby "davis",
          Principal com.ibm.security.auth.NTUserPrincipal "kent" {
        permission java.io.FilePermission "c:/kent/files/*", "read, write";
    };

Policy

Policy

Permission

Permission

Subject

Principal

    grant Principal com.ibm.security.auth.NTUserPrincipal "kent",
          Principal com.ibm.security.auth.NTSidGroupPrincipal "S-1-1-0" {
        permission java.io.FilePermission "c:/user/kent/", "read, write";
        permission java.net.SocketPermission "griffin.ibm.com", "connect";
    };

AuthPermission

Permission

AuthPermission

    public AuthPermission(String name);
    public AuthPermission(String name, String actions);

Policy

AuthPermission オブジェクトは、Policy、Subject、LoginContext、および Configuration オブジェクトへのアクセスを保護するために使用されます。 サポートされる有効な名前のリストについては、AuthPermission Javadoc を参照してください。

PrivateCredentialPermission

    public PrivateCredentialPermission(String name, String actions);

インプリメンテーション

JAAS プロバイダーおよびポリシー・ファイルにはデフォルト値が存在するため、ユーザーは JAAS をインプリメントするためにそれらのリストを静的に (java.security ファイル内で) リストすることも、動的に (コマンド行 -D オプション) リストすることも必要ありません。 また、デフォルト構成およびポリシー・ファイル・プロバイダーは、ユーザー開発のプロバイダーによって置き換えられることがあります。 そのため、このセクションでは、JAAS デフォルト・プロバイダーおよびポリシー・ファイルとともに、代わりのプロバイダーを使用可能にするプロパティーの説明を試みます。

ここで要約される事柄よりも詳しい情報については、Default Policy File API および Default Configuration File API をお読みください。

認証プロバイダー

login.configuration.provider=[class]

Configuration

以下に例を示します。

  login.configuration.provider=com.foo.Config

login.configuration.provider

com.ibm.security.auth.login.ConfigFile

Configuration

AuthPermission("getLoginConfiguration")

構成プロバイダーをコマンド行で動的に設定する方法はありません。

認証構成ファイル

login.config.url.n=[URL]

policy.allowSystemProperty

java.security.auth.login.config

  ... -Djava.security.auth.login.config=c:¥config_policy¥login.config ...
  または
  ... -Djava.security.auth.login.config=file:c:/config_policy/login.config ...

構成ファイルが静的または動的に見つからない場合、JAAS は構成ファイルを次のデフォルト位置からロードしようとします。

${user.home}¥.java.login.config

権限プロバイダー

auth.policy.provider=[class]

Policy

以下に例を示します。

  auth.policy.provider=com.foo.Policy

auth.policy.provider

com.ibm.security.auth.PolicyFile

Configuration

AuthPermission("getPolicy")

権限プロバイダーをコマンド行で動的に設定する方法はありません。

権限ポリシー・ファイル

auth.policy.url.n=[URL]

policy.allowSystemProperty

java.security.auth.policy

  ... -Djava.security.auth.policy=c:¥auth_policy¥java.auth.policy ...
  または
  ... -Djava.security.auth.policy=file:c:/auth_policy/java.auth.policy ...

権限ポリシーのロード元にするデフォルト位置はありません。

"Hello World"、JAAS スタイル!

黒っぽいサングラスをかけ、お気に入りのフェドーラ帽をかぶり、手にはアルト・サックスを取り ... JAAS-y を始めるときが来ました! これがもう一つの "Hello World!" プログラムです。 このセクションでは、JAAS インストールをテストするためのプログラムを使用可能にします。

インストール: JAAS がインストールされていることが想定されています。 たとえば、JAAS JAR ファイルがご使用の Development Kit の extensions ディレクトリーにコピーされています。

ファイルの取得: HelloWorld.tar をご使用のテスト・ディレクトリーにダウンロードします。 "jar xvf HelloWorld.tar" を使用して、それを解凍します。

テスト・ディレクトリーの内容を検査します。

• HWLoginModule.java
• HWPrincipal.java
• HelloWorld.java

• ソース・ファイルは、classes ディレクトリーにプリコンパイルされています。

• jaas.config
• java2.policy
• jaas.policy

ソース・ファイルのコンパイル: 3 つのソース・ファイル、HWLoginModule.java、HWPrincipal.java、および HelloWorld.java はすでにコンパイルされているため、コンパイルする必要はありません。

ソース・ファイルが変更される場合、それらが保管されているテスト・ディレクトリーに変更して、次のように入力します。

javac -d .¥classes *.java

注:

HWLoginModule

HWPrincipal

com.ibm.security

ポリシー・ファイルの調査: 構成ファイル jaas.config には次の 1 つの項目が含まれています。

helloWorld {
   com.ibm.security.HWLoginModule required debug=true;
};

LoginModule

LoginModuleControlFlag

HWLoginModule

Java 2 ポリシー・ファイル、java2.policy には、1 つの許可ブロックが含まれています。

grant {
   permission javax.security.auth.AuthPermission "createLoginContext";
   permission javax.security.auth.AuthPermission "modifyPrincipals";
   permission javax.security.auth.AuthPermission "doAsPrivileged";
};

Subject

Subject

JAAS ポリシー・ファイル jaas.policy にも、1 つの許可ブロックが含まれています。

grant Principal com.ibm.security.HWPrincipal "bob" {
   permission java.util.PropertyPermission "java.home", "read";
   permission java.util.PropertyPermission "user.home", "read";
   permission java.io.FilePermission "foo.txt", "read";
};

HWPrincipal

Subject

Subject.doAsPrivileged(lc.getSubject(), new PrivilegedAction() {
    public Object run() {
        System.out.println("¥nYour java.home property: "
                           +System.getProperty("java.home"));

        System.out.println("¥nYour user.home property: "
                           +System.getProperty("user.home"));

        File f = new File("foo.txt");
        System.out.print("¥nfoo.txt does ");
        if (!f.exists()) System.out.print("not ");
        System.out.println("exist in your current directory");

        System.out.println("¥nOh, by the way ...");

                try {
            Thread.currentThread().sleep(2000);
        } catch (Exception e) {
            // ignore
        }
        System.out.println("¥n¥nHello World!¥n");
        return null;
    }
}, null);

ソース・ファイルの調査:

HWLoginModule

HelloWorld アプリケーションでは、ユーザーは 3 回までパスワードの入力を試みることができます。 Go JAAS が正しく入力されると、ユーザー名と同じ名前を持つ

HWPrincipal

Subject

HWPrincipal

HelloWorld

LoginContext

MyCallbackHandler

    LoginContext lc = null;
    try {
        lc = new LoginContext("helloWorld", new MyCallbackHandler());
    } catch (LoginException le) {
        le.printStackTrace();
        System.exit(-1);
    }

HWLoginModule

HWPrincipal

すでに説明したとおり、以後の作業は、認証されたサブジェクトとして実行されます。

HelloWorld テストの実行

HelloWorld プログラムを実行するには、最初にテスト・ディレクトリーに変更します。 構成およびポリシー・ファイルをロードする必要があります。 正しいプロパティーについてインプリメンテーションを参照して、 java.security かコマンド行のいずれかに設定します。 後者のメソッドについて、これから説明します。

以下のコマンドは、明確にするために複数の行に分割されています。 1 つの連続するコマンドとして入力してください。

java -Djava.security.manager=
     -Djava.security.auth.login.config=.¥jaas.config
     -Djava.security.policy=.¥java2.policy
     -Djava.security.auth.policy=.¥jaas.policy
     HelloWorld

     -Djava.security.auth.login.config=c:¥test¥hello¥jaas.config

SecurityException

HelloWorld を楽しむ

好きなだけ HelloWorld を再実行してください。 入力したユーザー名/パスワードを変え、構成ファイル項目を変更し、ポリシー・ファイル許可を変更し、さらに追加の LoginModules を helloWorld 構成項目に追加する (積み重ねる) ことまで、すでに提案されました。 さらに、codebase フィールドをポリシー・ファイルに追加することができます。

最後に、セキュリティー・マネージャーなしでプログラムを実行して、問題発生時における動作を調べてみてください。

付録 A: java.security セキュリティー・プロパティー・ファイル・ファイルでの JAAS 設定

java.security

lib/security

lib¥security

jdk1.3

• jdk1.3/lib/security/java.security

  (Unix)

• jdk1.3¥lib¥security¥java.security

  (Windows)

java.security

• 認証プロパティー

  • login.configuration.provider

  • login.policy.url.n

• 権限プロパティー

  • auth.policy.provider

  • auth.policy.url.n

新規の JAAS プロパティーは、このファイルの末尾に置かれます。

#
# This is the "master security properties file".
#
# In this file, various security properties are set for use by
# java.security classes. This is where users can statically register
# Cryptography Package Providers ("providers" for short). The term
# "provider" refers to a package or set of packages that supply a
# concrete implementation of a subset of the cryptography aspects of
# the Java Security API. A provider may, for example, implement one or
# more digital signature algorithms or message digest algorithms.
#
# Each provider must implement a subclass of the Provider class.
# To register a provider in this master security properties file,
# specify the Provider subclass name and priority in the format
#
#    security.provider.n=className
#
# This declares a provider, and specifies its preference
# order n. The preference order is the order in which providers are
# searched for requested algorithms (when no specific provider is
# requested). The order is 1-based; 1 is the most preferred, followed
# by 2, and so on.
#
# className must specify the subclass of the Provider class whose
# constructor sets the values of various properties that are required
# for the Java Security API to look up the algorithms or other
# facilities implemented by the provider.
#
# There must be at least one provider specification in java.security.
# There is a default provider that comes standard with the JDK. It
# is called the "SUN" provider, and its Provider subclass
# named Sun appears in the sun.security.provider package. Thus, the
# "SUN" provider is registered via the following:
#
#    security.provider.1=sun.security.provider.Sun
#
# (The number 1 is used for the default provider.)
#
# Note: Statically registered Provider subclasses are instantiated
# when the system is initialized. Providers can be dynamically
# registered instead by calls to either the addProvider or
# insertProviderAt method in the Security class.

#
# List of providers and their preference orders (see above):
#
security.provider.1=sun.security.provider.Sun

#
# Class to instantiate as the system Policy. This is the name of the class
# that will be used as the Policy object.
#
policy.provider=sun.security.provider.PolicyFile 
# The default is to have a single system-wide policy file,
# and a policy file in the user's home directory.
policy.url.1=file:${java.home}/lib/security/java.policy
policy.url.2=file:${user.home}/.java.policy

# whether or not we expand properties in the policy file
# if this is set to false, properties (${...}) will not be expanded in policy
# files.
policy.expandProperties=true

# whether or not we allow an extra policy to be passed on the command line
# with -Djava.security.policy=somefile. Comment out this line to disable
# this feature.
policy.allowSystemProperty=true

# whether or not we look into the IdentityScope for trusted Identities
# when encountering a 1.1 signed JAR file. If the identity is found
# and is trusted, we grant it AllPermission.
policy.ignoreIdentityScope=false

#
# Default keystore type.
#
keystore.type=jks

#
# Class to instantiate as the system scope:
#
system.scope=sun.security.provider.IdentityDatabase

##############################################################################
#
# Java Authentication and Authorization Service (JAAS)
# properties and policy files:
#

# Class to instantiate as the system Configuration for authentication.
# This is the name of the class that will be used as the Authentication
# Configuration object.
#
login.configuration.provider=com.ibm.security.auth.login.ConfigFile 
# The default is to have a system-wide login configuration file found in
# the user's home directory.  For multiple files, the format is similar to
# that of CodeSource-base policy files above, that is policy.url.n
login.config.url.1=file:${user.home}/.java.login.config

# Class to instantiate as the system Principal-based Authorization Policy.
# This is the name of the class that will be used as the Authorization
# Policy object.
#
auth.policy.provider=com.ibm.security.auth.PolicyFile
# The default is to have a system-wide Principal-based policy file found in
# the user's home directory.  For multiple files, the format is similar to
# that of CodeSource-base policy files above, that is policy.url.n and
# auth.policy.url.n
auth.policy.url.1=file:${user.home}/.java.auth.policy

付録 B: ログイン構成ファイル

LoginContext

Application {
    LoginModule Flag ModuleOptions;
    > more LoginModule entries <
    LoginModule Flag ModuleOptions;
};

java.security

login.config.url.n

java.security

Flag の値は、認証が回を重ねて進むときの全部的な動作を制御します。 以下は、Flag の有効な値と、それぞれの意味の説明を表しています。

1. Required。

   LoginModule

   は成功する必要があります。 成功しても失敗しても、認証は

   LoginModule

   リストの処理を引き続き先に進めます。
2. Requisite。

   LoginModule

   は成功する必要があります。成功すると、認証は

   LoginModule

   リストの処理を継続します。 失敗すると、制御はただちにアプリケーションに戻ります (認証は

   LoginModule

   リストの処理を先に進めません)。
3. Sufficient。

   LoginModule

   は成功しなくても構いません。成功すると、制御はただちにアプリケーションに戻ります (認証は

   LoginModule

   リストの処理を先に進めません)。 失敗すると、認証は

   LoginModule

   リストの処理を継続します。
4. Optional。

   LoginModule

   は成功しなくても構いません。成功しても失敗しても、認証は

   LoginModule

   リストの処理を引き続き先に進めます。

全体の認証は、すべての Required および Requisite の LoginModules が正常に実行される場合に限り成功します。

LoginModule

LoginModule

LoginModule

サンプル構成ファイル:

/*  Sample Configuration File  */

Login1 {
   com.ibm.security.auth.module.SampleLoginModule required debug=true;
};

Login2 {
   com.ibm.security.auth.module.SampleLoginModule required;
   com.ibm.security.auth.module.NTLoginModule sufficient;
   ibm.loginModules.SmartCard requisite debug=true;
   ibm.loginModules.Kerberos optional debug=true;
};

com.ibm.security.auth.module.SampleLoginModule

LoginContext

Login2 は、表を使って説明する方が簡単です。

付録 C: 権限ポリシー・ファイル

上記のプリンシパル・ベースの JAAS ポリシーの grant ブロックの例では十分でない場合、ここにさらに説明があります。

// SAMPLE JAAS POLICY FILE:  java.auth.policy

// The following permissions are granted to Principal 'Pooh' and all codesource:

grant Principal com.ibm.security.Principal "Pooh" {
   permission javax.security.auth.AuthPermission "setPolicy";
   permission java.util.PropertyPermission "java.home", "read";
   permission java.util.PropertyPermission "user.home", "read";
   permission java.io.FilePermission "c:/foo/jaas.txt", "read";
};

// The following permissions are granted to Principal 'Pooh' AND 'Eyeore'
// and CodeSource signedBy "DrSecure":

grant signedBy "DrSecure"
      Principal com.ibm.security.Principal "Pooh",
      Principal com.ibm.security.Principal "Eyeore" {
   permission javax.security.auth.AuthPermission "modifyPublicCredentials";
   permission javax.security.auth.AuthPermission "modifyPrivateCredentials";
   permission java.net.SocketPermission "us.ibm.com", "connect,accept,resolve";
   permission java.net.SocketPermission "griffin.ibm.com", "accept";
};

// The following permissions are granted to Principal 'Pooh' AND 'Eyeore' AND
// 'Piglet' and CodeSource from the c:¥jaas directory signed by "kent" and "bruce":

grant codeBase "file:c:/jaas/*",
      signedBy "kent, bruce",
      Principal com.ibm.security.Principal "Pooh",
      Principal com.ibm.security.Principal "Eyeore",
      Principal com.ibm.security.Principal "Piglet"  {
   permission javax.security.auth.AuthPermission "getSubject";
   permission java.security.SecurityPermission "printIdentity";
   permission java.net.SocketPermission "guapo.ibm.com", "accept";
};