如何在Nestjs应用中基于express-cas-authentication实现CAS身份验证？

核心原理 #

NestJS 默认基于Express框架构建，底层请求/响应对象完全兼容Express生态的中间件，无需修改模块本身代码即可复用 express-cas-authentication 的全部能力。无法直接运行原生Express风格代码的原因是Nest有自身的路由、依赖注入管理体系，不建议在main.ts中直接手写路由逻辑，需匹配Nest的生命周期机制完成集成。

实现方式 #

前置依赖安装 #

执行命令安装模块：
npm install express-cas-authentication
如果是TypeScript项目，可补充安装类型声明：
npm install -D @types/express-cas-authentication

方案1：全局接口强制CAS校验（适合全后端仅面向内网登录用户的场景） #

直接在main.ts的启动流程中挂载校验逻辑，所有请求进入后先完成CAS校验，再进入Nest的路由处理流程。
参考代码：

// src/main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as CAS from 'express-cas-authentication';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  // 初始化CAS客户端，替换为实际项目配置
  const casClient = new CAS({
    casServerUrl: 'https://企业CAS服务地址/cas',
    serviceUrl: 'https://当前后端服务的对外访问地址',
    version: 3.0 // 匹配企业CAS服务端版本
  });

  // 挂载全局校验中间件
  app.use((req, res, next) => {
    // 配置无需校验的公开路径，避免校验死循环
    const publicPaths = ['/cas/callback', '/health', '/public'];
    if (publicPaths.includes(req.path)) {
      return next();
    }
    // 未登录则触发CAS跳转登录逻辑
    return casClient.bounce(req, res, next);
  });

  await app.listen(3000);
}
bootstrap();

方案2：局部路由CAS校验（仅部分接口需要登录校验） #

通过Nest中间件机制绑定指定路由，和原生Express中给单个接口加cas.bounce中间件的效果完全一致，不影响其他公开接口的访问。

1. 编写CAS校验中间件src/middleware/cas.middleware.ts

   import { Injectable, NestMiddleware } from '@nestjs/common';
   import * as CAS from 'express-cas-authentication';
   
   @Injectable()
   export class CasMiddleware implements NestMiddleware {
     // 通过依赖注入获取CAS客户端实例，避免重复初始化
     constructor(private casClient: CAS) {}
   
     use(req: any, res: any, next: () => void) {
       this.casClient.bounce(req, res, next);
     }
   }
   

2. 在根模块中注册CAS客户端实例、绑定中间件到指定路由

   // src/app.module.ts
   import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
   import { CasMiddleware } from './middleware/cas.middleware';
   import * as CAS from 'express-cas-authentication';
   
   @Module({
     providers: [
       // 全局提供CAS客户端实例，供各处注入使用
       {
         provide: 'CAS_CLIENT',
         useValue: new CAS({
           casServerUrl: 'https://企业CAS服务地址/cas',
           serviceUrl: 'https://当前后端服务的对外访问地址',
           version: 3.0
         })
       }
     ]
   })
   export class AppModule implements NestModule {
     configure(consumer: MiddlewareConsumer) {
       // 将CAS校验绑定到/app路由，和原Express代码逻辑等价
       consumer
         .apply(CasMiddleware)
         .forRoutes('/app');
     }
   }
   

常见注意事项 #

• CAS登录成功后的回调路径必须加入公开放行列表，否则会触发无限跳转：用户完成登录后，CAS服务端会携带ticket重定向到配置的serviceUrl，该路径需由express-cas-authentication模块自行完成ticket校验逻辑，不能被bounce校验拦截
• 校验通过后的用户信息会被挂载到req.user对象上，在Nest控制器中可直接通过@Req() req参数获取，无需额外解析
• 不要在main.ts中直接编写app.get类的原生Express路由，这类路由会绕开Nest的依赖注入、拦截器、管道、异常过滤器等核心机制，后续维护成本极高

内容的提问来源于stack exchange，提问作者Claeyssic