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

# Workbench: Incident Investigation and Response

> Use the Workbench for incident investigation and response: explore affected entities in the Entity Context Graph, then build, approve, and run Gamebooks.

The Security Workbench is your investigation and response command center. Visualize affected entities, build custom response workflows, and execute remediation actions—all from a single interface.

<Frame>
  <img src="https://mintcdn.com/contraforce/n2V4XUDWFOitCP6z/expanded-incident-workbench.jpeg?fit=max&auto=format&n=n2V4XUDWFOitCP6z&q=85&s=a9c26847a652444b38f03ca3ba446292" alt="Incident Workbench with the incident header, Investigation panel tabs, and a Response panel showing a finished Gamebook" width="1712" height="939" data-path="expanded-incident-workbench.jpeg" />
</Frame>

## What is the Workbench?

The Workbench combines investigation and response into one powerful experience:

<CardGroup cols={2}>
  <Card title="AI-Mapped Response Actions" icon="brain">
    Automatically recommended response actions based on affected entity types
  </Card>

  <Card title="Entity and Context Graph Visualization" icon="diagram-project">
    See all related entities in an interactive context graph
  </Card>

  <Card title="No-Code Queries" icon="magnifying-glass">
    Click-through investigation for entities  without writing queries
  </Card>

  <Card title="Custom Workflows" icon="arrows-split-up-and-left">
    Chain multiple actions into comprehensive Gamebooks
  </Card>
</CardGroup>

<Info>
  The Workbench is where investigation meets action. Instead of switching between tools, you can analyze the threat and respond to it in the same place.
</Info>

***

## Accessing the Workbench

<Steps>
  <Step title="Open an Incident">
    From the **Incidents** page, open an incident and select **View full details**
  </Step>

  <Step title="View the Summary">
    The Incident Summary opens with overview information
  </Step>

  <Step title="Open the Workbench">
    Select the Gamebooks Workbench icon next to **Actions**
  </Step>
</Steps>

***

## Workbench Layout

The Security Workbench is organized into several key areas:

### Incident Header

At the top of the Workbench, you'll find:

| Element | Description |
| - | - |
| **Incident Title** | Name and ID of the incident |
| **Status** | Current state (New, Active, Closed)—editable inline |
| **Owner** | Assigned analyst—editable inline |
| **Severity** | Incident severity level |

<Tip>
  You can update the Status and Owner directly from the Workbench without leaving the page.
</Tip>

### Entity Graph

The central visualization showing all entities involved in the incident:

* **Users** — Accounts that were affected or involved
* **Devices** — Endpoints implicated in the incident
* **IPs** — Network addresses related to the activity
* **Files** — Suspicious files or hashes detected
* **URLs/Domains** — Web resources involved

Click any entity icon to:

* View entity details
* See other incidents involving this entity
* Access available response actions

This is also the **investigation graph** your Security Delivery Agents traverse. When an agent investigates an incident, it walks these same relationships to determine which entities the incident impacted.

### Workbench Tabs

<Tabs>
  <Tab title="Summary">
    Overview of the incident including description, timeline summary, and key indicators.
  </Tab>

  <Tab title="Entities">
    Detailed list of all affected entities with expandable details and cross-incident correlation.
  </Tab>

  <Tab title="Comments">
    Team collaboration space. Add investigation notes and view comments from other analysts.
  </Tab>

  <Tab title="History">
    Complete audit trail of all actions taken on this incident, including previously run Gamebooks.
  </Tab>
</Tabs>

***

## Building a Gamebook

Gamebooks are response workflows made up of response actions for each affected entity — you build them yourself, or a Security Delivery Agent compiles one for you.

<Info>
  An agent-compiled Gamebook arrives already populated: the agent identifies the impacted entities from the graph above and maps the appropriate response actions to each one. It loads into the same **Gamebook card**, so you review and run it exactly as described below. See [Configuring Security Delivery Agents](/guides/getting-started/configuring-security-delivery-agents).
</Info>

The steps below cover building one by hand.

### Step 1: Select an Entity

Left-click an entity icon in the Entity Context Graph. The response actions appear already mapped to the entity type selected.

<Frame>
  <img src="https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/left-click-entity-graph.png?fit=max&auto=format&n=OXtE1nSnqbk3dWX9&q=85&s=a3af45f80a0b87fa76b835e33ad540d9" alt="Device entity action menu with Isolate Endpoint, Scan Endpoint and Release From Isolation, each with an add (+) button" width="316" height="188" data-path="left-click-entity-graph.png" />
</Frame>

### Step 2: Browse Available Actions

By left-clicking entities, you will be able to utilize the following response actions:

| Entity Type | Response Actions |
| - | - |
| **User** | Invalidate sessions, lockout user, reset user password, reset MFA, and unlock user |
| **Device** | Isolate device, run AV scan, unisolate device |
| **IP** | Block Azure Network Security Group (NSG) |
| **File** | Quarantine file, block hash |

<Info>
  Available actions depend on the entity type and your connected modules. Gamebook response actions automatically map to actions that are relevant and executable.
</Info>

### Step 3: Add Actions to Gamebook

* Click the **+ icon** to add a response action to your Gamebook
* Hover over the action in the Gamebook and the **red - icon** will remove a response action
* Repeat for each entity you want to take action on

