Nest.js 認証検証方法の例

エクスポート列挙型ロール{
 ユーザー = 'user'、
 管理者 = 'admin'
}

'@nestjs/common' から { SetMetadata } をインポートします。
'./role.enum' から { Role } をインポートします。

エクスポート const ROLES_KEY = 'roles'
エクスポート const Roles = (...roles: Role[]) => SetMetadata(ROLES_KEY, roles)

@役職（）
@Roles(ロール.管理者)
作成(@Body() createUserDto: CreateUserDto): Promise<UserEntity> {
 this.userService.create(createUserDto) を返します。
}

'@nestjs/common' から { Injectable、CanActivate、ExecutionContext } をインポートします。
'@nestjs/core' から { Reflector } をインポートします。

'./role.enum' から { Role } をインポートします。
'./roles.decorator' から { ROLES_KEY } をインポートします。

@インジェクタブル()
RolesGuardクラスをエクスポートし、CanActivateを実装します。
 コンストラクター(プライベートリフレクター: Reflector) {}

 canActivate(コンテキスト: ExecutionContext): ブール値 {
 const requireRoles = this.reflector.getAllAndOverride<Role[]>(ROLES_KEY、[context.getHandler(), context.getClass()])
 役割が必要な場合
  真を返す
 }
 const { ユーザー } = context.switchToHttp().getRequest()
 requireRoles.some(role => user.roles?.includes(role)) を返します
 }
}

クラスユーザー{
 // ...その他のプロパティ
 役割: 役割[]
}

プロバイダー:
 {
 提供: APP_GUARD、
 使用クラス: RolesGuard
 }
]

{
 「ステータスコード」: 403,
 "メッセージ": "禁止されたリソース",
 「エラー」: 「禁止」
}

@役職（）
@RequirePermissions(権限.CREATE_USER)
作成(@Body() createUserDto: CreateUserDto): Promise<UserEntity> {
 this.userService.create(createUserDto) を返します。
}

エクスポート列挙型ロール{
 CREATE_USER = ['追加'、'読み取り'、'更新'、'削除']、
 READ_USER = ['読み取り']
}

糸を追加 @casl/ability

クラスユーザー{
 id: 番号
 isAdmin: ブール値
}

クラス記事{
 id: 番号
 isPublished: ブール値
 著者ID: 文字列
}

エクスポート列挙アクション{
 管理 = '管理'、
 作成 = '作成'、
 読む = '読む'、
 更新 = '更新'、
 削除 = '削除'、
}

ネスト g モジュール casl
ネスト g クラス casl/casl-ability.factory

type Subjects = InferSubjects<typeof Article | typeof User> | 'all'

エクスポートタイプ AppAbility = Ability<[Action, Subjects]>

@インジェクタブル()
CaslAbilityFactoryクラスをエクスポートします。
 ユーザーを作成します(ユーザー: ユーザー) {
 const { can, cannot, build } = new AbilityBuilder<
  能力<[アクション、対象]>
 >(Ability を AbilityClass<AppAbility> として)

 （ユーザー.isAdmin）{
  can(Action.Manage, 'all') // すべての読み取りおよび書き込み操作を許可する } else {
  can(Action.Read, 'all') // 読み取り専用操作}

 できます(Action.Update、記事、{authorId:user.id})
 できません(Action.Delete、Article、{isPublished: true})

 ビルドを返す({
  // 詳細: https://casl.js.org/v5/en/guide/subject-type-detection#use-classes-as-subject-types
  対象タイプを検出: item => item.constructor を ExtractSubjectType<Subjects> として
 })
 }
}

'@nestjs/common' から { モジュール } をインポートします。
'./casl-ability.factory' から { CaslAbilityFactory } をインポートします。

@モジュール({
 プロバイダー: [CaslAbilityFactory],
 エクスポート: [CaslAbilityFactory]
})
CaslModule クラスをエクスポートします {}

コンストラクター(プライベート caslAbilityFactory: CaslAbilityFactory) {}

定数 能力 = this.caslAbilityFactory.createForUser(ユーザー)
（能力がAction.Read、'すべて'）の場合）{
 // "user" はすべてのコンテンツを読み書きできます}

定数ユーザー = 新しいユーザー()
ユーザー.isAdmin = false

定数 能力 = this.caslAbilityFactory.createForUser(ユーザー)
能力.can(Action.Read, Article) // true
能力.can(Action.Delete, Article) // false
能力.can(Action.Create, Article) // false

定数ユーザー = 新しいユーザー()
ユーザーID = 1

const article = 新しい Article()
記事の著者ID = ユーザーID

定数 能力 = this.caslAbilityFactory.createForUser(ユーザー)
ability.can(Action.Update, article) // true

記事の著者ID = 2
ability.can(Action.Update, article) // false

'../casl/casl-ability.factory' から { AppAbility } をインポートします

インターフェース IPolicyHandler {
 ハンドル(能力: AppAbility): ブール値
}

タイプ PolicyHandlerCallback = (ability: AppAbility) => ブール値

エクスポート型 PolicyHandler = IPolicyHandler | PolicyHandlerCallback

エクスポート const CHECK_POLICIES_KEY = 'check_policy'
エクスポート const CheckPolicies = (...handlers: PolicyHandler[]) => SetMetadata(CHECK_POLICIES_KEY, handlers)

@インジェクタブル()
エクスポートクラスPoliciesGuardはCanActivateを実装します{
 コンストラクタ（
 プライベートリフレクター：リフレクター、
 プライベート caslAbilityFactory: CaslAbilityFactory、
 ）{}

 非同期canActivate(コンテキスト: ExecutionContext): Promise<boolean> {
 定数ポリシーハンドラ =
  this.reflector.get<ポリシーハンドラ[]>(
  CHECK_POLICIES_KEY、
  コンテキスト.getHandler()
  ) || []

 const { ユーザー } = context.switchToHttp().getRequest()
 定数 能力 = this.caslAbilityFactory.createForUser(ユーザー)

 戻り値 policyHandlers.every((handler) =>
  this.execPolicyHandler(ハンドラ、機能)
 ）
 }

 プライベート execPolicyHandler(ハンドラー: PolicyHandler、機能: AppAbility) {
 if (ハンドラの型 === '関数') {
  ハンドラを返す(機能)
 }
 handler.handle(ability) を返す
 }
}

@得る（）
@UseGuards(ポリシーガード)
@CheckPolicies((ability: AppAbility) => ability.can(Action.Read, Article))
すべて検索() {
 this.articlesService.findAll() を返す
}

ReadArticlePolicyHandlerクラスをエクスポートし、IPolicyHandlerを実装します。
 ハンドル(能力: AppAbility) {
 能力を返すことができます(Action.Read, Article)
 }
}

@得る（）
@UseGuards(ポリシーガード)
@CheckPolicies(新しい ReadArticlePolicyHandler())
すべて検索() {
 this.articlesService.findAll() を返す
}