Skip to content

Connector and Documentation updates #475

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.

Sign up for GitHub

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

Merged
piaudonn merged 3 commits into from
Dec 21, 2024
Merged

Connector and Documentation updates #475

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
66edb3f
update to connector for v2.0.21
briandelmsft Dec 16, 2024
9f28f63
link update
briandelmsft Dec 16, 2024
5a1b983
Marking MDCA deprecated
briandelmsft Dec 16, 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
46 changes: 43 additions & 3 deletions Connector/connector.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
}
},
"variables": {
"STATConnectorVersion": "2.0.0"
"STATConnectorVersion": "2.0.21"
},
"resources": [
{
Expand Down Expand Up @@ -117,6 +117,36 @@
],
"x-ms-visibility": "advanced"
},
"EnrichAccountsWithMFA": {
"type": "boolean",
"description": "EnrichAccountsWithMFA",
"title": "",
"enum": [
true,
false
],
"x-ms-visibility": "advanced"
},
"EnrichAccountsWithRoles": {
"type": "boolean",
"description": "EnrichAccountsWithRoles",
"title": "",
"enum": [
true,
false
],
"x-ms-visibility": "advanced"
},
"EnrichHostsWithMDE": {
"type": "boolean",
"description": "EnrichHostsWithMDE",
"title": "",
"enum": [
true,
false
],
"x-ms-visibility": "advanced"
},
"Body": {
"type": "object",
"description": "Incident Body or Alert Body",
Expand Down Expand Up @@ -1237,6 +1267,15 @@
"description": "Instructions to include in the Microsoft Sentinel Task",
"x-ms-visibility": "advanced"
},
"Endpoint": {
"type": "string",
"description": "KQL Query Endpoint. Query for Analytics, Search for Basic/Auxiliary Logs.",
"enum": [
"Query",
"Search"
],
"x-ms-visibility": "advanced"
},
"BaseModuleBody": {
"type": "object",
"description": "Body from STAT Base Module",
Expand Down Expand Up @@ -2019,9 +2058,10 @@
},
"/api/modules/mdca": {
"post": {
"summary": "Microsoft Defender for Cloud Apps Module",
"description": "Sentinel Triage AssistanT Module for determining if user entities have investigation priorities in Microsoft Defender for Cloud Apps.",
"summary": "Microsoft Defender for Cloud Apps (Deprecated)",
"description": "This module has been deprecated due to the removal of the investigation priority score from MDCA",
"operationId": "MDCAModule",
"deprecated": true,
"parameters": [
{
"name": "body",
Expand Down
2 changes: 1 addition & 1 deletion Deploy/deployui.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"config": {
"isWizard": true,
"basics": {
"description": "## Microsoft Sentinel Triage AssistanT (STAT) Deployment\nThe Microsoft Sentinel Triage AssistanT is designed to help build automated triages for Microsoft Sentinel Incidents to optimize the efficiency of your security operations. This deployment will allow you to deploy the necessary resources to use the STAT tool.\n ### Post Deployment \nAfter deploying this template, ensure to run the [GrantPermissions.ps1](https://github.com/briandelmsft/SentinelAutomationModules/blob/statv2_preview/Deploy/GrantPermissions.ps1) script to grant permissions to the STAT modules. It may take up to 15 minutes for the permissions to become effective.",
"description": "## Microsoft Sentinel Triage AssistanT (STAT) Deployment\nThe Microsoft Sentinel Triage AssistanT is designed to help build automated triages for Microsoft Sentinel Incidents to optimize the efficiency of your security operations. This deployment will allow you to deploy the necessary resources to use the STAT tool.\n ### Post Deployment \nAfter deploying this template, ensure to run the [GrantPermissions.ps1](https://github.com/briandelmsft/SentinelAutomationModules/blob/main/Deploy/GrantPermissions.ps1) script to grant permissions to the STAT modules. It may take up to 15 minutes for the permissions to become effective.",
"resourceGroup": {
"constraints": {
"validations": [
Expand Down
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Microsoft Sentinel Triage AssistanT (STAT) :hospital:

The Microsoft Sentinel Triage AssistanT (STAT) is a Logic Apps Custom Connector that calls on a library of Automation [Modules](/Modules/) that can be used from Incident and alert based Microsoft Sentinel playbooks. This connector and modules simplify automation by moving complex automation tasks into these callable modules so they can be performed consistently and with ease from the Logic Apps Connector.
The Microsoft Sentinel Triage AssistanT (STAT) is a Logic Apps Custom Connector that calls on a library of Automation [Modules](https://github.com/briandelmsft/SentinelAutomationModules/wiki/Modules) that can be used from Incident and alert based Microsoft Sentinel playbooks. This connector and modules simplify automation by moving complex automation tasks into these callable modules so they can be performed consistently and with ease from the Logic Apps Connector.

Using the Microsoft Sentinel Triage AssistanT starts by calling the Base Module. This module prepares and enriches Incident and entity data for each of the triage modules which consumes this data. Once the Base Module has been called the triage modules can be used to perform analysis against the entities related to the Microsoft Sentinel incident. These triage modules will return an easy to use, well documented result so you can evaluate the outputs and quickly make decisions about how to handle an incident.

Expand All @@ -12,6 +12,6 @@ Project goals include:

Many of the Microsoft Sentinel playbook templates available today focus on Notification, Incident Enrichment and Remediation. This project focuses on the triage and analysis of an incident to provide additional confidence in the quality of the incident before taking actions. When the incident is determined to be low quality (likely a benign positive), it can be closed or lowered in severity through these automation flows. When the incident is determined to be of higher quality, it can be raised in severity, assigned to an analyst or even trigger a remediation playbook.

The full solution is available for deployment in the [Deployment](/Deploy/) section and additional documentation can be found in the [Wiki](https://github.com/briandelmsft/SentinelAutomationModules/wiki).
Documentation for STAT can be found in the [Wiki](https://github.com/briandelmsft/SentinelAutomationModules/wiki). Deployment information is also availble on the [deployment page](https://github.com/briandelmsft/SentinelAutomationModules/wiki/Deployment).

If you have any questions about this project or would like to provide suggestions to the STAT project maintainers please open an [issue](https://github.com/briandelmsft/SentinelAutomationModules/issues/new/choose).
If you have any questions about this project or would like to provide suggestions to the STAT project maintainers please open an [issue](https://github.com/briandelmsft/SentinelAutomationModules/issues/new/choose) or a [discussion](https://github.com/briandelmsft/SentinelAutomationModules/discussions).
Loading