Casdoor集成市场

Higress | 应用集成

用 Casdoor 保护 Higress 后面的服务

Higress 的 Casdoor Wasm 插件用授权码流程加 PKCE 让浏览器通过 Casdoor 登录,按 JWKS 校验 API 调用里的 Casdoor token,并通过 X-Casdoor-User、X-Casdoor-Email 和 X-Casdoor-Organization 请求头把用户传给上游。只有在 Casdoor 有商业版许可证时才能运行。

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

用 Casdoor 配置 Higress

  1. 1

    在 Casdoor 中注册 Higress

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

    • https://app.example.com/casdoor/callback
    • https://app.example.com/
  2. 2

    从集成市场安装

    在 Casdoor 的 集成市场 页面安装 Higress,填上受保护站点的地址。Casdoor 会建好应用,把回调地址 /casdoor/callback 和退出登录后的落地页设为重定向URLs。然后在同一个对话框里下载 casdoor-higress.wasm。

  3. 3

    发布模块

    把模块放到 Higress 能拉取的地方,例如用插件自带的 Dockerfile 构建的 OCI 镜像,或者一个 HTTPS 地址;再在 McpBridge 里配一个 DNS 服务,让网关能访问 Casdoor。

  4. 4

    添加 WasmPlugin

    新建一个指向这个模块的 WasmPlugin,填上应用的客户端ID和客户端密钥。

    apiVersion: extensions.higress.io/v1alpha1
    kind: WasmPlugin
    metadata:
      name: casdoor
      namespace: higress-system
    spec:
      url: oci://registry.example.com/casdoor-higress:1.0.0
      phase: AUTHN
      defaultConfig:
        casdoor_endpoint: https://door.casdoor.com
        casdoor_service: casdoor.dns
        client_id: <client id>
        client_secret: <client secret>
        cookie_secret: <at least 32 random characters>
  5. 5

    试一下

    在无痕窗口里打开受保护的站点:它会把你送到 Casdoor,登录后回到原页面。访问 /casdoor/logout 退出登录。

注意事项

  • 插件每 10 分钟向 Casdoor 查一次许可证,Casdoor 是开源版时返回 403。

Higress 的设置取自它的官方文档(核对于 2026年11月:Higress: Wasm plugins)。Higress 是其所有者的商标。