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

# Configure the EDR Library Item

> Configure the EDR Library Item in Iru Endpoint. Set posture modes, user alerts, behavioral detections, and custom allow and block lists.

<Callout icon="list-check" color="#71118C" iconType="regular">This guide applies to Mac computers and Windows devices</Callout>

<Warning>
  The [Endpoint Detection and Response](/en/endpoint/endpoint-detection-response-edr/endpoint-detection-and-response-edr-overview) add-on is required to use this Library Item.
</Warning>

### About EDR Library Item Configuration

The EDR Library Item is the core component of Iru Endpoint EDR. Configure detection settings, posture modes, end-user notifications, and custom allow and block lists to meet your organization's security requirements.

### Adding an EDR Library Item

To add this Library Item to your Iru Endpoint Library, follow the steps in [Library Overview](/en/endpoint/library/library-items-profiles/library-overview).

<Steps>
  <Step title="Add the EDR Library Item">
    Open the Iru Endpoint Web App and navigate to your **Library**. Add a new **EDR** Library Item and give it a **Name**.
  </Step>

  <Step title="Assign to Blueprints">
    Assign the Library Item to the [Blueprints](/en/endpoint/blueprints/assignment-maps/creating-a-blueprint) containing the devices you want to protect.

    <Frame>
      <img src="https://mintcdn.com/iru/xTYPpu1SsBsdAQc_/assets/media/images/edr-threats-create-library-item.png?fit=max&auto=format&n=xTYPpu1SsBsdAQc_&q=85&s=00ee8d918940ade1a3c62390c2fd6e8e" alt="EDR Library Item configuration interface showing settings or Blueprint assignment" width="1802" height="980" data-path="assets/media/images/edr-threats-create-library-item.png" />
    </Frame>
  </Step>
</Steps>

Configuration differs by platform. Select **macOS** or **Windows** below.

