Casdoor集成市场

帆软 FineReport / FineBI | 应用集成

帆软 FineReport / FineBI 单点登录

帆软的类Oauth2单点登录插件让决策平台把登录交给外部认证平台:没登录时跳到 Casdoor,回来后用授权码换令牌、取用户名,再以这个用户名登录决策平台。

Casdoor 官方核验商业版OAuth 2.0BI
你需要一个正在运行的 Casdoor,自己部署或用 Casdoor 云都可以。示例中的 https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。

用 Casdoor 配置 帆软 FineReport / FineBI

  1. 1

    在 Casdoor 中注册 帆软 FineReport / FineBI

    在 Casdoor 控制台打开 应用,为 帆软 FineReport / FineBI 添加一个应用,在它的 OIDC/OAuth 标签页复制 客户端ID 和 客户端密钥。把下面的地址加到 重定向URLs:

    • https://report.example.com/webroot/decision

    插件的回调地址就是决策平台地址,下面的认证地址和令牌申请里写的也是它。

  2. 2

    安装插件

    从帆软市场下载 类Oauth2单点插件,在设计器或决策平台的插件管理里安装。FineReport 11.0 装完即生效,10.0 装完要重启,而且要用 V1.0.3 以上的插件。

  3. 3

    基本配置

    管理员登录决策平台,进入 管理系统 → 单点集成,PC 端选 Oauth2 认证模式。

    动态获取报表域名关闭
    报表服务器地址https://report.example.com/webroot/decision
    保留平台登录页开启(管理员可从 /decision/login 用账号密码登录)
    平台登出地址https://auth.example.com/api/logout?client_id=<client ID>&post_logout_redirect_uri=https://report.example.com/webroot/decision
  4. 4

    初始参数

    插件用 ${"..."+变量} 的写法拼接地址,code 是 Token Name 取到的授权码。

    Client ID<client ID>
    Client Secret<client secret>
    Grant Typeauthorization_code
    Scopeopenid profile
    Statefanruan
    Token Namecode
    认证接口地址${"https://auth.example.com/login/oauth/authorize?response_type=code&client_id=<client ID>&scope=openid%20profile&state=fanruan&redirect_uri=https://report.example.com/webroot/decision"}
  5. 5

    令牌申请

    Casdoor 的 Token 接口只接受 POST,参数放在地址里即可,请求头和请求体留空。

    请求方式POST
    请求地址${"https://auth.example.com/api/login/oauth/access_token?grant_type=authorization_code&client_id=<client ID>&client_secret=<client secret>&redirect_uri=https://report.example.com/webroot/decision&code="+code}
    请求结果参数名 access_token,参数值 access_token
  6. 6

    用户信息

    Casdoor 的用户信息接口在 preferred_username 里返回用户名,把它作为 fr_login_name,决策平台就用这个用户名登录。

    请求方式GET
    请求地址${"https://auth.example.com/api/userinfo?access_token="+access_token}
    请求结果参数名 fr_login_name,参数值 preferred_username
  7. 7

    测试登录

    保存后在无痕窗口打开 https://report.example.com/webroot/decision,应跳到 Casdoor,登录后回到决策平台。

注意事项

  • fr_login_name 是决策平台里的用户名,Casdoor 用户名要和决策平台用户一致。决策平台里没有这个用户时登录会失败。
  • 插件 v1.0.4 起有 展示日志页面,开启后打开 https://report.example.com/webroot/decision/sso/plugin/log 能看到每一步的请求和返回,排查时先看这里。
  • 要登录后回到用户原来打开的报表,用插件高级设置里的 回调地址设置,通过 state 带上原始地址;回调地址本身仍是决策平台地址。
  • 移动端(HTML5 预览)要先装 HTML5 插件,再在移动端单独配置一遍。

帆软 FineReport / FineBI 的设置取自它的官方文档(核对于 2026年11月:FineReport 帮助文档:类Oauth2单点登录插件、FineReport 帮助文档:类Oauth2单点登录插件配置实例、帆软市场:类Oauth2单点插件)。帆软 FineReport / FineBI 是其所有者的商标。

常见问题

FineBI 能用吗?

帆软的插件文档说明它用于集成 FineReport、FineBI 平台,两者共用决策平台和这里的单点集成配置。装之前在帆软市场确认插件支持你的 FineBI 版本。

插件收费吗?

帆软的插件文档没有写价格,以帆软市场插件页的说明为准。

能用 CAS 吗?

FineReport 也能在 web.xml 里配 CAS 过滤器接 CAS 服务,Casdoor 可以当 CAS 服务端,但要改部署文件、报表有权限时还要写代码。用插件按 OAuth2 配更省事。