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

# User Management

> Manage users and profiles in Fentu Connect

## Overview

User Management in Fentu Connect allows you to create and manage user accounts, assign permissions through profiles, and control access to different features of the application.

***

## Users

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/user-management/users-list.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=416f07cde55e406f907841c138d93891" alt="Users List" width="1280" height="720" data-path="images/fentu-connect/user-management/users-list.png" />

The Users page displays all user accounts with:

| Column      | Description                           |
| ----------- | ------------------------------------- |
| **Avatar**  | User profile picture                  |
| **Name**    | User's display name                   |
| **Email**   | User's email address (used for login) |
| **Actions** | Edit or delete the user               |

### Creating a User

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/user-management/users-new.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=1ed9ee98e9755f6dc3c1b5c3b296db2c" alt="New User Form" width="1280" height="720" data-path="images/fentu-connect/user-management/users-new.png" />

To create a new user:

1. Click the **New** button from the Users list
2. Fill in the required fields
3. Click **Save**

| Field                | Description                         | Required |
| -------------------- | ----------------------------------- | -------- |
| **Name**             | The user's full display name        | Yes      |
| **Email**            | Email address used for login        | Yes      |
| **Password**         | Account password                    | Yes      |
| **Confirm Password** | Re-enter password for verification  | Yes      |
| **Avatar**           | Upload a profile picture (optional) | No       |

<Tip>
  Use business email addresses for user accounts. This makes it easier to manage access when employees leave the organization.
</Tip>

### Editing a User

1. Find the user in the list
2. Click the edit icon in the Actions column
3. Modify the fields (leave password blank to keep existing)
4. Click **Save**

### Deleting a User

1. Find the user in the list
2. Click the delete icon in the Actions column
3. Confirm the deletion

<Warning>
  Deleting a user is permanent. Consider deactivating users instead if you may need to restore access later.
</Warning>

***

## Profiles

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/user-management/profiles-list.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=834f2ff6543677c2e54d54901d6ff3af" alt="Profiles List" width="1280" height="720" data-path="images/fentu-connect/user-management/profiles-list.png" />

Profiles define sets of permissions that can be assigned to users. Each profile controls which features and menu items a user can access.

### Profile List

| Column      | Description                |
| ----------- | -------------------------- |
| **Name**    | The profile name           |
| **Actions** | Edit or delete the profile |

### Profile Detail

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/user-management/profiles-detail.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=01ccd57549602f6b872a174bc1ea97a8" alt="Profile Detail" width="1280" height="720" data-path="images/fentu-connect/user-management/profiles-detail.png" />

Click on a profile to view its details:

* **Edit Button** - Modify profile settings
* **Delete Button** - Remove the profile
* **Details Tab** - View profile information

### Creating a Profile

1. Click **New** from the Profiles list
2. Enter a name and description
3. Configure permissions
4. Click **Save**

### Editing a Profile

<img src="https://mintcdn.com/fentu/VaII27VqRBHw2baV/images/fentu-connect/user-management/profiles-edit.png?fit=max&auto=format&n=VaII27VqRBHw2baV&q=85&s=bba2ad07503864939dd985ddc0701f35" alt="Profile Edit Form" width="1280" height="720" data-path="images/fentu-connect/user-management/profiles-edit.png" />

1. Navigate to the profile detail
2. Click the **Edit** button
3. Configure the profile settings

| Field           | Description                       |
| --------------- | --------------------------------- |
| **Name**        | Display name for the profile      |
| **Description** | Notes about the profile's purpose |

### Permission Checkboxes

The profile edit form shows a list of features with checkboxes:

| Permission            | Description                         |
| --------------------- | ----------------------------------- |
| **Visible**           | Master toggle for visibility        |
| **Home**              | Access to the home dashboard        |
| **Connect Wizard**    | Access to the Connect Wizard        |
| **Connector Set**     | Access to Connector Set management  |
| **Connection Config** | Access to Connection Configuration  |
| **Connector**         | Access to Connector management      |
| **Connect Object**    | Access to Connect Object management |
| **Inbound**           | Access to Inbound connections       |
| **Outbound**          | Access to Outbound connections      |
| **Users**             | Access to User management           |
| **Profiles**          | Access to Profile management        |

<Note>
  Checked permissions grant access; unchecked permissions hide those features from users with this profile.
</Note>

### Deleting a Profile

1. Navigate to the profile detail or list
2. Click the delete icon or Delete button
3. Confirm the deletion

<Warning>
  Deleting a profile may affect users assigned to it. Reassign users to a different profile before deleting.
</Warning>

***

## Profile Configuration Best Practices

<AccordionGroup>
  <Accordion title="Create Role-Based Profiles" icon="user-gear">
    Design profiles around job functions:

    * **Administrator** - Full access to all features
    * **Integration Manager** - Access to connections and objects, no user management
    * **Viewer** - Read-only access to monitor sync status
  </Accordion>

  <Accordion title="Principle of Least Privilege" icon="shield-halved">
    Give users only the permissions they need:

    * Not everyone needs access to Connection Config (credentials)
    * Viewer roles shouldn't need edit capabilities
    * User management should be restricted to administrators
  </Accordion>

  <Accordion title="Document Profile Purposes" icon="file-lines">
    Use the description field to explain:

    * Who should have this profile
    * What access it provides
    * When it was last reviewed
  </Accordion>

  <Accordion title="Review Periodically" icon="calendar-check">
    Audit profiles and user assignments regularly:

    * Remove access for departed employees
    * Adjust permissions as job roles change
    * Review administrator access quarterly
  </Accordion>
</AccordionGroup>

***

## Common User Management Scenarios

<AccordionGroup>
  <Accordion title="New Employee Onboarding" icon="user-plus">
    1. Create a new user account with their email
    2. Set a temporary password
    3. Assign the appropriate profile based on their role
    4. Have them change their password on first login
  </Accordion>

  <Accordion title="Employee Role Change" icon="user-pen">
    1. Review the user's current profile
    2. Either assign them to a different profile, or
    3. Create a new profile if their access needs are unique
  </Accordion>

  <Accordion title="Employee Departure" icon="user-minus">
    1. Immediately delete or deactivate the user account
    2. Review any connections they managed
    3. Transfer ownership of integrations if needed
  </Accordion>

  <Accordion title="Restricting Sensitive Access" icon="lock">
    For sensitive operations like Connection Config (which stores credentials):

    1. Create a restricted profile without Connection Config access
    2. Assign to users who don't need to manage credentials
    3. Only grant Connection Config access to trusted administrators
  </Accordion>
</AccordionGroup>

***

## Common Questions

<AccordionGroup>
  <Accordion title="How do I reset a user's password?" icon="question">
    Edit the user and enter a new password in the password fields. The user will need to use the new password on their next login.
  </Accordion>

  <Accordion title="Can a user have multiple profiles?" icon="question">
    Users are typically assigned one profile at a time. If a user needs a unique combination of permissions, create a new profile for their specific needs.
  </Accordion>

  <Accordion title="What happens if I delete the only admin?" icon="question">
    Be careful not to delete or restrict all administrator accounts. Always maintain at least one account with full administrative access.
  </Accordion>

  <Accordion title="Can I see user activity or login history?" icon="question">
    Check with your system administrator for audit log capabilities. User activity tracking may be available through system logs.
  </Accordion>
</AccordionGroup>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Introduction" icon="home" href="/fentu-connect/introduction">
    Overview of Fentu Connect features
  </Card>

  <Card title="Connection Config" icon="gear" href="/fentu-connect/connection-config">
    Manage sensitive connection credentials
  </Card>
</CardGroup>