<Tabs>
  <Tab title="macOS" icon="apple" iconType="brands">
    ### Configuring File Detection Settings

    Configure individual posture mode preferences for Malware and PUPs. **Detect** mode scans and reports known malicious items. **Protect** mode scans, reports, and automatically quarantines known malicious items.

    <Steps>
      <Step title="Configure Malware Posture">
        Select **Detect** or **Protect** for **Malware Posture**.
      </Step>

      <Step title="Configure PUP Posture">
        Select **Detect** or **Protect** for **PUP Posture**.
      </Step>

      <Step title="Configure Notification Settings">
        If either Malware or PUP posture is set to **Protect**, a **Send user alerts** toggle becomes available to enable or disable end-user notifications.

        <Note>
          You can click **Expand preview** to see a sample of the user notifications.
        </Note>

        <Frame>
          <img src="https://mintcdn.com/iru/6OFhBTxsQJ8Xkobq/assets/media/images/edr-threats-library-file-detect-settings.png?fit=max&auto=format&n=6OFhBTxsQJ8Xkobq&q=85&s=21ed4706eb607ef65695049237e50c62" alt="File detection settings for Malware and PUP posture modes" width="1794" height="1550" data-path="assets/media/images/edr-threats-library-file-detect-settings.png" />
        </Frame>
      </Step>
    </Steps>

    ### Configuring Behavioral Detections

    Behavioral detections are turned on by default when creating a new EDR Library Item, but can be turned off to suit certain workflows.

    <Warning>
      Suspicious behavioral detections are automatically listed in the Detections table with an informational status to highlight unusual activities that may warrant attention. These detections are designed to provide visibility and cannot have their posture mode configured.
    </Warning>

    <Steps>
      <Step title="Enable Behavioral Detections">
        Toggle the switch to enable Behavioral detections.
      </Step>

      <Step title="Configure Malicious Behavior Posture">
        Under **Malicious behavior posture**, select either Detect or Protect.

        * **Detect** mode identifies and reports malicious behavioral detections
        * **Protect** mode identifies, reports, and blocks malicious behavioral detections
      </Step>

      <Step title="Configure Notification Settings">
        If Malicious behavior posture is set to Protect, a **Send user alerts** toggle becomes available to enable or disable user notifications.

        <Note>
          You can click **Expand preview** to see a sample of the user notifications.
        </Note>

        <Frame>
          <img src="https://mintcdn.com/iru/6OFhBTxsQJ8Xkobq/assets/media/images/edr-threats-library-behavioral-detect-settings.png?fit=max&auto=format&n=6OFhBTxsQJ8Xkobq&q=85&s=eb1bd90476490ba782a3380cd8958101" alt="Behavioral detection settings with Malicious behavior posture options" width="1790" height="1286" data-path="assets/media/images/edr-threats-library-behavioral-detect-settings.png" />
        </Frame>
      </Step>
    </Steps>

    ### Security Events in Self Service

    End users can view a list of quarantined files and blocked processes on their Mac computers by opening **Self Service** and clicking **Security events** from the left-hand navigation menu.

    <Frame>
      <img src="https://mintcdn.com/iru/6OFhBTxsQJ8Xkobq/assets/media/images/edr-threats-self-service-security-events.png?fit=max&auto=format&n=6OFhBTxsQJ8Xkobq&q=85&s=ab7c887c53e6f0b3b5a726a07fff0de9" alt="Configure the EDR Library Item step or screen" width="2286" height="1502" data-path="assets/media/images/edr-threats-self-service-security-events.png" />
    </Frame>

    ### Configuring Allow and Block Lists

    Allow and Block lists ensure that specific files or applications are always allowed or blocked in your environment, regardless of whether they appear in Iru Endpoint EDR's threat feeds.

    <Warning>
      Block items are considered Malware and require the Malware posture to be in **Protect** mode to be blocked on the device.
    </Warning>

    <Steps>
      <Step title="Add New Item">
        Click the **+ Add item** button.

        <Frame>
          <img src="https://mintcdn.com/iru/xTYPpu1SsBsdAQc_/assets/media/images/edr-threats-allow-block-list.png?fit=max&auto=format&n=xTYPpu1SsBsdAQc_&q=85&s=6d30d8fdf1005d6c0845288ce8d811fe" alt="Allow and Block list configuration interface" width="1970" height="1010" data-path="assets/media/images/edr-threats-allow-block-list.png" />
        </Frame>
      </Step>

      <Step title="Configure Item Details">
        Give the item a **Name**.
      </Step>

      <Step title="Set Item Action">
        Select **Allow** to permit a file or application. Select **Block** to block it.
      </Step>

      <Step title="Select Item Type">
        Specify the item type **Hash** or **Path** for the file or application.
      </Step>

      <Step title="Enter Item Information">
        If **Path** was selected, enter the application or file path. If **Hash** was selected, enter the file hash.
      </Step>

      <Step title="Add Item to List">
        Click **Add** to add the item to the Allow and Block list.

        Optionally, toggle **Add another item** in the lower-left corner to continue adding items.

        <Frame>
          <img src="https://mintcdn.com/iru/6OFhBTxsQJ8Xkobq/assets/media/images/edr-threats-list-add.png?fit=max&auto=format&n=6OFhBTxsQJ8Xkobq&q=85&s=b5f425cfc42bc38db8a226db9d08bf28" alt="Add item dialog for Allow or Block list" width="936" height="1258" data-path="assets/media/images/edr-threats-list-add.png" />
        </Frame>
      </Step>

      <Step title="Save Configuration">
        Click **Save** in the lower-right corner. Settings deploy and activate automatically on enrolled devices in the assigned Blueprints.
      </Step>
    </Steps>

    #### Determine Hash Value

    <Note>
      The **Hash** item type is only supported for files. The **Path** item type is supported for both files and applications.
    </Note>

    Use Terminal to determine the SHA256 hash value of a file:

    ```
    shasum -a 256 /path/to/file
    ```

    ### Considerations

    * **Posture mode selection**: Choose **Detect** for visibility without blocking, or **Protect** to actively quarantine known threats
    * **Behavioral detection**: Enable behavioral detections for comprehensive threat monitoring; consider impact on performance and false positive rates
    * **User alert management**: Configure user alerts to balance security awareness with user experience when files are quarantined
    * **Device isolation**: EDR provides [device isolation](/en/endpoint/endpoint-detection-response-edr/device-isolation) for quarantining compromised devices from the network
    * **Allow and block list management**: Maintain accurate lists to prevent legitimate applications from being blocked while ensuring malicious software is identified
    * **Hash vs. path configuration**: Use hash-based entries for specific file versions and path-based entries for applications that may update frequently
    * **Testing and validation**: Test configuration changes on a pilot device before broad deployment

    ### Next Steps

    See [Testing EDR Malware Detection](/en/endpoint/endpoint-detection-response-edr/endpoint-detection-response-testing-malware-detection) to validate your deployment.
  </Tab>

  <Tab title="Windows" icon="microsoft" iconType="brands">
    After you add the EDR Library Item and assign it to Blueprints, click **Save** to deploy it to enrolled Windows devices.

    See [Endpoint Detection & Response (EDR) Overview](/en/endpoint/endpoint-detection-response-edr/endpoint-detection-and-response-edr-overview) for Windows capabilities and [Testing EDR Malware Detection](/en/endpoint/endpoint-detection-response-edr/endpoint-detection-response-testing-malware-detection) to validate your deployment.
  </Tab>
</Tabs>

### Viewing Edit History in the EDR Library Item

You can audit changes to the EDR Library Item in the Activity tab of the Library Item or on the [Activity Page](/en/endpoint/devices/activity-page). This shows what configurations changed, the previous state, and who made the change.

<Steps>
  <Step title="Access Activity Log">
    Click **Activity** in your EDR Library Item or the **Activity** icon in the top-right navigation bar to open the [Activity Page](/en/endpoint/devices/activity-page).
  </Step>

  <Step title="Review Changes">
    Select the disclosure triangle next to **Library Item Edited** for the entry you want to review.

    <Frame>
      <img src="https://mintcdn.com/iru/xTYPpu1SsBsdAQc_/assets/media/images/edr-threat-library-activity.png?fit=max&auto=format&n=xTYPpu1SsBsdAQc_&q=85&s=7c58b8eee4c7e3f78b4f686879f8cab6" alt="Activity tab showing Library Item edit history" width="2170" height="834" data-path="assets/media/images/edr-threat-library-activity.png" />
    </Frame>
  </Step>
</Steps>
