nocobase-app-plugin-users

Integrates user management pages, APIs, and role scopes into NocoBase applications.

9|3|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/nocobase/nocobase3 --skill nocobase-app-plugin-users-nocobase
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nocobase-app-plugin-users
Source: https://github.com/nocobase/nocobase3/tree/main/packages/plugins/app-plugin-users/skills/nocobase-app-plugin-users
Command: npx skills add https://github.com/nocobase/nocobase3 --skill nocobase-app-plugin-users-nocobase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? NocoBase applications need a consistent way to add user administration pages and APIs without modifying the Users plugin source or duplicating Authentication and Authorization logic. This Skill guides developers through registering the Users plugin, placing its page, enforcing permissions, and exposing application-specific role scopes through public server contracts. ## Core Features & Use Cases - Plugin Registration and Page Placement: Register Authentication, Authorization, and Users plugins, then mount the users page under settings or app navigation with path and access control. - Permission Enforcement: Configure page:users/access and granular user resource actions (read, create, update, disable, enable, assign-role, reset-password, revoke-sessions) checked on every HTTP route. - Application Role Scopes: Register a UserRoleScope via userRoleScopeRegistryToken to own role options, assignments, atomic replacement, and disable guards within caller-managed transactions. - Use Case: A business plugin needs a department-based role scope shown on the Users page. Resolve the registry token in its ServiceProvider, register the scope during boot(), and enforce invariants like the last-administrator rule on the server. ## Quick Start Register the Authentication, Authorization, and Users plugins in my NocoBase app and mount the users page at /settings/users with the correct role permissions.

Frequently Asked Questions about nocobase-app-plugin-users

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a user management page to a NocoBase app?▼

Register Authentication, Authorization, and Users in the Client and Server plugin arrays, then configure the client factory with a mount and path. For example, users({ mount: 'settings', path: '/users' }) produces /settings/users, and you must grant page:users/access to roles that may open it.

How do I register a custom role scope in the NocoBase Users page?▼

Resolve userRoleScopeRegistryToken in your application or business plugin ServiceProvider and register one UserRoleScope during boot(). The scope owns its options, assignment lookup, filtering, atomic replacement, and disable guards, and should be unregistered during shutdown().

What permissions does the NocoBase Users API require?▼

Every HTTP route requires Authentication and Authorization, checking a user resource with actions like read, create, update, disable, enable, assign-role, reset-password, or revoke-sessions. Account creation checks both create and assign-role, and anonymous requests return 401 while missing actions return 403.

Can the Users plugin modify Authentication's user storage?▼

No. Authentication owns user identity, credentials, account state, password hashing, and Sessions. The Users plugin only owns the management API, built-in page, orchestration transaction, user authorization handler, and role-scope registry, and scopes must not write Authentication's internal tables.

What are the limitations of the NocoBase Users plugin?▼

The plugin does not provide user deletion or invitations, and it creates no roles or grants by itself. Conditional grants are not accepted as unrestricted user-management grants, and disabling a user invalidates their HTTP Sessions and Realtime connections.