Casdoor集成市场

泛微 e-cology | 应用集成

泛微 e-cology 单点登录

e-cology 10 的统一认证接入可以把登录交给第三方认证平台。按 OAuth2 接入 Casdoor 后,员工打开 OA 的企业登录地址会跳到 Casdoor 登录,再按邮箱进入对应的 E10 账号。统一认证接入只做登录,不同步人员。

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

用 Casdoor 配置 泛微 e-cology

  1. 1

    在 Casdoor 中注册 泛微 e-cology

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

    • https://oa.example.com

    E10 的回调地址在统一认证接入管理的 OAuth2 配置页上只读显示,把它原样加到这个应用的重定向 URL 里。Casdoor 按完整路径比对,上面的 e-cology 地址只是占位。

  2. 2

    确认版本

    下面按 e-cology 10 写:入口在 后台管理中心 → 统一认证接入管理,泛微文档没有提到另收费用。e-cology 9 的入口是 应用中心 → 集成中心 → 统一认证中心 → 认证接入管理,OAuth2、CAS 集成在 E9 上属于非标模块,要先向泛微确认已经购买。

  3. 3

    开启 OAuth2 集成,复制回调地址

    在统一认证接入管理里打开开关,认证方式选 OAuth2。页面上只读显示的 回调地址 就是 Casdoor 要跳回的地址,把它加到 Casdoor 这个应用的重定向 URL。然后填应用标识和应用密钥:

    应用标识<client ID>
    应用密钥<client secret>
  4. 4

    请求用户授权接口

    参数里的 ${client_id}、${redirect_uri} 从参数浏览框里选。scope 要带 email,Casdoor 才会在用户信息里返回邮箱。

    接口地址https://auth.example.com/login/oauth/authorize
    请求方式GET
    取值字段code
    参数 client_id${client_id}
    参数 response_typecode
    参数 redirect_uri${redirect_uri}
    参数 scopeopenid profile email
    参数 stateecology
  5. 5

    获取授权Token接口

    Casdoor 的 Token 接口只接受 POST,客户端凭据放在参数里即可。

    接口地址https://auth.example.com/api/login/oauth/access_token
    请求方式POST
    取值字段access_token
    参数 grant_typeauthorization_code
    参数 code${code}
    参数 client_id${client_id}
    参数 client_secret${client_secret}
    参数 redirect_uri${redirect_uri}
  6. 6

    获取用户信息接口

    Casdoor 的用户信息接口返回 preferred_username(用户名)、name(显示名)、email 等字段。账号规则选电子邮箱,E10 就用 Casdoor 用户的邮箱找对应的人员。

    接口地址https://auth.example.com/api/userinfo
    请求方式GET
    请求头 AuthorizationBearer ${access_token}
    账号规则电子邮箱
    取值字段email
  7. 7

    白名单和企业登录地址

    把 Casdoor 的域名加进 E10 的第三方系统域名白名单,否则跳转会被拦住。统一退出接口和检测心跳接口可以不配。然后在 界面配置中心 → 登录页设置 里设置企业登录地址,员工从这个地址进来才会跳到 Casdoor。

  8. 8

    测试登录

    用一个邮箱和 E10 人员邮箱一致的 Casdoor 账号,在无痕窗口打开企业登录地址,登录 Casdoor 后应直接进入 E10。

注意事项

  • 统一认证接入只认证、不同步人员。Casdoor 用户的邮箱必须和 E10 人员的电子邮箱一致,没有邮箱或对不上的人登录不进去。
  • 想按手机号对应人员:授权接口的 scope 加上 phone,账号规则选手机号码,取值字段填 phone(Casdoor 返回不带国家码的手机号)。
  • E10 的 OAuth2 没有用户名这种账号规则,只能按电子邮箱、手机号码或工号对应。

泛微 e-cology 的设置取自它的官方文档(核对于 2026年11月:泛微:本平台接入第三方统一认证平台(E10)、泛微:统一认证功能概述(E10)、华为云 OneAccess:泛微 e-cology 9 OAuth2 对接(第三方))。泛微 e-cology 是其所有者的商标。

常见问题

能不能用 CAS?

E10 的统一认证接入也支持 CAS:服务地址填 https://auth.example.com/cas/<组织名>/<应用名>,登录地址、退出地址分别在后面加 /login、/logout,组织名、应用名是这个 Casdoor 应用所属的组织和应用名称。但 CAS 返回的是 Casdoor 用户名,E10 只拿它去比对手机号码、工号或电子邮箱,所以 Casdoor 的用户名得等于工号、手机号或邮箱才行。用户名对不上时用上面的 OAuth2。

e-cology 9 怎么配?

泛微没有公开 E9 的配置文档。按竹云、华为云 OneAccess 等对接文档,E9 的 OAuth2 集成在 认证接入管理 里,接口和参数与上面类似,另有 client_id_key、code_key、access_token_key 等参数名配置,开启或关闭后要点 部署 才生效。E9 的 OAuth2、CAS 集成是非标模块,以泛微实施给的说明为准。

Casdoor 出问题时管理员怎么登录?

企业登录地址才会跳 Casdoor,关掉统一认证接入的开关就恢复系统默认的账号密码登录。配置时保留一个能进后台的管理员账号。