@ackplus/nest-auth (英语)

NestJS.Sessions,MFA,OAuth,无密码,多租,RBAC,审计记录,以及嵌入式管理控制台的全功能认证模块——所有类型安全端到结束.

📚 完整文档: ack-solutions.github.io/nst-auth (英语)

为什么

现代认证有一个长的清单:电子邮件+密码,OAuth,MFA,刷新-托肯旋转,RBAC,多租,审计日志,一个管理员控制台. 大多数团队将5个库(并拥有集成风险)粘合在一起,或购买主机供应商(并失去数据所有权). @ackplus/nest-auth 选择第三个路径 : 在自己的 NestJS 应用程序中安装的单一模块化库, 由自己的数据库支持。 。 。 .

安装

pnpm add @ackplus/nest-auth @ackplus/nest-auth-contracts

必要的同伴依赖性 :

pnpm add @nestjs/common @nestjs/core @nestjs/typeorm @nestjs/swagger \
  @nestjs/event-emitter @nestjs/platform-express \
  typeorm class-validator class-transformer reflect-metadata rxjs

可选, 只有在您启用匹配功能时 :

完整安装指南 −

AI 编码代理

使用 Claude 代码, Codex, Cursor 或者另一个 AI 编码代理? 安装 Nest Auth 技能使其知道 SDK 的真实 API :

npx @ackplus/nest-auth-skill

它检测你的堆栈( 或通过) --stack backend),并且只添加代理指令文件;您的应用程序不会被更改.

包括什么

最小示例

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { EventEmitterModule } from '@nestjs/event-emitter';
import { NestAuthModule, NestAuthEntities } from '@ackplus/nest-auth';

@Module({
  imports: [
    EventEmitterModule.forRoot(),
    TypeOrmModule.forRoot({
      type: 'postgres',
      url: process.env.DATABASE_URL,
      entities: [...NestAuthEntities],
      synchronize: process.env.NODE_ENV === 'development',
    }),
    TypeOrmModule.forFeature([...NestAuthEntities]),

    NestAuthModule.forRoot({
      appName: 'My App',
      session: { jwt: { secret: process.env.JWT_SECRET! } },
      // emailAuth: { enabled: true },        // default
      // google: { clientId, clientSecret },  // opt-in OAuth
      // mfa: { enabled: true, required: true },
      // tenant: { enabled: true, mode: TenantModeEnum.SHARED },
    }),
  ],
})
export class AppModule {}

就是这样,你立刻得到 POST /auth/signup, (中文(简体) ), POST /auth/login, (中文(简体) ), /auth/refresh-token,密码重置,MFA,OAuth调用,其余API. 线 EventEmitterModule.forRoot(), (中文(简体) ), cookie-parser,则 AuthExceptionFilter 从 设置清单 还有船.

文档

配套软件包

所有4个包都与同版本号一起放出. 把它们绑在同一个版本.

链接

• 📚 文档
• 💬 问题跟踪器
• 📦 GitHub 仓库

许可证

麻省理工学院