反馈已提交

网络繁忙

数字签名认证

  • 文档创建者:文档助手1
  • 历史版本:47
  • 最近更新:Carly 于 2023-07-21
  • 1. 概述

    1.1 版本

    报表服务器版本

    11.0

    1.2 应用场景

    有模板权限的用户复制自己的 模板预览URL 给其他用户,其他用户即使没有该模板的查看权限,也可以通过 URL 查看模板。

    数字签名认证则是即使有模板预览 URL ,没有数字签名就无法查看模板。

    1.3 功能简介

    1)通过数字签名验证签名信息合法后,才允许访问模板,否则返回没有模板访问权限的报错。

    2)访问 模板预览URL 时,需要在 URL 后添加后缀&fine_digital_signature=值

    222

    2. 开启数字签名认证

    2.1 获取 fine_digital_signature 值

    获取对应的数字签名密钥的 fine_digital_signature 值,这里以 GettingStarted.cpt 模板为例。

    1)需要提前准备 Java 环境及 IDE 工具并创建一个 Java 文件,将%FR_HOME%\webapps\webroot\WEB-INF\lib下的多个JAR包导入新建的工程中,如下图所示:

    需要导入的JAR包包括:fine-core-11.0.jar、fine-third-11.0.jar、fine-accumulator-11.0.jar、fine-cbb-11.0.jar

    2)将代码复制到新建的文件中,修改需要进行数字签名的模板并自定义数字签名密钥。如下图所示:

    注:path 的值为模板路径,相对路径,形如doc/xx.cpt;key 的值为数字签名密钥,这两个值会在本文 2.2 节平台设置中用到。

    3.png

    代码如下所示:

    import com.fr.cert.token.JwtBuilder;
    import com.fr.cert.token.Jwts;
    import com.fr.cert.token.SignatureAlgorithm;
    import java.util.Date;
    public class test {
        public static void main(String[] args) {
            //数字签名有效时长(毫秒)
            long validTime = 30 * 60 * 1000L;
            //数字签名内容,以访问资源的相对路径作为内容 
            String path = "GettingStarted.cpt"; //修改为需要进行数字签名认证的模板路径,相对路径,例如doc/xx.cpt
            String key = "123456"; //数字签名密钥,可以自定义
            //生成fine_digital_signature
            String fine_digital_signature = createJwt("", "", path, validTime, key);
            //输出fine_digital_signature
            System.out.println(fine_digital_signature);
        }
        private static String createJwt(String issuer, String id, String subject, long validTime, String key) {
            //用于生成数字签名,即参数fine_digital_signature的值
            SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;
            Date currentTime = new Date();
            Date expirationTime = new Date(currentTime.getTime() + validTime);
            JwtBuilder builder = Jwts.builder()
                    .setIssuer(issuer)
                    .setSubject(subject)
                    .setIssuedAt(currentTime)
                    .setExpiration(expirationTime)
                    .setId(id)
                    .signWith(signatureAlgorithm, key);
            return builder.compact();
        }
    }

    3)运行 test 文件并获得数字签名密钥的fine_digital_signature值,如下图所示:

    4.png

    运行结果的值会在本文 2.3 节效果预览中用到。

    2.2 平台设置

    管理员登录数据决策系统,点击「管理系统>模板认证>数字签名密钥地址」中,输入密钥值,如下图所示:

    12.png

    2.3 效果预览

    直接访问 模板预览URL ,本文示例链接为:http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt,提示没有权限,如下图所示:

    6.png

    在 URL 后面新增参数:&fine_digital_signature=值,「值」为本文 2.1 节运行 Java 文件得到的数据,即可正常查看模板。如下图所示:

    12.gif

    3. 注意事项

    3.1 远程设计预览模板无需验证数字签名

    为了方便制作模板,设计器远程连接开启了数字签名认证的远程服务器,预览模板时无需验证数字签名。

    1)远程设计,通过点击设计器上的预览按钮,预览模板效果时,无需验证数字签名,可直接预览模板。

    2)退出远程设计时,设计器的模板预览 URL 将会失去直接预览的效果,必须验证数字签名,方可预览模板。

    如下图所示:

    7.png

    3.2 屏蔽数字签名认证功能

    超管希望对次级管理员开放模板认证功能,但不希望次级管理员使用「数字签名认证」。

    超级管理员可通过「fine_conf_entity可视化配置插件」屏蔽数字签名认证功能。重启服务器后设置生效。

    注:修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。

    配置项
    修改规则
    TemplateAuthConfig.digitalAuthAvailable

    参数值如下,默认为true

    false:管理员无法使用模板认证-数字签名功能

    true:管理员可使用模板认证-数字签名功能

    修改配置项 TemplateAuthConfig.digitalAuthAvailable 的值为 false,重启服务器后,管理员点击「管理系统>模板认证>认证配置」,可以发现认证方式中的「数字签名认证」被屏蔽,无法设置。

    注:在屏蔽「数字签名认证」之前,请勿设置认证方式为「数字签名认证」。否则屏蔽后认证仍然生效。

    3.3 决策平台首页无法查看

    问题描述&原因分析:

    如果开启了模板认证:

    1)用户在数据决策系统查看目录模板,无需额外经过模板认证

    2)用户在数据决策系统查看首页模板,需要额外经过模板认证。

    如果首页挂载了模板A,用户没有模板A的模板认证权限,那么用户就看不到该首页。提示「您没有该页面的访问权限」。

    解决方案:

    1)直接从模板认证中关闭对应模板的数字签名认证,再从首页的配置页面挂载对应模板即可。               

    2)利用首页的链接进行挂载,利用对应的URL+参数&fine_digital_signature=值即可。

    其中的值为密钥生成的数字签名,而非密钥,获取方法见本文档2.1节

    附件列表


    主题: 数据决策系统
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持