UserDatabaseRealm

UserDatabaseRealm 是 Tomcat Realm 接口的一種實(shí)現(xiàn)，使用 JNDI 資源來存儲(chǔ)用戶信息。默認(rèn)，JNDI 資源是通過一個(gè) XML 文件來提供支持的。它并不是針對大規(guī)模生產(chǎn)環(huán)境用途而設(shè)計(jì)的。在啟動(dòng)時(shí)，UserDatabaseRealm 會(huì)從一個(gè) XML 文檔中加載所有用戶以及他們角色的信息（該 XML 文檔默認(rèn)位于 $CATALINA_BASE/conf/tomcat-users.xml。）用戶、密碼以及相應(yīng)角色通?？衫?/span> JMX 進(jìn)行動(dòng)態(tài)編輯，更改結(jié)果會(huì)加以保存并立刻反映在 XML 文檔中。

Realm 元素屬性

跟之前討論的一樣，為了配置 UserDatabaseRealm，需要在 $CATALINA_BASE/conf/server.xml 中創(chuàng)建  元素。關(guān)于 UserDatabaseRealm 中的屬性定義可參看 Realm 配置文檔。

用戶文件格式

用戶文件使用的格式與 MemoryRealm所使用的相同。

范例

默認(rèn)的 Tomcat 安裝已經(jīng)配置了內(nèi)嵌在  元素中的 UserDatabaseRealm，因而可以將其應(yīng)用于所有的虛擬主機(jī)和 Web 應(yīng)用中。默認(rèn)的 conf/tomcat-users.xml 文件內(nèi)容為：

<tomcat-users>
  <user username="tomcat" password="tomcat" roles="tomcat" />
  <user username="role1"  password="tomcat" roles="role1"  />
  <user username="both"   password="tomcat" roles="tomcat,role1" /></tomcat-users>

特別注意事項(xiàng)

使用 UserDatabaseRealm 需要遵循以下規(guī)則：

• 當(dāng) Tomcat 首次啟動(dòng)時(shí)，它會(huì)從用戶文件中加載所有已定義的用戶及其相關(guān)信息。假如對該用戶文件中的數(shù)據(jù)進(jìn)行修改，則只有重啟 Tomcat 后才能生效。這些修改并不是通過 UserDatabase 數(shù)據(jù)源來完成的，是由 Tomcat 所提供的通過 JMX 訪問的 MBean 來實(shí)現(xiàn)的。
• 當(dāng)用戶首次訪問一個(gè)受保護(hù)資源時(shí)，Tomcat 會(huì)調(diào)用這一 Realm 的 authenticate() 方法。
• 一旦用戶認(rèn)證成功，在登錄后，該用戶（及其相應(yīng)角色）就將緩存在 Tomcat 中。（對于以表單形式的認(rèn)證，這意味著直到會(huì)話超時(shí)或者無效才會(huì)過期；對于基本形式的驗(yàn)證，意味著直到用戶關(guān)閉瀏覽器才會(huì)過期。）在會(huì)話序列化期間不會(huì)保存或重置緩存的用戶。對已認(rèn)證用戶的數(shù)據(jù)庫信息進(jìn)行的任何改動(dòng)都不會(huì)生效，直到該用戶下次登錄。