<Frame>
  <img src="https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/gamebook-add-remove.png?fit=max&auto=format&n=OXtE1nSnqbk3dWX9&q=85&s=8b31d989445b2b91e2ef39b10636e98e" alt="Gamebook with actions added" width="365" height="546" data-path="gamebook-add-remove.png" />
</Frame>

### Step 4: Review Your Gamebook

As you add actions, they load in the **Gamebook card**.

### Step 5: Execute the Gamebook

<Steps>
  <Step title="Review Response Actions">
    Verify all actions in the Gamebook are correct
  </Step>

  <Step title="Click Run Gamebook">
    Execute all actions in the Gamebook
  </Step>

  <Step title="Monitor Progress">
    Status updates from "Pending" to "Running" to "Finished"
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/finished-gamebook.png?fit=max&auto=format&n=OXtE1nSnqbk3dWX9&q=85&s=231eae089ab36941059193acf0c09243" alt="Gamebook execution complete" width="363" height="544" data-path="finished-gamebook.png" />
</Frame>

***

## Gamebook Approval Workflow

Some Gamebooks require approval before execution, indicated by an **Approve** button in the Gamebooks page or in the Gamebook within the Workbench.

<Warning>
  Actions with approval requirements are typically high-impact operations like device isolation or reset user password. This prevents accidental execution.
</Warning>

### Requesting Approval

1. Build your Gamebook as usual (including locked actions)
2. Click **Request Gamebook Approval** instead of Run Gamebook
3. The request is sent to users with approval permissions

### Approving Gamebooks

Approvers can approve requests from:

* **The incident itself** — Open the incident and approve directly
* **Gamebook Activity tab** — Review all pending approvals in one place

  <Frame>
    <img src="https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/gamebook-activity-approval.png?fit=max&auto=format&n=OXtE1nSnqbk3dWX9&q=85&s=b2ba1d1486251293073fbb9bcf1ab6c0" alt="Incident Response panel Activity tab showing a Gamebook run with a Waiting Approval badge" width="364" height="546" data-path="images/gamebook-activity-approval.png" />
  </Frame>
* **Gamebook Activity page** — Review all pending approvals in one place

  <Frame>
    <img src="https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/gamebook-page-approvals.png?fit=max&auto=format&n=OXtE1nSnqbk3dWX9&q=85&s=4e84aa911ca8d9d2d0250afa7cd30c32" alt="Gamebooks Activity page with the Queued filter selected, listing queued Gamebook runs" width="1833" height="1006" data-path="images/gamebook-page-approvals.png" />
  </Frame>

<Tip>
  Loading previous Gamebooks is especially useful for recurring incident types. Build a response once, reuse it across similar incidents.
</Tip>

## Gamebook Activity Page

Track all Gamebooks in one queue across every workspace from the dedicated **Gamebooks Page**.

<Frame>
  <img src="https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/gamebook-page-approvals.png?fit=max&auto=format&n=OXtE1nSnqbk3dWX9&q=85&s=4e84aa911ca8d9d2d0250afa7cd30c32" alt="Gamebooks Activity page listing queued Gamebook runs across all workspaces, with status filter chips" width="1833" height="1006" data-path="images/gamebook-page-approvals.png" />
</Frame>

### What You Can See

| Column | Description |
| - | - |
| **Status** | Success, Failed, Pending Approval |
| **Incident** | Linked incident ID |
| **Actions** | What actions were performed |
| **Time to Run** | Execution duration |
| **Workspace** | Which workspace the actions ran against |

### Expanding Details

Click any row to expand and see:

* Individual action results
* Error messages (if any failed)
* Timestamps for each step
* Entity details

## Best Practices

<AccordionGroup>
  <Accordion title="Start with high-impact entities">
    Focus your initial response on the most critical entities—compromised users, infected devices, or malicious IPs that pose immediate risk.
  </Accordion>

  <Accordion title="Use comments to document findings">
    Add comments as you investigate. This creates a record for your team and helps with post-incident review.
  </Accordion>

  <Accordion title="Review before executing">
    Always review the complete Gamebook Card before clicking Run. Verify you're taking action on the correct entities.
  </Accordion>

  <Accordion title="Check History for patterns">
    Before building a new Gamebook, check the History tab. A previous response may already exist that you can reuse or adapt.
  </Accordion>

  <Accordion title="Monitor the Gamebook Activity page">
    Regularly check the Gamebook Activity page to ensure actions completed successfully and catch any failures early.
  </Accordion>
</AccordionGroup>

***

## Related Guides

<CardGroup cols={2}>
  <Card title="What are Gamebooks?" icon="gamepad" href="/guides/getting-started/what-are-gamebooks">
    Deep dive into Gamebook capabilities.
  </Card>

  <Card title="Incident Management" icon="shield-halved" href="/guides/getting-started/incident-management">
    Complete incident workflows.
  </Card>

  <Card title="Entity Insights" icon="lightbulb" href="/entity-insights">
    Available entity enrichment data.
  </Card>

  <Card title="Incident Classifications" icon="tag" href="/guides/getting-started/incident-classifications">
    Classify incidents after resolution.
  </Card>

  <Card title="Log Search" icon="terminal" href="/guides/getting-started/log-search">
    Run KQL queries against a workspace's Microsoft Sentinel logs.
  </Card>
</CardGroup>

***

<Note>
  Need help with the Security Workbench? Contact us at [support@contraforce.com](mailto:support@contraforce.com)
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.