在Openfire中使用自己的数据表之修改配置文件

时间：2021-12-26 00:56:52

　　目前我使用的Openfire版本是3.10.3，以下使用说明也是在这个版本上做的修改。

　　Openfire提供了两种方式使用用户数据表。一种是安装完成之后默认实现的org.jivesoftware.openfire.user.DefaultUserProvider，一种是org.jivesoftware.openfire.user.JDBCUserProvider，同样对于用户验证也提供了默认实现的org.jivesoftware.openfire.auth.DefaultAuthProvider，一种是org.jivesoftware.openfire.auth.JDBCAuthProvider。前者都是基于安装时候填的数据库表上建立用户表的。如果要想使用自己的用户表或者基于现有的用户表，则需要使用后者。

　　使用自定义的用户表方法有两种，一种是修改配置文件，一种是登录系统修改系统属性。

　　修改配置文件

　　打开Openfire的安装目录，找到conf/openfire.xml配置文件，这个是Openfire加载系统属性的文件，加入以下配置即可修改一些系统属性。

  • 增加管理员

　　Openfire默认的登录管理员名称是admin，这里可以进行修改。

 <admin>

         <authorizedUsernames>joe, jane</authorizedUsernames>

 </admin>

以上定义有两个用户名为joe和jane的用户可以登录管理控制台。

  • 　使用自定义的数据库连接
 <jdbcProvider>

     <driver>com.mysql.jdbc.Driver</driver>

     <connectionString>jdbc:mysql://localhost/dbname?user=username&amp;password=secret</connectionString>

  </jdbcProvider>
  • 自定义认证集成，openfire中默认使用的是md5加密密码的。
 <provider>

     <auth>

       <className>org.jivesoftware.openfire.auth.JDBCAuthProvider</className>

     </auth>

   </provider>

   <jdbcAuthProvider>

      <passwordSQL>SELECT password FROM user_account WHERE username=?</passwordSQL>

      <passwordType>plain</passwordType>

 </jdbcAuthProvider>

这里需要说明className是不能更改的字符串，passwordSQL是查询数据表的sql语句，passwordType是密码的加密方式，有plain、md5、sha1、sha256、sha512等几种字符串可填入。

  • 用户数据集成，官方说明，如果使用了用户数据集成，那么就必须使用认证集成。示例如下：
 <provider>

     <auth>

       <className>org.jivesoftware.openfire.auth.JDBCAuthProvider</className>

     </auth>

     <user>

       <className>org.jivesoftware.openfire.user.JDBCUserProvider</className>

     </user>

   </provider>

   <jdbcAuthProvider>

      <passwordSQL>SELECT password FROM user_account WHERE username=?</passwordSQL>

      <passwordType>plain</passwordType>

   </jdbcAuthProvider>

   <jdbcUserProvider>

      <loadUserSQL>SELECT name,email FROM myUser WHERE username=?</loadUserSQL>

      <userCountSQL>SELECT COUNT(*) FROM myUser</userCountSQL>

      <allUsersSQL>SELECT username FROM myUser</allUsersSQL>

      <searchSQL>SELECT username FROM myUser WHERE</searchSQL>

      <usernameField>username</usernameField>

      <nameField>name</nameField>

      <emailField>email</emailField>

  </jdbcUserProvider>

　　其中，user和auth里面的className是Openfire内置的类名，不能更改。jdbcUserProvider是Openfire提供的一些获取用户数据的方法。因为用到自己定义的表，所以字段和表名可能不同，所以必须自定义sql。需要定义的方法有

　　a. loadUserSQL ： 根据用户名查询用户信息，包括名称和邮件。语句后有一个“？”，这个问号会被username替换掉。

　　b. userCountSQL: 查询用户总数。

　　c. searchSQL : 查询用户。where后面没有接入任何字符串，jdbcUserProvider会根据填入查询的用户名或者名称邮件等自动加进去查询。如果没有查询条件将不起作用。

　　d. usernameField: 在自定义数据表中username的字段名。用于以上的sql查询。

　　e. nameField: 在自定义数据表中name的字段名。用于以上的sql查询。

　　f. emailField：在自定义数据表中email的字段名。用户以上的sql查询。

　　

  • 　分组集成，如果要使用自己的用户分组，那么也需要加入认证集成，这里认证集成就不再写了，仅展示分组集成配置。
 <provider>

     <group>

   <className>org.jivesoftware.openfire.group.JDBCGroupProvider</className>

     </group>

 </provider>

　　其中group中的className是固定的。

 <jdbcGroupProvider>

        <groupCountSQL>SELECT count(*) FROM myGroups</groupCountSQL>

        <allGroupsSQL>SELECT groupName FROM myGroups</allGroupsSQL>

        <userGroupsSQL>SELECT groupName FROM myGroupUsers WHERE username=?</userGroupsSQL>

        <descriptionSQL>SELECT groupDescription FROM myGroups WHERE groupName=?</descriptionSQL>

        <loadMembersSQL>SELECT username FROM myGroupUsers WHERE groupName=? AND isAdmin='N'</loadMembersSQL>

        <loadAdminsSQL>SELECT username FROM myGroupUsers WHERE groupName=? AND isAdmin='Y'</loadAdminsSQL>

 </jdbcGroupProvider>

以上配置简单说明：

　　a. groupCountSQL: 查询组个数，

　　b. allGroupsSQL: 查询所有的分组。

　　c. userGroupsSQL: 根据用户名查询分组。

　　d. descriptionSQL: 根据组名查询分组描述。

　　e. loadMembersSQL: 根据组名加载分组里面所有的成员。

　　f. loadAdminsSQL: 根据组名查询分组里所有的管理员。

　

相关文章