Template Authentication

  • Last update:September 19, 2025
  • Overview

    Version

    Report Server Version

    11.0

    Application Scenario

    Users can view templates in two ways:

    (1) Template preview URL generated by the designer, for example, http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt.

    (2) Directory preview URL generated by the decision-making platform, for example, http://localhost:8075/webroot/decision/v10/entry/access/0abd069d-bbf1-4b5f-93dc-30b21c1dc4cf?preview=true.

    If the user accesses the report project using FineReport's decision-making platform, that is method two, the system can restrict user permissions at login and control the user's behavior of viewing reports.

    If the user does not purchase the decision-making platform function point, but directly uses method one to integrate the reports into a third-party system, the admin needs to restrict user operation permissions on templates through the Template Authentication configurations.

    Function Description

    The system administrator can control the user's behavior of viewing reports in four ways.

    Method

    Description

    Help Document

    No authentication

    No authentication is required. Anyone who has obtained the template preview URL can view the corresponding report template.

    Disabled Template Authentication

    Username and password-based   authentication

    Login authentication is required. All users have the same permissions after they log in.

    Logged-in users who have obtained the template preview URL can view the corresponding report template.

    Authenticating User Passwords Only

    Role permission-based   authentication

    Login authentication is required. After a successful login, different users have different permissions according to their role information.

    A user can only view report templates to which the user has the viewing permission.

    Role-based Authentication

    Digital signature-based   authentication

    Report requests are authenticated through digital signatures. Only after authenticating the legality of the signature information through the digital signature will access to the report be allowed. Otherwise, information indicating no permission is returned.

    Digital Signature Authentication

    Notes

    (1) Template permission control needs to be used in integration with the user system. For details, see the following table.

    Template Permission Integration Function Point

    Decision-making Platform Function Point

    Effect After Setting

    Not purchased

    /

    The Template Authentication function cannot be used.

    Purchased

    Not purchased

    The Template Authentication function can be used and will take effect on the configured templates.

    The template cannot be mounted on the decision-making platform, and can only be accessed through links such as http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt.

    Purchased

    The Template Authentication function can be used.

    (1) The function will take effect on templates accessed through links such as http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt.

    (2) The function will not take effect on directory templates accessed through the decision-making platform.

    (3) The function will take effect on the homepage templates accessed through the decision-making platform.

    (2) When users preview reports in the designer, they may be restricted by template authentication, which may cause inconvenience during previewing in the template creation process.

    (3) After disabling template authentication and enabling it again, the previous configuration is still retained.

    Template Authentication

    Logging in to the Decision-Making Platform

    Log in to the decision-making platform as the admin and choose System Management > Template Authentication.

    Alternatively, enter http://IP:Port number/webroot/decision#management/template-authority in the browser address bar.

    登录数据决策系统.png

    Enabling Template Authentication

    Click the Permission Configuration button in the upper left corner to enable template authentication, and configure the templates that require authentication and the authentication method, as shown in the following figure.

    开启模板认证.png

    Selecting Templates that Require Authentication

    Click Select and configure the templates that require authentication, as shown in the following figure.

    By default, authentication is required for all templates. Switching the lock icon to the locked state indicates that authentication is not required for the selected template.

    iconNote:
    Do not create a top-level directory named reportlets in the WEB-INF/reportlets path of the project. Otherwise, the template tree cannot be loaded.

    选择需要认证的模板.png

    Selecting an Authentication Method

    The admin can choose the authentication method as required, which is Authenticate User Password Only by default. The setting process for the authentication methods is as follows:

    Attachment List


    Theme: Decision-making Platform
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy