What Security Onion Cases does for an analyst investigation
Security Onion Cases is the investigation workflow inside the Security Onion Console. Analysts use it to escalate findings from Alerts and Hunt, link the observables that matter to the investigation, and attach evidence so the record of what was found and why stays in one place. Teams usually need it once alerts and hunt results are arriving faster than they can be tracked in tickets, chat threads or spreadsheets, and when more than one analyst may touch the same activity. Before you rely on it, confirm the exact menus, field names and behavior against the Security Onion version you run, since the Console changes between releases. The current tagged release on GitHub is 3.3.0, and Security Onion 2.4 reaches end of life on October 1, 2026, so check which line your deployment is on first.
In practice, the analyst's path starts with a finding in Alerts or Hunt. Escalating that finding creates a case, and the case becomes the container for everything that follows. Observables are the IP addresses, domains, hashes, file names and similar values the investigation depends on. Linking them to the case lets the team see what has already been examined, and it gives reviewers a short list to check when they ask whether a value was looked at. Evidence attachments carry the supporting material, such as the alert details, query results and notes that justify each conclusion. Ask the platform owner which observable types the Console supports in your version and whether analyzers can run against them from the case, because that determines how much enrichment happens inside the tool and how much is manual.
The history of a case matters as much as its contents. An investigation often changes owner, scope or severity several times, and the audit trail should show who made each change and when. Before going live, test that the history records the actions your process depends on, such as status changes, reassignment and evidence removal, and confirm whether edits can be altered or deleted without a trace. Agree on naming conventions for cases and on who may close one, because a case that is closed without a documented outcome is hard to defend later. Plan for retention too: confirm how long case records and their attachments are kept and how they are backed up, since they live in the same platform that stores your alerts and logs.
Cases does not cover every workflow. Teams that need formal approvals, service-level tracking across many business units, automated containment steps or integration with a ticketing system for other departments usually need a separate case management tool or a SOAR platform alongside Security Onion. Shuffle is one open-source SOAR option that a team can evaluate for that purpose, but it is a separate system with its own hosting and licensing, not part of Cases. Decide early which system is the record of truth for an incident, and document how findings move between Cases and the other tool so that the same evidence is not maintained in two places with different status.
Which case workflow fits your team
This table compares four ways to run Security Onion Cases for incident investigation, from the Console alone to a SOAR platform such as Shuffle. Read each row against your team size, shift pattern and who owns automation. The main takeaway is that every added system creates a second record to keep consistent, so choose the smallest workflow that meets your handoff and reporting needs.
| Workflow | Team and staffing it suits | What it adds | What stays in a second system and what to confirm |
|---|---|---|---|
| Cases alone in the Console | Small teams where a few analysts triage and close their own cases, with no separate ticket queue to feed. | Escalation from Alerts and Hunt into a case, with observables, analyzers, evidence attachments and history in one place. | Little stays outside the Console. Confirm how case history is retained and who can edit or remove evidence before treating it as the record. |
| Cases with analyst-run investigation procedures | Teams with several analysts and shift handoffs that need the same steps followed on every case. | Written procedures for each alert type, so analysts work the same checklist and collect the same evidence. | Procedures usually live in a wiki or document store. Confirm that procedures can reference case IDs and where analysts record deviations. |
| Cases alongside a ticketing or case management system | Organizations where incidents route through a service desk or formal case process with owners outside the SOC. | Queueing, assignment, approvals and reporting that the SOC does not run itself. | Requester communication and approvals stay in the ticketing tool. Confirm how case IDs and status sync, and which system is the record of truth. |
| Cases alongside a SOAR platform such as Shuffle | Teams with an engineering owner who can build and test workflows that enrich cases across several tools. | Automated enrichment, containment steps and case updates, run as workflows with approvals where required. | Workflows, run history and app credentials live in Shuffle. Shuffle licensing counts app runs, so check run volume against its pricing article. Confirm Orborus and OpenSearch hosting, HA design and backup of the encryption secret. |
How alerts and hunts move into a Security Onion case
Analysts should escalate a finding into a case when it needs a shared record of investigation, evidence and decisions, and close or tune it when its cause is known and benign. Make that line explicit before the queue grows. A useful test is whether another analyst would need the reasoning to make the next decision. If the answer is yes, the finding belongs in a case. If the activity is explained and will recur, it belongs in a tuning change instead. Confirm in your installed version which action in Alerts or Hunt creates a case, and whether that action carries over the event fields, the rule that fired and the related events, or whether you must add them by hand.
Findings that usually justify a case include suspected host compromise, lateral movement between internal systems, data sent to destinations your organization does not expect, and rule hits that only make sense with context from several sources. Hunt results that show the same pattern across multiple hosts often belong in one case that groups those hosts, rather than in separate cases per event. Single hits with a clear, approved explanation can be closed with a note. For example, an illustrative nightly backup job that trips a data-volume rule should be closed with the job name and schedule recorded, so the next reviewer can see why it was dismissed.
Tuning happens in the Detections interface, and it determines how much noise reaches Cases. For NIDS rules loaded into Suricata, analysts can modify a rule, suppress it for specified sources or destinations, or set thresholds that control how many matches are needed before an alert is generated. For Sigma rules loaded into ElastAlert, custom filters remove matching events before they produce alerts. Suppression is the most powerful tool and the easiest to misuse. A suppression scoped to one known scanner is defensible. A suppression scoped to an entire subnet can hide the activity you most need to see. Keep each suppression as narrow as the known cause allows, and confirm in your version whether suppressions apply per sensor or across the deployment.
Treat tuning as a controlled change. Record who approved each suppression, threshold or filter, the reason and the review date, and test the change against recent Hunt results before it goes live, so you can see what it removes. Check whether your suppressions, thresholds and custom filters survive updates. Confirm this with the documentation for your release before any upgrade, including a move from Security Onion 2.4 to 3, because the interface and the way rule changes are retained may differ between versions. After each upgrade, review the tuned rules first, since a change that was once correct may no longer match the traffic it was written for.
Setting up Cases for a production team
This sequence turns a Security Onion Cases workflow into one your analysts can trust. Each step confirms something the next step depends on, from the deployment and access model to the escalation rules and the record a closed case keeps. Run it on a non-production deployment first where you can, then repeat the final checks on the production console.
Confirm the deployment type and manager availability
Record whether the console runs as a Distributed deployment with a manager node, sensor nodes and search nodes, or as a standalone, evaluation or import install. The Security Onion architecture documentation recommends Distributed for production. Confirm that analyst workstations can reach the manager and that search nodes are indexing, because if the manager goes down, search nodes stop indexing when they cannot reach Redis. Check: an analyst can open the Cases area and create a throwaway case without errors.
Define who can open, edit and close cases
Map the roles your team needs to the console's user and role settings. Confirm in your installed version which permissions control opening, editing, commenting, attaching evidence and closing a case, and whether closing can be limited to a lead. Keep the model small and write it down so that auditors and new analysts can read it. Check: create two test users with different roles and confirm each can perform only the actions its role allows.
Agree escalation criteria and naming
Write the conditions under which an alert or hunt finding becomes a case. Typical conditions include confirmed malicious activity, suspected compromise of an in-scope asset, or a finding that needs more than one analyst. Agree a naming convention that includes a date, a short description and an identifier your ticketing system can reference. Check: a second analyst reads the document and classifies the same sample alerts the same way.
Run a test case from an alert
Choose an alert from your sensors that has already been triaged and is safe to use as a rehearsal. Open a case from that alert, add the relevant observables and attach a note explaining the triage decision. Run an analyzer on an observable only where your policy allows that value to be sent to an external service. Check: the case shows the source alert, the observables and the note, and the alert links back to the case.
Run a test case from a hunt result
Run a hunt query that matches the behavior you want to investigate, select a result that is representative, and create a case from it. Add a finding that states what the hunt showed and which events support it. Confirm in your version whether the query itself is stored with the case. Check: the case carries the hunt-derived observables and the context you expected, and an analyst who did not create it can follow the reasoning from the case alone.
Verify history and evidence entries are recorded
Make a sequence of changes to the test cases: change the status, reassign the case, add an observable, attach a file or capture, and add a comment. Open the history view and confirm each change appears with the user and time it was made. Confirm that attached evidence opens from the case and is not only visible in the list. Check: every change you made appears in the history in the expected order, and every attachment opens correctly.
Confirm closed cases keep their history
Close one test case using the role you assigned for closing. Reopen it from the case list and confirm that the full history, observables, comments and evidence are still present. Also confirm that a closed case still appears in the searches and reports your team relies on. Check: nothing from the open state is missing and the closing entry shows the user who closed the case. If anything is missing, pause the rollout and investigate before analysts use the workflow.
Observables, analyzers and evidence attachments in practice
Observables are the indicators a case is built around, and the choices a team makes about how analysts add, enrich and store them decide whether the case can be trusted later. In Security Onion Cases, observables are typically values such as IP addresses, domains, file hashes and file names, pulled from an alert, a Hunt result or a packet capture and linked to the case. The supported observable types depend on the Security Onion version and configuration in use, so confirm the exact list in your release before writing analyst procedures around it. Map each common observable type to the source it usually comes from in your environment, so analysts know where to copy it from.
Analyzers enrich an observable by sending it to a service and returning the result to the case. Before enabling any analyzer, decide which ones are permitted, who may run them and what each one sends out. Submitting an internal IP address, a hostname or a file hash to an external reputation service is a data disclosure decision that your privacy and legal contacts should approve. Confirm the analyzer catalog for your version, the credentials each analyzer needs, the network egress rules those lookups require and whether results are stored with the case. On air-gapped installs, which Security Onion supports, expect few or no external analyzers, so plan manual enrichment steps instead.
Evidence attachments include items such as exported logs, packet capture excerpts, screenshots and files extracted by Strelka. The case history is the record of what changed, when and by whom. Confirm in your version whether history captures who added, edited or removed an observable or attachment, and whether those entries can be altered or deleted by anyone with case access. Also confirm the file types and size limits the upload accepts. If a full packet capture is too large to attach, the case should instead record the time range, sensor and file location so an investigator can retrieve it from the capture store under the same controls.
Four decisions need an owner before the first live case. First, who may attach raw packet captures or extracted files, since these can contain credentials, personal data or regulated records. Second, whether material must be redacted or minimized before attachment, and who performs that step. Third, how long attachments are kept, measured against the retention set for full packet capture and the search indices, and whether attachments are removed when a case closes. Fourth, which roles can view, edit and export sensitive attachments. Write these rules down, test them with a tabletop case, and confirm each control in the version you run.
Security and operational considerations for case data
Case data brings access, custody and retention questions that a network monitoring rollout does not settle on its own. The cards below cover the controls to plan and the checks to run before analysts depend on Cases. Each one names what to confirm in the Console and in your own environment.
Role-based access to case data
Cases hold analyst notes, observables and evidence references, so decide who may view, comment on, reassign and close them before the first case is opened. Map each role to a team, such as tier one triage, incident responders and read-only auditors, and test that a user outside a role cannot see restricted cases. Confirm in the Console how case permissions and sharing work in your release. OIDC single sign-on is a Pro option to evaluate for tying case access to your central identity provider and its offboarding process.
Manager node dependency
In a distributed deployment, the manager node hosts the Console that analysts use to work cases. The architecture documentation states that if the manager goes down, search nodes stop indexing because they cannot reach Redis, so new events stop appearing in investigation data during an outage. Plan a runbook that tells analysts how to continue triage, records the coverage gap and confirms how search nodes catch up after a restored manager.
Audit trail and case history
Case history should show who changed a status, added an observable, attached evidence or reassigned a case, and when. Before go-live, list the actions your review process requires, then test each one in a lab case and confirm the Console records it with a user and timestamp. Decide whether history stays in the platform or is exported to your SIEM or ticketing system, and confirm that all nodes use synchronized time so event order holds up in a review.
Personal and regulated data in evidence
Attached packet captures, extracted files and observables can contain personal, payment or health data. Write a rule for what may be attached, keep hashes and references in the case where policy allows, and limit who can open raw captures. Map each data category to the regulation or contract that governs it, and confirm retention with your privacy lead. LUKS data-at-rest encryption, FIPS mode and OS STIG compliance are Pro features to evaluate for regulated networks.
Backup and restore of case records
Case records need a backup scope that matches how analysts rely on them. Confirm with the Security Onion documentation which case data sits on the manager, which stores must be captured with it and whether attached evidence is included. Restore into a test environment on the same version, check that cases open with their history and attachments intact, and repeat the test after each upgrade. Track end-of-life dates for your release, since 2.4 reached end of life on October 1, 2026.
When a separate case management or SOAR tool is still needed
Keep a separate case management or SOAR system when the investigation process needs more than a case record in Security Onion. Four situations usually drive that decision: approvals that span several teams, service levels tied to a ticket queue, automated response actions that change systems outside the SOC, and enrichment that pulls from many tools at once. Before you build anything, list which of these apply to your analysts today. If none apply, Security Onion Cases may be enough on its own, and the extra platform is overhead you do not need to run.
Cross-team approvals and ticket-driven service levels are the most common reasons teams add a second system. If legal, IT operations or a third-party provider must approve containment before an analyst acts, the case needs approval steps, owners outside the SOC and timers that keep the request moving. Ask whether your existing ITSM platform already owns the service-level clock and the approval record. In many organizations that system stays the source of truth, and the case in Security Onion holds the investigation evidence and links back to the ticket. Confirm this split with the people who own the ticket queue before you decide.
Shuffle is a security automation platform, and it fits the automation and enrichment cases. Its server side has three parts: a frontend, a Go backend API listening on port 5001, and an OpenSearch document database. Separately, Orborus runtimes poll the backend for jobs and start a worker for each workflow execution, and that worker starts the containers for each app the workflow calls. This split matters for placement. The runtimes need network paths to the systems they act on, and the server needs paths to the analysts and to Security Onion. Map those paths on a diagram before you place either component.
Any integration between Shuffle and Security Onion Cases must be designed and confirmed, not assumed. Confirm with the vendors which interfaces Cases exposes, how authentication works, who owns the service account, and which events can trigger workflows. Shuffle's high availability guidance adds components you will need to operate: an OpenSearch cluster, optionally Memcached for a shared cache, NFS for shared files when several backends run, and more than one Orborus node so workflows continue if one fails. Secrets handling is the second design constraint. Shuffle encrypts saved app credentials and API keys in OpenSearch with AES-256 using the SHUFFLE_ENCRYPTION_MODIFIER value. Losing or changing that value breaks every saved app authentication, so store it in your secrets manager and include it in your recovery plan.
Cost and effort depend on how much automation you plan and which edition you need. Shuffle prices licensing on app runs, meaning actions that execute in a workflow, while triggers and skipped actions are not counted. Automation volume therefore drives the recurring cost, and it should be estimated from the workflows you plan to build. Shuffle states that all features are in the open-source edition and that paid tiers differ in limits, scaling and support, so check which limits your workflows will hit. Ask any implementation partner for a written scope that covers the Cases integration design, the high availability layout, secrets handling, workflow testing and handover, and the recurring tasks that follow, such as Shuffle upgrades and OpenSearch maintenance.
Limits to confirm before you commit to Cases
Cases behave differently depending on your Security Onion version, deployment type and operating system, so these checks come before any workflow design. Each card names one item to confirm and where to confirm it in your own environment.
Version and end-of-life date
Confirm the exact Security Onion version your Console runs and its support window. The EOL documentation lists 2.4 as reaching end of life on October 1, 2026, and 2.3 on April 6, 2024. A Cases workflow built on an unsupported release carries patching and security risk, so check the running version in the Console and against the EOL page before you plan any case configuration.
Deployment type and manager dependency
Identify whether you run Import, Evaluation, Standalone or Distributed. The architecture documentation recommends Distributed for production, with a manager, sensor nodes and search nodes. If the manager goes down, search nodes stop indexing because they cannot reach Redis, so confirm how a manager outage would affect analysts who are mid-investigation.
Oracle Linux 9 and the 3.0.0 change
Security Onion 3.0.0, released on March 31, 2026, supports only Oracle Linux 9 and replaced Stenographer with Suricata for full packet capture. The 3.0.0 release notes say 2.4 installations on Oracle Linux 9 can upgrade, while other distributions need a fresh install. Check your operating system inventory and schedule the upgrade with analysts, because the packet capture engine they pivot to from a case also changes.
Cases features and integrations
Verify which Cases functions your version provides and which integrations reach them. The Pro edition lists OIDC single sign-on, the Security Onion API and external notifications, but the documentation does not confirm each of these applies to Cases in every version. Test the identity, notification and API paths that your escalation process depends on in a non-production instance.
Observable types and analyzers
Check which observable types Cases accepts and which analyzers run against each type in your version. Analyzer coverage changes between releases, and it determines whether an analyst can enrich an indicator inside the case or must move to another tool. Confirm the list in the Cases section of the documentation for your exact version, then test each observable type you expect analysts to use with a sample case.
Retention and export of case data
Confirm how long case records, comments and attached evidence are kept and whether they can be exported in a usable form. Case retention is separate from the storage you size for logs and captured traffic, so it needs its own check against your retention policy. Ask for a documented export test that shows an investigation can leave the platform intact for legal hold or handoff.
Questions teams ask before setting up Security Onion Cases
How much does it cost to set up Security Onion Cases?
No price applies to every environment, and any quote follows a written scope agreed before work starts. The main cost drivers are the number of alert sources and integrations the case workflow must touch, the number of analyst roles that need separate permissions or queues, whether a SOAR layer is needed to automate steps, and how much procedure documentation must be written. Most of the setup cost is one-time: scoping, configuration, testing and training. Recurring costs sit in platform operations, upgrades and any paid edition you choose. Security Onion Pro is sold on 1 to 5 year terms and adds features such as OIDC single sign-on and professional support, so it is a separate cost decision. Ask any provider for line items that show who does each task, what is one-time versus recurring, and which assumptions about your environment the figure depends on.
How long does setting up Security Onion Cases take?
The duration depends on scope and on how ready your team and platform already are, so ask for a timeline tied to a written scope rather than a general figure. Readiness matters most: a running Distributed deployment on supported hardware and a supported operating system moves faster than a first build. Confirm your Security Onion version before starting, since 3.0.0 supports only Oracle Linux 9, and version 2.4 reaches end of life on October 1, 2026. Other drivers include how many alert sources feed cases, whether identity integration is in scope, whether change approvals are required and how many analysts must be trained. Ask the provider to show the phases, the dependencies on your team and the points where your approval is needed before each phase begins.
What does Security Onion Cases setup require from our staff?
Setup needs a named platform owner who can make Security Onion changes, analysts who will work cases daily and can review the workflow, and someone who manages identity if single sign-on is in scope. Infrastructure staff provide hardware or cloud accounts, network access between nodes, DNS, time synchronization and storage sized for your retention needs. Security staff must define case categories, severity levels, evidence handling rules and hand-off points, because those decisions drive the configuration. Change management staff are needed if production changes require sign-off. For air-gapped networks, staff must move ISO media for installs and for soup updates. Ask the provider for a list of client tasks with owners and dates recorded in the written scope, so your team knows its commitments before work begins.
Can our in-house team set up Security Onion Cases alone?
Yes, if the team already runs Linux servers and has operated Security Onion before, has a named owner and has time for testing. Cases setup involves more than enabling a feature: it touches workflow definitions, roles, evidence handling and written procedures. Gaps usually appear in sizing, upgrade planning, identity integration and the procedures analysts will follow after go-live. Ask who will own the workflow once it is live and who reviews changes to it. Some teams split the work, with internal staff owning configuration and daily operations while an outside team handles scoping, hardening or an independent review of the design. Whichever route you choose, agree the scope in writing so each party knows which tasks it owns and what it delivers.
When does Security Onion Cases need a separate SOAR tool?
Consider a SOAR tool when investigation steps repeat across systems and need automation, such as enrichment lookups, ticket creation or approval steps that span several tools. Whether Cases alone covers your tracking, observables and evidence needs is a question to confirm against the version you run. Shuffle is one open-source SOAR option. Its code is licensed under AGPL-3.0, and its documentation says all features are available in the open-source edition, while paid tiers differ in feature limits, scaling and support. Shuffle's licensing is based on app runs, meaning actions that execute in a workflow, and users, apps and workflows are unlimited. For higher availability, Shuffle recommends an OpenSearch cluster and more than one Orborus node. Plan how credentials are protected, because losing the SHUFFLE_ENCRYPTION_MODIFIER secret breaks all saved app authentications.
Can we use Security Onion in our organization under its license?
The Security Onion repository is licensed under the Elastic License 2.0, which is source-available and is not an OSI-approved open-source license. Review the license terms against how you plan to use, modify, host or offer the software before deployment, and have your legal team confirm the fit. Security Onion Pro is a separate paid edition sold on 1 to 5 year terms, so the license question applies to the edition you choose as well as to the free build. DeployOpen does not provide legal advice on licensing, but it can document how your deployment is configured so your legal and compliance reviewers have the facts they need. Ask any provider to state in writing which components they install, which licenses apply to each and which terms affect your rollout.
What happens to Security Onion case work if the manager node fails?
If the manager node goes down, search nodes stop indexing because they cannot reach Redis. Security Onion's architecture documentation recommends the Distributed deployment type for production, with a manager node, sensor nodes and search nodes. Receiver nodes add pipeline redundancy and load balancing, which reduces the impact of a single component failing. Plan for this before go-live: decide how the manager is monitored, how it is recovered and how backups are taken and tested. Also ask what the case workflow does while the manager is unavailable, including whether analysts can still open, update or review existing cases. Confirm these behaviors against your Security Onion version, because the answer depends on the deployment design you choose.
How DeployOpen works on this
DeployOpen plans, builds and hands over Security Onion Cases for incident investigation inside infrastructure you control, so analysts can move from an Alert or Hunt finding into a tracked case record. Engagements are fixed-scope, with scope, deliverables and timelines agreed in writing before work starts. Ongoing support is available as a retainer.
How we scope
- The written scope names which Alerts and Hunt workflows will escalate into Cases and which analysts use them.
- We confirm which observable types, analyzers and enrichment sources your team needs before configuration begins.
- Scope records whether a separate case management or SOAR tool is needed for tasks, approvals or playbooks.
How we build
- Configure Case fields and handling conventions to match your analyst roles and shift model.
- Build a tested path from Alerts and Hunt pivots into Cases, confirming each step on your Security Onion version.
- Test evidence attachments and case history with sample incidents that use no live or regulated data.
How we hand over
- Documented analyst runbook covering escalation from Alerts and Hunt, observables, analyzers and evidence handling.
- Administrator notes on Case permissions, retention and backups, tied to your Security Onion deployment type.
- Walkthrough sessions with the analysts and reviewers who will open, escalate and close Cases.
How we support
- Ongoing support, upgrades and maintenance are available as a retainer after handover.
- Plan for Security Onion release changes, including the 3.0.0 move to Oracle Linux 9 only.
- Confirm with Security Onion Solutions which Case features your version includes before finalizing the analyst runbook.

