Managing Users

Forjinn provides a dedicated Users page that displays all registered platform users and gives administrators the tools to manage accounts, assign roles, and control access.

Accessing the Users Page

1. From the left-hand sidebar, navigate to Admin.
2. Click on Users to open the user management page.

User List Overview

The Users page displays a table of all registered accounts, showing key information for each user:

• Name and Email: User's display name and login email address.
• Role(s): The roles currently assigned to the user.
• Status: Whether the account is active, suspended, or pending invitation.
• Last Login: Timestamp of the user's most recent session.
• Created: Date the account was created.

Adding a New User

1. On the Users page, click Invite User or Add New User.
2. Fill in the user details:
   • Email: The user's email address (used as login identifier).
   • Name: The user's full or display name.
   • Role(s): Select one or more roles to assign. The user's permissions will be the combined set of all assigned roles.
3. Click Invite or Create User.
   • If invited, the user receives an email with a link to set up their account.
   • If created directly, the admin may set an initial password and require the user to change it on first login.

Editing a User

1. From the Users page, locate the user you want to modify.
2. Click the Edit button or icon for that user.
3. Update fields as needed:
   • Change display name or email.
   • Add, remove, or change assigned roles.
   • Reset password or send a new invitation link.
4. Click Save to apply changes.

Suspending a User

Suspending a user disables their account and prevents further login without permanently deleting their data:

1. From the Users page, locate the user.
2. Click the Suspend button or toggle the account status to Suspended.
3. Confirm the action. The user will be logged out immediately and unable to sign back in.

To re-enable a suspended user, change their status back to Active.

Deleting a User

1. From the Users page, locate the user you want to delete.
2. Click the Delete button or icon.
3. Confirm the deletion when prompted.

Important: Deleting a user is irreversible. All associated data—such as API keys, personal settings, and owned resources—will be affected. Consider suspending the user first if deletion isn't strictly necessary.

User Roles and Permissions

User access is controlled through roles. Each user can be assigned one or more roles, and their effective permissions are the union of all assigned roles. See Managing Roles for details on role creation and Permissions for the full permission key reference.

Best Practices

• Review regularly: Audit the user list periodically to remove stale accounts and ensure correct role assignments.
• Use suspension over deletion: When a user leaves temporarily, suspend rather than delete to preserve audit trails and owned resources.
• Limit admin accounts: Only assign the Admin role to users who genuinely need full platform access.
• Track login activity: Use the Login Activity page to monitor user sessions and detect anomalies.