> ## Documentation Index
> Fetch the complete documentation index at: https://docs.figorisk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# User Management

> Add, manage, and configure user access in FigoRisk

## Overview

User management in FigoRisk allows you to control who has access to your GRC platform, what they can do, and how they interact with the system.

***

## User Roles

FigoRisk uses role-based access control (RBAC) with four primary roles:

<CardGroup cols={2}>
  <Card title="Admin" icon="user-shield">
    **Full access to everything** **Can:** - Manage all users - Configure system
    settings - Access all modules - Approve/reject actions - View all reports
    **Best for:** IT administrators, GRC managers
  </Card>

  <Card title="Maker" icon="pen-to-square">
    **Create and edit content** **Can:** - Create risks, assets, controls - Edit
    existing records - Submit for approval - Generate reports **Cannot:** -
    Approve their own submissions - Delete records - Manage users **Best for:**
    Risk analysts, compliance officers
  </Card>

  <Card title="Checker" icon="circle-check">
    **Review and approve content** **Can:** - Review submissions -
    Approve/reject changes - View all records - Generate reports **Cannot:** -
    Create new records - Edit records directly - Manage users **Best for:**
    Managers, supervisors, auditors
  </Card>

  <Card title="Viewer" icon="eye">
    **Read-only access** **Can:** - View risks, assets, controls - Generate
    reports - Export data **Cannot:** - Create or edit records - Approve
    submissions - Delete anything **Best for:** Executives, stakeholders,
    external auditors
  </Card>
</CardGroup>

***

## Adding New Users

### Single User Creation

<Steps>
  <Step title="Navigate to Users">
    Click **Users** in the main navigation menu
  </Step>

  <Step title="Click Add User">
    Click the **+ Add User** button in the top right
  </Step>

  <Step title="Fill User Details">
    **Basic Information:** - **First Name**: User's first name - **Last Name**:
    User's last name - **Email**: User's work email (used for login) -
    **Phone**: Contact phone number (optional) **Account Settings:** - **Role**:
    Select from Admin, Maker, Checker, or Viewer - **Department**: Assign to a
    department - **Status**: Active or Inactive **Optional Settings:** - **Job
    Title**: User's position - **Employee ID**: Internal employee identifier -
    **Manager**: Select reporting manager
  </Step>

  <Step title="Set Permissions">
    **Module Access** (Check applicable modules): - ☑ Risk Management - ☑
    Compliance Management - ☑ Asset Management - ☑ Incident Management - ☑
    Reporting & Analytics
  </Step>

  <Step title="Send Invitation">
    Choose how to onboard the user: **Option 1: Email Invitation (Recommended)**

    * User receives email with setup link - They set their own password - More
      secure **Option 2: Set Password** - You create a temporary password - Share
      credentials with user securely - User must change on first login
  </Step>

  <Step title="Create User">Click **Create User** to save</Step>
</Steps>

<Info>
  Users will receive an email invitation with instructions to set up their
  account and login credentials.
</Info>

***

## Bulk User Import

For adding multiple users at once:

<Steps>
  <Step title="Download Template">
    1. Navigate to **Users** page 2. Click **Bulk Import** 3. Download the CSV
       template
  </Step>

  <Step title="Fill Template">
    Open the CSV file and fill in user details: | First Name | Last Name | Email
    \| Role | Department | |-----------|-----------|-------|------|-----------| |
    John | Doe | [john@company.com](mailto:john@company.com) | Maker | IT | | Jane | Smith |
    [jane@company.com](mailto:jane@company.com) | Checker | Compliance | | Bob | Johnson | [bob@company.com](mailto:bob@company.com)
    \| Viewer | Finance |
  </Step>

  <Step title="Upload File">
    1. Click **Choose File** 2. Select your filled CSV 3. Click **Upload**
  </Step>

  <Step title="Review & Confirm">
    Review the preview of users to be imported - Check for errors - Verify role
    assignments - Confirm department mappings
  </Step>

  <Step title="Complete Import">
    Click **Import Users** to create all accounts All users will receive email
    invitations automatically
  </Step>
</Steps>

<Tip>
  **Pro Tip:** Start with a small test batch (3-5 users) to ensure your CSV is
  formatted correctly before importing hundreds of users.
</Tip>

***

## Managing Existing Users

### Edit User Information

