当初、JavaTM 認証・承認サービス (JavaTM Authentication and Authorization Service： JAAS) は、JavaTM 2 SDK, Standard Edition (J2SDK), v 1.3 のオプションパッケージでした。JAAS は、J2SDK 1.4 より Java TM Standard Edition Development Kit に統合されています。
JAAS は、次の 2 つの目的で使用できます。
このセクションでは、認証コンポーネントの基本的なチュートリアルを提供します。承認コンポーネントについては、「JAAS 承認」チュートリアルで説明します。
JAAS 認証は、「プラグイン可能」方式で実行されます。つまり、Java アプリケーションは、基盤となる認証技術から独立して機能します。新規または更新された技術を、アプリケーション自体を変更せずに、プラグインとして使用可能です。使用する認証技術の実装は実行時に決定されます。その内容は、ログイン構成ファイルに指定します。このチュートリアルで使用する認証技術は、ユーザーが特定の名前とパスワードを指定しているかどうかを確認するだけの非常に基本的なものです。
このチュートリアルは、次のセクションで構成されます。
チュートリアルのコードを最初に実行してみる場合は、「コードの実行」を先に読んでから、最初に戻り、コードの記述および構成ファイルの詳細について学習してください。
認証チュートリアルコード
このチュートリアルのコードは、3 つのファイルで構成されます。
- SampleAcn.java。サンプルアプリケーションクラス (SampleAcn) とユーザー入力の処理に使用されるクラス (MyCallbackHandler) が含まれています。このチュートリアルでは、このファイル内のコードを理解するだけで十分です。その他のソースファイルは、アプリケーションによって間接的に使用されます。
- SampleLoginModule.java は、チュートリアルのログイン構成ファイル によって、基盤となる適切な認証を実装するクラスとして指定されます。SampleLoginModule のユーザー認証は、ユーザーによって指定された名前とパスワードが特定の値を持っていることを検証する処理である
- SamplePrincipal.javaは、
java.security.Principalインタフェースを実装するサンプルクラスです。SampleLoginModule によって使用されるSampleAcn.java
認証チュートリアルのアプリケーションコードは、単一のソースファイル SampleAcn.java に含まれています。このファイルには次の 2 つのクラスが含まれています。
SampleAcn クラス
SampleAcn クラスのmainメソッドは、認証の実行後に、認証が成功したかどうかをレポートします。ユーザーの認証用コードは、非常に簡潔です。次の 2 つのステップで構成されています。
最初に基本的なコードを紹介します。続いて、必要な import 文およびエラー処理を含む
SampleAcn.javaソースファイルの 完全なコードを示します。LoginContext のインスタンス化
ユーザーの認証には、まず
javax.security.auth.login.LoginContextが必要です。次に、LoginContext をインスタンス化する基本的な方法を示します。次に、このチュートリアルコードによるインスタンス化の実行方法を具体的に示します。import javax.security.auth.login.*; . . . LoginContext lc = new LoginContext(<config file entry name>, <CallbackHandler to be used for user interaction>);import javax.security.auth.login.*; . . . LoginContext lc = new LoginContext("Sample", new MyCallbackHandler());引数について、次に説明します。
- JAAS ログイン構成ファイルのエントリ名
これは、LoginContext が、JAAS ログイン構成ファイル内でこのアプリケーションのエントリ検索に使用する名前です。詳細は、ここを参照してください。このようなエントリは、基盤となる適切な認証技術を実装するクラスを指定します。クラスは、
javax.security.auth.spiパッケージ内の LoginModule インタフェースを実装する必要があります。このサンプルコードでは、このチュートリアルに付属している
SampleLoginModuleを使用します。SampleLoginModule は、ユーザーが特定の名前およびパスワードを入力したかどうかを確認することによって認証を実行します。このチュートリアルで使用するログイン構成ファイル (sample_jaas.config) のエントリは、"Sample" という名前です。LoginContext コンストラクタの最初の引数には、この名前を指定してください。
- CallbackHandler のインスタンス
LoginModule がユーザーと通信する必要がある場合 (たとえばユーザー名やパスワードの入力を求める場合)、通信は直接には行われません。このため、ユーザーとのさまざまな通信方法が存在します。実際のところ、ログインモジュールがユーザーと通信する際、特定の方法に依存しないようにするのは、望ましい方法です。LoginModule は、
javax.security.auth.callback.CallbackHandlerを呼び出してユーザーと通信し、ユーザー名、パスワードをはじめとする要求された情報を取得します。使用する CallbackHandler のインスタンスを、LoginContext コンストラクタの 2 番目の引数として指定します。LoginContext は、このインスタンスを基盤となるログインモジュール (ここでは SampleLoginModule) に転送します。通常、アプリケーションは、固有の CallbackHandler 実装を提供します。
com.sun.security.auth.callbackパッケージには、サンプル実装として 2 つの単純な CallbackHandler (TextCallbackHandler と DialogCallbackHandler) を提供します。このチュートリアルでは、コマンド行に情報を出力し、コマンド行から入力を読み取る TextCallbackHandler を使用できます。ただし、実際に紹介するのは、固有の CallbackHandler 実装を提供するアプリケーションの典型例です (「MyCallbackHandler クラス」を参照)。LoginContext の
loginメソッドの呼び出しこれで LoginContext
lcを保持できたので、loginメソッドを呼び出して認証処理を実行します。lc.login();LoginContext は、新しい空の
javax.security.auth.Subjectオブジェクト (認証されるユーザーまたはサービス) をインスタンス化します。また、構成済みのログインモジュール (この例の場合は SampleLoginModule) を構築し、この新しいサブジェクトと MyCallbackHandler を使ってインスタンス化します。次に、LoginContext の
loginメソッドによって SampleLoginModule 内のメソッドが呼び出され、ログインおよび認証が実行されます。SampleLoginModule は、MyCallbackHandler を使ってユーザー名とパスワードを取得します。次に、名前とパスワードが適切であるかどうかをチェックします。認証に成功した場合、SampleLoginModule は、ユーザーを表すプリンシパルをサブジェクトに追加します。SampleLoginModule によってサブジェクトに追加されるプリンシパルは、SamplePrincipal ( java.security.Principal インタフェースを実装するクラス) のインスタンスです。
これらの用語の詳細は、「サブジェクト、プリンシパル、認証、およびクレデンシャル」を参照してください。
その後、呼び出し側アプリケーションは、LoginContext の
getSubjectメソッドを呼び出し (このステップは、このチュートリアルではオプション)、認証されたサブジェクトを取得します。完全な
SampleAcnクラスのコードここまでで、ユーザーの認証に必要な基本コードを見てきました。ここで、すべてを統合して、関連する import 文およびエラー処理を含む完全なクラスを SampleAcn.java 内に作成できます。
package sample; import javax.security.auth.login.*; // . . . other import statements needed by MyCallbackHandler . . . /** * This Sample application attempts to authenticate a user * and reports whether or not the authentication was * successful. */ public class SampleAcn { /** * Attempt to authenticate the user. * * @param args input arguments for this application. * These are ignored. */ public static void main(String[] args) { // Obtain a LoginContext, needed for authentication. // Tell it to use the LoginModule implementation // specified by the entry named "Sample" in the // JAAS login configuration file and to also use the // specified CallbackHandler. LoginContext lc = null; try { lc = new LoginContext("Sample", new MyCallbackHandler()); } catch (LoginException le) { System.err.println("Cannot create LoginContext. " + le.getMessage()); System.exit(-1); } catch (SecurityException se) { System.err.println("Cannot create LoginContext. " + se.getMessage()); System.exit(-1); } // the user has 3 attempts to authenticate successfully int i; for (i = 0; i < 3; i++) { try { // attempt authentication lc.login(); // if we return with no exception, // authentication succeeded break; } catch (LoginException le) { System.err.println("Authentication failed:"); System.err.println(" " + le.getMessage()); try { Thread.currentThread().sleep(3000); } catch (Exception e) { // ignore } } } // did they fail three times? if (i == 3) { System.out.println("Sorry"); System.exit(-1); } System.out.println("Authentication succeeded!"); } }MyCallbackHandler クラス
ログインモジュールがユーザーと通信を行なって、認証情報を取得することが必要な場合があります。LoginModule は、
javax.security.auth.callback.CallbackHandlerを使用してこれを実行します。アプリケーションは、com.sun.security.auth.callbackパッケージ内のサンプル実装を作成できます。独自の CallbackHandler 実装を作成することもできます。アプリケーションは、LoginContext のインスタンス化の引数として CallbackHandler を渡します。LoginContext は、この CallbackHandler を基盤となるログインモジュールに直接転送します。このチュートリアルのサンプルコードでは、独自の CallbackHandler 実装 (SampleAcn.java 内の MyCallbackHandler クラス) を使用します。
CallbackHandler は、1 つのメソッドを実装するインタフェースです。
void handle(Callback[] callbacks) throws java.io.IOException, UnsupportedCallbackException;LoginModule は、CallbackHandler の handle メソッドに適切な
javax.security.auth.callback.Callbackの配列 (ユーザー名の場合 NameCallback、パスワードの場合 PasswordCallback) を渡します。CallbackHandler は、要求に従ってユーザーと通信し、Callback 内に適切な値を設定します。MyCallbackHandler の
handleメソッドの構築方法は次のとおりです。public void handle(Callback[] callbacks) throws IOException, UnsupportedCallbackException { for (int i = 0; i < callbacks.length; i++) { if (callbacks[i] instanceof TextOutputCallback) { // display a message according to a specified type . . . } else if (callbacks[i] instanceof NameCallback) { // prompt the user for a username . . . } else if (callbacks[i] instanceof PasswordCallback) { // prompt the user for a password . . . } else { throw new UnsupportedCallbackException (callbacks[i], "Unrecognized Callback"); } } }CallbackHandler の
handleメソッドは、特定の型の Callback インスタンス (NameCallback、PasswordCallback など) の配列を受け取ります。このメソッドは、アプリケーションの実行に適した方法でユーザーと通信し、各 Callback を処理します。MyCallbackHandler は、ユーザー名の入力を求める NameCallback、パスワードの入力を求める PasswordCallback、SampleLoginModule からユーザーに送信するメッセージ (エラー、警告など) を報告する TextOutputCallback を処理します。
handleメソッドは、報告するメッセージを抽出し、System.outに出力することにより、TextOutputCallback を処理します。オプションとして、出力の前に用語説明 (メッセージの型によって異なる) を付けることもできます。報告されるメッセージは、TextOutputCallback のgetMessageメソッドを呼び出すことによって決定されます。メッセージの型は、getMessageTypeメソッドを呼び出すことによって決定されます。以下は、TextOutputCallback を処理するコードです。if (callbacks[i] instanceof TextOutputCallback) { // display the message according to the specified type TextOutputCallback toc = (TextOutputCallback)callbacks[i]; switch (toc.getMessageType()) { case TextOutputCallback.INFORMATION: System.out.println(toc.getMessage()); break; case TextOutputCallback.ERROR: System.out.println("ERROR: " + toc.getMessage()); break; case TextOutputCallback.WARNING: System.out.println("WARNING: " + toc.getMessage()); break; default: throw new IOException("Unsupported message type: " + toc.getMessageType()); }
handleメソッドは、ユーザーにユーザー名の入力を求めることによって NameCallback を処理します。まず、System.errにプロンプトを出力します。次に、NameCallback のsetNameメソッドを呼び出し、ユーザーによって入力された名前を渡すことにより、SampleLoginModule によって使用される名前を設定します。} else if (callbacks[i] instanceof NameCallback) { // prompt the user for a username NameCallback nc = (NameCallback)callbacks[i]; System.err.print(nc.getPrompt()); System.err.flush(); nc.setName((new BufferedReader (new InputStreamReader(System.in))).readLine());PasswordCallback を処理するときも、
System.errにパスワードの入力を求めるプロンプトを出力します。次に、PasswordCallback のsetPasswordメソッドを呼び出し、ユーザーによって入力されたパスワード (以下のreadPasswordメソッドを呼び出して読み取る) を渡すことにより、パスワードを設定します。} else if (callbacks[i] instanceof PasswordCallback) { // prompt the user for sensitive information PasswordCallback pc = (PasswordCallback)callbacks[i]; System.err.print(pc.getPrompt()); System.err.flush(); pc.setPassword(readPassword(System.in));
readPasswordメソッドは、InputStream からパスワードを読み取る基本的なメソッドです。private char[] readPassword(InputStream in) throws IOException { char[] lineBuffer; char[] buf; int i; buf = lineBuffer = new char[128]; int room = buf.length; int offset = 0; int c; loop: while (true) { switch (c = in.read()) { case -1: case '\n': break loop; case '\r': int c2 = in.read(); if ((c2 != '\n') && (c2 != -1)) { if (!(in instanceof PushbackInputStream)) { in = new PushbackInputStream(in); } ((PushbackInputStream)in).unread(c2); } else break loop; default: if (--room < 0) { buf = new char[offset + 128]; room = buf.length - offset - 1; System.arraycopy(lineBuffer, 0, buf, 0, offset); Arrays.fill(lineBuffer, ' '); lineBuffer = buf; } buf[offset++] = (char) c; break; } } if (offset == 0) { return null; } char[] ret = new char[offset]; System.arraycopy(buf, 0, ret, 0, offset); Arrays.fill(buf, ' '); return ret; } }SampleLoginModule.java と SamplePrincipal.java
SampleLoginModule.java は
LoginModuleインタフェースを実装します。SampleLoginModule はチュートリアルのログイン構成ファイルにより、基盤となる適切な認証を実装するクラスとして指定されます。SampleLoginModule のユーザー認証は、ユーザーによって指定された名前とパスワードが特定の値を持っていることを検証する処理であるこの SampleLoginModule は、チュートリアルのログイン構成ファイルにより、LoginModule として指定されます。これは、(1) あらゆる環境に適切な基本的な認証を実行し、すべてのユーザーのチュートリアルで使用できる (2) 認証技術を実装するログインモジュールを記述する必要がある上級プログラマ向けのログインモジュールの実装例を提供できるからです。SamplePrincipal.javaは、
java.security.Principalインタフェースを実装するサンプルクラスです。認証に成功した場合、SampleLoginModule は、ユーザーを表す SamplePrincipal をサブジェクトに追加します。重要: アプリケーションの作成者は、ログインモジュールやプリンシパル実装の記述方法を理解していなくてもかまいません。SampleLoginModule や SamplePrincipal のコードを確認する必要はありません。アプリケーションを作成し、構成情報 (ログイン構成ファイルの情報など) を指定し、アプリケーションが構成によって指定されたログインモジュールを利用してユーザーを認証できるようにするだけで十分です。使用するログインモジュールを決定し、ログインモジュールのドキュメントからログインモジュールの動作を制御するために (構成内に) 指定できる値を確認してください。
どのベンダーの提供するログインモジュール実装でも使用可能です。「JAAS ログイン構成ファイル」ドキュメントに記載されているように、いくつかの実装が Sun Microsystems の JRE に同梱されています。
LoginModule を記述する必要があるプログラマ向けの情報は、「JAAS
LoginModule開発者ガイド」で確認できます。
JAAS 認証はプラグイン可能な形式で実行されるため、アプリケーションは、基盤となる認証技術から独立した状態を維持できます。システム管理者は、各アプリケーションで使用する認証技術 (ログインモジュール) を決定し、ログイン構成内に構成します。構成情報のソース (ファイルやデータベース) は、現在の javax.security.auth.login.Configuration 実装によって異なります。Sun Microsystems のデフォルトの
Configuration実装は、 com.sun.security.auth.login.ConfigFile.html で説明するように、構成ファイルから構成情報を読み取ります。ログイン構成ファイルとその内容、およびログイン構成ファイルの指定方法については、「JAAS ログイン構成ファイル」を参照してください。
このチュートリアルのログイン構成ファイル
すでに説明したように、このチュートリアルで使用するログイン構成ファイル sample_jaas.config には、次のエントリのみが含まれます。
Sample { sample.module.SampleLoginModule required debug=true; };このエントリの名前は「Sample」です。チュートリアルアプリケーション
SampleAcnがエントリを参照するときに、この名前を使用します。このエントリは、ユーザー認証に使用するログインモジュールがsample.moduleパッケージ内の SampleLoginModule であること、認証が成功したと見なされるためにはこの SampleLoginModule が「成功する」必要があることを示します。SampleLoginModule は、ユーザーから提供された名前とパスワードが正しい (testUser と testPassword である) 場合にかぎり成功します。SampleLoginModule はデバッグオプションも定義します (
trueに設定可能)。このオプションの値をtrueに設定すると、SampleLoginModule により、認証の進捗に関する追加情報が出力されます。LoginModule が定義できるオプションの数に制限はありません。LoginModule のドキュメントには、構成ファイル内に設定可能なオプションの名前と値が記載されています。
JAAS 認証チュートリアルコードを実行するには、次の操作を行う必要があります。
- 次のファイルを 1 つのディレクトリ内に格納します。
- sample_jaas.config ログイン構成ファイル
- 最上位ディレクトリの下に sample という名前のサブディレクトリを作成し、ここに以下のファイルを格納します (注:
SampleAcn.java内の SampleAcn および MyCallbackHandler クラスはsampleパッケージ内にある)。
- SampleAcn.java アプリケーションソースファイル
- sample ディレクトリのサブディレクトリを作成し、module という名前を付けます。ここに以下のファイルを格納します (注: SampleLoginModule クラスは
sample.moduleパッケージ内にある)。
- SampleLoginModule.java ソースファイル
- sample ディレクトリのサブディレクトリをもう 1 つ作成し、principal という名前を付けます。ここに以下のファイルを格納します (注: SamplePrincipal クラスは
sample.principalパッケージ内にある)。
- SamplePrincipal.java ソースファイル
- 最上位のディレクトリで、
SampleAcn.java、SampleLoginModule.java、SamplePrincipal.javaをコンパイルします。コマンド全体を 1 行に入力してください。javac sample/SampleAcn.java sample/module/SampleLoginModule.java sample/principal/SamplePrincipal.java
- 以下の内容を指定して、
SampleAcnアプリケーションを実行します。
-Djava.security.auth.login.config==sample_jaas.config。使用するログイン構成ファイルとして、sample_jaas.configを指定します。次に、完全なコマンドを示します。
java -Djava.security.auth.login.config==sample_jaas.config sample.SampleAcnユーザー名とパスワードの入力を求めるプロンプトが表示されます。入力後、ログイン構成ファイルに指定された SampleLoginModule により、その内容の確認が行われます。SampleLoginModule は、ユーザー名 testUser とパスワード testPassword を適切な値として認識します。
debugオプション (ログイン構成ファイル内でtrueに設定) の結果として、SampleLoginModule によりメッセージが出力されます。ログインに成功すると、SampleAcn により、次のメッセージが表示されます。ログインに失敗した場合 (パスワードのスペルミスなどにより)、次のメッセージが表示されます。Authentication succeeded!この後に、失敗の原因が示されます。たとえば、パスワードのスペルミスがあった場合、次のようなメッセージが表示されます。Authentication failed:Authentication failed: Password Incorrectログインの最大試行回数は 3 回です。
セキュリティーマネージャーがインストールされた環境で Java プログラムを実行する場合、有効なセキュリティーポリシーによりアクセス権が明示的に付与されているのでないかぎり、リソースへのアクセスやセキュリティー関連操作の実行は許可されません。J2SE v 1.2 以降と互換性のある Java プラットフォームでは、アクセス権の付与をポリシーファイル内のエントリに指定する必要があります。
大半のブラウザはセキュリティーマネージャーをインストールします。このため、一般に「アプレット」は、セキュリティーマネージャーに監視されながら実行されます。一方、「アプリケーション」ではそのようなことはありません。これは、アプリケーションの実行時には、セキュリティーマネージャーは自動的にインストールされないためです。このため、
SampleAcnなどのアプリケーションでは、デフォルトでリソースへのフルアクセスが可能です。セキュリティーマネージャーを使用してアプリケーションを実行するには、コマンド行に
-Djava.security.manager引数を含めてインタプリタを呼び出すだけです。ポリシーファイルは指定せずに、セキュリティーマネージャーを使用して
SampleAcnを呼び出そうすると (必要なアクセス権またはAllPermissionを付与するデフォルトポリシー設定を他の場所で保持しない限り)、以下のメッセージが表示されます。% java -Djava.security.manager \ -Djava.security.auth.login.config==sample_jaas.config sample.SampleAcn Exception in thread "main" java.security.AccessControlException: access denied ( javax.security.auth.AuthPermission createLoginContext.Sample)LoginContext の作成に必要なアクセス権をコードに付与するポリシーファイルが作成および使用されていないため、上に示すように AccessControlException が表示されます。
セキュリティーマネージャーをインストールした環境で
SampleAcnアプリケーションを実行するために必要なすべてのステップを、次に示します。「コードの実行」で説明した手順を実行済みの場合は、最初の 5 つのステップを省略できます。
- 次のファイルを 1 つのディレクトリ内に格納します。
- sample_jaas.config ログイン構成ファイル
- 最上位ディレクトリの下に sample という名前のサブディレクトリを作成し、ここに以下のファイルを格納します (注:
SampleAcn.java内の SampleAcn および MyCallbackHandler クラスはsampleパッケージ内にある)。
- SampleAcn.java アプリケーションソースファイル
- sample ディレクトリのサブディレクトリを作成し、module という名前を付けます。ここに以下のファイルを格納します (注: SampleLoginModule クラスは
sample.moduleパッケージ内にある)。
- SampleLoginModule.java ソースファイル
- sample ディレクトリのサブディレクトリをもう 1 つ作成し、principal という名前を付けます。ここに以下のファイルを格納します (注: SamplePrincipal クラスは
sample.principalパッケージ内にある)。
- SamplePrincipal.java ソースファイル
- 最上位のディレクトリで、
SampleAcn.java、SampleLoginModule.java、SamplePrincipal.javaをコンパイルします。コマンド全体を 1 行に入力してください。javac sample/SampleAcn.java sample/module/SampleLoginModule.java sample/principal/SamplePrincipal.java
SampleAcn.classおよびMyCallbackHandler.classを含む JAR ファイルを作成します。jar -cvf SampleAcn.jar sample/SampleAcn.class sample/MyCallbackHandler.classコマンド全体を 1 行に入力してください。このコマンドにより、JAR ファイル
SampleAcn.jarが作成され、その内部にSampleAcn.classとMyCallbackHandler.classが格納されます。
SampleLoginModule.classとSamplePrincipal.classを含む JAR ファイルを作成します。jar -cvf SampleLM.jar sample/module/SampleLoginModule.class sample/principal/SamplePrincipal.class
- 適切なアクセス権を付与するポリシーファイルを作成します。
LoginContext のインスタンス化を実行するコードに必要なアクセス権は、ターゲットを "createLoginContext.<entry name>" とする
javax.security.auth.AuthPermissionです。ここで、<entry name> は、アプリケーションが LoginContext のインスタンス化で参照する、ログイン構成ファイルのエントリ名です。コード内に示されているように、SampleAcnアプリケーションが LoginContext のインスタンス化で使用する名前は、"Sample" です。LoginContext lc = new LoginContext("Sample", new MyCallbackHandler());このため、以下のアクセス権を
SampleAcn.jarに付与する必要があります。permission javax.security.auth.AuthPermission "createLoginContext.Sample";
SampleLM.jarファイルにもアクセス権を付与する必要があります。どのようなアクセス権を付与する必要があるかについては、ログインモジュールのドキュメントを参照してください。SampleLoginModule の場合、サブジェクトにプリンシパルを追加するには、modifyPrincipals をターゲットとするjavax.security.auth.AuthPermissionが必要です。permission javax.security.auth.AuthPermission "modifyPrincipals";ポリシーファイル sampleacn.policy を、
SampleAcn.javaなどの格納先ディレクトリにコピーします。これは、次のgrant文を含むポリシーファイルで、SampleAcn.jar(現在のディレクトリ内) に必要なアクセス権を付与します。grant codebase "file:./SampleAcn.jar" { permission javax.security.auth.AuthPermission "createLoginContext.Sample"; };ポリシーファイルには、
SampleLM.jar(カレントディレクトリにもある) に適切なアクセス権を付与する次のようなgrant文が含まれています。grant codebase "file:./SampleAcn.jar" { permission javax.security.auth.AuthPermission "modifyPrincipals"; };注: ポリシーファイルおよびその内部のエントリ構造の詳細は、 「デフォルトの Policy の実装とポリシーファイルの構文」を参照してください。アクセス権の詳細は、ここを参照してください。
- 以下の内容を指定して、
SampleAcnアプリケーションを実行します。
- 適切な
-classpath節 (SampleAcn.jarおよびSampleLM.jarJAR ファイル内でクラスを検索するため)
-Djava.security.manager。セキュリティーマネージャーのインストールを指定します。
- 使用するポリシーファイルとして
sampleacn.policyを指定する-Djava.security.policy==sampleacn.policy
-Djava.security.auth.login.config==sample_jaas.config。使用するログイン構成ファイルとして、sample_jaas.configを指定します。次に、Microsoft Windows および Unix システムの両方で使用可能なすべてのコマンドを示します。classpath 項目の区切りとして、UNIX システムでは コロンを使用するのに対し、Microsoft Windows システムではセミコロンを使用する点だけが異なります。
次に Microsoft Windows システムの全コマンドを示します。
java -classpath SampleAcn.jar;SampleLM.jar -Djava.security.manager -Djava.security.policy==sampleacn.policy \ -Djava.security.auth.login.config==sample_jaas.config \ sample.SampleAcn次に UNIX システムの全コマンドを示します。
java -classpath SampleAcn.jar:SampleLM.jar -Djava.security.manager -Djava.security.policy==sampleacn.policy \ -Djava.security.auth.login.config==sample_jaas.config \ sample.SampleAcnコマンド全体は、1 行で入力してください。ここでは、読みやすくするために複数行に分けて表示してあります。コマンドが長すぎる場合は、.bat ファイル (Microsoft Windows) または .sh ファイル (UNIX) に記述します。 このファイルを実行することで、コマンドを実行できます。
指定されたポリシーファイルには、コードに適切なアクセス権を付与するエントリが含まれています。このため、実行は、適切なアクセス権が付与されていないことを示す例外をスローすることなく続行されます。要求に応じてユーザー名 (testUser) とパスワード (testPassword) を入力すると、ログイン構成ファイルに指定された SampleLoginModule により、入力された名前とパスワードのチェックが行われます。ログインに成功すると「Authentication succeeded!」というメッセージが、失敗すると「Authentication failed.」というメッセージが表示されます。この後に、失敗の原因が示されます。