帆软用户密码加密

向右看齐 2021-12-21 05:34 1051阅读 0赞

简单权限之密码加密-
    https://help.finereport.com/doc-view-875.html

## 1. 问题描述 ##

在平台内置进行 [用户身份验证][Link 1] 的时候，密码存在数据库(FineReport 内置数据库 FineDB 或者其他数据库)中，认证时用户输入的密码与数据库中密码相同则认证通过，若数据库被破解了则对系统造成威胁，怎样保证系统安全呢？

## 2. 解决方案 ##

在进行 [手动添加用户][Link 2] 的时候，使用密码加密功能。数据库中存的是密文，输入的密码需要进行加密才能和数据库中的密文进行匹配，加大破解难度，提高系统安全性。

## 3. 实现原理 ##

### 3.1 设置方法 ###

登录平台，点击管理系统>用户管理>设置开启同步数据集的时候，设置加密方式，如下图：

![1534908440oKjgRIGA.png][]

### 3.2 密码加密方式分类 ###

密码加密功能分为：内置 SHA 加密、自定义密码加密。

*  内置 SHA 加密：加密方式已经封装了；
 *  自定义密码加密：需要将自定义的密码验证类（包含了加密方法）放在报表服务器如/webapps/webroot/WEB-INF/classes下，勾选自定义密码加密，并指向自定义的密码验证类。

### 3.3 原理 ###

若设置了加密规则，encodePassword 方法中会先对用户输入密码进行加密转换，再与数据库密码匹配。

*  **内置 SHA 加密**：用户输入的密码默认经过SHA加密，再和数据库中的密码进行匹配;
 *  自定义密码加密：用户输入的“密码”或“用户名和密码”经过自定义加密规则进行加密，再和数据库中的信息进行匹配，支持 2 个接口实现方法，如下：

1）只需要对密码进行加密得到密文：String encode(String originText);//入参是明文密码，对密码进行加密得到密文

2）对用户名和密码进行加密得到密文：String encode(String originUserName, String originPassword);//入参是用户名和明文密码，返回结果是密文字符

注：其中 String encode(String originUserName, String originPassword);加密方式为 2019.1.18 新增的接口，包含接口1的功能，推荐使用此接口。

## 4. 自定义密码加密示例 ##

下面我们制作三个简单的自定义密码加密示例：实现自定义密码 BASE64 加密、SHA256、MD5 加密。

### 4.1 BASE64 加密方式 ###

1）自定义密码验证类

定义一个类，命名为 Base64PasswordValidator.java，扩展于 AbstractPasswordValidator，详细的代码参见：

[https://git.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/decision/privilege/encrpt/Base64PasswordValidator.java][https_git.fanruan.com_demo_example_src_release_10.0_src_main_java_com_fr_decision_privilege_encrpt_Base64PasswordValidator.java]

编译获得 [Base64PasswordValidator.class][]，将编译的 Base64PasswordValidator.class 放在/webapps/webroot/WEB-INF/classes/com/fr/decision/privilege/encrpt目录下。

注：这里使用 String encode(String originText);//只对密码进行加密得到密文。

注：需要重启工程。

2）平台设置

在平台的用户同步数据集>加密方式>自定义加密类中选择 BASE64 加密类即可，如下图：

![1536551758qOJPzy1s.png][]

注：这边是举了一个最简单的例子，您可以根据自己的需求自己定义加密的方式。

### 4.2 SHA256 加密方式 ###

1）自定义密码加密类

定义一个类，命名为 CustomSHA256PasswordValidator.java，扩展于 AbstractPasswordValidator，详细的代码参见：

[https://git.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/decision/privilege/encrpt/CustomSHA256PasswordValidator.java][https_git.fanruan.com_demo_example_src_release_10.0_src_main_java_com_fr_decision_privilege_encrpt_CustomSHA256PasswordValidator.java]

同上，编译获得 [CustomSHA256PasswordValidator.class][]

将编译的CustomSHA256PasswordValidator.class放在/webapps/webroot/WEB-INF/classes/com/fr/decision/privilege/encrpt目录下。

注：这里使用 String encode(String originUserName, String originPassword);//对用户名和密码一起进行加密得到密文。

2）平台设置

同 BASE64 加密方式，在平台的用户同步数据集>加密方式>自定义加密类中选择 SHA256 加密类即可。

### 4.3 MD5 加密方式 ###

9.0 及以前的版本，同步数据集中密码可以选择“内置 MD5 加密”，而在 FR10.0 中取消了默认的 MD5 加密。

若用户的工程是 9.0 升级到 10.0 的，而在升级之前用户同步采用的是默认内置 MD5 加密或者用户就想使用 MD5 加密方式，又该如何处理呢？

1）下载 MD5 加密类

现提供现成的 [MD5 加密类][MD5]，点击下载之后，将类放于%FR\_HOME%\\webroot\\WEB-INF\\classes\\com\\fr\\decision目录下

2）平台设置

在平台的用户同步数据集>加密方式>自定义加密类中选择 MD5 加密类即可，如下图：

![1547793728qgCaQD6M.png][]

3）支持用户名加密

若用户需要的是【用户名+密码】的方式进行自定义加密，请使用文件：[decision.zip][]，使用方法同上。

[Link 1]: http://help.finereport.com/doc-view-702.html
[Link 2]: http://help.finereport.com/doc-view-705.html
[1534908440oKjgRIGA.png]: /images/20211220/d079aaf9b56848698cce961c8cd03ddb.png
[https_git.fanruan.com_demo_example_src_release_10.0_src_main_java_com_fr_decision_privilege_encrpt_Base64PasswordValidator.java]: https://git.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/decision/privilege/encrpt/Base64PasswordValidator.java
[Base64PasswordValidator.class]: http://www.finereporthelp.com:8021/download/FR10.0/%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8A%A0%E5%AF%86/Base64PasswordValidator.class
[1536551758qOJPzy1s.png]: /images/20211220/93b47595abfd4df680a1dfc1a8eeaebd.png
[https_git.fanruan.com_demo_example_src_release_10.0_src_main_java_com_fr_decision_privilege_encrpt_CustomSHA256PasswordValidator.java]: https://git.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/decision/privilege/encrpt/CustomSHA256PasswordValidator.java
[CustomSHA256PasswordValidator.class]: http://www.finereporthelp.com:8021/download/FR10.0/%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8A%A0%E5%AF%86/CustomSHA256PasswordValidator.class
[MD5]: http://www.finereporthelp.com:8021/download/FR10.0/%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8A%A0%E5%AF%86/decision-new-password.zip
[1547793728qgCaQD6M.png]: /images/20211220/4c1d85032a8d48949dffe18b34337b51.png
[decision.zip]: http://www.finereporthelp.com:8021/download/FR10.0/%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8A%A0%E5%AF%86/decision.zip