<Tabs>
  <Tab title="Basic Info">
    **To update user details:** 1. Go to **Users** page 2. Click on the user's
    name 3. Click **Edit** button 4. Update information: - Name and contact
    details - Job title and employee ID - Department assignment 5. Click **Save
    Changes**
  </Tab>

  <Tab title="Role Changes">
    **To change user role:** 1. Open user profile 2. Click **Edit** 3. Select
    new role from dropdown 4. Click **Save**

    <Warning>
      Role changes take effect immediately. User permissions will update on
      their next action.
    </Warning>
  </Tab>

  <Tab title="Module Access">
    **To modify module permissions:** 1. Open user profile 2. Click **Edit
    Permissions** 3. Toggle modules on/off: - Risk Management - Compliance -
    Asset Management - Incident Management - Reporting 4. Click **Save
    Permissions**
  </Tab>
</Tabs>

### Deactivate User

When an employee leaves or no longer needs access:

<Steps>
  <Step title="Find User">Navigate to **Users** and search for the user</Step>

  <Step title="Open Profile">Click on the user's name</Step>

  <Step title="Deactivate Account">
    Click **Deactivate** button **What happens:** - User cannot log in - Active
    sessions are terminated - Data and history are preserved - Can be
    reactivated later if needed
  </Step>

  <Step title="Confirm">Click **Confirm Deactivation**</Step>
</Steps>

<Info>
  **Deactivated vs Deleted:** Deactivating preserves audit trails and historical
  data. Deleting permanently removes the user (not recommended).
</Info>

***

## User Groups & Teams

Create groups for easier permission management:

### Create a Group

<Steps>
  <Step title="Access Groups">Go to **Users** → **Groups**</Step>

  <Step title="Create New Group">
    Click **+ Create Group** Fill in: - **Group Name**: e.g., "Security Team",
    "Audit Committee" - **Description**: Purpose of the group - **Default
    Role**: Role for all members (optional)
  </Step>

  <Step title="Add Members">
    * Search and select users - Or bulk select from department
  </Step>

  <Step title="Set Group Permissions">Configure what the group can access</Step>

  <Step title="Save Group">Click **Create Group**</Step>
</Steps>

**Common groups to create:**

* Executive Leadership
* Security Operations Team
* Compliance Officers
* Risk Assessment Committee
* IT Operations
* Audit Team

***

## Password Management

### Reset User Password

<Tabs>
  <Tab title="Admin Reset">
    **As an admin, reset any user's password:** 1. Navigate to user profile 2.
    Click **Reset Password** 3. Choose option: - **Email Reset Link**: User
    receives password reset email - **Generate Temporary Password**: Create
    password and share with user 4. User must change password on next login
  </Tab>

  <Tab title="User Self-Service">
    **Users can reset their own password:** 1. From login page, click **Forgot
    Password?** 2. Enter email address 3. Receive reset link via email 4. Follow
    link and set new password 5. Login with new credentials
  </Tab>
</Tabs>

### Force Password Change

Require a user to change their password:

1. Open user profile
2. Click **Force Password Reset**
3. On next login, user must set a new password

<Info>
  **Use this when:** Suspected account compromise, employee role change, or
  routine security policy enforcement.
</Info>

***

## Session Management

### View Active Sessions

See who's currently logged in:

1. Go to **Users** → **Active Sessions**
2. View list showing:
   * Username
   * Login time
   * IP address
   * Device type
   * Last activity

### Terminate Sessions

<AccordionGroup>
  <Accordion icon="user" title="Individual User">
    1. Find user in Active Sessions 2. Click **Terminate Session** 3. User is
       immediately logged out
  </Accordion>

  <Accordion icon="users" title="All Users">
    1. Click **Terminate All Sessions** (top right) 2. Confirm action 3. All
       users are logged out
       <Warning>Use sparingly! This logs out everyone including you.</Warning>
  </Accordion>

  <Accordion icon="shield" title="Suspicious Activity">
    If you notice suspicious activity: 1. Terminate the session immediately 2.
    Reset the user's password 3. Contact the user to verify their activity 4.
    Review audit logs for unauthorized actions
  </Accordion>
</AccordionGroup>

***

## Access Logs & Audit Trail

Monitor user activity:

### View User Activity

<Steps>
  <Step title="Access Audit Logs">Go to **Users** → **Activity Logs**</Step>

  <Step title="Filter Logs">
    Filter by: - **User**: Specific user or all - **Action Type**: Login,
    Create, Edit, Delete, etc. - **Date Range**: Last 7 days, 30 days, custom -
    **Module**: Risk, Compliance, Assets, etc.
  </Step>

  <Step title="Review Activity">
    See detailed logs showing: - Timestamp - User who performed action - Action
    type - Affected resource - IP address - Status (Success/Failed)
  </Step>

  <Step title="Export Logs">Click **Export** to download logs as CSV</Step>
</Steps>

**Common audit checks:**

* Failed login attempts (potential security threat)
* After-hours activity (unusual access patterns)
* Bulk deletions (potential data loss)
* Permission changes (privilege escalation)

***

