Node.js集成OIDC Provider路径报错及路由覆盖问题如何解决?
问题修复方案
1. 路径不识别错误修复
该错误的核心原因是仅修改了Issuer的路径前缀,没有同步配置oidc-provider的路由前缀参数,导致服务实际注册的OIDC相关路由仍在根路径下,和你访问的带/api/v1前缀的路径不匹配。
修复步骤
在你的configuration配置中添加routes.prefix参数,取值和Issuer的路径前缀保持一致即可,修正后代码如下:
const { Provider } = require('oidc-provider'); const configuration = { // 新增路由前缀配置,和Issuer路径前缀保持一致 routes: { prefix: '/api/v1' }, clients: [{ client_id: 'foo', client_secret: 'bar', redirect_uris: ['http://localhost:3000/api/v1/'], true_provider: "pcc" }], }; const oidc = new Provider('http://localhost:3000/api/v1/', configuration); // 若使用standalone模式直接启动,配置后即可正常访问 const server = oidc.listen(3000, () => { console.log('oidc-provider listening on port 3000, check http://localhost:3000/api/v1/.well-known/openid-configuration'); });
如果是挂载到现有Express应用的场景,除了上述配置外,还需要将oidc中间件挂载到对应前缀路径下:
// 示例Express挂载代码 const express = require('express'); const app = express(); // 挂载oidc中间件到/api/v1路径下 app.use('/api/v1', oidc.callback()); app.listen(3000);
2. 路由被覆盖问题修复
该问题通常出现在将oidc-provider挂载到现有Node.js Web服务(如Express、Koa)的场景,按以下规则配置即可避免:
- 优先挂载oidc-provider中间件,再挂载你自己的业务路由、全局404处理中间件,避免业务路由提前拦截OIDC相关请求
- 不要全局挂载body-parser、json解析等中间件,这类中间件会干扰oidc-provider自身的请求解析逻辑,仅将其挂载到你的业务路由分组下即可
- 确保oidc的路由前缀和你的业务路由前缀没有重叠,比如OIDC用
/api/v1/oidc的前缀,业务接口用/api/v1/biz的前缀,从根源上避免路径冲突
内容的提问来源于stack exchange,提问作者Hariprasath Vengatachalam
相关产品推荐
相关产品推荐

