Entities

Entities represent the people, organizations, and government bodies involved in your cases. They serve as the legal owners and custodians of evidence items, enabling proper chain-of-custody tracking.

Entity Types

DFIRe supports five entity types, each representing a different kind of legal entity that may be involved in an investigation or incident:

Type Icon Purpose
Person User icon Individual people such as suspects, witnesses, employees, and custodians
Organization Building icon Companies, businesses, and private organizations
Government Globe icon Government agencies, regulatory bodies, and law enforcement
Team Users icon Teams, departments, or other organizational units
Other Generic icon Anything that doesn't fit the above categories. Vendors, unknown parties, placeholders

Entities are defined once and can be linked to evidence items across multiple cases.

Managing Entities

The Entities page, accessible from the header bar, lists every entity in a table. By default the table shows Name, Type, Notes, Items and Updated. Items is the number of times evidence names the entity as Legal Owner or Primary User (see below). Open Columns to show Contact, Address or Created. Uncheck a column to hide it, or drag its handle to change its position. Long notes, contact details and addresses are cut to fit. Point at one to read all of it.

Click a column header to sort by that column, and click it again to reverse the order. The table opens sorted by name. The count above the table shows how many entities there are. While you search or filter, it shows how many of them match, for example 2 of 12 entities.

Search entities finds an entity by its name, notes or contact details. Filter narrows the directory by Name, Type, Notes, Contact, Address, Created or Updated, for example Type equals Person. Each filter shows under the toolbar. Click a filter to change it, or Clear filters to remove them all. A reload or a shared link keeps the search and the filters.

Click an entity's name or row to open it. To open an entity in a new tab, middle-click its name. New Entity and the delete button appear only if your role allows you to add or delete entities. If the list cannot load, the page shows an error.

Click New Entity to create a new entity. When creating or editing an entity, the following fields are available:

  • Name - The full name of the person, organization, or group
  • Type - The entity type (Person, Organization, Government, Team, or Other)
  • Internal Notes - Free-text notes for internal reference
  • Contact Info - Contact details such as email or phone
  • Physical Address - A postal or site address

Linking Entities to Evidence

An evidence item can reference entities through two distinct roles:

  • Legal Owner. The person or organization that legally owns the item (e.g., the company that issued a corporate laptop).
  • Primary User. The individual who actually uses the item (e.g., the employee assigned that laptop). Often different from the legal owner.

Both roles appear on the evidence item detail view. The Items count in the Entities directory combines both relationships so you can see the total footprint of an entity at a glance.

A single entity can be linked to evidence items across multiple cases, making it easy to track all evidence associated with a particular person or organization.

Custody Transfers

Entities also appear in chain-of-custody transfers on evidence items. When recording a custody transfer (intake, transfer, released, correction), you can identify the from and to parties by picking entities from the directory. This gives you a persistent, audit-log-grade trail of who held each item and when, reusing entity records across cases.

Seeing an entity on evidence and in custody transfers needs the permission to view legal entities. Without it, the legal owner and the primary user are empty, and a custody entry names an entity party only as Legal entity. A timeline entry about such a transfer shows only its type, time and author. An action assigned to an entity shows as External assignee, as does any other assignee with no account here. Search does not find an item through its owner or primary user.

Entities are managed system-wide. Changes to an entity's details are reflected everywhere that entity is referenced.

Configuring Entities

The entity list is managed from the Entities page in the header bar, where entities can be created, edited, and deleted. It is not part of Settings.

Deleting an entity always works, also when a closed or archived case refers to it. DFIRe clears it from the evidence items that list it as owner or primary user and removes it from projects. Custody transfers lose their link to it but keep the name they recorded, so the chain of custody stays complete and still verifies. The timeline entries of those transfers and the actions assigned to the entity keep its name too. The audit log, exports and backups keep their copies. Rename the entity instead when its record should stay.