@nocobase/plugin-auth NPM

Auth

提供基础认证功能和扩展认证器管理功能。

使用方法

认证器管理

页面：系统设置 - 认证

内置认证器

名称：basic
认证类型：邮箱密码登录

增加认证器

Add new - 选择认证类型

启用/禁用

Actions - Edit - 勾选/取消Enabled

配置认证器

Actions - Edit

开发一个登录插件

接口

Nocobase内核提供了扩展登录方式的接入和管理。扩展登录插件的核心逻辑处理，需要继承内核的Auth类，并对相应的标准接口进行实现。参考core/auth/auth.ts

import { Auth } from '@nocobase/auth';

class CustomAuth extends Auth {
  set user(user) {}
  get user() {}
  
  async check() {}
  async signIn() {}
}

多数情况下，扩展的用户登录方式也将沿用现有的jwt逻辑来生成用户访问API的凭证，插件也可以继承BaseAuth类以便复用部分逻辑代码，如check, signIn接口。

import { BaseAuth } from '@nocobase/auth';

class CustomAuth extends BaseAuth {
  constructor(config: AuthConfig) {
    const userCollection = config.ctx.db.getCollection('users');
    super({ ...config, userCollection });
  }
  
  async validate() {}
}

用户数据

@nocobase/plugin-auth插件提供了usersAuthenticators表来建立users和authenticators，即用户和认证方式的关联。
通常情况下，扩展登录方式用users和usersAuthenticators来存储相应的用户数据即可，特殊情况下才需要自己新增Collection.
users存储的是最基础的用户数据，邮箱、昵称和密码。
usersAuthenticators存储扩展登录方式数据

uuid: 该种认证方式的用户唯一标识，如手机号、微信openid等
meta: JSON字段，其他需要保存的信息
userId: 用户id
authenticator：认证器名字

对于用户操作，Authenticator模型也提供了几个封装的方法，可以在CustomAuth类中通过this.authenticator[方法名]使用：

findUser(uuid: string): UserModel - 查询用户
newUser(uuid: string, values?: any): UserModel - 创建新用户
findOrCreateUser(uuid: string, userValues?: any): UserModel - 查找或创建新用户

注册

扩展的登录方式需要向内核注册。

async load() {
  this.app.authManager.registerTypes('custom-auth-type', {
    auth: CustomAuth,
  });
}

客户端API

OptionsComponentProvider

可供用户配置的认证器配置项

authType 认证方式
component 配置组件

<OptionsComponentProvider authType="custom-auth-type" component={Options} />

Options组件使用的值是authenticator的options字段，如果有需要暴露在前端的配置，应该放在options.public字段中。authenticators:publicList接口会返回options.public字段的值。

SigninPageProvider

自定义登录页界面

authType 认证方式
tabTitle 登录页tab标题
component 登录页组件

SignupPageProvider

自定义注册页界面

authType 认证方式
component 注册页组件

SigninPageExtensionProvider

自定义登录页下方的扩展内容

authType 认证方式
component 扩展组件

Authentication

@everything-registry/sub-chunk-656 @nocobase/preset-nocobase

1.4.0-alpha.20241027230531

9 months ago

1.3.41-beta

9 months ago

1.3.42-beta

9 months ago

1.4.0-alpha.20241031134640

8 months ago

1.4.0-alpha.20241025010959

9 months ago

1.3.40-beta

9 months ago

1.3.38-beta

9 months ago

1.4.0-alpha.20241024133132

9 months ago

1.4.0-alpha

9 months ago

1.4.0-alpha.20241024151311

9 months ago

1.3.39-beta

9 months ago

1.3.37-beta

9 months ago

1.4.0-alpha.20241023053303

9 months ago

1.3.36-beta

9 months ago

1.3.34-beta

9 months ago

1.3.33-beta

9 months ago

1.4.0-alpha.20241017164316

9 months ago

1.4.0-alpha.20241020033334

9 months ago

1.3.35-beta

9 months ago

1.4.0-alpha.20241016084738

9 months ago

1.4.0-alpha.20241020025811

9 months ago

1.4.0-alpha.20241016035453

9 months ago

1.4.0-alpha.20240930160619

9 months ago

1.3.26-beta

9 months ago

1.4.0-alpha.20240930031045

9 months ago

1.4.0-alpha.20240929231156

9 months ago

1.3.31-beta

9 months ago

1.3.28-beta

9 months ago

1.3.27-beta

9 months ago

1.4.0-alpha.20240928155737

10 months ago

1.4.0-alpha.20241008122235

9 months ago

1.3.32-beta

9 months ago

1.3.29-beta

9 months ago

1.4.0-alpha.20240930005110

9 months ago

1.3.30-beta

9 months ago

1.4.0-alpha.20241011073807

9 months ago

1.3.25-beta

10 months ago

1.3.24-beta

10 months ago

1.4.0-alpha.20240923152933

10 months ago

1.4.0-alpha.20240914084300

10 months ago

1.4.0-alpha.20240919174335

10 months ago

1.4.0-alpha.20240914235554

10 months ago

1.4.0-alpha.20240918085507

10 months ago

1.4.0-alpha.20240914095808

10 months ago

1.3.23-beta

10 months ago

1.3.22-beta

10 months ago

1.3.21-beta

10 months ago

1.4.0-alpha.20240911231734

10 months ago

1.4.0-alpha.20240910145333

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

1.4.0-alpha.20240906133133

10 months ago

1.4.0-alpha.20240906114411

10 months ago

1.3.15-beta

10 months ago

1.4.0-alpha.20240903083725

10 months ago

1.3.14-beta

10 months ago

1.4.0-alpha.20240903050434

10 months ago

1.4.0-alpha.20240903052847

10 months ago

1.3.13-beta

10 months ago

1.4.0-alpha.20240902080620

10 months ago

1.4.0-alpha.20240902083444

10 months ago

1.4.0-alpha.20240902071446

10 months ago

1.4.0-alpha.20240902021325

10 months ago

10 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1.4.0-alpha.20240828033319

11 months ago

1.3.5-beta

11 months ago

1.3.4-beta

11 months ago

1.4.0-alpha.20240827104423

11 months ago

1.3.3-beta

11 months ago

1.3.1-beta

11 months ago

1.4.0-alpha.20240826225858

11 months ago

1.4.0-alpha.20240826214041

11 months ago

1.3.2-beta

11 months ago

1.2.19-alpha

12 months ago

1.3.0-alpha.20240710084543

1 year ago

1.3.0-alpha.20240724142600

12 months ago

1 year ago

1 year ago

11 months ago

1 year ago

12 months ago

1.3.0-alpha.20240710141659

1 year ago

1 year ago

11 months ago

12 months ago

11 months ago

1.3.0-alpha.20240814073548

11 months ago

1.4.0-alpha.20240825165425

11 months ago

11 months ago

1 year ago

1 year ago

12 months ago

11 months ago

12 months ago

1 year ago

12 months ago

1 year ago

1.3.0-alpha.20240806102951

11 months ago

11 months ago

11 months ago

1 year ago

12 months ago

12 months ago

11 months ago

12 months ago

1 year ago

1 year ago

1.3.0-alpha.20240721030922

12 months ago

1.2.15-alpha

12 months ago

1.2.28-alpha

11 months ago

1.3.0-alpha.20240719150832

12 months ago

1.3.0-alpha.20240807100243

11 months ago

1.2.5-alpha

1 year ago

1.2.38-alpha

11 months ago

1.3.0-alpha.20240710155619

1 year ago

11 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

1 year ago

1.3.0-alpha.20240819011229

11 months ago

11 months ago

1 year ago

1 year ago

12 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago