@digiforce-nc/plugin-verification

Plugin xác minh danh tính — quản lý verifiers, gửi mã xác minh qua SMS OTP, và cung cấp VerificationManager cho các plugin khác (2FA, auth) sử dụng.

Plugin này làm gì?

Plugin cung cấp hệ thống verification trung tâm cho Digiforce. Nó quản lý verifiers (SMS OTP, Email OTP), scenes (kịch bản xác minh), và cung cấp API để plugin khác đăng ký verification type mới. Plugin plugin-two-factor-authentication và plugin-auth-sms đều phụ thuộc vào plugin này.

Tính năng chính

#	Tính năng	Mô tả
1	VerificationManager	Quản lý verification types, scenes, actions, middleware
2	SMS OTP	Gửi mã xác minh qua SMS (Aliyun, Tencent)
3	Verifier binding	User liên kết verifier (số điện thoại) với tài khoản
4	Scene-based	Mỗi kịch bản xác minh có rules riêng (2FA, auth-sms, unbind)
5	Rate limiting	Counter chống gửi SMS quá nhiều (dùng cache + lock)
6	Extensible	Plugin khác đăng ký verification type và SMS provider mới

API Resources

Resource	Action	Quyền	Mô tả
`verifiers`	`listByUser`	`loggedIn`	Liệt kê verifiers của user hiện tại
`verifiers`	`listForVerify`	`loggedIn`	Liệt kê verifiers khả dụng cho xác minh
`verifiers`	`bind`	`loggedIn`	Liên kết verifier mới
`verifiers`	`unbind`	`loggedIn`	Xóa liên kết verifier
`smsOTP`	`create`	`loggedIn`	Tạo và gửi mã SMS OTP
`smsOTP`	`publicCreate`	`public`	Tạo SMS OTP không cần đăng nhập
`verifiers:*`	—	Admin (snippet)	Quản lý verifiers
`smsOTPProviders:*`	—	Admin (snippet)	Quản lý SMS providers

Dependencies

Package	Vai trò
`@digiforce-nc/server`	Server framework
`@digiforce-nc/database`	Database ORM
`@digiforce-nc/cache`	Counter — rate limiting SMS OTP
`@digiforce-nc/utils`	`tval` — translatable value