## User Notifications

Configure how users receive notifications:

### Per-User Settings

1. Open user profile
2. Click **Notification Settings**
3. Configure:

<Tabs>
  <Tab title="Email Notifications">
    * **Risk Alerts**: High/Critical risks assigned to user - **Approval
      Requests**: Pending items requiring approval - **Compliance Reminders**:
      Upcoming compliance deadlines - **System Alerts**: Important system
      notifications **Frequency:** - Immediate - Daily digest - Weekly summary
  </Tab>

  <Tab title="In-App Notifications">
    * **Real-time Alerts**: Pop-up notifications - **Notification Center**:
      Badge with unread count - **Desktop Notifications**: Browser notifications
  </Tab>

  <Tab title="Report Subscriptions">
    Subscribe users to automated reports: - **Risk Dashboard**: Weekly summary -
    **Compliance Status**: Monthly report - **Incident Reports**: As they occur
  </Tab>
</Tabs>

***

## User Onboarding Checklist

When adding new users, ensure they complete these steps:

<Steps>
  <Step title="Account Setup">
    * [ ] User receives invitation email - \[ ] User sets up password - \[ ] User
      completes profile information
  </Step>

  <Step title="Training">
    * [ ] Review FigoRisk overview - \[ ] Module-specific training (based on
      role) - \[ ] Practice creating/editing records
  </Step>

  <Step title="Access Verification">
    * [ ] Test login credentials - \[ ] Verify module access - \[ ] Check
      notification settings
  </Step>

  <Step title="First Tasks">
    * [ ] Review assigned risks/tasks - \[ ] Join relevant groups/teams - \[ ] Set
      up dashboard preferences
  </Step>
</Steps>

***

## Common User Management Tasks

<AccordionGroup>
  <Accordion icon="user-plus" title="Onboarding New Employee">
    1. Create user account with appropriate role 2. Assign to department and
       manager 3. Send invitation email 4. Schedule training session 5. Assign
       initial tasks/responsibilities
  </Accordion>

  <Accordion icon="arrow-right-arrow-left" title="Employee Department Transfer">
    1. Update user's department 2. Reassign pending tasks to new team 3. Update
       group memberships 4. Notify user of changes
  </Accordion>

  <Accordion icon="arrow-up" title="Role Promotion">
    1. Update user role (e.g., Maker → Checker) 2. Adjust module permissions if
       needed 3. Update group memberships 4. Notify user of new responsibilities
  </Accordion>

  <Accordion icon="user-xmark" title="Employee Offboarding">
    1. Deactivate user account 2. Reassign active tasks to others 3. Transfer
       ownership of records 4. Archive user data (keep for audit trail) 5. Remove
       from all groups 6. Document offboarding date and reason
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion icon="envelope-circle-check" title="User didn't receive invitation email">
    **Check:** 1. Spam/junk folder 2. Email address is correct 3. Organization
    email server isn't blocking **Solution:** - Resend invitation from user
    profile - Or manually share login credentials
  </Accordion>

  <Accordion icon="lock" title="User can't login">
    **Possible causes:** 1. Account is deactivated 2. Too many failed attempts
    (locked) 3. Incorrect credentials 4. Password expired **Solution:** - Check
    account status - Unlock account if locked - Reset password
  </Accordion>

  <Accordion icon="ban" title="User can't access a module">
    **Check:** 1. User role has permission 2. Module is enabled for user 3. User
    is in correct group **Solution:** - Update role or permissions - Enable
    module access in user profile
  </Accordion>

  <Accordion icon="clock" title="User session expires too quickly">
    **Solution:** - Admin: Go to **Settings** → **Security** - Increase session
    timeout duration - Apply changes (affects all users)
  </Accordion>
</AccordionGroup>

***

## Best Practices

<Card icon="lightbulb" title="User Management Best Practices">
  **Security:** - Review user access quarterly - Remove inactive users promptly

  * Use principle of least privilege - Enable multi-factor authentication (MFA)
    when available **Organization:** - Create clear naming conventions - Use
    groups for permission management - Document role definitions - Maintain
    updated contact information **Compliance:** - Keep audit logs for required
    period - Review access logs monthly - Document user access changes - Regular
    access certification reviews
</Card>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Asset Management" icon="database" href="/guides/asset-management">
    Build your asset inventory
  </Card>

  <Card title="Risk Assessment" icon="shield-check" href="/guides/risk-assessment">
    Start assessing risks
  </Card>

  <Card title="Compliance Management" icon="list-check" href="/guides/compliance-management">
    Manage compliance requirements
  </Card>

  <Card title="API Access" icon="code" href="/api-reference/introduction">
    Set up API integrations
  </Card>
</CardGroup>
