Casdoor集成市场

Kong Gateway | 应用集成

用 Casdoor 保护 Kong 后面的服务

Kong Gateway 3.x 的 Casdoor 插件用授权码流程加 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 配置 Kong Gateway

  1. 1

    在 Casdoor 中注册 Kong Gateway

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

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

    从集成市场安装

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

  3. 3

    在 Kong 上安装插件

    在每个 Kong 节点上解压,用 LuaRocks 安装,再把 casdoor 加到 Kong 加载的插件列表里。

    cd kong-plugin-casdoor
    luarocks make kong-plugin-casdoor-0.1.0-1.rockspec
    export KONG_PLUGINS=bundled,casdoor
    kong restart
  4. 4

    在服务上启用

    启用插件,填上应用的客户端ID和客户端密钥。

    curl -X POST http://localhost:8001/services/<service>/plugins \n  --data name=casdoor \n  --data config.casdoor_endpoint=https://door.casdoor.com \n  --data config.client_id=<client id> \n  --data config.client_secret=<client secret> \n  --data config.cookie_secret=<at least 32 random characters>
  5. 5

    试一下

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

注意事项

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

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