NestJS 멀티테넌시와 PostgreSQL RLS

@nestarc/tenancy 0.16.x는 요청에서 테넌트 ID를 추출하고, Prisma Client Extension이 트랜잭션 내부에서 PostgreSQL 세션 컨텍스트를 설정하도록 돕습니다. 실제 격리는 데이터베이스의 RLS 정책이 수행합니다. 0.15에는 운영 역할과 적용된 RLS를 검사하는 doctor, Prisma 6/7 PgBouncer transaction-mode 검증, 비HTTP missing-context 정책이 추가되었습니다.

반드시 확인할 점

• 기본 테넌트 ID 검증은 UUID 형식입니다. 다른 형식이나 존재 확인이 필요하면 validateTenantId를 설정합니다.
• TenancyModule.forRoot() 등록만으로 Prisma 쿼리가 격리되지는 않습니다. createPrismaTenancyExtension()으로 만든 확장 클라이언트를 사용해야 합니다.
• 테이블 소유자 우회를 막아야 한다면 FORCE ROW LEVEL SECURITY와 운영 DB 역할을 함께 검토합니다.
• 배치와 큐 작업은 HTTP 요청 밖에서 실행되므로 TenancyContext.run()으로 컨텍스트를 명시하고, missingContext: { policy: 'warn' | 'throw' }로 누락을 관찰하거나 차단합니다.
• 배포 전후 npx @nestarc/tenancy check로 생성 SQL을 검사하고, 실제 애플리케이션 DB 역할로 npx @nestarc/tenancy doctor를 실행합니다.
• interactive transaction은 Prisma 내부 API에 의존하는 투명 모드 대신 tenancyTransaction()을 사용합니다. 0.15는 maxWait, timeout, isolation level을 전달합니다.

전체 설치 문서 · CLI와 live doctor · 비HTTP 리소스 보호 · PostgreSQL RLS 공식 문서

0.16 업그레이드

Node.js ^22.13.0 || ^24.0.0이 필요합니다. lifecycle event의 raw request 필드는 제거되었으므로 requestSummary를 사용합니다. TEXT/UUID tenant 컬럼에 맞춘 정책과 비어 있지 않은 컨텍스트를 요구하는 restrictive RLS guard가 생성됩니다. 기존 배포도 SQL diff와 정책 이름을 검토한 뒤 재적용하고 check와 doctor로 확인해야 합니다.

RPC에는 명시적인 TenantIdValidator를 연결합니다. 검증은 producer 인증과 tenant 권한 확인을 대체하지 않습니다. interactiveTransactionSupport는 0.16에서 deprecated 상태로 유지되며 0.17 제거 예정입니다. 전체 마이그레이션을 참고하세요.