https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。用 Casdoor 配置 帆软 FineReport / FineBI
- 1
在 Casdoor 中注册 帆软 FineReport / FineBI
在 Casdoor 控制台打开 应用,为 帆软 FineReport / FineBI 添加一个应用,在它的 OIDC/OAuth 标签页复制 客户端ID 和 客户端密钥。把下面的地址加到 重定向URLs:
https://report.example.com/webroot/decision
插件的回调地址就是决策平台地址,下面的认证地址和令牌申请里写的也是它。
- 2
安装插件
从帆软市场下载 类Oauth2单点插件,在设计器或决策平台的插件管理里安装。FineReport 11.0 装完即生效,10.0 装完要重启,而且要用 V1.0.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
初始参数
插件用
${"..."+变量}的写法拼接地址,code是 Token Name 取到的授权码。Client ID <client ID> Client Secret <client secret> Grant Type authorization_code Scope openid profile State fanruan Token Name code 认证接口地址 ${"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
令牌申请
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
用户信息
Casdoor 的用户信息接口在
preferred_username里返回用户名,把它作为fr_login_name,决策平台就用这个用户名登录。请求方式 GET 请求地址 ${"https://auth.example.com/api/userinfo?access_token="+access_token} 请求结果 参数名 fr_login_name,参数值 preferred_username - 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 配更省事。
更多应用集成
查看全部
阿里邮箱商业版
应用集成阿里邮箱 AI尊享版可以把 Casdoor 加成 OIDC 身份源:员工在邮箱登录页跳到 Casdoor 登录,按邮箱地址进入对应的邮箱账号。
Argo CD
应用集成用 OpenID Connect 把 Argo CD 接入 Casdoor:argocd-cm 里的 oidc.config、客户端密钥、PKCE、CLI 登录,以及按 Casdoor 群组分配 RBAC 权限。

DeepSeek Harness商业版
应用集成让 DeepSeek Harness 以智能体身份登录 Casdoor,经 Casdoor MCP 网关使用你所在组织的 MCP 服务器,工具级授权、调用记录和审计都由 Casdoor 管理,全部在 Casdoor 和 DeepSeek Harness 的网页上完成设置。

