Files
sonobarr/doc/user-management.md
2026-03-03 08:59:00 -03:00

37 lines
1.3 KiB
Markdown

# User Management And Artist Approval
## Scope
This document describes the user access flags that control account status, administrative privileges, and artist approval behavior.
## User Flags
The `users` table includes these access-control fields:
- `is_active`: Controls whether the user can authenticate.
- `is_admin`: Grants access to admin routes and direct artist addition.
- `auto_approve_artist_requests`: Allows non-admin users to add artists directly without waiting for manual admin approval.
## Admin UI Controls
The user management page at `/admin/users` provides toggles for:
- Active account
- Admin privileges
- Auto approve artist additions
Admins can set these flags when creating a user and when editing an existing user.
## Artist Addition And Request Flow
Server-side behavior is enforced in `DataHandler`:
- Users with `is_admin = true` or `auto_approve_artist_requests = true` can add artists directly to Lidarr.
- Users without either flag submit a pending artist request for manual admin approval.
- Unauthorized direct add attempts are rejected with an "Approval Required" message.
The frontend receives permission metadata from the socket `user_info` payload and renders the action button accordingly:
- Direct-add users see the default add action.
- Manual-approval users see the request action.