本節(jié)通過一個簡單的例子介紹JAAS開發(fā)的基本步驟,。本節(jié)中的范例位于Apusic應(yīng)用服務(wù)器安裝目錄中的docs/samples/jaas/simple目錄,。有關(guān)范例的內(nèi)容、編譯,、部署與運行,，可參考docs/samples/jaas/simple目錄下的readme.txt文件。

范例程序的代碼分為兩部分,，一部分為主程序,，執(zhí)行用戶認證過程，源程序如下：

package samples;
import javax.security.auth.Subject;
import javax.security.auth.login.LoginContext;
import javax.security.auth.login.LoginException;
import com.sun.security.auth.callback.TextCallbackHandler;
public class CountFiles {
static LoginContext lc = null;
public static void main(String[] args) {
//使用配置文件中名字為“CountFiles”的條目
try {
lc = new LoginContext("CountFiles",
new TextCallbackHandler());
} catch (LoginException le) {
le.printStackTrace();
System.exit(-1);
}
try {
lc.login();
//如果沒有異常拋出,，則表示認證成功
} catch (Exception e) {
System.out.println("Login failed: " + e);
System.exit(-1);
}
//以認證用戶的身份執(zhí)行代碼
Object o = Subject.doAs(lc.getSubject(), new CountFilesAction());
System.out.println("User " + lc.getSubject( ) + " found " + o + " files.");
System.exit(0);
}
}

可以看出,，主程序包含了三個重要的步驟：首先構(gòu)造一個LoginContext對象,，然后使用這個對象進行登錄，最后,，把用戶作為doAs方法一個參數(shù),。

另一部分表示用戶想要執(zhí)行的具體操作,，源程序如下：

package samples;
import java.io.File;
import java.security.PrivilegedAction;
class CountFilesAction implements PrivilegedAction {
public Object run() {
File f = new File(".");
File[] files = f.listFiles();
return new Integer(files.length);
}
}

JAAS相關(guān)的核心類和接口分為三類,，公共、認證和授權(quán),。

詳細的描述請參考《JAAS Reference Guide》。

JAAS認證被實現(xiàn)為一種可插入的方式,，系統(tǒng)管理員可以通過配置文件為每一個應(yīng)用程序配置LoginModuls來決定應(yīng)用程序使用的認證技術(shù),。配置信息可以保存在文件或數(shù)據(jù)庫中，通過javax.security.auth.login.Configuration對象進行讀取,。javax.security.auth.login.Configuration為抽象類,，JDK提供了可實例化的子類com.sun.security.auth.login.ConfigFile，從文件中讀取配置信息,。配置文件中包含一個或多個條目,，每一個條目指明了特定應(yīng)用程序使用的認證方法。條目的結(jié)構(gòu)如下：

<name used by application to refer to this entry> {
<LoginModule> <flag> <LoginModule options>;
<optional additional LoginModules, flags and options>;
};

可以看出,，每一個條目由名字和一個或多個LoginModule組成,。范例程序使用的配置文件login.conf內(nèi)容如下：

CountFiles {
com.apusic.security.auth.login.ClientPasswordLoginModule required;
};

詳細的描述信息可以參考Configuration。

JAAS授權(quán)擴展了現(xiàn)有的Java安全體系結(jié)構(gòu),，在給代碼授權(quán)時可以包括一個多個Principal域,，指出Principal代表的用戶執(zhí)行特定的代碼時，具有分配的權(quán)限,。因此,，授權(quán)聲明的基本形式為：

grant <signer(s) field>, <codeBase URL>
<Principal field(s)> {
permission perm_class_name "target_name", "action";
....
permission perm_class_name "target_name", "action";
};

缺省的策略文件實現(xiàn)和策略文件語法請參考《Default Policy Implementation and Policy File Syntax》。范例程序使用的策略文件policy.jaas內(nèi)容如下：

grant codeBase "file:./build" {
permission java.security.AllPermission;
};
grant codeBase "file:/${apusic.home}/lib/apusic.jar" {
permission java.security.AllPermission;
};
grant codeBase "file:./build/actions" Principal com.apusic.security.PrincipalImpl "admin" {
permission java.io.FilePermission "<<ALL FILES>>", "read";
};

可以看出,，給主程序和apusic.jar授予了所有權(quán)限,；當執(zhí)行具體操作的用戶為“admin”時，授予了讀取所有文件的權(quán)限,。

范例程序提供了ant的build.xml腳本,，請用戶自己下載并安裝ant,。運行范例程序的步驟為：