Skip to main content

User Management Overview

What is User Management?

User Management is Sumo Ledger’s access-control module for defining roles, users, and user types. It controls who can sign in, what features they can access, and how users are categorized across the platform.

User Management sits under Configurations → System Settings and consists of two primary areas:

AreaPurpose
RolesDefine permission sets by assigning system features to named roles
UsersCreate user accounts and assign roles and user types

A related setting — User Types under Accounting Settings — provides an additional classification layer used when assigning users and configuring business rules.


User Management Capabilities

CapabilityDescription
Role-based access controlCreate roles and map them to system features (for example, DASHBOARD, CONF_PRODUCT, EXEC_JV).
User account managementAdd users with username, password, and an initial role assignment.
Role assignmentAssign or change roles for existing users through the Assign Role dialog.
User type assignmentClassify users with types such as admin through Assign User Type.
Feature granularityControl access at the module level — configuration screens, reports, transactions, and logs.
Bulk permission setupUse Create All Permission to initialize the full feature set for a role.
Load configuration in memoryPublish role and user changes to the running service.

User Management lives inside the Configurations module.

  1. Click Configurations in the main sidebar.
  2. Under System Settings, select Roles or Users.
SectionURLPurpose
Roles/settings/role/listManage roles and feature permissions
Users/settings/auth-user/listManage user accounts and assignments

Related setting:

SectionLocationPurpose
User TypesConfigurations → Accounting Settings → User TypesDefine user type categories used in assignments

How Roles, Users, and Features Connect

┌──────────────────────────────────────────┐
│ Administrator creates a Role │
│ (for example, RM, Sumo User Guide) │
└──────────────────────────────────────────┘


┌──────────────────────────────────────────┐
│ Features assigned to the Role │
│ (Set Feature or Create All Permission) │
└──────────────────────────────────────────┘


┌──────────────────────────────────────────┐
│ User account created (+ Add User) │
└──────────────────────────────────────────┘


┌──────────────────────────────────────────┐
│ Role assigned to the User │
│ (at creation or via Assign Role) │
└──────────────────────────────────────────┘


┌──────────────────────────────────────────┐
│ User Type assigned (optional) │
│ (via Assign User Type) │
└──────────────────────────────────────────┘


┌──────────────────────────────────────────┐
│ User signs in with role-based access │
└──────────────────────────────────────────┘
  1. An administrator creates a Role and assigns Features that define what the role can access.
  2. A User account is created with a username, password, and role.
  3. Optionally, a User Type is assigned for additional classification.
  4. When the user signs in, the system enforces permissions based on their assigned role’s features.

Typical Roles

RoleDescriptionExample Features
ADMINFull administrative accessAll features (typically unrestricted)
USERStandard user for viewing reportsReport-oriented access
API_USERService or integration accountAUTH_SERVICE
RMRelationship ManagerAUTH_SERVICE, DASHBOARD, TASKS
BMBranch ManagerTASKS
Sumo User GuideDemo/training role with broad accessConfiguration, transactions, reports, and logs

ModuleRelationship
Form BuilderMaker, Checker, and Approver roles on forms map to user types or roles.
Process ConfigurationProcess execution visibility depends on user permissions.
Product ConfigurationRequires CONF_PRODUCT feature for access.
COA MappingRequires CONF_COA_MAPPING feature for access.