Skip to content

Add SummarizeData playbook for NSE log ingestion - #14966

Open
v-sabiraj wants to merge 4 commits into
masterfrom
v-sabiraj-updatingnetworksessionsplaybook
Open

Add SummarizeData playbook for NSE log ingestion#14966
v-sabiraj wants to merge 4 commits into
masterfrom
v-sabiraj-updatingnetworksessionsplaybook

Conversation

@v-sabiraj

Copy link
Copy Markdown
Contributor

Adds a new Logic App playbook azuredeploy.json for the Network Session Essentials solution that summarizes _Im_NetworkSession data (by IP, port, country, protocol, source info, threat, threat IOC, and rule) and ingests results via Log Ingestion API into custom tables. Includes supporting Data Collection Endpoint, Data Collection Rule with stream declarations, and role assignment granting the playbook's managed identity Monitoring Metrics Publisher access.

Required items, please complete

Change(s):

  • See guidance below

Reason for Change(s):

  • See guidance below

Version Updated:

  • Required only for Detections/Analytic Rule templates
  • See guidance below

Testing Completed:

  • See guidance below

Checked that the validations are passing and have addressed any issues that are present:

  • See guidance below

Guidance <- remove section before submitting


Before submitting this PR please ensure that you have read the following sections and filled out the changes, reason for change and testing complete sections:

Thank you for your contribution to the Microsoft Sentinel Github repo.

Details of the code changes in your submitted PR. Providing descriptions for pull requests ensures there is context to changes being made and greatly enhances the code review process. Providing associated Issues that this resolves also easily connects the reason.

Change(s):

  • Updated syntax for XYZ.yaml

Reason for Change(s):

Version updated:

  • Yes
  • Detections/Analytic Rule templates are required to have the version updated

The code should have been tested in a Microsoft Sentinel environment that does not have any custom parsers, functions or tables, so that you validate no incorrect syntax and execution functions properly. If your submission requires a custom parser or function, it must be submitted with the PR.

Testing Completed:

  • Yes/No/Need Help

Note: If updating a detection, you must update the version field.

Before the submission has been made, please look at running the KQL and Yaml Validation Checks locally.
https://github.com/Azure/Azure-Sentinel#run-kql-validation-locally

Checked that the validations are passing and have addressed any issues that are present:

  • Yes/No/Need Help

Note: Let us know if you have tried fixing the validation error and need help.

References:


Adds a new Logic App playbook azuredeploy.json for the Network Session Essentials solution that summarizes _Im_NetworkSession data (by IP, port, country, protocol, source info, threat, threat IOC, and rule) and ingests results via Log Ingestion API into custom tables. Includes supporting Data Collection Endpoint, Data Collection Rule with stream declarations, and role assignment granting the playbook's managed identity Monitoring Metrics Publisher access.
Updates the azuredeploy.json metadata title to clarify this playbook uses the log ingestion API, and corrects the default PlaybookName parameter to match (SummarizeData_NSE_Logingestionapi).
Adds Microsoft.OperationalInsights/workspaces/tables resources for the nine NetworkCustomAnalytics_*_CL tables so they are created during deployment, and adds them as dependencies of the data collection rule.

Also shortens the DCE/DCR name prefixes from 'network-session-summarization-' to 'nse-summarization-' to stay within Azure resource name length limits.
Add deployment and post-deployment instructions for the Logs Ingestion API playbook, and correct the Azure Government deployment button link for the existing playbook.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants