Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding the Startup Application Query event class in the discovery category. #1119

Merged
merged 30 commits into from
Sep 4, 2024
Merged
Show file tree
Hide file tree
Changes from 13 commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
9a0cc9f
The Startup Application Query event class in the discovery category i…
maxhotta Jun 25, 2024
e0eb24b
Add Changelog entry
maxhotta Jun 25, 2024
8e2cf27
Merge branch 'main' into discovery-startupapp
maxhotta Jun 25, 2024
cfbd9df
Incorporating feedback, and discussion results.
maxhotta Jul 15, 2024
4677089
Merge remote-tracking branch 'origin/discovery-startupapp' into disco…
maxhotta Jul 15, 2024
1cf72e6
Merge remote-tracking branch 'origin/main' into discovery-startupapp
maxhotta Jul 15, 2024
1520c77
Changelog update
maxhotta Jul 15, 2024
c6976aa
Merge branch 'main' into discovery-startupapp
maxhotta Jul 15, 2024
0903a9d
Update conflicting uid for new class
maxhotta Jul 15, 2024
eb3689e
Merge remote-tracking branch 'origin/discovery-startupapp' into disco…
maxhotta Jul 15, 2024
019b136
Adding win_service as a target
maxhotta Jul 22, 2024
58e15c9
Fixed validator issue for win_service
maxhotta Jul 22, 2024
9cf3dbd
Merge remote-tracking branch 'origin/main' into discovery-startupapp
maxhotta Jul 22, 2024
300deaf
Added win_service to startup_app in the windows extension to fix the …
maxhotta Jul 23, 2024
25ab7c0
Re-adding caption to fix schema validation
maxhotta Jul 23, 2024
2b90e2f
Merge remote-tracking branch 'origin/main' into discovery-startupapp
maxhotta Jul 23, 2024
82d25b7
Merge branch 'main' into discovery-startupapp
floydtree Jul 26, 2024
6f606c5
Addressing some of the feedback
maxhotta Jul 29, 2024
4cbd7c0
Merge remote-tracking branch 'origin/discovery-startupapp' into disco…
maxhotta Jul 29, 2024
4d873bd
Merge branch 'main' into discovery-startupapp
floydtree Jul 30, 2024
c68c07b
Merge branch 'main' into discovery-startupapp
floydtree Aug 13, 2024
4a8273e
Addressing feedback; fixed the convention for run mode attributes.
maxhotta Aug 15, 2024
c741c02
Addressing feedback; Removed unnecessary fields, as they are defined …
maxhotta Aug 15, 2024
62f4cf5
Updated model for exposing constraints for an extension object.
maxhotta Aug 16, 2024
fba0d09
Renamed the event class and descriptions to 'Startup Item'
maxhotta Aug 20, 2024
5052e0a
Merge from main, and moved event addition to unreleased
maxhotta Aug 20, 2024
f5b9fba
Merge from main, update uid for Startup Item event class (now conflic…
maxhotta Aug 21, 2024
5360e61
Merge from main
maxhotta Aug 27, 2024
913e83c
Merge from main, resolve conflict in changelog.md
maxhotta Aug 28, 2024
07b82ed
Merge branch 'main' into discovery-startupapp
floydtree Sep 4, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ Thankyou! -->
2. Added `Remediation Activity` `File Remediation Activity` `Process Remediation Activity` `Network Remediation Activity` event classes. #1066
3. Added `Windows Service Activity` event class to the Windows extension. #1103
4. Added `Software Inventory Info` event class to the Discovery category. #1134
5. Added `Startup Application Query` event class. #1119
* #### Profiles
1. Added `osint` Profile based on `osint` object. #992
* #### Objects
Expand Down
70 changes: 70 additions & 0 deletions dictionary.json
Original file line number Diff line number Diff line change
Expand Up @@ -3671,6 +3671,19 @@
"description": "The rules that reported the events.",
"type": "rule"
},
"run_mode_ids": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"caption": "Run Mode IDs",
"description": "The list of normalized identifiers that describe application attributes.",
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"type": "integer_t",
"enum": {},
"is_array": true
},
"run_modes": {
"caption": "Run Modes",
"description": "The list of run_modes, normalized to the captions of the run_mode_ids values. In the case of 'Other', they are defined by the event source.",
"type": "string_t",
"is_array": true
},
"run_state": {
"caption": "Run State",
"description": "The state of the job or service, normalized to the caption of the run_state_id value. In the case of 'Other', it is defined by the event source. See specific usage.",
Expand Down Expand Up @@ -4068,6 +4081,63 @@
"description": "The start time of a time period. See specific usage.",
"type": "timestamp_t"
},
"start_type": {
"caption": "Start Type",
"description": "The start type of a service, driver, or application.",
"type": "string_t"
},
"start_type_id": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"caption": "Start Type ID",
"description": "The start type ID of a service or application.",
"enum": {
"0": {
"caption": "Unknown",
"description": "The start type is unknown."
},
"1": {
"caption": "Auto",
"description": "Service started automatically during system startup."
},
"2": {
"caption": "Boot",
"description": "Device driver started by the system loader."
},
"3": {
"caption": "On Demand",
"description": "Started on demand. For example, by the Window service control manager when a process calls the <i>StartService</i> function."
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
},
"4": {
"caption": "Disabled",
"description": "The service is disabled, and cannot be started."
},
"5": {
"caption": "All Logins",
"description": "Started on all user logins."
},
"6": {
"caption": "Specific User Login",
"description": "Started on specific user logins."
},
"7": {
"caption": "Scheduled",
"description": "Stared according to a schedule."
},
"8": {
"caption": "System Changed",
"description": "Started when a system item, such as a file or registry key, changes."
},
"99": {
"caption": "Other",
"description": "The start type is not mapped. See the <code>start_type</code> attribute, which contains a data source specific value."
}
},
"type": "integer_t"
},
"startup_app": {
"caption": "Startup Application",
"description": "The startup application object describes an application that has associated startup criteria and configurations.",
"type": "startup_app"
},
"state": {
"caption": "State",
"description": "The state of the event or object, normalized to the caption of the state_id value. In the case of 'Other', it is defined by the event source. See specific usage.",
Expand Down
13 changes: 13 additions & 0 deletions events/discovery/startup_app_query.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
{
"caption": "Startup Application Query",
"description": "Startup Application Query events report information about discovered startup applications.",
"extends": "discovery_result",
"name": "startup_app_query",
"uid": 21,
"attributes": {
"startup_app": {
"group": "primary",
"requirement": "required"
}
}
}
171 changes: 171 additions & 0 deletions objects/startup_app.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
{
"caption": "Startup Application",
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"name": "startup_app",
"description": "The startup application object describes an application that has associated startup criteria and configurations.",
"attributes": {
"name": {
"description": "The unique name of the startup application.",
"requirement": "required"
},
"run_modes": {
"description": "The list of run_modes, normalized to the captions of the run_mode_id values. In the case of 'Other', they are defined by the event source.",
"requirement": "optional"
},
"run_mode_ids": {
"description": "The list of normalized identifiers that describe application attributes.",
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"requirement": "optional",
"enum": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"0": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"caption": "Interactive",
"description": "The application interacts with the desktop."
},
"1": {
"caption": "Own Process",
"description": "The application runs in its own process."
},
"2": {
"caption": "Shared Process",
"description": "The application runs in a shared process."
},
"99": {
"caption": "Other"
}
}
},
"run_state": {
"description": "The run state of the startup application.",
"requirement": "optional"
},
"run_state_id": {
"description": "The run state ID of the startup application.",
"requirement": "recommended",
"enum": {
"0": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"caption": "Unknown",
"description": "The run state is unknown."
},
"1": {
"caption": "Stopped",
"description": "The sercie is not running."
},
"2": {
"caption": "Start Pending",
"description": "The service is starting."
},
"3": {
"caption": "Stop Pending",
"description": "The service is stopping."
},
"4": {
"caption": "Running",
"description": "The service is running."
},
"5": {
"caption": "Continue Pending",
"description": "The service is pending continue."
},
"6": {
"caption": "Pause Pending",
"description": "The service is pending pause."
},
"7": {
"caption": "Paused",
"description": "The service is paused."
},
"8": {
"caption": "Restart Pending",
"description": "The service is pending restart."
},
"99": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"caption": "Other",
"description": "The run state is not mapped. See the <code>run_state</code> attribute, which contains data source specific values."
}
}
},
"start_type": {
"description": "The start type of the startup application.",
"requirement": "optional"
},
"start_type_id": {
"description": "The start type ID of the startup application.",
"requirement": "required"
},
"type": {
"caption": "Type",
"description": "The startup application type.",
"type": "string_t"
},
"type_id": {
"caption": "Type ID",
"description": "The startup application type identifier.",
"enum": {
"0": {
"caption": "Unknown",
"description": "The type is unknown."
},
"1": {
"caption": "Kernel Mode Driver",
"description": "Kernel mode Operating System driver."
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
},
"2": {
"caption": "User Mode Driver",
"description": "User mode Operating System driver."
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
},
"3": {
"caption": "Service",
"description": "An executable background process typically managed by the Operating System."
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
},
"4": {
"caption": "User Mode Application",
"description": "An application that runs in the user space."
},
"5": {
"caption": "Autoload",
"description": "The macOS Autoload Application."
},
"6": {
"caption": "System Extension",
"description": "System extensions on macOS enables 3rd parties to extend the capabilities of macOS."
},
"7": {
"caption": "Kernel Extension",
"description": "Kernel extensions on macOS includes Apple provided pre-installs and 3rd party installs which enables support for specific hardware or software features not natively supported by macOS."
},
"8": {
"caption": "Scheduled Job, Task",
"description": "A job or task that runs on a configured schedule."
},
"99": {
"caption": "Other",
"description": "The startup application type is not mapped. See the <code>type</code> attribute, which contains data source specific values."
}
},
"type": "integer_t"
},
"driver": {
"description": "The startup application kernel driver resource.",
"requirement": "optional"
},
"job": {
"description": "The startup application job resource.",
"requirement": "optional"
},
"process": {
"description": "The startup application process resource.",
"requirement": "optional"
},
"win/win_service": {
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
"caption": "Windows Service",
"description": "The startup application windows service resource.",
"requirement": "optional"
}
},
"constraints": {
"just_one": [
"driver",
"job",
"process",
"win_service"
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
]
}
maxhotta marked this conversation as resolved.
Show resolved Hide resolved
}
Loading