diff --git a/Logos/Druva_Logo.svg b/Logos/Druva_Logo.svg new file mode 100644 index 00000000000..634576f5eda --- /dev/null +++ b/Logos/Druva_Logo.svg @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/Parsers/ASimAuthentication/ARM/vimAuthenticationNative/vimAuthenticationNative.json b/Parsers/ASimAuthentication/ARM/vimAuthenticationNative/vimAuthenticationNative.json index 57f763f8f38..86874ab2f5f 100644 --- a/Parsers/ASimAuthentication/ARM/vimAuthenticationNative/vimAuthenticationNative.json +++ b/Parsers/ASimAuthentication/ARM/vimAuthenticationNative/vimAuthenticationNative.json @@ -27,7 +27,7 @@ "displayName": "Authentication Event ASIM filtering parser for Microsoft Sentinel native Authentication table", "category": "ASIM", "FunctionAlias": "vimAuthenticationNative", - "query": "let parser=\n(\n starttime: datetime=datetime(null), \n endtime: datetime=datetime(null), \n username_has_any: dynamic = dynamic([]),\n targetappname_has_any: dynamic = dynamic([]),\n srcipaddr_has_any_prefix: dynamic = dynamic([]),\n srchostname_has_any: dynamic = dynamic([]),\n eventtype_in: dynamic = dynamic([]),\n eventresultdetails_in: dynamic = dynamic([]),\n eventresult: string = '*',\n disabled: bool=false\n)\n{\n ASimAuthenticationEventLogs | where not(disabled)\n // -- Pre-parsing filtering:\n | where\n (isnull(starttime) or TimeGenerated >= starttime) \n and (isnull(endtime) or TimeGenerated <= endtime)\n and ((array_length(username_has_any) == 0) or TargetUsername has_any (username_has_any))\n and ((array_length(targetappname_has_any) == 0) or TargetAppName has_any (targetappname_has_any)) \n and ((array_length(srcipaddr_has_any_prefix) == 0) or (has_any_ipv4_prefix(SrcIpAddr, srcipaddr_has_any_prefix)))\n and ((array_length(srchostname_has_any) == 0) or SrcHostname has_any (srchostname_has_any))\n and ((array_length(eventtype_in) == 0) or EventType in~ (eventtype_in))\n and (array_length(eventresultdetails_in) == 0 or EventResultDetails has_any (eventresultdetails_in))\n and (eventresult == \"*\" or (EventResult == eventresult))\n | extend\n User = TargetUsername,\n Src = coalesce (SrcDvcId, SrcHostname, SrcIpAddr),\n IpAddr=SrcIpAddr,\n LogonTarget= coalesce (TargetAppName, TargetUrl, TargetHostname),\n Dvc=EventVendor,\n Application=TargetAppName,\n Dst = coalesce (TargetDvcId,TargetHostname, TargetIpAddr, TargetAppId,TargetAppName), \n Rule = coalesce(RuleName, tostring(RuleNumber)),\n EventStartTime = TimeGenerated,\n EventEndTime = TimeGenerated,\n EventSchema = \"Authentication\"\n | project-rename\n EventUid = _ItemId\n | project-away TenantId, SourceSystem, _ResourceId, _SubscriptionId\n};\nparser\n (\n starttime=starttime,\n endtime=endtime,\n username_has_any=username_has_any,\n targetappname_has_any=targetappname_has_any,\n srcipaddr_has_any_prefix=srcipaddr_has_any_prefix,\n srchostname_has_any=srchostname_has_any,\n eventtype_in=eventtype_in,\n eventresultdetails_in=eventresultdetails_in,\n eventresult=eventresult,\n disabled=disabled\n)", + "query": "let parser=\n(\n starttime: datetime=datetime(null), \n endtime: datetime=datetime(null), \n username_has_any: dynamic = dynamic([]),\n targetappname_has_any: dynamic = dynamic([]),\n srcipaddr_has_any_prefix: dynamic = dynamic([]),\n srchostname_has_any: dynamic = dynamic([]),\n eventtype_in: dynamic = dynamic([]),\n eventresultdetails_in: dynamic = dynamic([]),\n eventresult: string = '*',\n disabled: bool=false\n)\n{\n ASimAuthenticationEventLogs | where not(disabled)\n // -- Pre-parsing filtering:\n | where\n (isnull(starttime) or TimeGenerated >= starttime) \n and (isnull(endtime) or TimeGenerated <= endtime)\n and ((array_length(username_has_any) == 0) or TargetUsername has_any (username_has_any))\n and ((array_length(targetappname_has_any) == 0) or TargetAppName has_any (targetappname_has_any)) \n and ((array_length(srcipaddr_has_any_prefix) == 0) or (has_any_ipv4_prefix(SrcIpAddr, srcipaddr_has_any_prefix)))\n and ((array_length(srchostname_has_any) == 0) or SrcHostname has_any (srchostname_has_any))\n and ((array_length(eventtype_in) == 0) or EventType in~ (eventtype_in))\n and (array_length(eventresultdetails_in) == 0 or EventResultDetails has_any (eventresultdetails_in))\n and (eventresult == \"*\" or (EventResult == eventresult))\n | extend\n User = TargetUsername,\n Src = coalesce (SrcDvcId, SrcHostname, SrcIpAddr),\n IpAddr=SrcIpAddr,\n LogonTarget= coalesce (TargetAppName, TargetUrl, TargetHostname),\n Dvc=EventVendor,\n Application=TargetAppName,\n Dst = coalesce (TargetDvcId,TargetHostname, TargetIpAddr, TargetAppId,TargetAppName), \n Rule = coalesce(RuleName, tostring(RuleNumber)),\n EventStartTime = TimeGenerated,\n EventEndTime = TimeGenerated,\n EventSchema = \"Authentication\"\n | project-rename\n EventUid = _ItemId\n | project-away TenantId, SourceSystem, _ResourceId, _SubscriptionId\n};\nparser\n (\n starttime=starttime,\n endtime=endtime,\n username_has_any=username_has_any,\n targetappname_has_any=targetappname_has_any,\n srcipaddr_has_any_prefix=srcipaddr_has_any_prefix,\n srchostname_has_any=srchostname_has_any,\n eventtype_in=eventtype_in,\n eventresultdetails_in=eventresultdetails_in,\n eventresult=eventresult,\n disabled=disabled\n)\n", "version": 1, "functionParameters": "starttime:datetime=datetime(null),endtime:datetime=datetime(null),username_has_any:dynamic=dynamic([]),targetappname_has_any:dynamic=dynamic([]),srcipaddr_has_any_prefix:dynamic=dynamic([]),srchostname_has_any:dynamic=dynamic([]),eventtype_in:dynamic=dynamic([]),eventresultdetails_in:dynamic=dynamic([]),eventresult:string='*',disabled:bool=False" } diff --git a/Solutions/Check Point CloudGuard CNAPP/Package/3.0.0.zip b/Solutions/Check Point CloudGuard CNAPP/Package/3.0.0.zip index 4f68527901a..98b7f78d809 100644 Binary files a/Solutions/Check Point CloudGuard CNAPP/Package/3.0.0.zip and b/Solutions/Check Point CloudGuard CNAPP/Package/3.0.0.zip differ diff --git a/Solutions/Check Point CloudGuard CNAPP/Package/mainTemplate.json b/Solutions/Check Point CloudGuard CNAPP/Package/mainTemplate.json index ab16ea67e62..b9a385dcb70 100644 --- a/Solutions/Check Point CloudGuard CNAPP/Package/mainTemplate.json +++ b/Solutions/Check Point CloudGuard CNAPP/Package/mainTemplate.json @@ -48,7 +48,7 @@ "_email": "[variables('email')]", "_solutionName": "Check Point CloudGuard CNAPP", "_solutionVersion": "3.0.0", - "solutionId": "checkpoint-cloudguard.checkpoint-sentinel-solutions-cloud-guard", + "solutionId": "checkpoint.checkpoint-sentinel-solutions-cloud-guard", "_solutionId": "[variables('solutionId')]", "workspaceResourceId": "[resourceId('microsoft.OperationalInsights/Workspaces', parameters('workspace'))]", "dataConnectorCCPVersion": "1.0.0", diff --git a/Solutions/Check Point CloudGuard CNAPP/SolutionMetadata.json b/Solutions/Check Point CloudGuard CNAPP/SolutionMetadata.json index d58b502f0ed..5b12dff7c29 100644 --- a/Solutions/Check Point CloudGuard CNAPP/SolutionMetadata.json +++ b/Solutions/Check Point CloudGuard CNAPP/SolutionMetadata.json @@ -1,5 +1,5 @@ { - "publisherId": "checkpoint-cloudguard", + "publisherId": "checkpoint", "offerId": "checkpoint-sentinel-solutions-cloud-guard", "firstPublishDate": "2024-11-12", "providers": [ diff --git a/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_DCR.json b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_DCR.json new file mode 100644 index 00000000000..3bfdb69386f --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_DCR.json @@ -0,0 +1,219 @@ +[ + { + "name": "DruvaDCR", + "apiVersion": "2021-09-01-preview", + "type": "Microsoft.Insights/dataCollectionRules", + "location": "{{location}}", + "properties": { + "dataCollectionEndpointId": "{{dataCollectionEndpointId}}", + "streamDeclarations": { + "Custom-DruvaSecurityEvents_CL": { + "columns": [ + { + "name": "TimeGenerated", + "type": "datetime" + }, + { + "name": "id", + "type": "int" + }, + { + "name": "globalCustomerId", + "type": "string" + }, + { + "name": "occurenceTime", + "type": "int" + }, + { + "name": "area", + "type": "string" + }, + { + "name": "category", + "type": "string" + }, + { + "name": "type", + "type": "string" + }, + { + "name": "syslogSeverity", + "type": "int" + }, + { + "name": "syslogFacility", + "type": "int" + }, + { + "name": "details", + "type": "string" + } + ] + }, + "Custom-DruvaPlatformEvents_CL": { + "columns": [ + { + "name": "TimeGenerated", + "type": "datetime" + }, + { + "name": "category", + "type": "string" + }, + { + "name": "details", + "type": "dynamic" + }, + { + "name": "feature", + "type": "string" + }, + { + "name": "globalID", + "type": "string" + }, + { + "name": "timeStamp", + "type": "int" + }, + { + "name": "productID", + "type": "int" + }, + { + "name": "syslogFacility", + "type": "int" + }, + { + "name": "syslogSeverity", + "type": "int" + }, + { + "name": "type", + "type": "string" + } + ] + }, + "Custom-DruvaInsyncEvents_CL": { + "columns": [ + { + "name": "eventType", + "type": "string" + }, + { + "name": "eventState", + "type": "string" + }, + { + "name": "eventID", + "type": "int" + }, + { + "name": "eventDetails", + "type": "string" + }, + { + "name": "timestamp", + "type": "datetime" + }, + { + "name": "initiator", + "type": "string" + }, + { + "name": "ip", + "type": "string" + }, + { + "name": "profileID", + "type": "string" + }, + { + "name": "profileName", + "type": "string" + }, + { + "name": "inSyncUserID", + "type": "string" + }, + { + "name": "inSyncUserName", + "type": "string" + }, + { + "name": "inSyncUserEmail", + "type": "string" + }, + { + "name": "inSyncDataSourceID", + "type": "string" + }, + { + "name": "inSyncDataSourceName", + "type": "string" + }, + { + "name": "clientOS", + "type": "string" + }, + { + "name": "clientVersion", + "type": "string" + }, + { + "name": "severity", + "type": "int" + }, + { + "name": "facility", + "type": "int" + } + ] + } + }, + "destinations": { + "logAnalytics": [ + { + "workspaceResourceId": "{{workspaceResourceId}}", + "name": "clv2ws1" + } + ] + }, + "dataFlows": [ + { + "streams": [ + "Custom-DruvaSecurityEvents_CL" + ], + "destinations": [ + "clv2ws1" + ], + "transformKql": "source\n| extend TimeGenerated = datetime_add('second',occurenceTime,make_datetime(1970,1,1)) \n| extend event_type = type\n| project-away occurenceTime, type\n| extend id = tostring(id) // Convert 'id' to string and rename to EventUid\n| project-rename EventUid = id\n\n", + "outputStream": "Custom-DruvaSecurityEvents_CL" + }, + + { + "streams": [ + "Custom-DruvaPlatformEvents_CL" + ], + "destinations": [ + "clv2ws1" + ], + "transformKql": "source\n| extend TimeGenerated = datetime_add('second',timeStamp,make_datetime(1970,1,1))\n| extend event_type = type\n| project-away timeStamp, type\n", + "outputStream": "Custom-DruvaPlatformEvents_CL" + }, + + { + "streams": [ + "Custom-DruvaInsyncEvents_CL" + ], + "destinations": [ + "clv2ws1" + ], + "transformKql": "source\n| extend TimeGenerated = timestamp\n| extend eventID = tostring(eventID)\n| project-rename EventUid = eventID\n| project-away timestamp\n", + "outputStream": "Custom-DruvaInsyncEvents_CL" + } + ] + } + } +] \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_DataConnectorDefinition.json b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_DataConnectorDefinition.json new file mode 100644 index 00000000000..ee3245accf1 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_DataConnectorDefinition.json @@ -0,0 +1,131 @@ +{ + "name": "DruvaEventCCPDefinition", + "apiVersion": "2022-09-01-preview", + "type": "Microsoft.SecurityInsights/dataConnectorDefinitions", + "location": "{{location}}", + "kind": "Customizable", + "properties": + { + + "connectorUiConfig": { + "id": "DruvaEventCCPDefinition", + "title": "Druva Events Connector", + "publisher" : "Microsoft", + "descriptionMarkdown" : "Provides capability to ingest the druva events from druva apis", + "graphQueriesTableName" : "DruvaSecurityEvents_CL", + "graphQueries": [ + { + "metricName":"Total Security Events", + "legend":"Druva Security events received", + "baseQuery": "{{graphQueriesTableName}}" + }, + + { + "metricName":"Total platform events", + "legend":"Druva platform events received", + "baseQuery": "DruvaPlatformEvents_CL" + }, + { + "metricName":"Total insync events", + "legend":"Druva insync events received", + "baseQuery": "DruvaInsyncEvents_CL" + } + ], + "sampleQueries":[ + { + "description": "Sample of Druva security events", + "query": "{{graphQueriesTableName}}\n| take 10" + }, + { + "description": "Sample of Druva platform events", + "query": "DruvaPlatformEvents_CL\n| take 10" + }, + { + "description": "Sample of Druva insync events", + "query": "DruvaInsyncEvents_CL\n| take 10" + } + ], + "dataTypes":[ + { + "name": "{{graphQueriesTableName}}", + "lastDataReceivedQuery": "{{graphQueriesTableName}}\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaPlatformEvents_CL", + "lastDataReceivedQuery": "DruvaPlatformEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaInsyncEvents_CL", + "lastDataReceivedQuery": "DruvaInsyncEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + } + ], + "connectivityCriteria":[ + { + "type": "HasDataConnectors" + } + ], + "permissions":{ + "resourceProvider":[ + { + "provider": "Microsoft.OperationalInsights/workspaces", + "permissionsDisplayText":"Read and Write permission are required", + "providerDisplayName":"Workspace", + "scope":"Workspace", + "requiredPermissions":{ + "write": true, + "read":true, + "delete": true + } + } + ], + "customs":[ + { + "name": "Druva API Access", + "description":"Druva api requires a client id and client secret to authenticate" + } + ] + }, + "instructionSteps":[ + { + "description": ">Note: Configurations to connect to Druva Rest API\n" + }, + { + "description": "Step 1: Create Crdentials from Druva Console: https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials\n" + }, + { + "description": "Step 2: Enter the hostname public cloud its apis.druva.com\n" + }, + { + "description": "Step 3: Get client id and client secret key\n" + }, + { + "description": "Provide required values:\n", + "instructions":[ + + { + "type": "Textbox", + "parameters": { + "label": "hostname", + "placeholder": "Example: apis.druva.com", + "type": "text", + "name": "hostname" + } + }, + + { + "type": "OAuthForm", + "parameters":{ + "clientIdLabel":"Client ID", + "clientSecretLabel" : "Client Secret", + "connectButtonLabel":"Connect", + "disconnectButtonLabel": "Diconnect" + + } + } + ], + "tittle": "Connect to Druva API to start collecting logs in microft sentinel" + } + ] + } + } +} \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_PollingConfig.json b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_PollingConfig.json new file mode 100644 index 00000000000..3339511330d --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_PollingConfig.json @@ -0,0 +1,156 @@ +[ + { + "name": "DruvaSecurityEventsPolling", + "apiVersion": "2022-12-01-preview", + "type": "Microsoft.SecurityInsights/dataConnectors", + "location": "{{location}}", + "kind": "RestApiPoller", + "properties": { + "connectorDefinitionName": "DruvaEventCCPDefinition", + "dataType": "DruvaSecurityEvents_CL", + "dcrConfig": { + "dataCollectionEndpoint": "{{dataCollectionEndpoint}}", + "dataCollectionRuleImmutableId": "{{dataCollectionRuleImmutableId}}", + "streamName": "Custom-DruvaSecurityEvents_CL" + }, + "auth": { + "type" : "OAuth2", + "clientSecret": "{{clientSecret}}", + "clientId": "{{clientId}}", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization" : "[[concat('Basic ', base64(concat(parameters('ClientId'), ':', parameters('ClientSecret'))))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + "request": { + "apiEndpoint": "https://{{hostname}}/realize/eventmanagement/v1/events/tracker", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + } + }, + "paging": { + "pagingType" : "PersistentToken", + "nextPageTokenJsonPath": "$.nextTrackerToken", + "nextPageParaName": "trackerToken" + }, + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + } + } + }, + { + "name": "DruvaPlatformEventsPolling", + "apiVersion": "2022-12-01-preview", + "type": "Microsoft.SecurityInsights/dataConnectors", + "location": "{{location}}", + "kind": "RestApiPoller", + "properties": { + "connectorDefinitionName": "DruvaEventCCPDefinition", + "dataType": "DruvaPlatformEvents_CL", + "dcrConfig": { + "dataCollectionEndpoint": "{{dataCollectionEndpoint}}", + "dataCollectionRuleImmutableId": "{{dataCollectionRuleImmutableId}}", + "streamName": "Custom-DruvaPlatformEvents_CL" + }, + "auth": { + "type" : "OAuth2", + "clientSecret": "{{clientSecret}}", + "clientId": "{{clientId}}", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization" : "[[concat('Basic ', base64(concat(parameters('ClientId'), ':', parameters('ClientSecret'))))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + "request": { + "apiEndpoint": "https://{{hostname}}/platform/eventmanagement/v2/events", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + } + }, + "paging": { + "pagingType" : "PersistentToken", + "nextPageTokenJsonPath": "$.nextPageToken", + "nextPageParaName": "pageToken" + }, + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + } + } + }, + { + "name": "DruvaInsyncEventsPolling", + "apiVersion": "2022-12-01-preview", + "type": "Microsoft.SecurityInsights/dataConnectors", + "location": "{{location}}", + "kind": "RestApiPoller", + "properties": { + "connectorDefinitionName": "DruvaEventCCPDefinition", + "dataType": "DruvaInsyncEvents_CL", + "dcrConfig": { + "dataCollectionEndpoint": "{{dataCollectionEndpoint}}", + "dataCollectionRuleImmutableId": "{{dataCollectionRuleImmutableId}}", + "streamName": "Custom-DruvaInsyncEvents_CL" + }, + "auth": { + "type" : "OAuth2", + "clientSecret": "{{clientSecret}}", + "clientId": "{{clientId}}", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization" : "[[concat('Basic ', base64(concat(parameters('ClientId'), ':', parameters('ClientSecret'))))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + "request": { + "apiEndpoint": "https://{{hostname}}/insync/eventmanagement/v2/events", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + + } + }, + "paging": { + "pagingType" : "PersistentToken", + "nextPageTokenJsonPath": "$.tracker", + "nextPageParaName": "tracker" + }, + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + } + } + } +] \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_Tables.json b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_Tables.json new file mode 100644 index 00000000000..6ebd2eb5aca --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/Druva_Tables.json @@ -0,0 +1,259 @@ +[ + { + "name": "DruvaSecurityEvents_CL", + "type": "Microsoft.OperationalInsights/workspaces/tables", + "apiVersion": "2021-03-01-privatepreview", + "location": "{{location}}", + "properties": { + "schema": { + "name": "DruvaSecurityEvents_CL", + "columns": [ + { + "name": "area", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "category", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "details", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "globalCustomerId", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogFacility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogSeverity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "event_type", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "EventUid", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + }, + + { + "name": "DruvaPlatformEvents_CL", + "type": "Microsoft.OperationalInsights/workspaces/tables", + "apiVersion": "2021-03-01-privatepreview", + "location": "{{location}}", + "properties": { + "schema": { + "name": "DruvaPlatformEvents_CL", + "columns": [ + { + "name": "category", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "details", + "type": "dynamic", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "feature", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "globalID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "productID", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogFacility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogSeverity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "event_type", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + }, + + { + "name": "DruvaInsyncEvents_CL", + "type": "Microsoft.OperationalInsights/workspaces/tables", + "apiVersion": "2021-03-01-privatepreview", + "location": "{{location}}", + "properties": { + "schema": { + "name": "DruvaInsyncEvents_CL", + "columns": [ + { + "name": "clientOS", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "clientVersion", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventDetails", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventState", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventType", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "facility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "initiator", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncDataSourceID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncDataSourceName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserEmail", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "ip", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "profileID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "profileName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "severity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "EventUid", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + } +] \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/azuredeploy_DruvaEvents_poller_connector.json b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/azuredeploy_DruvaEvents_poller_connector.json new file mode 100644 index 00000000000..de1309ac4c7 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data Connectors/Druva_ccp/azuredeploy_DruvaEvents_poller_connector.json @@ -0,0 +1,1061 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "workspace": { + "defaultValue": "", + "type": "string", + "metadata": { + "description": "the log analytics workspace enabled for Microsoft Sentinel" + } + } + }, + "variables": { + "DCRName": "DruvaDCR", + "workspaceResourceId": "[resourceId('microsoft.OperationalInsights/Workspaces', parameters('workspace'))]", + "_solutionName": "Druva Events Connector", + "_solutionVersion": "1.0.0", + "_solutionAuthor": "Druva", + "_packageIcon": "icon icon icon icon", + "_solutionId": "azuresentinel.azure-sentinel-solution-azuresentinel.azure-sentinel-Druva", + "dataConnectorVersionConnectorDefinition": "1.0.0", + "dataConnectorVersionConnections": "1.0.0", + "_solutionTier": "Druva", + "_dataConnectorContentIdConnectorDefinition": "DruvaDataConnectorDefinition", + "dataConnectorTemplateNameConnectorDefinition": "[concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentIdConnectorDefinition')))]", + "_dataConnectorContentIdConnections": "DruvaDataConnections", + "dataConnectorTemplateNameConnections": "[concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentIdConnections')))]", + "location": "[resourceGroup().location]", + "subscriptionId": "[last(split(subscription().id, '/'))]", + "druvaSecurityEventsTableName": "DruvaSecurityEvents_CL", + "druvaPlatformEventsTableName": "DruvaPlatformEvents_CL", + "druvaInsyncEventsTableName": "DruvaInsyncEvents_CL" + }, + + "resources": [ + + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', variables('dataConnectorTemplateNameConnectorDefinition'), variables('dataConnectorVersionConnectorDefinition'))]", + "location": "[variables('location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "contentId": "[variables('_dataConnectorContentIdConnectorDefinition')]", + "displayName": "[concat(variables('_solutionName'), variables('dataConnectorTemplateNameConnectorDefinition'))]", + "contentKind": "DataConnector", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('dataConnectorVersionConnectorDefinition')]", + "parameters": {}, + "variables": {}, + "resources": [ + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', variables('_dataConnectorContentIdConnectorDefinition')))]", + "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "properties": { + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectorDefinitions', variables('_dataConnectorContentIdConnectorDefinition'))]", + "contentId": "[variables('_dataConnectorContentIdConnectorDefinition')]", + "kind": "DataConnector", + "version": "[variables('dataConnectorVersionConnectorDefinition')]", + "source": { + "sourceId": "[variables('_solutionId')]", + "name": "[variables('_solutionName')]", + "kind": "Solution" + }, + "author": { + "name": "[variables('_solutionAuthor')]" + }, + "support": { + "name": "[variables('_solutionAuthor')]", + "tier": "[variables('_solutionTier')]" + }, + "dependencies": { + "criteria": [ + { + "version": "[variables('dataConnectorVersionConnections')]", + "contentId": "[variables('_dataConnectorContentIdConnections')]", + "kind": "ResourcesDataConnector" + } + ] + } + } + }, + { + "name": "[variables('DCRName')]", + "apiVersion": "2021-09-01-preview", + "type": "Microsoft.Insights/dataCollectionRules", + "location": "[variables('location')]", + "properties": { + "dataCollectionEndpointId": "[concat('/subscriptions/',variables('subscriptionID'),'/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Insights/dataCollectionEndpoints/',parameters('workspace'))]", + "streamDeclarations": { + "[concat('Custom-', variables('druvaSecurityEventsTableName'))]": { + "columns": [ + { + "name": "TimeGenerated", + "type": "datetime" + }, + { + "name": "id", + "type": "int" + }, + { + "name": "globalCustomerId", + "type": "string" + }, + { + "name": "occurenceTime", + "type": "int" + }, + { + "name": "area", + "type": "string" + }, + { + "name": "category", + "type": "string" + }, + { + "name": "type", + "type": "string" + }, + { + "name": "syslogSeverity", + "type": "int" + }, + { + "name": "syslogFacility", + "type": "int" + }, + { + "name": "details", + "type": "string" + } + ] + }, + "[concat('Custom-', variables('druvaPlatformEventsTableName'))]": { + "columns": [ + { + "name": "TimeGenerated", + "type": "datetime" + }, + { + "name": "category", + "type": "string" + }, + { + "name": "details", + "type": "dynamic" + }, + { + "name": "feature", + "type": "string" + }, + { + "name": "globalID", + "type": "string" + }, + { + "name": "timeStamp", + "type": "int" + }, + { + "name": "productID", + "type": "int" + }, + { + "name": "syslogFacility", + "type": "int" + }, + { + "name": "syslogSeverity", + "type": "int" + }, + { + "name": "type", + "type": "string" + } + ] + }, + "[concat('Custom-', variables('druvaInsyncEventsTableName'))]": { + "columns": [ + { + "name": "eventType", + "type": "string" + }, + { + "name": "eventState", + "type": "string" + }, + { + "name": "eventID", + "type": "int" + }, + { + "name": "eventDetails", + "type": "string" + }, + { + "name": "timestamp", + "type": "datetime" + }, + { + "name": "initiator", + "type": "string" + }, + { + "name": "ip", + "type": "string" + }, + { + "name": "profileID", + "type": "string" + }, + { + "name": "profileName", + "type": "string" + }, + { + "name": "inSyncUserID", + "type": "string" + }, + { + "name": "inSyncUserName", + "type": "string" + }, + { + "name": "inSyncUserEmail", + "type": "string" + }, + { + "name": "inSyncDataSourceID", + "type": "string" + }, + { + "name": "inSyncDataSourceName", + "type": "string" + }, + { + "name": "clientOS", + "type": "string" + }, + { + "name": "clientVersion", + "type": "string" + }, + { + "name": "severity", + "type": "int" + }, + { + "name": "facility", + "type": "int" + } + ] + } + }, + "destinations": { + "logAnalytics": [ + { + "workspaceResourceId": "[variables('workspaceResourceId')]", + "name": "clv2ws1" + } + ] + }, + "dataFlows": [ + { + "streams": [ + "[concat('Custom-', variables('druvaSecurityEventsTableName'))]" + ], + "destinations": [ + "clv2ws1" + ], + "transformKql": "source\n| extend TimeGenerated = datetime_add('second',occurenceTime,make_datetime(1970,1,1)) \n| extend event_type = type\n| project-away occurenceTime, type\n| extend id = tostring(id) // Convert 'id' to string and rename to EventUid\n| project-rename EventUid = id\n\n", + "outputStream": "[concat('Custom-', variables('druvaSecurityEventsTableName'))]" + }, + + { + "streams": [ + "[concat('Custom-', variables('druvaPlatformEventsTableName'))]" + ], + "destinations": [ + "clv2ws1" + ], + "transformKql": "source\n| extend TimeGenerated = datetime_add('second',timeStamp,make_datetime(1970,1,1))\n| extend event_type = type\n| project-away timeStamp, type\n", + "outputStream": "[concat('Custom-', variables('druvaPlatformEventsTableName'))]" + }, + + { + "streams": [ + "[concat('Custom-', variables('druvaInsyncEventsTableName'))]" + ], + "destinations": [ + "clv2ws1" + ], + "transformKql": "source\n| extend TimeGenerated = timestamp\n| extend eventID = tostring(eventID)\n| project-rename EventUid = eventID\n| project-away timestamp\n", + "outputStream": "[concat('Custom-', variables('druvaInsyncEventsTableName'))]" + } + ] + } + }, + { + "name": "[variables('druvaSecurityEventsTableName')]", + "apiVersion": "2021-03-01-privatepreview", + "type": "Microsoft.OperationalInsights/workspaces", + "location": "[variables('location')]", + "properties": { + "schema": { + "name": "[variables('druvaSecurityEventsTableName')]", + "columns": [ + { + "name": "area", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "category", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "details", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "globalCustomerId", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogFacility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogSeverity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "event_type", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "EventUid", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + }, + + { + "name": "[variables('druvaPlatformEventsTableName')]", + "apiVersion": "2021-03-01-privatepreview", + "type": "Microsoft.OperationalInsights/workspaces", + "location": "[variables('location')]", + "properties": { + "schema": { + "name": "[variables('druvaPlatformEventsTableName')]", + "columns": [ + { + "name": "category", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "details", + "type": "dynamic", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "feature", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "globalID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "productID", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogFacility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogSeverity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "event_type", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + }, + + { + "name": "[variables('druvaInsyncEventsTableName')]", + "apiVersion": "2021-03-01-privatepreview", + "type": "Microsoft.OperationalInsights/workspaces", + "location": "[variables('location')]", + "kind": null, + "properties": { + "schema": { + "name": "[variables('druvaInsyncEventsTableName')]", + "columns": [ + { + "name": "clientOS", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "clientVersion", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventDetails", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventState", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventType", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "facility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "initiator", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncDataSourceID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncDataSourceName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserEmail", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "ip", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "profileID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "profileName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "severity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "EventUid", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + } + ] + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "contentProductId": "[concat(substring(variables('_solutionId'), 0, 50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentIdConnectorDefinition'),'-', variables('dataConnectorVersionConnectorDefinition'))))]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "version": "[variables('_solutionVersion')]" + } + }, + + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentIdConnectorDefinition'))]", + "apiVersion": "2022-09-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectorDefinitions", + "location": "[variables('location')]", + "kind": "Customizable", + "properties": + { + "connectorUiConfig": { + "title": "Druva Events Connector", + "publisher" : "Microsoft", + "descriptionMarkdown" : "Provides capability to ingest the druva events from druva apis", + "graphQueriesTableName" : "[variables('druvaSecurityEventsTableName')]", + "graphQueries": [ + { + "metricName":"Total Security Events", + "legend":"Druva Security events received", + "baseQuery": "{{graphQueriesTableName}}" + }, + + { + "metricName":"Total platform events", + "legend":"Druva platform events received", + "baseQuery": "DruvaPlatformEvents_CL" + }, + { + "metricName":"Total insync events", + "legend":"Druva insync events received", + "baseQuery": "DruvaInsyncEvents_CL" + } + ], + "sampleQueries":[ + { + "description": "Sample of Druva security events", + "query": "{{graphQueriesTableName}}\n| take 10" + }, + { + "description": "Sample of Druva platform events", + "query": "DruvaPlatformEvents_CL\n| take 10" + }, + { + "description": "Sample of Druva insync events", + "query": "DruvaInsyncEvents_CL\n| take 10" + } + ], + "dataTypes":[ + { + "name": "{{graphQueriesTableName}}", + "lastDataReceivedQuery": "{{graphQueriesTableName}}\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaPlatformEvents_CL", + "lastDataReceivedQuery": "DruvaPlatformEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaInsyncEvents_CL", + "lastDataReceivedQuery": "DruvaInsyncEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + } + ], + "connectivityCriteria":[ + { + "type": "HasDataConnectors" + } + ], + "permissions":{ + "resourceProvider":[ + { + "provider": "Microsoft.OperationalInsights/workspaces", + "permissionsDisplayText":"Read and Write permission are required", + "providerDisplayName":"Workspace", + "scope":"Workspace", + "requiredPermissions":{ + "write": true, + "read":true, + "delete": true + } + } + ], + "customs":[ + { + "name": "Druva API credential", + "description":"Druva api requires a client id and client secret to authenticate" + } + ] + }, + "instructionSteps":[ + { + "description": ">Note: Configurations to connect to Druva Rest API\n" + }, + { + "description": "Step 1: Create Crdentials from Druva Console: https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials\n" + }, + { + "description": "Step 2: Enter the hostname public cloud its apis.druva.com\n" + }, + { + "description": "Step 3: Get client id and client secret key\n" + }, + { + "description": "Provide required values:\n", + "instructions":[ + + { + "type": "Textbox", + "parameters": { + "label": "hostname", + "placeholder": "Example: apis.druva.com", + "type": "text", + "name": "hostname" + } + }, + + { + "type": "OAuthForm", + "parameters":{ + "clientIdLabel":"Client ID", + "clientSecretLabel" : "Client Secret", + "connectButtonLabel":"Connect", + "disconnectButtonLabel": "Diconnect" + } + } + ], + "tittle": "Connect to Druva API to start collecting logs in microft sentinel" + } + ] + } + } + }, + + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', variables('_dataConnectorContentIdConnectorDefinition')))]", + "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "properties": { + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectorDefinitions', variables('_dataConnectorContentIdConnectorDefinition'))]", + "contentId": "[variables('_dataConnectorContentIdConnectorDefinition')]", + "kind": "DataConnector", + "version": "[variables('dataConnectorVersionConnectorDefinition')]", + "source": { + "sourceId": "[variables('_solutionId')]", + "name": "[variables('_solutionName')]", + "kind": "Solution" + }, + "author": { + "name": "[variables('_solutionAuthor')]" + }, + "support": { + "name": "[variables('_solutionAuthor')]", + "tier": "[variables('_solutionTier')]" + }, + "dependencies": { + "criteria": [ + { + "version": "[variables('dataConnectorVersionConnections')]", + "contentId": "[variables('_dataConnectorContentIdConnections')]", + "kind": "ResourcesDataConnector" + } + ] + } + } + }, + + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', variables('dataConnectorTemplateNameConnections'), variables('dataConnectorVersionConnections'))]", + "location": "[variables('location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "contentId": "[variables('_dataConnectorContentIdConnections')]", + "displayName": "[concat(variables('_solutionName'), variables('dataConnectorTemplateNameConnections'))]", + "contentKind": "ResourcesDataConnector", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('dataConnectorVersionConnections')]", + "parameters":{ + "connectorDefinitionName": { + "defaultValue": "connectorDefinitionName", + "type": "string", + "minLength": 1 + }, + + "hostname":{ + "defaultValue": "apis.druva.com", + "type":"string", + "minlength": 1, + "metadata":{ + "description": "hostname" + } + }, + + "clientId":{ + "defaultValue": "-NA-", + "type":"string", + "minlength": 1, + "metadata":{ + "description": "clientId" + } + }, + + "clientSecret":{ + "defaultValue": "-NA-", + "type":"string", + "minlength": 1, + "metadata":{ + "description": "clientSecret" + } + }, + + "workspace": { + "defaultValue": "[parameters('workspace')]", + "type": "string" + }, + "dcrConfig": { + "defaultValue": { + "dataCollectionEndpoint": "data collection Endpoint", + "dataCollectionRuleImmutableId": "data collection rule immutableId" + }, + "type": "object" + } + + }, + "variables": { + "_dataConnectorContentIdConnections": "[variables('_dataConnectorContentIdConnections')]", + "clientAuthBase64": "[[base64(concat(parameters('clientId'), ':', parameters('clientSecret')))]" + }, + "resources": [ + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', variables('_dataConnectorContentIdConnections')))]", + "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "properties": { + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentIdConnections'))]", + "contentId": "[variables('_dataConnectorContentIdConnections')]", + "kind": "ResourcesDataConnector", + "version": "[variables('dataConnectorVersionConnections')]", + "source": { + "sourceId": "[variables('_solutionId')]", + "name": "[variables('_solutionName')]", + "kind": "Solution" + }, + "author": { + "name": "[variables('_solutionAuthor')]" + }, + "support": { + "name": "[variables('_solutionAuthor')]", + "tier": "[variables('_solutionTier')]" + } + } + }, + + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', 'RealizeConnector')]", + + "apiVersion": "2022-12-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", + "location": "[variables('location')]", + "kind": "RestApiPoller", + "properties": + { + + "dataType": "[variables('druvaSecurityEventsTableName')]", + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + }, + "paging": { + "pagingType" : "PersistentToken", + "nextPageTokenJsonPath": "$.nextTrackerToken", + "nextPageParaName": "trackerToken" + }, + "connectorDefinitionName": "[[parameters('connectorDefinitionName')]", + "auth": { + "type" : "OAuth2", + "clientSecret": "[[parameters('clientSecret')]", + "clientId": "[[parameters('clientId')]", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization" : "[[concat('Basic ', variables('clientAuthBase64'))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + + "request": { + "apiEndpoint": "[[concat('https://', parameters('hostname'), '/realize/eventmanagement/v1/events/tracker')]", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + + } + }, + "dcrConfig": { + "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]", + "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]", + "streamName": "[concat('Custom-', variables('druvaSecurityEventsTableName'))]" + }, + "isActive": true + } + }, + + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', 'PlatformConnector')]", + + "apiVersion": "2022-12-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", + "location": "[variables('location')]", + "kind": "RestApiPoller", + "properties": + { + + "dataType": "[variables('druvaPlatformEventsTableName')]", + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + }, + "paging": { + "pagingType" : "PersistentToken", + "nextPageTokenJsonPath": "$.nextPageToken", + "nextPageParaName": "pageToken" + }, + "connectorDefinitionName": "[[parameters('connectorDefinitionName')]", + "auth": { + "type" : "OAuth2", + "clientSecret": "[[parameters('clientSecret')]", + "clientId": "[[parameters('clientId')]", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization" : "[[concat('Basic ', variables('clientAuthBase64'))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + + "request": { + "apiEndpoint": "[[concat('https://', parameters('hostname'), '/platform/eventmanagement/v2/events')]", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + + } + }, + "dcrConfig": { + "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]", + "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]", + "streamName": "[concat('Custom-', variables('druvaPlatformEventsTableName'))]" + }, + "isActive": true + } + }, + + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', 'InsyncConnector')]", + + "apiVersion": "2022-12-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", + "location": "[variables('location')]", + "kind": "RestApiPoller", + "properties": + { + + "dataType": "[variables('druvaInsyncEventsTableName')]", + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + }, + + "paging": { + "pagingType" : "PersistentToken", + "nextPageTokenJsonPath": "$.tracker", + "nextPageParaName": "tracker" + }, + + "connectorDefinitionName": "[[parameters('connectorDefinitionName')]", + "auth": { + "type" : "OAuth2", + "clientSecret": "[[parameters('clientSecret')]", + "clientId": "[[parameters('clientId')]", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization" : "[[concat('Basic ', variables('clientAuthBase64'))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + + "request": { + "apiEndpoint": "[[concat('https://', parameters('hostname'), '/insync/eventmanagement/v2/events')]", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + + } + }, + "dcrConfig": { + "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]", + "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]", + "streamName": "[concat('Custom-', variables('druvaInsyncEventsTableName'))]" + }, + "isActive": true + } + } + + ] + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "contentProductId": "[concat(substring(variables('_solutionId'), 0, 50),'-','rdc','-', uniqueString(concat(variables('_solutionId'),'-','ResourcesDataConnector','-',variables('_dataConnectorContentIdConnections'),'-', variables('dataConnectorVersionConnections'))))]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "version": "[variables('_solutionVersion')]" + } + }, + + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentPackages", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', variables('_solutionId'))]", + "location": "[variables('location')]", + "apiVersion": "2023-04-01-preview", + "properties": { + "version": "[variables('_solutionVersion')]", + "kind": "Solution", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_solutionId')]", + "source": { + "kind": "Solution", + "name": "[variables('_solutionName')]", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "[variables('_solutionAuthor')]" + }, + "support": { + "name": "[variables('_solutionAuthor')]" + }, + "dependencies": { + "operator": "AND", + "criteria": [ + { + "kind": "DataConnector", + "contentId": "[variables('dataConnectorVersionConnectorDefinition')]", + "version": "[variables('_dataConnectorContentIdConnectorDefinition')]" + } + ] + }, + "firstPublishDate": "2023-12-05", + "providers": [ + "[variables('_solutionAuthor')]" + ], + "contentKind": "Solution", + "packageId": "[variables('_solutionId')]", + "contentProductId": "[concat(substring(variables('_solutionId'), 0, 50),'-','sl','-', uniqueString(concat(variables('_solutionId'),'-','Solution','-',variables('_solutionId'),'-', variables('_solutionVersion'))))]", + "displayName": "[variables('_solutionName')]", + "publisherDisplayName": "[variables('_solutionId')]", + "descriptionHtml": "test", + "icon": "[variables('_packageIcon')]" + } + } + + ] +} diff --git a/Solutions/DruvaDataSecurityCloud/Data Connectors/Logo/Druva_Logo.svg b/Solutions/DruvaDataSecurityCloud/Data Connectors/Logo/Druva_Logo.svg new file mode 100644 index 00000000000..634576f5eda --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data Connectors/Logo/Druva_Logo.svg @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/Solutions/DruvaDataSecurityCloud/Data/Solution_Druva.json b/Solutions/DruvaDataSecurityCloud/Data/Solution_Druva.json new file mode 100644 index 00000000000..82b5bbf4ca2 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Data/Solution_Druva.json @@ -0,0 +1,21 @@ +{ + "Name": "DruvaDataSecurityCloud", + "Author": "Druva - support@druva.com", + "Logo": "", + "Description": "The [Druva Event CCP Connector] solution provides the capability to ingest to ingest [Druva events]", + "Playbooks": [ + "Playbooks/DruvaQuarantineEnterpriseWorkload/azuredeploy.json", + "Playbooks/DruvaQuarantineInsyncWorkloads/azuredeploy.json", + "Playbooks/DruvaQuarantineUsingResourceID/azuredeploy.json", + "Playbooks/DruvaQuarantineSharePoint/azuredeploy.json", + "Playbooks/DruvaQuarantineSharedDrive/azuredeploy.json" + ], + "Data Connectors": [ + "Data Connectors/Druva_ccp/Druva_DataConnectorDefinition.json" + ], + "BasePath": "C:\\GitHub\\Azure-Sentinel\\Solutions\\DruvaDataSecurityCloud", + "Version": "3.0.0", + "Metadata": "SolutionMetadata.json", + "TemplateSpec": true, + "Is1PConnector": false +} diff --git a/Solutions/DruvaDataSecurityCloud/Package/3.0.0.zip b/Solutions/DruvaDataSecurityCloud/Package/3.0.0.zip new file mode 100644 index 00000000000..2703d3c3a10 Binary files /dev/null and b/Solutions/DruvaDataSecurityCloud/Package/3.0.0.zip differ diff --git a/Solutions/DruvaDataSecurityCloud/Package/createUiDefinition.json b/Solutions/DruvaDataSecurityCloud/Package/createUiDefinition.json new file mode 100644 index 00000000000..02c0c14c17e --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Package/createUiDefinition.json @@ -0,0 +1,113 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/0.1.2-preview/CreateUIDefinition.MultiVm.json#", + "handler": "Microsoft.Azure.CreateUIDef", + "version": "0.1.2-preview", + "parameters": { + "config": { + "isWizard": false, + "basics": { + "description": "\n\n**Note:** Please refer to the following before installing the solution: \n\n• Review the solution [Release Notes](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/DruvaDataSecurityCloud/ReleaseNotes.md)\n\n • There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing.\n\nThe [Druva Event CCP Connector] solution provides the capability to ingest to ingest [Druva events]\n\n**Data Connectors:** 1, **Playbooks:** 5\n\n[Learn more about Microsoft Sentinel](https://aka.ms/azuresentinel) | [Learn more about Solutions](https://aka.ms/azuresentinelsolutionsdoc)", + "subscription": { + "resourceProviders": [ + "Microsoft.OperationsManagement/solutions", + "Microsoft.OperationalInsights/workspaces/providers/alertRules", + "Microsoft.Insights/workbooks", + "Microsoft.Logic/workflows" + ] + }, + "location": { + "metadata": { + "hidden": "Hiding location, we get it from the log analytics workspace" + }, + "visible": false + }, + "resourceGroup": { + "allowExisting": true + } + } + }, + "basics": [ + { + "name": "getLAWorkspace", + "type": "Microsoft.Solutions.ArmApiControl", + "toolTip": "This filters by workspaces that exist in the Resource Group selected", + "condition": "[greater(length(resourceGroup().name),0)]", + "request": { + "method": "GET", + "path": "[concat(subscription().id,'/providers/Microsoft.OperationalInsights/workspaces?api-version=2020-08-01')]" + } + }, + { + "name": "workspace", + "type": "Microsoft.Common.DropDown", + "label": "Workspace", + "placeholder": "Select a workspace", + "toolTip": "This dropdown will list only workspace that exists in the Resource Group selected", + "constraints": { + "allowedValues": "[map(filter(basics('getLAWorkspace').value, (filter) => contains(toLower(filter.id), toLower(resourceGroup().name))), (item) => parse(concat('{\"label\":\"', item.name, '\",\"value\":\"', item.name, '\"}')))]", + "required": true + }, + "visible": true + } + ], + "steps": [ + { + "name": "dataconnectors", + "label": "Data Connectors", + "bladeTitle": "Data Connectors", + "elements": [ + { + "name": "dataconnectors1-text", + "type": "Microsoft.Common.TextBlock", + "options": { + "text": "This Solution installs the data connector for DruvaDataSecurityCloud. You can get DruvaDataSecurityCloud data in your Microsoft Sentinel workspace. After installing the solution, configure and enable this data connector by following guidance in Manage solution view." + } + }, + { + "name": "dataconnectors-link2", + "type": "Microsoft.Common.TextBlock", + "options": { + "link": { + "label": "Learn more about connecting data sources", + "uri": "https://docs.microsoft.com/azure/sentinel/connect-data-sources" + } + } + } + ] + }, + { + "name": "playbooks", + "label": "Playbooks", + "subLabel": { + "preValidation": "Configure the playbooks", + "postValidation": "Done" + }, + "bladeTitle": "Playbooks", + "elements": [ + { + "name": "playbooks-text", + "type": "Microsoft.Common.TextBlock", + "options": { + "text": "This solution installs the Playbook templates to help implement your Security Orchestration, Automation and Response (SOAR) operations. After installing the solution, these will be deployed under Playbook Templates in the Automation blade in Microsoft Sentinel. They can be configured and managed from the Manage solution view in Content Hub." + } + }, + { + "name": "playbooks-link", + "type": "Microsoft.Common.TextBlock", + "options": { + "link": { + "label": "Learn more", + "uri": "https://docs.microsoft.com/azure/sentinel/tutorial-respond-threats-playbook?WT.mc_id=Portal-Microsoft_Azure_CreateUIDef" + } + } + } + ] + } + ], + "outputs": { + "workspace-location": "[first(map(filter(basics('getLAWorkspace').value, (filter) => and(contains(toLower(filter.id), toLower(resourceGroup().name)),equals(filter.name,basics('workspace')))), (item) => item.location))]", + "location": "[location()]", + "workspace": "[basics('workspace')]" + } + } +} diff --git a/Solutions/DruvaDataSecurityCloud/Package/mainTemplate.json b/Solutions/DruvaDataSecurityCloud/Package/mainTemplate.json new file mode 100644 index 00000000000..a53d4e3faab --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Package/mainTemplate.json @@ -0,0 +1,4534 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "metadata": { + "author": "Druva - support@druva.com", + "comments": "Solution template for DruvaDataSecurityCloud" + }, + "parameters": { + "location": { + "type": "string", + "minLength": 1, + "defaultValue": "[resourceGroup().location]", + "metadata": { + "description": "Not used, but needed to pass arm-ttk test `Location-Should-Not-Be-Hardcoded`. We instead use the `workspace-location` which is derived from the LA workspace" + } + }, + "workspace-location": { + "type": "string", + "defaultValue": "", + "metadata": { + "description": "[concat('Region to deploy solution resources -- separate from location selection',parameters('location'))]" + } + }, + "workspace": { + "defaultValue": "", + "type": "string", + "metadata": { + "description": "Workspace name for Log Analytics where Microsoft Sentinel is setup" + } + }, + "resourceGroupName": { + "type": "string", + "defaultValue": "[resourceGroup().name]", + "metadata": { + "description": "resource group name where Microsoft Sentinel is setup" + } + }, + "subscription": { + "type": "string", + "defaultValue": "[last(split(subscription().id, '/'))]", + "metadata": { + "description": "subscription id where Microsoft Sentinel is setup" + } + } + }, + "variables": { + "email": "support@druva.com", + "_email": "[variables('email')]", + "_solutionName": "DruvaDataSecurityCloud", + "_solutionVersion": "3.0.0", + "solutionId": "druva-azuresentinel-solution.azure-sentinel-solution-druva", + "_solutionId": "[variables('solutionId')]", + "DruvaQuarantineEnterpriseWorkload": "DruvaQuarantineEnterpriseWorkload", + "_DruvaQuarantineEnterpriseWorkload": "[variables('DruvaQuarantineEnterpriseWorkload')]", + "TemplateEmptyArray": "[json('[]')]", + "playbookVersion1": "1.0", + "playbookContentId1": "DruvaQuarantineEnterpriseWorkload", + "_playbookContentId1": "[variables('playbookContentId1')]", + "playbookId1": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId1'))]", + "playbookTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pl-',uniquestring(variables('_playbookContentId1'))))]", + "workspaceResourceId": "[resourceId('microsoft.OperationalInsights/Workspaces', parameters('workspace'))]", + "_playbookcontentProductId1": "[concat(take(variables('_solutionId'),50),'-','pl','-', uniqueString(concat(variables('_solutionId'),'-','Playbook','-',variables('_playbookContentId1'),'-', variables('playbookVersion1'))))]", + "blanks": "[replace('b', 'b', '')]", + "DruvaQuarantineInsyncWorkloads": "DruvaQuarantineInsyncWorkloads", + "_DruvaQuarantineInsyncWorkloads": "[variables('DruvaQuarantineInsyncWorkloads')]", + "playbookVersion2": "1.0", + "playbookContentId2": "DruvaQuarantineInsyncWorkloads", + "_playbookContentId2": "[variables('playbookContentId2')]", + "playbookId2": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId2'))]", + "playbookTemplateSpecName2": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pl-',uniquestring(variables('_playbookContentId2'))))]", + "_playbookcontentProductId2": "[concat(take(variables('_solutionId'),50),'-','pl','-', uniqueString(concat(variables('_solutionId'),'-','Playbook','-',variables('_playbookContentId2'),'-', variables('playbookVersion2'))))]", + "DruvaQuarantineUsingResourceID": "DruvaQuarantineUsingResourceID", + "_DruvaQuarantineUsingResourceID": "[variables('DruvaQuarantineUsingResourceID')]", + "playbookVersion3": "1.0", + "playbookContentId3": "DruvaQuarantineUsingResourceID", + "_playbookContentId3": "[variables('playbookContentId3')]", + "playbookId3": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId3'))]", + "playbookTemplateSpecName3": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pl-',uniquestring(variables('_playbookContentId3'))))]", + "_playbookcontentProductId3": "[concat(take(variables('_solutionId'),50),'-','pl','-', uniqueString(concat(variables('_solutionId'),'-','Playbook','-',variables('_playbookContentId3'),'-', variables('playbookVersion3'))))]", + "DruvaQuarantineSharePoint": "DruvaQuarantineSharePoint", + "_DruvaQuarantineSharePoint": "[variables('DruvaQuarantineSharePoint')]", + "playbookVersion4": "1.0", + "playbookContentId4": "DruvaQuarantineSharePoint", + "_playbookContentId4": "[variables('playbookContentId4')]", + "playbookId4": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId4'))]", + "playbookTemplateSpecName4": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pl-',uniquestring(variables('_playbookContentId4'))))]", + "_playbookcontentProductId4": "[concat(take(variables('_solutionId'),50),'-','pl','-', uniqueString(concat(variables('_solutionId'),'-','Playbook','-',variables('_playbookContentId4'),'-', variables('playbookVersion4'))))]", + "DruvaQuarantineSharedDrive": "DruvaQuarantineSharedDrive", + "_DruvaQuarantineSharedDrive": "[variables('DruvaQuarantineSharedDrive')]", + "playbookVersion5": "1.0", + "playbookContentId5": "DruvaQuarantineSharedDrive", + "_playbookContentId5": "[variables('playbookContentId5')]", + "playbookId5": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId5'))]", + "playbookTemplateSpecName5": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pl-',uniquestring(variables('_playbookContentId5'))))]", + "_playbookcontentProductId5": "[concat(take(variables('_solutionId'),50),'-','pl','-', uniqueString(concat(variables('_solutionId'),'-','Playbook','-',variables('_playbookContentId5'),'-', variables('playbookVersion5'))))]", + "dataConnectorCCPVersion": "1.0.0", + "_dataConnectorContentIdConnectorDefinition1": "DruvaEventCCPDefinition", + "dataConnectorTemplateNameConnectorDefinition1": "[concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentIdConnectorDefinition1')))]", + "_dataConnectorContentIdConnections1": "DruvaEventCCPDefinitionConnections", + "dataConnectorTemplateNameConnections1": "[concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentIdConnections1')))]", + "dataCollectionEndpointId1": "[concat('/subscriptions/',parameters('subscription'),'/resourceGroups/',parameters('resourceGroupName'),'/providers/Microsoft.Insights/dataCollectionEndpoints/',parameters('workspace'))]", + "_solutioncontentProductId": "[concat(take(variables('_solutionId'),50),'-','sl','-', uniqueString(concat(variables('_solutionId'),'-','Solution','-',variables('_solutionId'),'-', variables('_solutionVersion'))))]" + }, + "resources": [ + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[variables('playbookTemplateSpecName1')]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "description": "Druva_Quarantine_Enterprise_Workloads Playbook with template version 3.0.0", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('playbookVersion1')]", + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Enterprise_Workloads", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[[concat('KeyVault-', parameters('PlaybookName'))]", + "connection-2": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/keyvault')]", + "_connection-2": "[[variables('connection-2')]", + "workspace-location-inline": "[concat('[resourceGroup().locatio', 'n]')]", + "workspace-name": "[parameters('workspace')]", + "workspaceResourceId": "[[resourceId('microsoft.OperationalInsights/Workspaces', variables('workspace-name'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[[parameters('PlaybookName')]", + "location": "[[variables('workspace-location-inline')]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineEnterpriseWorkloadsResource", + "hidden-SentinelTemplateVersion": "1.0", + "hidden-SentinelWorkspaceId": "[[variables('workspaceResourceId')]" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "enterprise_resource_name": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_Device": { + "runAfter": { + "Initialize_Combined_Resources_variable": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/backupset", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "hostname": "@{triggerBody()?['enterprise_resource_name']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Find_VM_Device": { + "runAfter": { + "Initialize_Combined_Resources_variable": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/backupset", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "hostname": "@{triggerBody()?['enterprise_resource_name']}", + "serverTypes[]": "3" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Resource_Details": { + "runAfter": { + "Find_Device": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Device')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "Parse_VM_Resource_Details": { + "runAfter": { + "Find_VM_Device": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_VM_Device')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "CombineResponses": { + "runAfter": { + "Parse_Resource_Details": [ + "Succeeded" + ], + "Parse_VM_Resource_Details": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": [ + { + "resources": "@body('Parse_Resource_Details')?['resources']" + }, + { + "resources": "@body('Parse_VM_Resource_Details')?['resources']" + } + ] + }, + "Initialize_Combined_Resources_variable": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "CombinedResources", + "type": "array", + "value": "[variables('TemplateEmptyArray')]" + } + ] + } + }, + "For_Each_Response": { + "foreach": "@outputs('CombineResponses')", + "actions": { + "Nested_For_each_": { + "foreach": "@item()?['resources']", + "actions": { + "Append_to_array_variable": { + "type": "AppendToArrayVariable", + "inputs": { + "name": "CombinedResources", + "value": "@item()" + } + } + }, + "type": "Foreach" + } + }, + "runAfter": { + "Parse_CombineResponses_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_Resources": { + "runAfter": { + "For_Each_Responses": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "resources": "@variables('CombinedResources')" + } + }, + "If_Resource_Exists": { + "actions": { + "Resource_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_Resources')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_Resources": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "Resource Not Found" + } + } + } + } + }, + "expression": { + "or": [ + { + "equals": [ + "@variables('ResourceMatch')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "For_each_Resource": { + "foreach": "@body('Resource_JSON')?['resources']", + "actions": { + "Quarantine_VM_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": "@item()?['orgID']", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_VM_Range_ID_": { + "runAfter": { + "Quarantine_VM_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_VM_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "runAfter": { + "If_Resource_Exists": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Get_secret_ClientId": { + "runAfter": { + "Initialize_variable_Match_Resource": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "check_resourcename": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "username is not empty" + } + } + }, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Username is empty\"" + } + } + } + } + }, + "expression": { + "or": [ + { + "not": { + "equals": [ + "@triggerBody()?['enterprise_resource_name']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Initialize_variable_Match_Resource": { + "runAfter": { + "check_resourcename": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "ResourceMatch", + "type": "boolean", + "value": false + } + ] + } + }, + "Parse_CombineResponses_JSON": { + "runAfter": { + "CombineResponses": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@outputs('CombineResponses')", + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + } + }, + "required": [ + "resources" + ] + } + } + } + }, + "For_Each_Responses": { + "foreach": "@outputs('Parse_CombineResponses_JSON')['body']", + "actions": { + "Nested_For_each": { + "foreach": "@item()['resources']", + "actions": { + "Check_If_Resource_exists": { + "actions": { + "Set_Match_Resource_True": { + "type": "SetVariable", + "inputs": { + "name": "ResourceMatch", + "value": true + } + } + }, + "expression": { + "or": [ + { + "equals": [ + "@item()['resourceParentName']", + "@triggerBody()?['enterprise_resource_name']" + ] + } + ] + }, + "type": "If" + } + }, + "type": "Foreach" + } + }, + "runAfter": { + "Parse_CombineResponses_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + } + } + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[[variables('keyvaultConnectionName')]", + "id": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[[variables('keyvaultConnectionName')]", + "location": "[[variables('workspace-location-inline')]", + "kind": "V1", + "properties": { + "displayName": "[[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[[parameters('keyvaultName')]" + } + } + }, + "api": { + "id": "[[variables('_connection-2')]" + } + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "apiVersion": "2022-01-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('Playbook-', last(split(variables('playbookId1'),'/'))))]", + "properties": { + "parentId": "[variables('playbookId1')]", + "contentId": "[variables('_playbookContentId1')]", + "kind": "Playbook", + "version": "[variables('playbookVersion1')]", + "source": { + "kind": "Solution", + "name": "DruvaDataSecurityCloud", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } + } + } + ], + "metadata": { + "title": "Druva Quarantine Playbook for Enterprise Workload", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread in your enterprise workload", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ + "Ransomware Recovery", + "Druva Security", + "Unusual Data Activity", + "Quarantine Snapshots" + ], + "lastUpdateTime": "2025-01-08T18:21:38.767Z", + "releaseNotes": { + "version": "1.0", + "title": "[variables('blanks')]", + "notes": [ + "Initial version" + ] + } + } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId1')]", + "contentKind": "Playbook", + "displayName": "Druva_Quarantine_Enterprise_Workloads", + "contentProductId": "[variables('_playbookcontentProductId1')]", + "id": "[variables('_playbookcontentProductId1')]", + "version": "[variables('playbookVersion1')]" + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[variables('playbookTemplateSpecName2')]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "description": "Druva_Quarantine_Insync_User_Workloads Playbook with template version 3.0.0", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('playbookVersion2')]", + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Insync_User_Workloads", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[[concat('KeyVault-', parameters('PlaybookName'))]", + "connection-2": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/keyvault')]", + "_connection-2": "[[variables('connection-2')]", + "workspace-location-inline": "[concat('[resourceGroup().locatio', 'n]')]", + "workspace-name": "[parameters('workspace')]", + "workspaceResourceId": "[[resourceId('microsoft.OperationalInsights/Workspaces', variables('workspace-name'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[[parameters('PlaybookName')]", + "location": "[[variables('workspace-location-inline')]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineInsyncWorkloadsResource", + "hidden-SentinelTemplateVersion": "1.0", + "hidden-SentinelWorkspaceId": "[[variables('workspaceResourceId')]" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "resourceTypes": { + "defaultValue": [ + "Endpoint", + "OneDrive", + "Google Drive" + ], + "type": "Array" + }, + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "username": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_User": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/users", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "users": "@{triggerBody()?['username']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_User_Details": { + "runAfter": { + "Find_User": [ + "Succeeded", + "TimedOut", + "Skipped", + "Failed" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_User')", + "schema": { + "type": "object", + "properties": { + "users": { + "type": "array", + "items": { + "type": "object", + "properties": { + "userID": { + "type": "integer" + }, + "userName": { + "type": "string" + }, + "emailID": { + "type": "string" + }, + "profileID": { + "type": "integer" + }, + "storageID": { + "type": "integer" + } + }, + "required": [ + "userID", + "userName", + "emailID", + "profileID", + "storageID" + ] + } + }, + "totalSize": { + "type": "integer" + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "Find_Users_Device": { + "runAfter": { + "Compose_api_host": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@concat(parameters('api_host'),\n '/realize/ransomwarerecovery/v1/search/device?',\n outputs('Compose_api_host')\n)", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Device_Details": { + "runAfter": { + "Find_Users_Device": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Users_Device')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "userID": { + "type": "integer" + }, + "userName": { + "type": "string" + }, + "profileID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "userID", + "userName", + "profileID" + ] + } + }, + "nextPageToken": { + "type": "string" + }, + "isLast": { + "type": "boolean" + }, + "errorMessage": { + "type": "string" + } + } + } + } + }, + "For_each_user_device": { + "foreach": "@body('Parse_Device_Details')?['resources']", + "actions": { + "Parse_Range_ID": { + "runAfter": { + "Quarantine_Resource_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Resource_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + }, + "Quarantine_Resource_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": -1, + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + } + }, + "runAfter": { + "Parse_Device_Details": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "check_username": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "username is not empty" + } + } + }, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Username is empty\"" + } + } + } + } + }, + "expression": { + "or": [ + { + "not": { + "equals": [ + "@triggerBody()?['username']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "For_each": { + "foreach": "@body('Parse_User_Details')?['users']", + "actions": { + "Check_If_user_exists": { + "actions": { + "Set_Match_User_True": { + "type": "SetVariable", + "inputs": { + "name": "UserNameMatched", + "value": true + } + }, + "Append_to_User_array_": { + "runAfter": { + "Set_Match_User_True": [ + "Succeeded" + ] + }, + "type": "AppendToArrayVariable", + "inputs": { + "name": "UserArray", + "value": "@items('For_each')" + } + } + }, + "expression": { + "or": [ + { + "equals": [ + "@item()?['userName']", + "@triggerBody()?['username']" + ] + } + ] + }, + "type": "If" + } + }, + "runAfter": { + "Parse_User_Details": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_api_host": { + "runAfter": { + "Check_if_User_found_": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": "@concat(\n 'users[]=',\n string(body('User_JSON')?['users'][0]['userID']),\n '&resourceTypes[]=',\n join(parameters('resourceTypes'), '&resourceTypes[]=')\n)" + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientID": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Get_secret_ClientID": { + "runAfter": { + "Initialize_Array": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Check_if_User_found_": { + "actions": { + "User_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_Users')", + "schema": { + "type": "object", + "properties": { + "users": { + "type": "array", + "items": { + "type": "object", + "properties": { + "userID": { + "type": "integer" + }, + "userName": { + "type": "string" + }, + "emailID": { + "type": "string" + }, + "profileID": { + "type": "integer" + }, + "storageID": { + "type": "integer" + } + }, + "required": [ + "userID", + "userName", + "emailID", + "profileID", + "storageID" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_Users": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "User Not Found" + } + } + } + } + }, + "expression": { + "and": [ + { + "equals": [ + "@variables('UserNameMatched')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "Initialize_Array": { + "runAfter": { + "Initialize_variable_Match_User": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "UserArray", + "type": "array", + "value": "[variables('TemplateEmptyArray')]" + } + ] + } + }, + "Initialize_variable_Match_User": { + "runAfter": { + "check_username": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "UserNameMatched", + "type": "boolean", + "value": false + } + ] + } + }, + "Compose_Users": { + "runAfter": { + "For_each": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "users": "@variables('UserArray')" + } + } + } + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[[variables('keyvaultConnectionName')]", + "id": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[[variables('keyvaultConnectionName')]", + "location": "[[variables('workspace-location-inline')]", + "kind": "V1", + "properties": { + "displayName": "[[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[[parameters('keyvaultName')]" + } + } + }, + "api": { + "id": "[[variables('_connection-2')]" + } + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "apiVersion": "2022-01-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('Playbook-', last(split(variables('playbookId2'),'/'))))]", + "properties": { + "parentId": "[variables('playbookId2')]", + "contentId": "[variables('_playbookContentId2')]", + "kind": "Playbook", + "version": "[variables('playbookVersion2')]", + "source": { + "kind": "Solution", + "name": "DruvaDataSecurityCloud", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } + } + } + ], + "metadata": { + "title": "Druva Quarantine Playbook for inSync Workloads", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your inSync User based workloads.", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ + "Ransomware Recovery", + "Druva Security", + "Unusual Data Activity", + "Quarantine Snapshots" + ], + "lastUpdateTime": "2025-01-08T18:21:39.133Z", + "releaseNotes": { + "version": "1.0", + "title": "[variables('blanks')]", + "notes": [ + "Initial version" + ] + } + } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId2')]", + "contentKind": "Playbook", + "displayName": "Druva_Quarantine_Insync_User_Workloads", + "contentProductId": "[variables('_playbookcontentProductId2')]", + "id": "[variables('_playbookcontentProductId2')]", + "version": "[variables('playbookVersion2')]" + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[variables('playbookTemplateSpecName3')]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "description": "Druva_Quarantine_With_Resource_ID_Workloads Playbook with template version 3.0.0", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('playbookVersion3')]", + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_With_Resource_ID_Workloads", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[[concat('KeyVault-', parameters('PlaybookName'))]", + "connection-2": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/keyvault')]", + "_connection-2": "[[variables('connection-2')]", + "workspace-location-inline": "[concat('[resourceGroup().locatio', 'n]')]", + "workspace-name": "[parameters('workspace')]", + "workspaceResourceId": "[[resourceId('microsoft.OperationalInsights/Workspaces', variables('workspace-name'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[[parameters('PlaybookName')]", + "location": "[[variables('workspace-location-inline')]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineResourceUsingResourceID", + "hidden-SentinelTemplateVersion": "1.0", + "hidden-SentinelWorkspaceId": "[[variables('workspaceResourceId')]" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceType": { + "type": "string" + }, + "orgID": { + "type": "integer" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "check_resourceID": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "Resource ID is not empty" + } + } + }, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Resource ID, Resource Type or ORG ID is empty\"" + } + } + } + } + }, + "expression": { + "and": [ + { + "not": { + "equals": [ + "@triggerBody()?['resourceID']", + "@null" + ] + } + }, + { + "not": { + "equals": [ + "@triggerBody()?['resourceType']", + "@null" + ] + } + }, + { + "not": { + "equals": [ + "@triggerBody()?['orgID']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Quarantine_Resource_API": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{triggerBody()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@triggerBody()?['resourceType']", + "orgID": "@triggerBody()?['orgID']", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Get_secret_ClientId": { + "runAfter": { + "check_resourceID": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Parse_JSON": { + "runAfter": { + "Quarantine_Resource_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Resource_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + } + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[[variables('keyvaultConnectionName')]", + "id": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[[variables('keyvaultConnectionName')]", + "location": "[[variables('workspace-location-inline')]", + "kind": "V1", + "properties": { + "displayName": "[[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[[parameters('keyvaultName')]" + } + } + }, + "api": { + "id": "[[variables('_connection-2')]" + } + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "apiVersion": "2022-01-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('Playbook-', last(split(variables('playbookId3'),'/'))))]", + "properties": { + "parentId": "[variables('playbookId3')]", + "contentId": "[variables('_playbookContentId3')]", + "kind": "Playbook", + "version": "[variables('playbookVersion3')]", + "source": { + "kind": "Solution", + "name": "DruvaDataSecurityCloud", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } + } + } + ], + "metadata": { + "title": "Druva Quarantine Using Resource id", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment.", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ + "Ransomware Recovery", + "Druva Security", + "Unusual Data Activity", + "Quarantine Snapshots" + ], + "lastUpdateTime": "2025-01-08T18:21:39.302Z", + "releaseNotes": { + "version": "1.0", + "title": "[variables('blanks')]", + "notes": [ + "Initial version" + ] + } + } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId3')]", + "contentKind": "Playbook", + "displayName": "Druva_Quarantine_With_Resource_ID_Workloads", + "contentProductId": "[variables('_playbookcontentProductId3')]", + "id": "[variables('_playbookcontentProductId3')]", + "version": "[variables('playbookVersion3')]" + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[variables('playbookTemplateSpecName4')]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "description": "Druva_Quarantine_Share_Point Playbook with template version 3.0.0", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('playbookVersion4')]", + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Share_Point", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[[concat('KeyVault-', parameters('PlaybookName'))]", + "connection-2": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/keyvault')]", + "_connection-2": "[[variables('connection-2')]", + "workspace-location-inline": "[concat('[resourceGroup().locatio', 'n]')]", + "workspace-name": "[parameters('workspace')]", + "workspaceResourceId": "[[resourceId('microsoft.OperationalInsights/Workspaces', variables('workspace-name'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[[parameters('PlaybookName')]", + "location": "[[variables('workspace-location-inline')]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineSharePointResource", + "hidden-SentinelTemplateVersion": "1.0", + "hidden-SentinelWorkspaceId": "[[variables('workspaceResourceId')]" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "share_point_site": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "check_share_point_site": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "Share Point Site is not empty" + } + } + }, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Share Point Site is Empty\"" + } + } + } + } + }, + "expression": { + "and": [ + { + "not": { + "equals": [ + "@triggerBody()?['share_point_site']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Get_secret_ClientId": { + "runAfter": { + "Initialize_Array": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_Share_Point_Sites": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/sharepoint-sites", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "siteTitlePrefix": "@{triggerBody()?['share_point_site']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_SharePoint_Site_JSON": { + "runAfter": { + "Find_Share_Point_Sites": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Share_Point_Sites')", + "schema": { + "type": "object", + "properties": { + "siteCollections": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "siteType": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "siteType" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "Initialize_variable_Match_Share_Point_Site": { + "runAfter": { + "check_share_point_site": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharePointSiteMatched", + "type": "boolean", + "value": false + } + ] + } + }, + "Initialize_Array": { + "runAfter": { + "Initialize_variable_Match_Share_Point_Site": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharePointSiteArray", + "type": "array", + "value": "[variables('TemplateEmptyArray')]" + } + ] + } + }, + "For_each": { + "foreach": "@outputs('Parse_SharePoint_Site_JSON')?['body']?['siteCollections']", + "actions": { + "Check_If_Share_Point_Site_exists": { + "actions": { + "Set_Match_Share_Point_Site_True": { + "type": "SetVariable", + "inputs": { + "name": "SharePointSiteMatched", + "value": true + } + }, + "Append_to_Share_Point_Site_array_variable": { + "runAfter": { + "Set_Match_Share_Point_Site_True": [ + "Succeeded" + ] + }, + "type": "AppendToArrayVariable", + "inputs": { + "name": "SharePointSiteArray", + "value": "@items('For_each')" + } + } + }, + "expression": { + "or": [ + { + "equals": [ + "@item()?['resourceParentName']", + "@triggerBody()?['share_point_site']" + ] + } + ] + }, + "type": "If" + } + }, + "runAfter": { + "Parse_SharePoint_Site_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_SiteCollections": { + "runAfter": { + "For_each": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "siteCollections": "@variables('SharePointSiteArray')" + } + }, + "Check_if_Site_Collection_found_": { + "actions": { + "Site_Collection_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_SiteCollections')", + "schema": { + "type": "object", + "properties": { + "siteCollections": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "siteType": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "siteType" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_SiteCollections": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "Site Collections Not Found" + } + } + } + } + }, + "expression": { + "and": [ + { + "equals": [ + "@variables('SharePointSiteMatched')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "For_each_Site_Collection": { + "foreach": "@outputs('Site_Collection_JSON')?['body']?['siteCollections']", + "actions": { + "Quarantine_Site_Collection_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": "@null", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Share_Point_Site_Range_ID": { + "runAfter": { + "Quarantine_Site_Collection_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Site_Collection_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "runAfter": { + "Check_if_Site_Collection_found_": [ + "Succeeded" + ] + }, + "type": "Foreach" + } + } + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[[variables('keyvaultConnectionName')]", + "id": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[[variables('keyvaultConnectionName')]", + "location": "[[variables('workspace-location-inline')]", + "kind": "V1", + "properties": { + "displayName": "[[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[[parameters('keyvaultName')]" + } + } + }, + "api": { + "id": "[[variables('_connection-2')]" + } + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "apiVersion": "2022-01-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('Playbook-', last(split(variables('playbookId4'),'/'))))]", + "properties": { + "parentId": "[variables('playbookId4')]", + "contentId": "[variables('_playbookContentId4')]", + "kind": "Playbook", + "version": "[variables('playbookVersion4')]", + "source": { + "kind": "Solution", + "name": "DruvaDataSecurityCloud", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } + } + } + ], + "metadata": { + "title": "Druva Quarantine Playbook for Sharepoint", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread in your sharepoint", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ + "Ransomware Recovery", + "Druva Security", + "Unusual Data Activity", + "Quarantine Snapshots" + ], + "lastUpdateTime": "2025-01-08T18:21:39.553Z", + "releaseNotes": { + "version": "1.0", + "title": "[variables('blanks')]", + "notes": [ + "Initial version" + ] + } + } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId4')]", + "contentKind": "Playbook", + "displayName": "Druva_Quarantine_Share_Point", + "contentProductId": "[variables('_playbookcontentProductId4')]", + "id": "[variables('_playbookcontentProductId4')]", + "version": "[variables('playbookVersion4')]" + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[variables('playbookTemplateSpecName5')]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "description": "Druva_Quarantine_Shared_Drive Playbook with template version 3.0.0", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('playbookVersion5')]", + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Shared_Drive", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[[concat('KeyVault-', parameters('PlaybookName'))]", + "connection-2": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/keyvault')]", + "_connection-2": "[[variables('connection-2')]", + "workspace-location-inline": "[concat('[resourceGroup().locatio', 'n]')]", + "workspace-name": "[parameters('workspace')]", + "workspaceResourceId": "[[resourceId('microsoft.OperationalInsights/Workspaces', variables('workspace-name'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[[parameters('PlaybookName')]", + "location": "[[variables('workspace-location-inline')]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineSharedDriveResource", + "hidden-SentinelTemplateVersion": "1.0", + "hidden-SentinelWorkspaceId": "[[variables('workspaceResourceId')]" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "shared_drive": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "check_Shared_Drive": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "Shared Drive is not empty" + } + } + }, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Shared Drive is Empty\"" + } + } + } + } + }, + "expression": { + "and": [ + { + "not": { + "equals": [ + "@triggerBody()?['shared_drive']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Initialize_variable_Match_Shared_Drive": { + "runAfter": { + "check_Shared_Drive": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharedDriveMatched", + "type": "boolean", + "value": false + } + ] + } + }, + "Initialize_Array": { + "runAfter": { + "Initialize_variable_Match_Shared_Drive": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharedDriveArray", + "type": "array", + "value": "[variables('TemplateEmptyArray')]" + } + ] + } + }, + "Get_secret_ClientId": { + "runAfter": { + "Initialize_Array": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_Shared_Drives": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/shareddrive-accounts", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "accountTitlePrefix": "@{triggerBody()?['shared_drive']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Share_Drive_JSON": { + "runAfter": { + "Find_Shared_Drives": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Shared_Drives')", + "schema": { + "type": "object", + "properties": { + "accountList": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "For_each": { + "foreach": "@outputs('Share_Drive_JSON')?['body']?['accountList']", + "actions": { + "Check_If_Shared_Drive_exists": { + "actions": { + "Set_Match_Shared_Drive_True": { + "type": "SetVariable", + "inputs": { + "name": "SharedDriveMatched", + "value": true + } + }, + "Append_to_Shared_Drive_array_variable": { + "runAfter": { + "Set_Match_Shared_Drive_True": [ + "Succeeded" + ] + }, + "type": "AppendToArrayVariable", + "inputs": { + "name": "SharedDriveArray", + "value": "@items('For_each')" + } + } + }, + "expression": { + "or": [ + { + "equals": [ + "@item()?['resourceName']", + "@triggerBody()?['shared_drive']" + ] + } + ] + }, + "type": "If" + } + }, + "runAfter": { + "Share_Drive_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_SharedDrive_Collections": { + "runAfter": { + "For_each": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "accountList": "@variables('SharedDriveArray')" + } + }, + "Check_if_Shared_Drive_found": { + "actions": { + "Account_List_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_SharedDrive_Collections')", + "schema": { + "type": "object", + "properties": { + "accountList": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_SharedDrive_Collections": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "Site Collections Not Found" + } + } + } + } + }, + "expression": { + "and": [ + { + "equals": [ + "@variables('SharedDriveMatched')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "For_each_Shared_Drive_Collection": { + "foreach": "@outputs('Account_List_JSON')?['body']?['accountList']", + "actions": { + "Quarantine_Account_List_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": "@null", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Shared_Drive_Range_ID_": { + "runAfter": { + "Quarantine_Account_List_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Account_List_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "runAfter": { + "Check_if_Shared_Drive_found": [ + "Succeeded" + ] + }, + "type": "Foreach" + } + } + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[[variables('keyvaultConnectionName')]", + "id": "[[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', variables('workspace-location-inline'), '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[[variables('keyvaultConnectionName')]", + "location": "[[variables('workspace-location-inline')]", + "kind": "V1", + "properties": { + "displayName": "[[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[[parameters('keyvaultName')]" + } + } + }, + "api": { + "id": "[[variables('_connection-2')]" + } + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "apiVersion": "2022-01-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('Playbook-', last(split(variables('playbookId5'),'/'))))]", + "properties": { + "parentId": "[variables('playbookId5')]", + "contentId": "[variables('_playbookContentId5')]", + "kind": "Playbook", + "version": "[variables('playbookVersion5')]", + "source": { + "kind": "Solution", + "name": "DruvaDataSecurityCloud", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } + } + } + ], + "metadata": { + "title": "Druva Quarantine Playbook for Shared Drive", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your shared drives.", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ + "Ransomware Recovery", + "Druva Security", + "Unusual Data Activity", + "Quarantine Snapshots" + ], + "lastUpdateTime": "2025-01-08T18:21:39.777Z", + "releaseNotes": { + "version": "1.0", + "title": "[variables('blanks')]", + "notes": [ + "Initial version" + ] + } + } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId5')]", + "contentKind": "Playbook", + "displayName": "Druva_Quarantine_Shared_Drive", + "contentProductId": "[variables('_playbookcontentProductId5')]", + "id": "[variables('_playbookcontentProductId5')]", + "version": "[variables('playbookVersion5')]" + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', variables('dataConnectorTemplateNameConnectorDefinition1'), variables('dataConnectorCCPVersion'))]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "contentId": "[variables('_dataConnectorContentIdConnectorDefinition1')]", + "displayName": "Druva Events Connector", + "contentKind": "DataConnector", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('dataConnectorCCPVersion')]", + "parameters": {}, + "variables": {}, + "resources": [ + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentIdConnectorDefinition1'))]", + "apiVersion": "2022-09-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectorDefinitions", + "location": "[parameters('workspace-location')]", + "kind": "Customizable", + "properties": { + "connectorUiConfig": { + "id": "DruvaEventCCPDefinition", + "title": "Druva Events Connector", + "publisher": "Microsoft", + "descriptionMarkdown": "Provides capability to ingest the druva events from druva apis", + "graphQueriesTableName": "DruvaSecurityEvents_CL", + "graphQueries": [ + { + "metricName": "Total Security Events", + "legend": "Druva Security events received", + "baseQuery": "{{graphQueriesTableName}}" + }, + { + "metricName": "Total platform events", + "legend": "Druva platform events received", + "baseQuery": "DruvaPlatformEvents_CL" + }, + { + "metricName": "Total insync events", + "legend": "Druva insync events received", + "baseQuery": "DruvaInsyncEvents_CL" + } + ], + "sampleQueries": [ + { + "description": "Sample of Druva security events", + "query": "{{graphQueriesTableName}}\n| take 10" + }, + { + "description": "Sample of Druva platform events", + "query": "DruvaPlatformEvents_CL\n| take 10" + }, + { + "description": "Sample of Druva insync events", + "query": "DruvaInsyncEvents_CL\n| take 10" + } + ], + "dataTypes": [ + { + "name": "{{graphQueriesTableName}}", + "lastDataReceivedQuery": "{{graphQueriesTableName}}\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaPlatformEvents_CL", + "lastDataReceivedQuery": "DruvaPlatformEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaInsyncEvents_CL", + "lastDataReceivedQuery": "DruvaInsyncEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + } + ], + "connectivityCriteria": [ + { + "type": "HasDataConnectors" + } + ], + "permissions": { + "resourceProvider": [ + { + "provider": "Microsoft.OperationalInsights/workspaces", + "permissionsDisplayText": "Read and Write permission are required", + "providerDisplayName": "Workspace", + "scope": "Workspace", + "requiredPermissions": { + "write": true, + "read": true, + "delete": true + } + } + ], + "customs": [ + { + "name": "Druva API Access", + "description": "Druva api requires a client id and client secret to authenticate" + } + ] + }, + "instructionSteps": [ + { + "description": ">Note: Configurations to connect to Druva Rest API\n" + }, + { + "description": "Step 1: Create Crdentials from Druva Console: https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials\n" + }, + { + "description": "Step 2: Enter the hostname public cloud its apis.druva.com\n" + }, + { + "description": "Step 3: Get client id and client secret key\n" + }, + { + "description": "Provide required values:\n", + "instructions": [ + { + "type": "Textbox", + "parameters": { + "label": "hostname", + "placeholder": "Example: apis.druva.com", + "type": "text", + "name": "hostname" + } + }, + { + "type": "OAuthForm", + "parameters": { + "clientIdLabel": "Client ID", + "clientSecretLabel": "Client Secret", + "connectButtonLabel": "Connect", + "disconnectButtonLabel": "Diconnect" + } + } + ], + "tittle": "Connect to Druva API to start collecting logs in microft sentinel" + } + ] + } + } + }, + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', variables('_dataConnectorContentIdConnectorDefinition1')))]", + "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "properties": { + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectorDefinitions', variables('_dataConnectorContentIdConnectorDefinition1'))]", + "contentId": "[variables('_dataConnectorContentIdConnectorDefinition1')]", + "kind": "DataConnector", + "version": "[variables('dataConnectorCCPVersion')]", + "source": { + "sourceId": "[variables('_solutionId')]", + "name": "[variables('_solutionName')]", + "kind": "Solution" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + }, + "dependencies": { + "criteria": [ + { + "version": "[variables('dataConnectorCCPVersion')]", + "contentId": "[variables('_dataConnectorContentIdConnections1')]", + "kind": "ResourcesDataConnector" + } + ] + } + } + }, + { + "name": "DruvaDCR", + "apiVersion": "2022-06-01", + "type": "Microsoft.Insights/dataCollectionRules", + "location": "[parameters('workspace-location')]", + "kind": "[variables('blanks')]", + "properties": { + "dataCollectionEndpointId": "[variables('dataCollectionEndpointId1')]", + "streamDeclarations": { + "Custom-DruvaSecurityEvents_CL": { + "columns": [ + { + "name": "TimeGenerated", + "type": "datetime" + }, + { + "name": "id", + "type": "int" + }, + { + "name": "globalCustomerId", + "type": "string" + }, + { + "name": "occurenceTime", + "type": "int" + }, + { + "name": "area", + "type": "string" + }, + { + "name": "category", + "type": "string" + }, + { + "name": "type", + "type": "string" + }, + { + "name": "syslogSeverity", + "type": "int" + }, + { + "name": "syslogFacility", + "type": "int" + }, + { + "name": "details", + "type": "string" + } + ] + }, + "Custom-DruvaPlatformEvents_CL": { + "columns": [ + { + "name": "TimeGenerated", + "type": "datetime" + }, + { + "name": "category", + "type": "string" + }, + { + "name": "details", + "type": "dynamic" + }, + { + "name": "feature", + "type": "string" + }, + { + "name": "globalID", + "type": "string" + }, + { + "name": "timeStamp", + "type": "int" + }, + { + "name": "productID", + "type": "int" + }, + { + "name": "syslogFacility", + "type": "int" + }, + { + "name": "syslogSeverity", + "type": "int" + }, + { + "name": "type", + "type": "string" + } + ] + }, + "Custom-DruvaInsyncEvents_CL": { + "columns": [ + { + "name": "eventType", + "type": "string" + }, + { + "name": "eventState", + "type": "string" + }, + { + "name": "eventID", + "type": "int" + }, + { + "name": "eventDetails", + "type": "string" + }, + { + "name": "timestamp", + "type": "datetime" + }, + { + "name": "initiator", + "type": "string" + }, + { + "name": "ip", + "type": "string" + }, + { + "name": "profileID", + "type": "string" + }, + { + "name": "profileName", + "type": "string" + }, + { + "name": "inSyncUserID", + "type": "string" + }, + { + "name": "inSyncUserName", + "type": "string" + }, + { + "name": "inSyncUserEmail", + "type": "string" + }, + { + "name": "inSyncDataSourceID", + "type": "string" + }, + { + "name": "inSyncDataSourceName", + "type": "string" + }, + { + "name": "clientOS", + "type": "string" + }, + { + "name": "clientVersion", + "type": "string" + }, + { + "name": "severity", + "type": "int" + }, + { + "name": "facility", + "type": "int" + } + ] + } + }, + "destinations": { + "logAnalytics": [ + { + "workspaceResourceId": "[variables('workspaceResourceId')]", + "name": "[parameters('workspace')]" + } + ] + }, + "dataFlows": [ + { + "streams": [ + "Custom-DruvaSecurityEvents_CL" + ], + "destinations": [ + "[parameters('workspace')]" + ], + "transformKql": "source\n| extend TimeGenerated = datetime_add('second',occurenceTime,make_datetime(1970,1,1)) \n| extend event_type = type\n| project-away occurenceTime, type\n| extend id = tostring(id) // Convert 'id' to string and rename to EventUid\n| project-rename EventUid = id\n\n", + "outputStream": "Custom-DruvaSecurityEvents_CL" + }, + { + "streams": [ + "Custom-DruvaPlatformEvents_CL" + ], + "destinations": [ + "[parameters('workspace')]" + ], + "transformKql": "source\n| extend TimeGenerated = datetime_add('second',timeStamp,make_datetime(1970,1,1))\n| extend event_type = type\n| project-away timeStamp, type\n", + "outputStream": "Custom-DruvaPlatformEvents_CL" + }, + { + "streams": [ + "Custom-DruvaInsyncEvents_CL" + ], + "destinations": [ + "[parameters('workspace')]" + ], + "transformKql": "source\n| extend TimeGenerated = timestamp\n| extend eventID = tostring(eventID)\n| project-rename EventUid = eventID\n| project-away timestamp\n", + "outputStream": "Custom-DruvaInsyncEvents_CL" + } + ] + } + }, + { + "name": "DruvaSecurityEvents_CL", + "apiVersion": "2022-10-01", + "type": "Microsoft.OperationalInsights/workspaces/tables", + "location": "[[parameters('workspace-location')]", + "properties":{ + "schema": { + "name": "DruvaSecurityEvents_CL", + "columns": [ + { + "name": "area", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "category", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "details", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "globalCustomerId", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogFacility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogSeverity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "event_type", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "EventUid", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + }, + { + "name": "DruvaPlatformEvents_CL", + "apiVersion": "2022-10-01", + "type": "Microsoft.OperationalInsights/workspaces/tables", + "location": "[[parameters('workspace-location')]", + "properties":{ + "schema": { + "name": "DruvaPlatformEvents_CL", + "columns": [ + { + "name": "category", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "details", + "type": "dynamic", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "feature", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "globalID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "productID", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogFacility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "syslogSeverity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "event_type", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + }, + { + "name": "DruvaInsyncEvents_CL", + "apiVersion": "2022-10-01", + "type": "Microsoft.OperationalInsights/workspaces/tables", + "location": "[[parameters('workspace-location')]", + "properties": { + "schema": { + "name": "DruvaInsyncEvents_CL", + "columns": [ + { + "name": "clientOS", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "clientVersion", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventDetails", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventState", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "eventType", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "facility", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "initiator", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncDataSourceID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncDataSourceName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserEmail", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "inSyncUserName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "ip", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "profileID", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "profileName", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "severity", + "type": "int", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "TimeGenerated", + "type": "datetime", + "isDefaultDisplay": false, + "isHidden": false + }, + { + "name": "EventUid", + "type": "string", + "isDefaultDisplay": false, + "isHidden": false + } + ] + } + } + } + ] + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "contentProductId": "[concat(take(variables('_solutionId'), 50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentIdConnectorDefinition1'),'-', variables('dataConnectorCCPVersion'))))]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "version": "[variables('dataConnectorCCPVersion')]" + } + }, + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentIdConnectorDefinition1'))]", + "apiVersion": "2022-09-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectorDefinitions", + "location": "[parameters('workspace-location')]", + "kind": "Customizable", + "properties": { + "connectorUiConfig": { + "id": "DruvaEventCCPDefinition", + "title": "Druva Events Connector", + "publisher": "Microsoft", + "descriptionMarkdown": "Provides capability to ingest the druva events from druva apis", + "graphQueriesTableName": "DruvaSecurityEvents_CL", + "graphQueries": [ + { + "metricName": "Total Security Events", + "legend": "Druva Security events received", + "baseQuery": "{{graphQueriesTableName}}" + }, + { + "metricName": "Total platform events", + "legend": "Druva platform events received", + "baseQuery": "DruvaPlatformEvents_CL" + }, + { + "metricName": "Total insync events", + "legend": "Druva insync events received", + "baseQuery": "DruvaInsyncEvents_CL" + } + ], + "sampleQueries": [ + { + "description": "Sample of Druva security events", + "query": "{{graphQueriesTableName}}\n| take 10" + }, + { + "description": "Sample of Druva platform events", + "query": "DruvaPlatformEvents_CL\n| take 10" + }, + { + "description": "Sample of Druva insync events", + "query": "DruvaInsyncEvents_CL\n| take 10" + } + ], + "dataTypes": [ + { + "name": "{{graphQueriesTableName}}", + "lastDataReceivedQuery": "{{graphQueriesTableName}}\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaPlatformEvents_CL", + "lastDataReceivedQuery": "DruvaPlatformEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + }, + { + "name": "DruvaInsyncEvents_CL", + "lastDataReceivedQuery": "DruvaInsyncEvents_CL\n | summarize Time=max(TimeGenerated) \n | where isnotempty(Time)" + } + ], + "connectivityCriteria": [ + { + "type": "HasDataConnectors" + } + ], + "permissions": { + "resourceProvider": [ + { + "provider": "Microsoft.OperationalInsights/workspaces", + "permissionsDisplayText": "Read and Write permission are required", + "providerDisplayName": "Workspace", + "scope": "Workspace", + "requiredPermissions": { + "write": true, + "read": true, + "delete": true + } + } + ], + "customs": [ + { + "name": "Druva API Access", + "description": "Druva api requires a client id and client secret to authenticate" + } + ] + }, + "instructionSteps": [ + { + "description": ">Note: Configurations to connect to Druva Rest API\n" + }, + { + "description": "Step 1: Create Crdentials from Druva Console: https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials\n" + }, + { + "description": "Step 2: Enter the hostname public cloud its apis.druva.com\n" + }, + { + "description": "Step 3: Get client id and client secret key\n" + }, + { + "description": "Provide required values:\n", + "instructions": [ + { + "type": "Textbox", + "parameters": { + "label": "hostname", + "placeholder": "Example: apis.druva.com", + "type": "text", + "name": "hostname" + } + }, + { + "type": "OAuthForm", + "parameters": { + "clientIdLabel": "Client ID", + "clientSecretLabel": "Client Secret", + "connectButtonLabel": "Connect", + "disconnectButtonLabel": "Diconnect" + } + } + ], + "tittle": "Connect to Druva API to start collecting logs in microft sentinel" + } + ] + } + } + }, + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', variables('_dataConnectorContentIdConnectorDefinition1')))]", + "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "properties": { + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectorDefinitions', variables('_dataConnectorContentIdConnectorDefinition1'))]", + "contentId": "[variables('_dataConnectorContentIdConnectorDefinition1')]", + "kind": "DataConnector", + "version": "[variables('dataConnectorCCPVersion')]", + "source": { + "sourceId": "[variables('_solutionId')]", + "name": "[variables('_solutionName')]", + "kind": "Solution" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + }, + "dependencies": { + "criteria": [ + { + "version": "[variables('dataConnectorCCPVersion')]", + "contentId": "[variables('_dataConnectorContentIdConnections1')]", + "kind": "ResourcesDataConnector" + } + ] + } + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', variables('dataConnectorTemplateNameConnections1'), variables('dataConnectorCCPVersion'))]", + "location": "[parameters('workspace-location')]", + "dependsOn": [ + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" + ], + "properties": { + "contentId": "[variables('_dataConnectorContentIdConnections1')]", + "displayName": "Druva Events Connector", + "contentKind": "ResourcesDataConnector", + "mainTemplate": { + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "[variables('dataConnectorCCPVersion')]", + "parameters": { + "ClientId": { + "defaultValue": "-NA-", + "type": "securestring", + "minLength": 1 + }, + "ClientSecret": { + "defaultValue": "-NA-", + "type": "securestring", + "minLength": 1 + }, + "hostname": { + "defaultValue": "Enter hostname value", + "type": "string", + "minLength": 1 + }, + "connectorDefinitionName": { + "defaultValue": "Druva Events Connector", + "type": "string", + "minLength": 1 + }, + "workspace": { + "defaultValue": "[parameters('workspace')]", + "type": "string" + }, + "dcrConfig": { + "defaultValue": { + "dataCollectionEndpoint": "data collection Endpoint", + "dataCollectionRuleImmutableId": "data collection rule immutableId" + }, + "type": "object" + }, + "AuthorizationCode": { + "defaultValue": "-NA-", + "type": "securestring", + "minLength": 1 + } + }, + "variables": { + "_dataConnectorContentIdConnections1": "[variables('_dataConnectorContentIdConnections1')]" + }, + "resources": [ + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', variables('_dataConnectorContentIdConnections1')))]", + "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", + "properties": { + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentIdConnections1'))]", + "contentId": "[variables('_dataConnectorContentIdConnections1')]", + "kind": "ResourcesDataConnector", + "version": "[variables('dataConnectorCCPVersion')]", + "source": { + "sourceId": "[variables('_solutionId')]", + "name": "[variables('_solutionName')]", + "kind": "Solution" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } + } + }, + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', 'DruvaSecurityEventsPolling')]", + "apiVersion": "2023-02-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", + "location": "[parameters('workspace-location')]", + "kind": "RestApiPoller", + "properties": { + "connectorDefinitionName": "DruvaEventCCPDefinition", + "dataType": "DruvaSecurityEvents_CL", + "dcrConfig": { + "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]", + "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]", + "streamName": "Custom-DruvaSecurityEvents_CL" + }, + "auth": { + "type": "OAuth2", + "clientSecret": "[[parameters('ClientSecret')]", + "clientId": "[[parameters('ClientId')]", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization": "[[concat('Basic ', base64(concat(parameters('ClientId'), ':', parameters('ClientSecret'))))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + "request": { + "apiEndpoint": "[[concat('https://', parameters('hostname'), '/realize/eventmanagement/v1/events/tracker')]", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + } + }, + "paging": { + "pagingType": "PersistentToken", + "nextPageTokenJsonPath": "$.nextTrackerToken", + "nextPageParaName": "trackerToken" + }, + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + } + } + }, + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', 'DruvaPlatformEventsPolling')]", + "apiVersion": "2023-02-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", + "location": "[parameters('workspace-location')]", + "kind": "RestApiPoller", + "properties": { + "connectorDefinitionName": "DruvaEventCCPDefinition", + "dataType": "DruvaPlatformEvents_CL", + "dcrConfig": { + "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]", + "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]", + "streamName": "Custom-DruvaPlatformEvents_CL" + }, + "auth": { + "type": "OAuth2", + "clientSecret": "[[parameters('ClientSecret')]", + "clientId": "[[parameters('ClientId')]", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization": "[[concat('Basic ', base64(concat(parameters('ClientId'), ':', parameters('ClientSecret'))))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + "request": { + "apiEndpoint": "[[concat('https://', parameters('hostname'), '/platform/eventmanagement/v2/events')]", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + } + }, + "paging": { + "pagingType": "PersistentToken", + "nextPageTokenJsonPath": "$.nextPageToken", + "nextPageParaName": "pageToken" + }, + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + } + } + }, + { + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', 'DruvaInsyncEventsPolling')]", + "apiVersion": "2023-02-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", + "location": "[parameters('workspace-location')]", + "kind": "RestApiPoller", + "properties": { + "connectorDefinitionName": "DruvaEventCCPDefinition", + "dataType": "DruvaInsyncEvents_CL", + "dcrConfig": { + "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]", + "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]", + "streamName": "Custom-DruvaInsyncEvents_CL" + }, + "auth": { + "type": "OAuth2", + "clientSecret": "[[parameters('ClientSecret')]", + "clientId": "[[parameters('ClientId')]", + "tokenEndpoint": "[[concat('https://', parameters('hostname'), '/token')]", + "tokenEndpointHeaders": { + "Accept": "application/json", + "Content-Type": "application/x-www-form-urlencoded", + "Authorization": "[[concat('Basic ', base64(concat(parameters('ClientId'), ':', parameters('ClientSecret'))))]" + }, + "TokenEndpointQueryParameters": {}, + "grantType": "client_credentials" + }, + "request": { + "apiEndpoint": "[[concat('https://', parameters('hostname'), '/insync/eventmanagement/v2/events')]", + "rateLimitQPS": 10, + "queryWindowInMin": 15, + "httpMethod": "GET", + "retryCount": 3, + "timeoutInSeconds": 30, + "headers": { + "Accept": "application/json" + } + }, + "paging": { + "pagingType": "PersistentToken", + "nextPageTokenJsonPath": "$.tracker", + "nextPageParaName": "tracker" + }, + "response": { + "eventsJsonPaths": [ + "$.events" + ], + "format": "json" + } + } + } + ] + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "contentProductId": "[concat(take(variables('_solutionId'), 50),'-','rdc','-', uniqueString(concat(variables('_solutionId'),'-','ResourcesDataConnector','-',variables('_dataConnectorContentIdConnections1'),'-', variables('dataConnectorCCPVersion'))))]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "version": "[variables('dataConnectorCCPVersion')]" + } + }, + { + "type": "Microsoft.OperationalInsights/workspaces/providers/contentPackages", + "apiVersion": "2023-04-01-preview", + "location": "[parameters('workspace-location')]", + "properties": { + "version": "3.0.0", + "kind": "Solution", + "contentSchemaVersion": "3.0.0", + "displayName": "DruvaDataSecurityCloud", + "publisherDisplayName": "Druva Inc", + "descriptionHtml": "

Note: Please refer to the following before installing the solution:

\n

• Review the solution Release Notes

\n

• There may be known issues pertaining to this Solution, please refer to them before installing.

\n

The [Druva Event CCP Connector] solution provides the capability to ingest to ingest [Druva events]

\n

Data Connectors: 1, Playbooks: 5

\n

Learn more about Microsoft Sentinel | Learn more about Solutions

\n", + "contentKind": "Solution", + "contentProductId": "[variables('_solutioncontentProductId')]", + "id": "[variables('_solutioncontentProductId')]", + "icon": "", + "contentId": "[variables('_solutionId')]", + "parentId": "[variables('_solutionId')]", + "source": { + "kind": "Solution", + "name": "DruvaDataSecurityCloud", + "sourceId": "[variables('_solutionId')]" + }, + "author": { + "name": "Druva", + "email": "[variables('_email')]" + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + }, + "dependencies": { + "operator": "AND", + "criteria": [ + { + "kind": "Playbook", + "contentId": "[variables('_DruvaQuarantineEnterpriseWorkload')]", + "version": "[variables('playbookVersion1')]" + }, + { + "kind": "Playbook", + "contentId": "[variables('_DruvaQuarantineInsyncWorkloads')]", + "version": "[variables('playbookVersion2')]" + }, + { + "kind": "Playbook", + "contentId": "[variables('_DruvaQuarantineUsingResourceID')]", + "version": "[variables('playbookVersion3')]" + }, + { + "kind": "Playbook", + "contentId": "[variables('_DruvaQuarantineSharePoint')]", + "version": "[variables('playbookVersion4')]" + }, + { + "kind": "Playbook", + "contentId": "[variables('_DruvaQuarantineSharedDrive')]", + "version": "[variables('playbookVersion5')]" + }, + { + "kind": "DataConnector", + "contentId": "[variables('_dataConnectorContentIdConnections1')]", + "version": "[variables('dataConnectorCCPVersion')]" + } + ] + }, + "firstPublishDate": "2024-12-24", + "providers": [ + "Druva" + ], + "categories": { + "domains": [ + "Security - Others" + ] + } + }, + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/', variables('_solutionId'))]" + } + ], + "outputs": {} +} diff --git a/Solutions/DruvaDataSecurityCloud/Package/testParameters.json b/Solutions/DruvaDataSecurityCloud/Package/testParameters.json new file mode 100644 index 00000000000..554801e41b7 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Package/testParameters.json @@ -0,0 +1,38 @@ +{ + "location": { + "type": "string", + "minLength": 1, + "defaultValue": "[resourceGroup().location]", + "metadata": { + "description": "Not used, but needed to pass arm-ttk test `Location-Should-Not-Be-Hardcoded`. We instead use the `workspace-location` which is derived from the LA workspace" + } + }, + "workspace-location": { + "type": "string", + "defaultValue": "", + "metadata": { + "description": "[concat('Region to deploy solution resources -- separate from location selection',parameters('location'))]" + } + }, + "workspace": { + "defaultValue": "", + "type": "string", + "metadata": { + "description": "Workspace name for Log Analytics where Microsoft Sentinel is setup" + } + }, + "resourceGroupName": { + "type": "string", + "defaultValue": "[resourceGroup().name]", + "metadata": { + "description": "resource group name where Microsoft Sentinel is setup" + } + }, + "subscription": { + "type": "string", + "defaultValue": "[last(split(subscription().id, '/'))]", + "metadata": { + "description": "subscription id where Microsoft Sentinel is setup" + } + } +} diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineEnterpriseWorkload/README.md b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineEnterpriseWorkload/README.md new file mode 100644 index 00000000000..e9850d52a09 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineEnterpriseWorkload/README.md @@ -0,0 +1,60 @@ +# Druva Quarantine Enterprise Workload Resource + +## Summary + +This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment. + +### Prerequisites + +1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the [Druva Security Cloud Platform](https://console.druva.com/). +2. Generate Druva API Client Credentials + * Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials. + * [Druva's Documentation Page](https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials) + * Copy/Paste or Store the creds for future use. +3. Store Service account credentials in Key Vault Secrets and obtain keyvault name. + * Create a Key Vault with name as Druva-ClientCredential + * Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively. + * Store the secrets obtained for your organization and user from Druva Console UI in the previous step. + +### Deployment instructions + +1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard. +2. Fill in the required parameters: + * PlaybookName: Name by which you want to deploy the playbook. + * keyvaultName: Name of keyvault where secrets are stored. +3. Validate the deployment: + * Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully. + * Verify the deployment logs for any errors. +4. Authorize connections: + * Follow the steps in the 'postDeployment' section to authorize connections. + +[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineEnterpriseWorkload%2Fazuredeploy.json) [![Deploy to Azure](https://aka.ms/deploytoazuregovbutton)](https://portal.azure.us/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineEnterpriseWorkload%2Fazuredeploy.json) + +### Post-Deployment instructions + +#### a. Authorize connections + +Once deployment is complete, authorize each connection keyvault. + +1. Login to the Microsoft Azure protal and in the search box Type API Connections. +2. Find API connection option. +3. Check for your Created API connection exists. eg. -KeyVault-Connection +4. Check Status should be ready for the same API Connection. + +#### b. Grant permissions + +Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User' + +### Execute the playbook: + +1. Trigger the playbook manually by using the dropdown option as 'run_with_payload'. +2. On triggering a side screen will appear in which there will be a section named as 'Body'. +3. Inside body paste the json obtained from the below with respective edited values according to your resources. + ```json + { + "enterprise_resource_name" : "", + "fromDate" : "<2024-12-01>", + "toDate" : "<2024-12-18>" + } +4. Hit the 'run' button at the bottom. +5. Navigate to the playbook home page and check the run history if the run was successful or not. diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineEnterpriseWorkload/azuredeploy.json b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineEnterpriseWorkload/azuredeploy.json new file mode 100644 index 00000000000..9a3b7437f48 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineEnterpriseWorkload/azuredeploy.json @@ -0,0 +1,760 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "metadata": { + "title": "Druva Quarantine Playbook for Enterprise Workload", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread in your enterprise workload", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "author": "Druva", + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ "Ransomware Recovery", "Druva Security", "Unusual Data Activity", "Quarantine Snapshots" ] + }, + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Enterprise_Workloads", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[concat('KeyVault-', parameters('PlaybookName'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[parameters('PlaybookName')]", + "location": "[resourceGroup().location]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineEnterpriseWorkloadsResource", + "hidden-SentinelTemplateVersion": "1.0" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "defaultValue": {}, + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "enterprise_resource_name": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_Device": { + "runAfter": { + "Initialize_Combined_Resources_variable": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/backupset", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "hostname": "@{triggerBody()?['enterprise_resource_name']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Find_VM_Device": { + "runAfter": { + "Initialize_Combined_Resources_variable": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/backupset", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "hostname": "@{triggerBody()?['enterprise_resource_name']}", + "serverTypes[]": "3" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Resource_Details": { + "runAfter": { + "Find_Device": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Device')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "Parse_VM_Resource_Details": { + "runAfter": { + "Find_VM_Device": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_VM_Device')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "CombineResponses": { + "runAfter": { + "Parse_Resource_Details": [ + "Succeeded" + ], + "Parse_VM_Resource_Details": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": [ + { + "resources": "@body('Parse_Resource_Details')?['resources']" + }, + { + "resources": "@body('Parse_VM_Resource_Details')?['resources']" + } + ] + }, + "Initialize_Combined_Resources_variable": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "CombinedResources", + "type": "array", + "value": [] + } + ] + } + }, + "For_Each_Response": { + "foreach": "@outputs('CombineResponses')", + "actions": { + "Nested_For_each_": { + "foreach": "@item()?['resources']", + "actions": { + "Append_to_array_variable": { + "type": "AppendToArrayVariable", + "inputs": { + "name": "CombinedResources", + "value": "@item()" + } + } + }, + "type": "Foreach" + } + }, + "runAfter": { + "Parse_CombineResponses_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_Resources": { + "runAfter": { + "For_Each_Responses": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "resources": "@variables('CombinedResources')" + } + }, + "If_Resource_Exists": { + "actions": { + "Resource_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_Resources')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_Resources": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "Resource Not Found" + } + } + } + } + }, + "expression": { + "or": [ + { + "equals": [ + "@variables('ResourceMatch')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "For_each_Resource": { + "foreach": "@body('Resource_JSON')?['resources']", + "actions": { + "Quarantine_VM_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": "@item()?['orgID']", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_VM_Range_ID_": { + "runAfter": { + "Quarantine_VM_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_VM_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "runAfter": { + "If_Resource_Exists": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Get_secret_ClientId": { + "runAfter": { + "Initialize_variable_Match_Resource": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "check_resourcename": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "username is not empty" + } + } + }, + "runAfter": {}, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Username is empty\"" + } + } + } + } + }, + "expression": { + "or": [ + { + "not": { + "equals": [ + "@triggerBody()?['enterprise_resource_name']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Initialize_variable_Match_Resource": { + "runAfter": { + "check_resourcename": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "ResourceMatch", + "type": "boolean", + "value": false + } + ] + } + }, + "Parse_CombineResponses_JSON": { + "runAfter": { + "CombineResponses": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@outputs('CombineResponses')", + "schema": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "orgID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "orgID" + ] + } + } + }, + "required": [ + "resources" + ] + } + } + } + }, + "For_Each_Responses": { + "foreach": "@outputs('Parse_CombineResponses_JSON')['body']", + "actions": { + "Nested_For_each": { + "foreach": "@item()['resources']", + "actions": { + "Check_If_Resource_exists": { + "actions": { + "Set_Match_Resource_True": { + "type": "SetVariable", + "inputs": { + "name": "ResourceMatch", + "value": true + } + } + }, + "else": { + "actions": {} + }, + "expression": { + "or": [ + { + "equals": [ + "@item()['resourceParentName']", + "@triggerBody()?['enterprise_resource_name']" + ] + } + ] + }, + "type": "If" + } + }, + "type": "Foreach" + } + }, + "runAfter": { + "Parse_CombineResponses_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + } + }, + "outputs": {} + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[variables('keyvaultConnectionName')]", + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[variables('keyvaultConnectionName')]", + "location": "[resourceGroup().location]", + "kind": "V1", + "properties": { + "displayName": "[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[parameters('keyvaultName')]" + } + } + }, + "customParameterValues": {}, + "api": { + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/keyvault')]" + } + } + } + ] +} \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineInsyncWorkloads/README.md b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineInsyncWorkloads/README.md new file mode 100644 index 00000000000..f9ca9a43802 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineInsyncWorkloads/README.md @@ -0,0 +1,60 @@ +# Druva Quarantine Insync Workload Resource + +## Summary + +This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment. + +### Prerequisites + +1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the [Druva Security Cloud Platform](https://console.druva.com/). +2. Generate Druva API Client Credentials + * Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials. + * [Druva's Documentation Page](https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials) + * Copy/Paste or Store the creds for future use. +3. Store Service account credentials in Key Vault Secrets and obtain keyvault name. + * Create a Key Vault with name as Druva-ClientCredential + * Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively. + * Store the secrets obtained for your organization and user from Druva Console UI in the previous step. + +### Deployment instructions + +1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard. +2. Fill in the required parameters: + * PlaybookName: Name by which you want to deploy the playbook. + * keyvaultName: Name of keyvault where secrets are stored. +3. Validate the deployment: + * Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully. + * Verify the deployment logs for any errors. +4. Authorize connections: + * Follow the steps in the 'postDeployment' section to authorize connections. + +[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineInsyncWorkload%2Fazuredeploy.json) [![Deploy to Azure](https://aka.ms/deploytoazuregovbutton)](https://portal.azure.us/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineInsyncWorkload%2Fazuredeploy.json) + +### Post-Deployment instructions + +#### a. Authorize connections + +Once deployment is complete, authorize each connection keyvault. + +1. Login to the Microsoft Azure protal and in the search box Type API Connections. +2. Find API connection option. +3. Check for your Created API connection exists. eg. -KeyVault-Connection +4. Check Status should be ready for the same API Connection. + +#### b. Grant permissions + +Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User' + +### Execute the playbook: + +1. Trigger the playbook manually by using the dropdown option as 'run_with_payload'. +2. On triggering a side screen will appear in which there will be a section named as 'Body'. +3. Inside body paste the json obtained from the below with respective edited values according to your resources. + ```json + { + "username" : "", + "fromDate" : "<2024-12-01>", + "toDate" : "<2024-12-18>" + } +4. Hit the 'run' button at the bottom. +5. Navigate to the playbook home page and check the run history if the run was successful or not. diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineInsyncWorkloads/azuredeploy.json b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineInsyncWorkloads/azuredeploy.json new file mode 100644 index 00000000000..aaa3e9afbab --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineInsyncWorkloads/azuredeploy.json @@ -0,0 +1,688 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "metadata": { + "title": "Druva Quarantine Playbook for inSync Workloads", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your inSync User based workloads.", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "author": "Druva", + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ "Ransomware Recovery", "Druva Security", "Unusual Data Activity", "Quarantine Snapshots" ] + }, + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Insync_User_Workloads", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[concat('KeyVault-', parameters('PlaybookName'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[parameters('PlaybookName')]", + "location": "[resourceGroup().location]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineInsyncWorkloadsResource", + "hidden-SentinelTemplateVersion": "1.0" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "resourceTypes": { + "defaultValue": [ + "Endpoint", + "OneDrive", + "Google Drive" + ], + "type": "Array" + }, + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "defaultValue": {}, + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "username": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_User": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/users", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "users": "@{triggerBody()?['username']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_User_Details": { + "runAfter": { + "Find_User": [ + "Succeeded", + "TimedOut", + "Skipped", + "Failed" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_User')", + "schema": { + "type": "object", + "properties": { + "users": { + "type": "array", + "items": { + "type": "object", + "properties": { + "userID": { + "type": "integer" + }, + "userName": { + "type": "string" + }, + "emailID": { + "type": "string" + }, + "profileID": { + "type": "integer" + }, + "storageID": { + "type": "integer" + } + }, + "required": [ + "userID", + "userName", + "emailID", + "profileID", + "storageID" + ] + } + }, + "totalSize": { + "type": "integer" + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "Find_Users_Device": { + "runAfter": { + "Compose_api_host": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@concat(parameters('api_host'),\n '/realize/ransomwarerecovery/v1/search/device?',\n outputs('Compose_api_host')\n)", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Device_Details": { + "runAfter": { + "Find_Users_Device": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Users_Device')", + "schema": { + "type": "object", + "properties": { + "resources": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "userID": { + "type": "integer" + }, + "userName": { + "type": "string" + }, + "profileID": { + "type": "integer" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "userID", + "userName", + "profileID" + ] + } + }, + "nextPageToken": { + "type": "string" + }, + "isLast": { + "type": "boolean" + }, + "errorMessage": { + "type": "string" + } + } + } + } + }, + "For_each_user_device": { + "foreach": "@body('Parse_Device_Details')?['resources']", + "actions": { + "Parse_Range_ID": { + "runAfter": { + "Quarantine_Resource_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Resource_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + }, + "Quarantine_Resource_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": -1, + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + } + }, + "runAfter": { + "Parse_Device_Details": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "check_username": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "username is not empty" + } + } + }, + "runAfter": {}, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Username is empty\"" + } + } + } + } + }, + "expression": { + "or": [ + { + "not": { + "equals": [ + "@triggerBody()?['username']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "For_each": { + "foreach": "@body('Parse_User_Details')?['users']", + "actions": { + "Check_If_user_exists": { + "actions": { + "Set_Match_User_True": { + "type": "SetVariable", + "inputs": { + "name": "UserNameMatched", + "value": true + } + }, + "Append_to_User_array_": { + "runAfter": { + "Set_Match_User_True": [ + "Succeeded" + ] + }, + "type": "AppendToArrayVariable", + "inputs": { + "name": "UserArray", + "value": "@items('For_each')" + } + } + }, + "else": { + "actions": {} + }, + "expression": { + "or": [ + { + "equals": [ + "@item()?['userName']", + "@triggerBody()?['username']" + ] + } + ] + }, + "type": "If" + } + }, + "runAfter": { + "Parse_User_Details": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_api_host": { + "runAfter": { + "Check_if_User_found_": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": "@concat(\n 'users[]=',\n string(body('User_JSON')?['users'][0]['userID']),\n '&resourceTypes[]=',\n join(parameters('resourceTypes'), '&resourceTypes[]=')\n)" + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientID": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Get_secret_ClientID": { + "runAfter": { + "Initialize_Array": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Check_if_User_found_": { + "actions": { + "User_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_Users')", + "schema": { + "type": "object", + "properties": { + "users": { + "type": "array", + "items": { + "type": "object", + "properties": { + "userID": { + "type": "integer" + }, + "userName": { + "type": "string" + }, + "emailID": { + "type": "string" + }, + "profileID": { + "type": "integer" + }, + "storageID": { + "type": "integer" + } + }, + "required": [ + "userID", + "userName", + "emailID", + "profileID", + "storageID" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_Users": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "User Not Found" + } + } + } + } + }, + "expression": { + "and": [ + { + "equals": [ + "@variables('UserNameMatched')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "Initialize_Array": { + "runAfter": { + "Initialize_variable_Match_User": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "UserArray", + "type": "array", + "value": [] + } + ] + } + }, + "Initialize_variable_Match_User": { + "runAfter": { + "check_username": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "UserNameMatched", + "type": "boolean", + "value": false + } + ] + } + }, + "Compose_Users": { + "runAfter": { + "For_each": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "users": "@variables('UserArray')" + } + } + }, + "outputs": {} + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[variables('keyvaultConnectionName')]", + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[variables('keyvaultConnectionName')]", + "location": "[resourceGroup().location]", + "kind": "V1", + "properties": { + "displayName": "[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[parameters('keyvaultName')]" + } + } + }, + "customParameterValues": {}, + "api": { + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/keyvault')]" + } + } + } + ] +} \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharePoint/README.md b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharePoint/README.md new file mode 100644 index 00000000000..234c5901b3a --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharePoint/README.md @@ -0,0 +1,60 @@ +# Druva Quarantine Share Point Resource + +## Summary + +This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment. + +### Prerequisites + +1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the [Druva Security Cloud Platform](https://console.druva.com/). +2. Generate Druva API Client Credentials + * Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials. + * [Druva's Documentation Page](https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials) + * Copy/Paste or Store the creds for future use. +3. Store Service account credentials in Key Vault Secrets and obtain keyvault name. + * Create a Key Vault with name as Druva-ClientCredential + * Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively. + * Store the secrets obtained for your organization and user from Druva Console UI in the previous step. + +### Deployment instructions + +1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard. +2. Fill in the required parameters: + * PlaybookName: Name by which you want to deploy the playbook. + * keyvaultName: Name of keyvault where secrets are stored. +3. Validate the deployment: + * Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully. + * Verify the deployment logs for any errors. +4. Authorize connections: + * Follow the steps in the 'postDeployment' section to authorize connections. + +[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineSharePoint%2Fazuredeploy.json) [![Deploy to Azure](https://aka.ms/deploytoazuregovbutton)](https://portal.azure.us/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineSharePoint%2Fazuredeploy.json) + +### Post-Deployment instructions + +#### a. Authorize connections + +Once deployment is complete, authorize each connection keyvault. + +1. Login to the Microsoft Azure protal and in the search box Type API Connections. +2. Find API connection option. +3. Check for your Created API connection exists. eg. -KeyVault-Connection +4. Check Status should be ready for the same API Connection. + +#### b. Grant permissions + +Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User' + +### Execute the playbook: + +1. Trigger the playbook manually by using the dropdown option as 'run_with_payload'. +2. On triggering a side screen will appear in which there will be a section named as 'Body'. +3. Inside body paste the json obtained from the below with respective edited values according to your resources. + ```json + { + "site_url" : "", + "fromDate" : "<2024-12-01>", + "toDate" : "<2024-12-18>" + } +4. Hit the 'run' button at the bottom. +5. Navigate to the playbook home page and check the run history if the run was successful or not. diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharePoint/azuredeploy.json b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharePoint/azuredeploy.json new file mode 100644 index 00000000000..766572ddb06 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharePoint/azuredeploy.json @@ -0,0 +1,590 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "metadata": { + "title": "Druva Quarantine Playbook for Sharepoint", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread in your sharepoint", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "author": "Druva", + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ "Ransomware Recovery", "Druva Security", "Unusual Data Activity", "Quarantine Snapshots" ] + }, + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Share_Point", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[concat('KeyVault-', parameters('PlaybookName'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[parameters('PlaybookName')]", + "location": "[resourceGroup().location]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineSharePointResource", + "hidden-SentinelTemplateVersion": "1.0" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "defaultValue": {}, + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "share_point_site": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "check_share_point_site": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "Share Point Site is not empty" + } + } + }, + "runAfter": {}, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Share Point Site is Empty\"" + } + } + } + } + }, + "expression": { + "and": [ + { + "not": { + "equals": [ + "@triggerBody()?['share_point_site']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Get_secret_ClientId": { + "runAfter": { + "Initialize_Array": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_Share_Point_Sites": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/sharepoint-sites", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "siteTitlePrefix": "@{triggerBody()?['share_point_site']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_SharePoint_Site_JSON": { + "runAfter": { + "Find_Share_Point_Sites": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Share_Point_Sites')", + "schema": { + "type": "object", + "properties": { + "siteCollections": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "siteType": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "siteType" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "Initialize_variable_Match_Share_Point_Site": { + "runAfter": { + "check_share_point_site": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharePointSiteMatched", + "type": "boolean", + "value": false + } + ] + } + }, + "Initialize_Array": { + "runAfter": { + "Initialize_variable_Match_Share_Point_Site": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharePointSiteArray", + "type": "array", + "value": [] + } + ] + } + }, + "For_each": { + "foreach": "@outputs('Parse_SharePoint_Site_JSON')?['body']?['siteCollections']", + "actions": { + "Check_If_Share_Point_Site_exists": { + "actions": { + "Set_Match_Share_Point_Site_True": { + "type": "SetVariable", + "inputs": { + "name": "SharePointSiteMatched", + "value": true + } + }, + "Append_to_Share_Point_Site_array_variable": { + "runAfter": { + "Set_Match_Share_Point_Site_True": [ + "Succeeded" + ] + }, + "type": "AppendToArrayVariable", + "inputs": { + "name": "SharePointSiteArray", + "value": "@items('For_each')" + } + } + }, + "else": { + "actions": {} + }, + "expression": { + "or": [ + { + "equals": [ + "@item()?['resourceParentName']", + "@triggerBody()?['share_point_site']" + ] + } + ] + }, + "type": "If" + } + }, + "runAfter": { + "Parse_SharePoint_Site_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_SiteCollections": { + "runAfter": { + "For_each": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "siteCollections": "@variables('SharePointSiteArray')" + } + }, + "Check_if_Site_Collection_found_": { + "actions": { + "Site_Collection_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_SiteCollections')", + "schema": { + "type": "object", + "properties": { + "siteCollections": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + }, + "siteType": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName", + "siteType" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_SiteCollections": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "Site Collections Not Found" + } + } + } + } + }, + "expression": { + "and": [ + { + "equals": [ + "@variables('SharePointSiteMatched')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "For_each_Site_Collection": { + "foreach": "@outputs('Site_Collection_JSON')?['body']?['siteCollections']", + "actions": { + "Quarantine_Site_Collection_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": "@null", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Share_Point_Site_Range_ID": { + "runAfter": { + "Quarantine_Site_Collection_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Site_Collection_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "runAfter": { + "Check_if_Site_Collection_found_": [ + "Succeeded" + ] + }, + "type": "Foreach" + } + }, + "outputs": {} + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[variables('keyvaultConnectionName')]", + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[variables('keyvaultConnectionName')]", + "location": "[resourceGroup().location]", + "kind": "V1", + "properties": { + "displayName": "[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[parameters('keyvaultName')]" + } + } + }, + "customParameterValues": {}, + "api": { + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/keyvault')]" + } + } + } + ] +} \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharedDrive/README.md b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharedDrive/README.md new file mode 100644 index 00000000000..ba04eb6544e --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharedDrive/README.md @@ -0,0 +1,60 @@ +# Druva Quarantine Shared Drive Resource + +## Summary + +This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment. + +### Prerequisites + +1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the [Druva Security Cloud Platform](https://console.druva.com/). +2. Generate Druva API Client Credentials + * Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials. + * [Druva's Documentation Page](https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials) + * Copy/Paste or Store the creds for future use. +3. Store Service account credentials in Key Vault Secrets and obtain keyvault name. + * Create a Key Vault with name as Druva-ClientCredential + * Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively. + * Store the secrets obtained for your organization and user from Druva Console UI in the previous step. + +### Deployment instructions + +1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard. +2. Fill in the required parameters: + * PlaybookName: Name by which you want to deploy the playbook. + * keyvaultName: Name of keyvault where secrets are stored. +3. Validate the deployment: + * Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully. + * Verify the deployment logs for any errors. +4. Authorize connections: + * Follow the steps in the 'postDeployment' section to authorize connections. + +[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineSharedDrive%2Fazuredeploy.json) [![Deploy to Azure](https://aka.ms/deploytoazuregovbutton)](https://portal.azure.us/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineSharedDrive%2Fazuredeploy.json) + +### Post-Deployment instructions + +#### a. Authorize connections + +Once deployment is complete, authorize each connection keyvault. + +1. Login to the Microsoft Azure protal and in the search box Type API Connections. +2. Find API connection option. +3. Check for your Created API connection exists. eg. -KeyVault-Connection +4. Check Status should be ready for the same API Connection. + +#### b. Grant permissions + +Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User' + +### Execute the playbook: + +1. Trigger the playbook manually by using the dropdown option as 'run_with_payload'. +2. On triggering a side screen will appear in which there will be a section named as 'Body'. +3. Inside body paste the json obtained from the below with respective edited values according to your resources. + ```json + { + "shared_drive" : "", + "fromDate" : "<2024-12-01>", + "toDate" : "<2024-12-18>" + } +4. Hit the 'run' button at the bottom. +5. Navigate to the playbook home page and check the run history if the run was successful or not. diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharedDrive/azuredeploy.json b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharedDrive/azuredeploy.json new file mode 100644 index 00000000000..66a42a0ad26 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineSharedDrive/azuredeploy.json @@ -0,0 +1,582 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "metadata": { + "title": "Druva Quarantine Playbook for Shared Drive", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your shared drives.", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "author": "Druva", + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ "Ransomware Recovery", "Druva Security", "Unusual Data Activity", "Quarantine Snapshots" ] + }, + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_Shared_Drive", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[concat('KeyVault-', parameters('PlaybookName'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[parameters('PlaybookName')]", + "location": "[resourceGroup().location]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineSharedDriveResource", + "hidden-SentinelTemplateVersion": "1.0" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "defaultValue": {}, + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "shared_drive": { + "type": "string" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "check_Shared_Drive": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "Shared Drive is not empty" + } + } + }, + "runAfter": {}, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Shared Drive is Empty\"" + } + } + } + } + }, + "expression": { + "and": [ + { + "not": { + "equals": [ + "@triggerBody()?['shared_drive']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Initialize_variable_Match_Shared_Drive": { + "runAfter": { + "check_Shared_Drive": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharedDriveMatched", + "type": "boolean", + "value": false + } + ] + } + }, + "Initialize_Array": { + "runAfter": { + "Initialize_variable_Match_Shared_Drive": [ + "Succeeded" + ] + }, + "type": "InitializeVariable", + "inputs": { + "variables": [ + { + "name": "SharedDriveArray", + "type": "array", + "value": [] + } + ] + } + }, + "Get_secret_ClientId": { + "runAfter": { + "Initialize_Array": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Find_Shared_Drives": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/search/shareddrive-accounts", + "method": "GET", + "headers": { + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}" + }, + "queries": { + "accountTitlePrefix": "@{triggerBody()?['shared_drive']}" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Share_Drive_JSON": { + "runAfter": { + "Find_Shared_Drives": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Find_Shared_Drives')", + "schema": { + "type": "object", + "properties": { + "accountList": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName" + ] + } + }, + "nextPageToken": { + "type": "string" + } + } + } + } + }, + "For_each": { + "foreach": "@outputs('Share_Drive_JSON')?['body']?['accountList']", + "actions": { + "Check_If_Shared_Drive_exists": { + "actions": { + "Set_Match_Shared_Drive_True": { + "type": "SetVariable", + "inputs": { + "name": "SharedDriveMatched", + "value": true + } + }, + "Append_to_Shared_Drive_array_variable": { + "runAfter": { + "Set_Match_Shared_Drive_True": [ + "Succeeded" + ] + }, + "type": "AppendToArrayVariable", + "inputs": { + "name": "SharedDriveArray", + "value": "@items('For_each')" + } + } + }, + "else": { + "actions": {} + }, + "expression": { + "or": [ + { + "equals": [ + "@item()?['resourceName']", + "@triggerBody()?['shared_drive']" + ] + } + ] + }, + "type": "If" + } + }, + "runAfter": { + "Share_Drive_JSON": [ + "Succeeded" + ] + }, + "type": "Foreach" + }, + "Compose_SharedDrive_Collections": { + "runAfter": { + "For_each": [ + "Succeeded" + ] + }, + "type": "Compose", + "inputs": { + "accountList": "@variables('SharedDriveArray')" + } + }, + "Check_if_Shared_Drive_found": { + "actions": { + "Account_List_JSON": { + "type": "ParseJson", + "inputs": { + "content": "@outputs('Compose_SharedDrive_Collections')", + "schema": { + "type": "object", + "properties": { + "accountList": { + "type": "array", + "items": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceName": { + "type": "string" + }, + "resourceType": { + "type": "string" + }, + "resourceStatus": { + "type": "string" + }, + "resourceParentName": { + "type": "string" + } + }, + "required": [ + "resourceID", + "resourceName", + "resourceType", + "resourceStatus", + "resourceParentName" + ] + } + } + } + } + } + } + }, + "runAfter": { + "Compose_SharedDrive_Collections": [ + "Succeeded" + ] + }, + "else": { + "actions": { + "Terminate": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "Site Collections Not Found" + } + } + } + } + }, + "expression": { + "and": [ + { + "equals": [ + "@variables('SharedDriveMatched')", + "@true" + ] + } + ] + }, + "type": "If" + }, + "For_each_Shared_Drive_Collection": { + "foreach": "@outputs('Account_List_JSON')?['body']?['accountList']", + "actions": { + "Quarantine_Account_List_API": { + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{item()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@item()?['resourceType']", + "orgID": "@null", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Shared_Drive_Range_ID_": { + "runAfter": { + "Quarantine_Account_List_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Account_List_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "runAfter": { + "Check_if_Shared_Drive_found": [ + "Succeeded" + ] + }, + "type": "Foreach" + } + }, + "outputs": {} + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[variables('keyvaultConnectionName')]", + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[variables('keyvaultConnectionName')]", + "location": "[resourceGroup().location]", + "kind": "V1", + "properties": { + "displayName": "[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[parameters('keyvaultName')]" + } + } + }, + "customParameterValues": {}, + "api": { + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/keyvault')]" + } + } + } + ] +} \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineUsingResourceID/README.md b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineUsingResourceID/README.md new file mode 100644 index 00000000000..1b06a721d6e --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineUsingResourceID/README.md @@ -0,0 +1,62 @@ +# Druva Quarantine Device using Resource ID + +## Summary + +This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment. + +### Prerequisites + +1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the [Druva Security Cloud Platform](https://console.druva.com/). +2. Generate Druva API Client Credentials + * Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials. + * [Druva's Documentation Page](https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials) + * Copy/Paste or Store the creds for future use. +3. Store Service account credentials in Key Vault Secrets and obtain keyvault name. + * Create a Key Vault with name as Druva-ClientCredential + * Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively. + * Store the secrets obtained for your organization and user from Druva Console UI in the previous step. + +### Deployment instructions + +1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard. +2. Fill in the required parameters: + * PlaybookName: Name by which you want to deploy the playbook. + * keyvaultName: Name of keyvault where secrets are stored. +3. Validate the deployment: + * Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully. + * Verify the deployment logs for any errors. +4. Authorize connections: + * Follow the steps in the 'postDeployment' section to authorize connections. + +[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineUsingResourceID%2Fazuredeploy.json) [![Deploy to Azure](https://aka.ms/deploytoazuregovbutton)](https://portal.azure.us/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2FAzure-Sentinel%2Fmaster%2FSolutions%2FDruvaDataSecurityCloud%2FPlaybooks%2FDruvaQuarantineUsingResourceID%2Fazuredeploy.json) + +### Post-Deployment instructions + +#### a. Authorize connections + +Once deployment is complete, authorize each connection keyvault. + +1. Login to the Microsoft Azure protal and in the search box Type API Connections. +2. Find API connection option. +3. Check for your Created API connection exists. eg. -KeyVault-Connection +4. Check Status should be ready for the same API Connection. + +#### b. Grant permissions + +Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User' + +### Execute the playbook: + +1. Trigger the playbook manually by using the dropdown option as 'run_with_payload'. +2. On triggering a side screen will appear in which there will be a section named as 'Body'. +3. Inside body paste the json obtained from the below with respective edited values according to your resources. + ```json + { + "resourceID": "", + "resourceType": "", + "orgID" : "", + "fromDate" : "<2024-12-01>", + "toDate" : "<2024-12-18>" + } +4. Hit the 'run' button at the bottom. +5. Navigate to the playbook home page and check the run history if the run was successful or not. diff --git a/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineUsingResourceID/azuredeploy.json b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineUsingResourceID/azuredeploy.json new file mode 100644 index 00000000000..b62bb432a53 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/Playbooks/DruvaQuarantineUsingResourceID/azuredeploy.json @@ -0,0 +1,358 @@ +{ + "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", + "contentVersion": "1.0.0.0", + "metadata": { + "title": "Druva Quarantine Using Resource id", + "description": "This playbook uses Druva-Ransomware-Response capabilities to stop the spread of ransomware and avoid reinfection or contamination spread to your environment.", + "prerequisites": [ + "1. Verify ARR (Accelerated Ransomeware Recovery) should be enabled for the respective Device using Resource ID on the Druva Security Cloud Platform.", + "2. Generate Druva API Client Credentials", + "a. Use the following link to navigate to Druva's documentation page and refer the steps to generate API Client Credentials.", + "b. Druva's Documentation Page : https://help.druva.com/en/articles/8580838-create-and-manage-api-credentials", + "c. Copy/Paste or Store the creds for future use.", + "3. Store Service account credentials in Key Vault Secrets and obtain keyvault name.", + "a. Create a Key Vault with name as Druva-ClientCredential", + "b. Go to KeyVault -> secrets -> Generate/import and create 'Druva-ClientID' & 'Druva-ClientSecret' for storing client_id and client_secret respectively", + "c. Store the secrets obtained for your organization and user from Druva Console UI in the previous step." + ], + "executionSteps": [ + "1. Deploy the ARM template:", + "a. Open the Azure Portal.", + "b. Navigate to 'Deploy a custom template'.", + "c. Upload this ARM template file or paste its content.", + "d. Provide the necessary parameter values (e.g., KeyVault name, connection name, etc.).", + "e. Review and start the deployment.", + "2. Validate the deployment:", + "a. Check if the resources (e.g., Key Vault, API connections, Logic Apps) are created successfully.", + "b. Verify the deployment logs for any errors.", + "3. Authorize connections:", + "a. Follow the steps in the 'postDeployment' section to authorize connections.", + "4. Test the playbook:", + "a. Trigger the playbook manually by using the dropdown option as 'run_with_payload'", + "b. On triggering a side screen will appear in which there will be a section named as 'Body'.", + "c. Inside body paste the json obtained from the README.md file with respective edited values according to your resources.", + "d. Hit the 'run' button at the bottom.", + "e. Navigate to the playbook home page and check the run history if the run was successful or not." + ], + "postDeployment": [ + "**a. Authorize connections**", + "Once deployment is complete, authorize each connection.", + "1. Login to the Microsoft Azure protal and in the search box Type API Connections.", + "2. Find API connection option.", + "3. Check for your Created API connection exists. eg. Druva-KeyVault-Connection", + "4. Check Status should be ready for the same API Connection.", + "**b. Grant permissions**", + "Make sure that this playbook and your user has the IAM role permission granted as 'Key Vault Secrets User'." + ], + "author": "Druva", + "version": "1.0", + "category": "Druva-Realize-UDA-Quarantine_snapshots", + "tags": [ "Ransomware Recovery", "Druva Security", "Unusual Data Activity", "Quarantine Snapshots" ] + }, + "parameters": { + "PlaybookName": { + "defaultValue": "Druva_Quarantine_With_Resource_ID_Workloads", + "type": "string", + "metadata": { + "description": "Name of the Playbook." + } + }, + "keyvaultName": { + "type": "String", + "defaultValue": "Druva-ClientCredential", + "metadata": { + "description": "Name of the Vault created to store Druva Client Credentials." + } + } + }, + "variables": { + "keyvaultConnectionName": "[concat('KeyVault-', parameters('PlaybookName'))]" + }, + "resources": [ + { + "type": "Microsoft.Logic/workflows", + "apiVersion": "2017-07-01", + "name": "[parameters('PlaybookName')]", + "location": "[resourceGroup().location]", + "tags": { + "hidden-SentinelTemplateName": "DruvaQuarantineResourceUsingResourceID", + "hidden-SentinelTemplateVersion": "1.0" + }, + "identity": { + "type": "SystemAssigned" + }, + "dependsOn": [ + "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]" + ], + "properties": { + "state": "Enabled", + "definition": { + "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#", + "contentVersion": "1.0.0.0", + "parameters": { + "api_host": { + "defaultValue": "https://apis.druva.com", + "type": "String" + }, + "$connections": { + "defaultValue": {}, + "type": "Object" + } + }, + "triggers": { + "When_a_HTTP_request_is_received": { + "type": "Request", + "kind": "Http", + "inputs": { + "schema": { + "type": "object", + "properties": { + "resourceID": { + "type": "integer" + }, + "resourceType": { + "type": "string" + }, + "orgID": { + "type": "integer" + }, + "fromDate": { + "type": "string" + }, + "toDate": { + "type": "string" + } + } + } + } + } + }, + "actions": { + "check_resourceID": { + "actions": { + "Compose_Message": { + "type": "Compose", + "inputs": { + "message": "Resource ID is not empty" + } + } + }, + "runAfter": {}, + "else": { + "actions": { + "Terminate_Execution": { + "type": "Terminate", + "inputs": { + "runStatus": "Failed", + "runError": { + "code": "500", + "message": "\"Resource ID, Resource Type or ORG ID is empty\"" + } + } + } + } + }, + "expression": { + "and": [ + { + "not": { + "equals": [ + "@triggerBody()?['resourceID']", + "@null" + ] + } + }, + { + "not": { + "equals": [ + "@triggerBody()?['resourceType']", + "@null" + ] + } + }, + { + "not": { + "equals": [ + "@triggerBody()?['orgID']", + "@null" + ] + } + } + ] + }, + "type": "If" + }, + "Quarantine_Resource_API": { + "runAfter": { + "Parse_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/realize/ransomwarerecovery/v1/quarantineranges/resource/@{triggerBody()?['resourceID']}", + "method": "POST", + "headers": { + "accept": "application/json", + "Authorization": "Bearer @{body('Parse_Bearer_Token')?['access_token']}", + "Content-Type": "application/json" + }, + "body": { + "resourceType": "@triggerBody()?['resourceType']", + "orgID": "@triggerBody()?['orgID']", + "fromDate": "@triggerBody()?['fromDate']", + "toDate": "@triggerBody()?['toDate']" + } + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Get_secret_ClientId": { + "runAfter": { + "check_resourceID": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientID')}/value" + } + }, + "Get_secret_ClientSecret": { + "runAfter": { + "Get_secret_ClientId": [ + "Succeeded" + ] + }, + "type": "ApiConnection", + "inputs": { + "host": { + "connection": { + "name": "@parameters('$connections')['keyvault']['connectionId']" + } + }, + "method": "get", + "path": "/secrets/@{encodeURIComponent('Druva-ClientSecret')}/value" + } + }, + "Generate_Bearer_Token": { + "runAfter": { + "Get_secret_ClientSecret": [ + "Succeeded" + ] + }, + "type": "Http", + "inputs": { + "uri": "@{parameters('api_host')}/token", + "method": "POST", + "headers": { + "Authorization": "Basic @{base64(concat(body('Get_secret_ClientId')?['value'], ':', body('Get_secret_ClientSecret')?['value']))}", + "Content-Type": "application/x-www-form-urlencoded" + }, + "body": "scope=read&grant_type=client_credentials" + }, + "runtimeConfiguration": { + "contentTransfer": { + "transferMode": "Chunked" + } + } + }, + "Parse_Bearer_Token": { + "runAfter": { + "Generate_Bearer_Token": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Generate_Bearer_Token')", + "schema": { + "type": "object", + "properties": { + "access_token": { + "type": "string" + }, + "token_type": { + "type": "string" + }, + "expires_in": { + "type": "integer" + } + } + } + } + }, + "Parse_JSON": { + "runAfter": { + "Quarantine_Resource_API": [ + "Succeeded" + ] + }, + "type": "ParseJson", + "inputs": { + "content": "@body('Quarantine_Resource_API')", + "schema": { + "type": "object", + "properties": { + "rangeID": { + "type": "integer" + } + } + } + } + } + }, + "outputs": {} + }, + "parameters": { + "$connections": { + "value": { + "keyvault": { + "connectionId": "[resourceId('Microsoft.Web/connections', variables('keyvaultConnectionName'))]", + "connectionName": "[variables('keyvaultConnectionName')]", + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/Keyvault')]", + "connectionProperties": { + "authentication": { + "type": "ManagedServiceIdentity" + } + } + } + } + } + } + } + }, + { + "type": "Microsoft.Web/connections", + "apiVersion": "2018-07-01-preview", + "name": "[variables('keyvaultConnectionName')]", + "location": "[resourceGroup().location]", + "kind": "V1", + "properties": { + "displayName": "[variables('keyvaultConnectionName')]", + "connectionState": "Enabled", + "parameterValueSet": { + "name": "oauthMI", + "values": { + "vaultName": { + "value": "[parameters('keyvaultName')]" + } + } + }, + "customParameterValues": {}, + "api": { + "id": "[concat('/subscriptions/', subscription().subscriptionId, '/providers/Microsoft.Web/locations/', resourceGroup().location, '/managedApis/keyvault')]" + } + } + } + ] +} \ No newline at end of file diff --git a/Solutions/DruvaDataSecurityCloud/ReleaseNotes.md b/Solutions/DruvaDataSecurityCloud/ReleaseNotes.md new file mode 100644 index 00000000000..e52ae1ab5d3 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/ReleaseNotes.md @@ -0,0 +1,4 @@ +| **Version** | **Date Modified (DD-MM-YYYY)** | **Change History** | +|-------------|--------------------------------|--------------------------------------------------------| +| 3.0.0 | 09-01-2025 | Initial Solution Release | + diff --git a/Solutions/DruvaDataSecurityCloud/SolutionMetadata.json b/Solutions/DruvaDataSecurityCloud/SolutionMetadata.json new file mode 100644 index 00000000000..d1032daa019 --- /dev/null +++ b/Solutions/DruvaDataSecurityCloud/SolutionMetadata.json @@ -0,0 +1,15 @@ +{ + "publisherId": "druva-azuresentinel-solution", + "offerId": "azure-sentinel-solution-druva", + "firstPublishDate": "2024-12-24", + "providers": ["Druva"], + "categories": { + "domains" : ["Security - Others"] + }, + "support": { + "name": "Druva Inc", + "email": "support@druva.com", + "tier": "Partner", + "link": "https://support.druva.com/" + } +} diff --git a/Solutions/SecurityBridge App/Analytical Rules/CriticalEventTriggered.yaml b/Solutions/SecurityBridge App/Analytical Rules/CriticalEventTriggered.yaml index ed24a1013cb..b9ced228a4a 100644 --- a/Solutions/SecurityBridge App/Analytical Rules/CriticalEventTriggered.yaml +++ b/Solutions/SecurityBridge App/Analytical Rules/CriticalEventTriggered.yaml @@ -4,9 +4,6 @@ description: | 'This rule alerts if there is any critical event occured in the SAP system' severity: Medium requiredDataConnectors: - - connectorId: SecurityBridgeSAP - dataTypes: - - SecurityBridgeLogs_CL - connectorId: CustomLogsAma datatypes: - SecurityBridgeLogs_CL @@ -35,5 +32,5 @@ entityMappings: fieldMappings: - identifier: HostName columnName: Computer -version: 1.0.3 +version: 1.0.4 kind: Scheduled \ No newline at end of file diff --git a/Solutions/SecurityBridge App/Data/Solution_SecurityBridgeSAP.json b/Solutions/SecurityBridge App/Data/Solution_SecurityBridgeSAP.json index abaa373bab0..559a97bf9ab 100644 --- a/Solutions/SecurityBridge App/Data/Solution_SecurityBridgeSAP.json +++ b/Solutions/SecurityBridge App/Data/Solution_SecurityBridgeSAP.json @@ -2,7 +2,7 @@ "Name": "SecurityBridge App", "Author": "Christoph Nagy - christoph.nagy@securitybridge.com", "Logo": "", - "Description": "The [SecurityBridge App](https://securitybridge.com/) solution provides the capability to ingest SecurityBridge Threat Detection events from all on-premise and cloud based SAP instances into Microsoft Sentinel.\n\nThis solution is dependent on the Custom logs via AMA connector to collect the logs. The Custom logs solution will be installed as part of this solution installation. \n\n **NOTE**: Microsoft recommends installation of Custom logs via AMA Connector. Legacy connector uses the Log Analytics agent which is about to be deprecated by **Aug 31, 2024**. Using MMA and AMA on same machine can cause log duplication and extra ingestion cost [more details](https://learn.microsoft.com/azure/sentinel/ama-migrate?WT.mc_id=Portal-fx).", + "Description": "The [SecurityBridge App](https://securitybridge.com/) solution provides the capability to ingest SecurityBridge Threat Detection events from all on-premise and cloud based SAP instances into Microsoft Sentinel.\n\nThis solution is dependent on the Custom logs via AMA connector to collect the logs. The Custom logs solution will be installed as part of this solution installation. \n\n **NOTE**: Microsoft recommends installation of Custom logs via AMA Connector. Legacy connector uses the Log Analytics agent which were deprecated on **Aug 31, 2024.** Using MMA and AMA on same machine can cause log duplication and extra ingestion cost [more details](https://learn.microsoft.com/azure/sentinel/ama-migrate?WT.mc_id=Portal-fx).", "Workbooks": [ "Workbooks/SecurityBridgeThreatDetectionforSAP.json" ], @@ -12,14 +12,11 @@ "Parsers": [ "Parsers/SecurityBridgeLogs.yaml" ], - "Data Connectors": [ - "Data Connectors/Connector_SecurityBridge.json" - ], "dependentDomainSolutionIds": [ "azuresentinel.azure-sentinel-solution-customlogsviaama" ], "BasePath": "https://raw.githubusercontent.com/frozenstrawberries/Azure-Sentinel/master/Solutions/SecurityBridge/", - "Version": "3.0.0", + "Version": "3.0.1", "Metadata": "SolutionMetadata.json", "TemplateSpec": true } \ No newline at end of file diff --git a/Solutions/SecurityBridge App/Package/3.0.1.zip b/Solutions/SecurityBridge App/Package/3.0.1.zip new file mode 100644 index 00000000000..fd341bb3f9f Binary files /dev/null and b/Solutions/SecurityBridge App/Package/3.0.1.zip differ diff --git a/Solutions/SecurityBridge App/Package/createUiDefinition.json b/Solutions/SecurityBridge App/Package/createUiDefinition.json index 077529849b8..ab9c9a25105 100644 --- a/Solutions/SecurityBridge App/Package/createUiDefinition.json +++ b/Solutions/SecurityBridge App/Package/createUiDefinition.json @@ -6,7 +6,7 @@ "config": { "isWizard": false, "basics": { - "description": "\n\n**Note:** Please refer to the following before installing the solution: \n\n• Review the solution [Release Notes](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/SecurityBridge%20App/ReleaseNotes.md)\n\n • There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing.\n\nThe [SecurityBridge App](https://securitybridge.com/) solution provides the capability to ingest SecurityBridge Threat Detection events from all on-premise and cloud based SAP instances into Microsoft Sentinel.\n\nThis solution is dependent on the Custom logs via AMA connector to collect the logs. The Custom logs solution will be installed as part of this solution installation. \n\n **NOTE**: Microsoft recommends installation of Custom logs via AMA Connector. Legacy connector uses the Log Analytics agent which is about to be deprecated by **Aug 31, 2024**. Using MMA and AMA on same machine can cause log duplication and extra ingestion cost [more details](https://learn.microsoft.com/azure/sentinel/ama-migrate?WT.mc_id=Portal-fx).\n\n**Data Connectors:** 1, **Parsers:** 1, **Workbooks:** 1, **Analytic Rules:** 1\n\n[Learn more about Microsoft Sentinel](https://aka.ms/azuresentinel) | [Learn more about Solutions](https://aka.ms/azuresentinelsolutionsdoc)", + "description": "\n\n**Note:** Please refer to the following before installing the solution: \n\n• Review the solution [Release Notes](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/SecurityBridge%20App/ReleaseNotes.md)\n\n • There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing.\n\nThe [SecurityBridge App](https://securitybridge.com/) solution provides the capability to ingest SecurityBridge Threat Detection events from all on-premise and cloud based SAP instances into Microsoft Sentinel.\n\nThis solution is dependent on the Custom logs via AMA connector to collect the logs. The Custom logs solution will be installed as part of this solution installation. \n\n **NOTE**: Microsoft recommends installation of Custom logs via AMA Connector. Legacy connector uses the Log Analytics agent which were deprecated on **Aug 31, 2024.** Using MMA and AMA on same machine can cause log duplication and extra ingestion cost [more details](https://learn.microsoft.com/azure/sentinel/ama-migrate?WT.mc_id=Portal-fx).\n\n**Parsers:** 1, **Workbooks:** 1, **Analytic Rules:** 1\n\n[Learn more about Microsoft Sentinel](https://aka.ms/azuresentinel) | [Learn more about Solutions](https://aka.ms/azuresentinelsolutionsdoc)", "subscription": { "resourceProviders": [ "Microsoft.OperationsManagement/solutions", @@ -51,37 +51,6 @@ } ], "steps": [ - { - "name": "dataconnectors", - "label": "Data Connectors", - "bladeTitle": "Data Connectors", - "elements": [ - { - "name": "dataconnectors1-text", - "type": "Microsoft.Common.TextBlock", - "options": { - "text": "The SecurityBridge App data connector allows you to easily connect your SecurityBridge App logs with Microsoft Sentinel. After installing the solution, configure and enable this data connector by following guidance in Manage solution view." - } - }, - { - "name": "dataconnectors-parser-text", - "type": "Microsoft.Common.TextBlock", - "options": { - "text": "The solution installs a parser that transforms ingested data. The transformed logs can be accessed using the SecurityBridgeLogs Kusto Function alias." - } - }, - { - "name": "dataconnectors-link2", - "type": "Microsoft.Common.TextBlock", - "options": { - "link": { - "label": "Learn more about connecting data sources", - "uri": "https://docs.microsoft.com/azure/sentinel/connect-data-sources" - } - } - } - ] - }, { "name": "workbooks", "label": "Workbooks", diff --git a/Solutions/SecurityBridge App/Package/mainTemplate.json b/Solutions/SecurityBridge App/Package/mainTemplate.json index 35830beabec..97477f24849 100644 --- a/Solutions/SecurityBridge App/Package/mainTemplate.json +++ b/Solutions/SecurityBridge App/Package/mainTemplate.json @@ -41,7 +41,7 @@ "email": "christoph.nagy@securitybridge.com", "_email": "[variables('email')]", "_solutionName": "SecurityBridge App", - "_solutionVersion": "3.0.0", + "_solutionVersion": "3.0.1", "solutionId": "securitybridge1647511278080.securitybridge-sentinel-app-1", "_solutionId": "[variables('solutionId')]", "workbookVersion1": "1.0.0", @@ -52,28 +52,19 @@ "workspaceResourceId": "[resourceId('microsoft.OperationalInsights/Workspaces', parameters('workspace'))]", "_workbookcontentProductId1": "[concat(take(variables('_solutionId'),50),'-','wb','-', uniqueString(concat(variables('_solutionId'),'-','Workbook','-',variables('_workbookContentId1'),'-', variables('workbookVersion1'))))]", "analyticRuleObject1": { - "analyticRuleVersion1": "1.0.3", + "analyticRuleVersion1": "1.0.4", "_analyticRulecontentId1": "8c5c766a-ce9b-4112-b6ed-1b8fe33733b7", "analyticRuleId1": "[resourceId('Microsoft.SecurityInsights/AlertRuleTemplates', '8c5c766a-ce9b-4112-b6ed-1b8fe33733b7')]", "analyticRuleTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-ar-',uniquestring('8c5c766a-ce9b-4112-b6ed-1b8fe33733b7')))]", - "_analyticRulecontentProductId1": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','8c5c766a-ce9b-4112-b6ed-1b8fe33733b7','-', '1.0.3')))]" + "_analyticRulecontentProductId1": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','8c5c766a-ce9b-4112-b6ed-1b8fe33733b7','-', '1.0.4')))]" }, "parserObject1": { - "_parserName1": "[concat(parameters('workspace'),'/','SecurityBridge Threat Detection for SAP Data Parser')]", - "_parserId1": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'SecurityBridge Threat Detection for SAP Data Parser')]", + "_parserName1": "[concat(parameters('workspace'),'/','SecurityBridgeLogs')]", + "_parserId1": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'SecurityBridgeLogs')]", "parserTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pr-',uniquestring('SecurityBridgeLogs-Parser')))]", "parserVersion1": "1.0.0", "parserContentId1": "SecurityBridgeLogs-Parser" }, - "uiConfigId1": "SecurityBridgeSAP", - "_uiConfigId1": "[variables('uiConfigId1')]", - "dataConnectorContentId1": "SecurityBridgeSAP", - "_dataConnectorContentId1": "[variables('dataConnectorContentId1')]", - "dataConnectorId1": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", - "_dataConnectorId1": "[variables('dataConnectorId1')]", - "dataConnectorTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentId1'))))]", - "dataConnectorVersion1": "1.0.0", - "_dataConnectorcontentProductId1": "[concat(take(variables('_solutionId'),50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentId1'),'-', variables('dataConnectorVersion1'))))]", "_solutioncontentProductId": "[concat(take(variables('_solutionId'),50),'-','sl','-', uniqueString(concat(variables('_solutionId'),'-','Solution','-',variables('_solutionId'),'-', variables('_solutionVersion'))))]" }, "resources": [ @@ -86,7 +77,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "SecurityBridgeThreatDetectionforSAP Workbook with template version 3.0.0", + "description": "SecurityBridgeThreatDetectionforSAP Workbook with template version 3.0.1", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('workbookVersion1')]", @@ -174,7 +165,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "CriticalEventTriggered_AnalyticalRules Analytics Rule with template version 3.0.0", + "description": "CriticalEventTriggered_AnalyticalRules Analytics Rule with template version 3.0.1", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('analyticRuleObject1').analyticRuleVersion1]", @@ -201,12 +192,6 @@ "triggerThreshold": 0, "status": "Available", "requiredDataConnectors": [ - { - "dataTypes": [ - "SecurityBridgeLogs_CL" - ], - "connectorId": "SecurityBridgeSAP" - }, { "datatypes": [ "SecurityBridgeLogs_CL" @@ -302,7 +287,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "SecurityBridgeLogs Data Parser with template version 3.0.0", + "description": "SecurityBridgeLogs Data Parser with template version 3.0.1", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('parserObject1').parserVersion1]", @@ -338,7 +323,7 @@ "[variables('parserObject1')._parserId1]" ], "properties": { - "parentId": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'SecurityBridge Threat Detection for SAP Data Parser')]", + "parentId": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'SecurityBridgeLogs')]", "contentId": "[variables('parserObject1').parserContentId1]", "kind": "Parser", "version": "[variables('parserObject1').parserVersion1]", @@ -404,7 +389,7 @@ "[variables('parserObject1')._parserId1]" ], "properties": { - "parentId": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'SecurityBridge Threat Detection for SAP Data Parser')]", + "parentId": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'SecurityBridgeLogs')]", "contentId": "[variables('parserObject1').parserContentId1]", "kind": "Parser", "version": "[variables('parserObject1').parserVersion1]", @@ -425,448 +410,17 @@ } } }, - { - "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", - "apiVersion": "2023-04-01-preview", - "name": "[variables('dataConnectorTemplateSpecName1')]", - "location": "[parameters('workspace-location')]", - "dependsOn": [ - "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" - ], - "properties": { - "description": "SecurityBridge App data connector with template version 3.0.0", - "mainTemplate": { - "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", - "contentVersion": "[variables('dataConnectorVersion1')]", - "parameters": {}, - "variables": {}, - "resources": [ - { - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentId1'))]", - "apiVersion": "2021-03-01-preview", - "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", - "location": "[parameters('workspace-location')]", - "kind": "GenericUI", - "properties": { - "connectorUiConfig": { - "id": "[variables('_uiConfigId1')]", - "title": "[Deprecated] SecurityBridge Threat Detection for SAP", - "publisher": "SecurityBridge", - "descriptionMarkdown": "SecurityBridge is the first and only holistic, natively integrated security platform, addressing all aspects needed to protect organizations running SAP from internal and external threats against their core business applications. The SecurityBridge platform is an SAP-certified add-on, used by organizations around the globe, and addresses the clients’ need for advanced cybersecurity, real-time monitoring, compliance, code security, and patching to protect against internal and external threats.This Microsoft Sentinel Solution allows you to integrate SecurityBridge Threat Detection events from all your on-premise and cloud based SAP instances into your security monitoring.Use this Microsoft Sentinel Solution to receive normalized and speaking security events, pre-built dashboards and out-of-the-box templates for your SAP security monitoring.", - "additionalRequirementBanner": "These queries are dependent on a parser based on a Kusto Function deployed as part of the solution.", - "graphQueries": [ - { - "metricName": "Total data received", - "legend": "SecurityBridgeLogs", - "baseQuery": "SecurityBridgeLogs_CL" - } - ], - "sampleQueries": [ - { - "description": "Top 10 Event Names", - "query": "SecurityBridgeLogs_CL \n| extend Name = tostring(split(RawData, '|')[5]) \n| summarize count() by Name | top 10 by count_" - } - ], - "dataTypes": [ - { - "name": "SecurityBridgeLogs_CL", - "lastDataReceivedQuery": "SecurityBridgeLogs_CL\n| summarize Time = max(TimeGenerated)\n| where isnotempty(Time)" - } - ], - "connectivityCriterias": [ - { - "type": "IsConnectedQuery", - "value": [ - "SecurityBridgeLogs_CL\n| summarize LastLogReceived = max(TimeGenerated)\n| project IsConnected = LastLogReceived > ago(2d)" - ] - } - ], - "availability": { - "status": 1, - "isPreview": false - }, - "permissions": { - "resourceProvider": [ - { - "provider": "Microsoft.OperationalInsights/workspaces", - "permissionsDisplayText": "read and write permissions are required.", - "providerDisplayName": "Workspace", - "scope": "Workspace", - "requiredPermissions": { - "read": true, - "write": true, - "delete": true - } - }, - { - "provider": "Microsoft.OperationalInsights/workspaces/sharedKeys", - "permissionsDisplayText": "read permissions to shared keys for the workspace are required. [See the documentation to learn more about workspace keys](https://docs.microsoft.com/azure/azure-monitor/platform/agent-windows#obtain-workspace-id-and-key).", - "providerDisplayName": "Keys", - "scope": "Workspace", - "requiredPermissions": { - "action": true - } - } - ] - }, - "instructionSteps": [ - { - "description": "*NOTE:** This data connector depends on a parser based on a Kusto Function to work as expected which is deployed as part of the solution. To view the function code in Log Analytics, open Log Analytics/Microsoft Sentinel Logs blade, click Functions and search for the alias SecurityBridgeLogs and load the function code or click [here](https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/SecurityBridge%20App/Parsers/SecurityBridgeLogs.txt).The function usually takes 10-15 minutes to activate after solution installation/update." - }, - { - "description": ">**NOTE:** This data connector has been developed using SecurityBridge Application Platform 7.4.0." - }, - { - "description": "This solution requires logs collection via an Microsoft Sentinel agent installation\n\n> The Microsoft Sentinel agent is supported on the following Operating Systems: \n1. Windows Servers \n2. SUSE Linux Enterprise Server\n3. Redhat Linux Enterprise Server\n4. Oracle Linux Enterprise Server\n5. If you have the SAP solution installed on HPUX / AIX then you will need to deploy a log collector on one of the Linux options listed above and forward your logs to that collector\n\n", - "instructions": [ - { - "parameters": { - "title": "Choose where to install the Linux agent:", - "instructionSteps": [ - { - "title": "Install agent on Azure Linux Virtual Machine", - "description": "Select the machine to install the agent on and then click **Connect**.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnLinuxVirtualMachine" - }, - "type": "InstallAgent" - } - ] - }, - { - "title": "Install agent on a non-Azure Linux Machine", - "description": "Download the agent on the relevant machine and follow the instructions.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnLinuxNonAzure" - }, - "type": "InstallAgent" - } - ] - } - ] - }, - "type": "InstructionStepsGroup" - } - ], - "title": "1. Install and onboard the agent for Linux or Windows" - }, - { - "instructions": [ - { - "parameters": { - "title": "Choose where to install the Windows agent:", - "instructionSteps": [ - { - "title": "Install agent on Azure Windows Virtual Machine", - "description": "Select the machine to install the agent on and then click **Connect**.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnVirtualMachine" - }, - "type": "InstallAgent" - } - ] - }, - { - "title": "Install agent on a non-Azure Windows Machine", - "description": "Download the agent on the relevant machine and follow the instructions.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnNonAzure" - }, - "type": "InstallAgent" - } - ] - } - ] - }, - "type": "InstructionStepsGroup" - } - ] - }, - { - "description": "Configure the custom log directory to be collected", - "instructions": [ - { - "parameters": { - "linkType": "OpenCustomLogsSettings" - }, - "type": "InstallAgent" - } - ], - "title": "2. Configure the logs to be collected" - }, - { - "description": "1. Select the link above to open your workspace advanced settings \n2. Click **+Add custom**\n3. Click **Browse** to upload a sample of a SecurityBridge SAP log file (e.g. AED_20211129164544.cef). Then, click **Next >**\n4. Select **New Line** as the record delimiter then click **Next >**\n5. Select **Windows** or **Linux** and enter the path to SecurityBridge logs based on your configuration. Example:\n - '/usr/sap/tmp/sb_events/*.cef' \n\n>**NOTE:** You can add as many paths as you want in the configuration.\n\n6. After entering the path, click the '+' symbol to apply, then click **Next >** \n7. Add **SecurityBridgeLogs** as the custom log Name and click **Done**" - }, - { - "description": "Open Log Analytics to check if the logs are received using the SecurityBridgeLogs_CL Custom log table.\n\n>**NOTE:** It may take up to 30 minutes before new logs will appear in SecurityBridgeLogs_CL table.", - "title": "3. Check logs in Microsoft Sentinel" - } - ] - } - } - }, - { - "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2023-04-01-preview", - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", - "properties": { - "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", - "contentId": "[variables('_dataConnectorContentId1')]", - "kind": "DataConnector", - "version": "[variables('dataConnectorVersion1')]", - "source": { - "kind": "Solution", - "name": "SecurityBridge App", - "sourceId": "[variables('_solutionId')]" - }, - "author": { - "name": "Christoph Nagy", - "email": "[variables('_email')]" - }, - "support": { - "name": "Christoph Nagy", - "email": "christoph.nagy@securitybridge.com", - "tier": "Partner", - "link": "https://securitybridge.com/contact/" - } - } - } - ] - }, - "packageKind": "Solution", - "packageVersion": "[variables('_solutionVersion')]", - "packageName": "[variables('_solutionName')]", - "packageId": "[variables('_solutionId')]", - "contentSchemaVersion": "3.0.0", - "contentId": "[variables('_dataConnectorContentId1')]", - "contentKind": "DataConnector", - "displayName": "[Deprecated] SecurityBridge Threat Detection for SAP", - "contentProductId": "[variables('_dataConnectorcontentProductId1')]", - "id": "[variables('_dataConnectorcontentProductId1')]", - "version": "[variables('dataConnectorVersion1')]" - } - }, - { - "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2023-04-01-preview", - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", - "dependsOn": [ - "[variables('_dataConnectorId1')]" - ], - "location": "[parameters('workspace-location')]", - "properties": { - "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", - "contentId": "[variables('_dataConnectorContentId1')]", - "kind": "DataConnector", - "version": "[variables('dataConnectorVersion1')]", - "source": { - "kind": "Solution", - "name": "SecurityBridge App", - "sourceId": "[variables('_solutionId')]" - }, - "author": { - "name": "Christoph Nagy", - "email": "[variables('_email')]" - }, - "support": { - "name": "Christoph Nagy", - "email": "christoph.nagy@securitybridge.com", - "tier": "Partner", - "link": "https://securitybridge.com/contact/" - } - } - }, - { - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentId1'))]", - "apiVersion": "2021-03-01-preview", - "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", - "location": "[parameters('workspace-location')]", - "kind": "GenericUI", - "properties": { - "connectorUiConfig": { - "title": "[Deprecated] SecurityBridge Threat Detection for SAP", - "publisher": "SecurityBridge", - "descriptionMarkdown": "SecurityBridge is the first and only holistic, natively integrated security platform, addressing all aspects needed to protect organizations running SAP from internal and external threats against their core business applications. The SecurityBridge platform is an SAP-certified add-on, used by organizations around the globe, and addresses the clients’ need for advanced cybersecurity, real-time monitoring, compliance, code security, and patching to protect against internal and external threats.This Microsoft Sentinel Solution allows you to integrate SecurityBridge Threat Detection events from all your on-premise and cloud based SAP instances into your security monitoring.Use this Microsoft Sentinel Solution to receive normalized and speaking security events, pre-built dashboards and out-of-the-box templates for your SAP security monitoring.", - "graphQueries": [ - { - "metricName": "Total data received", - "legend": "SecurityBridgeLogs", - "baseQuery": "SecurityBridgeLogs_CL" - } - ], - "dataTypes": [ - { - "name": "SecurityBridgeLogs_CL", - "lastDataReceivedQuery": "SecurityBridgeLogs_CL\n| summarize Time = max(TimeGenerated)\n| where isnotempty(Time)" - } - ], - "connectivityCriterias": [ - { - "type": "IsConnectedQuery", - "value": [ - "SecurityBridgeLogs_CL\n| summarize LastLogReceived = max(TimeGenerated)\n| project IsConnected = LastLogReceived > ago(2d)" - ] - } - ], - "sampleQueries": [ - { - "description": "Top 10 Event Names", - "query": "SecurityBridgeLogs_CL \n| extend Name = tostring(split(RawData, '|')[5]) \n| summarize count() by Name | top 10 by count_" - } - ], - "availability": { - "status": 1, - "isPreview": false - }, - "permissions": { - "resourceProvider": [ - { - "provider": "Microsoft.OperationalInsights/workspaces", - "permissionsDisplayText": "read and write permissions are required.", - "providerDisplayName": "Workspace", - "scope": "Workspace", - "requiredPermissions": { - "read": true, - "write": true, - "delete": true - } - }, - { - "provider": "Microsoft.OperationalInsights/workspaces/sharedKeys", - "permissionsDisplayText": "read permissions to shared keys for the workspace are required. [See the documentation to learn more about workspace keys](https://docs.microsoft.com/azure/azure-monitor/platform/agent-windows#obtain-workspace-id-and-key).", - "providerDisplayName": "Keys", - "scope": "Workspace", - "requiredPermissions": { - "action": true - } - } - ] - }, - "instructionSteps": [ - { - "description": "*NOTE:** This data connector depends on a parser based on a Kusto Function to work as expected which is deployed as part of the solution. To view the function code in Log Analytics, open Log Analytics/Microsoft Sentinel Logs blade, click Functions and search for the alias SecurityBridgeLogs and load the function code or click [here](https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/SecurityBridge%20App/Parsers/SecurityBridgeLogs.txt).The function usually takes 10-15 minutes to activate after solution installation/update." - }, - { - "description": ">**NOTE:** This data connector has been developed using SecurityBridge Application Platform 7.4.0." - }, - { - "description": "This solution requires logs collection via an Microsoft Sentinel agent installation\n\n> The Microsoft Sentinel agent is supported on the following Operating Systems: \n1. Windows Servers \n2. SUSE Linux Enterprise Server\n3. Redhat Linux Enterprise Server\n4. Oracle Linux Enterprise Server\n5. If you have the SAP solution installed on HPUX / AIX then you will need to deploy a log collector on one of the Linux options listed above and forward your logs to that collector\n\n", - "instructions": [ - { - "parameters": { - "title": "Choose where to install the Linux agent:", - "instructionSteps": [ - { - "title": "Install agent on Azure Linux Virtual Machine", - "description": "Select the machine to install the agent on and then click **Connect**.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnLinuxVirtualMachine" - }, - "type": "InstallAgent" - } - ] - }, - { - "title": "Install agent on a non-Azure Linux Machine", - "description": "Download the agent on the relevant machine and follow the instructions.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnLinuxNonAzure" - }, - "type": "InstallAgent" - } - ] - } - ] - }, - "type": "InstructionStepsGroup" - } - ], - "title": "1. Install and onboard the agent for Linux or Windows" - }, - { - "instructions": [ - { - "parameters": { - "title": "Choose where to install the Windows agent:", - "instructionSteps": [ - { - "title": "Install agent on Azure Windows Virtual Machine", - "description": "Select the machine to install the agent on and then click **Connect**.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnVirtualMachine" - }, - "type": "InstallAgent" - } - ] - }, - { - "title": "Install agent on a non-Azure Windows Machine", - "description": "Download the agent on the relevant machine and follow the instructions.", - "instructions": [ - { - "parameters": { - "linkType": "InstallAgentOnNonAzure" - }, - "type": "InstallAgent" - } - ] - } - ] - }, - "type": "InstructionStepsGroup" - } - ] - }, - { - "description": "Configure the custom log directory to be collected", - "instructions": [ - { - "parameters": { - "linkType": "OpenCustomLogsSettings" - }, - "type": "InstallAgent" - } - ], - "title": "2. Configure the logs to be collected" - }, - { - "description": "1. Select the link above to open your workspace advanced settings \n2. Click **+Add custom**\n3. Click **Browse** to upload a sample of a SecurityBridge SAP log file (e.g. AED_20211129164544.cef). Then, click **Next >**\n4. Select **New Line** as the record delimiter then click **Next >**\n5. Select **Windows** or **Linux** and enter the path to SecurityBridge logs based on your configuration. Example:\n - '/usr/sap/tmp/sb_events/*.cef' \n\n>**NOTE:** You can add as many paths as you want in the configuration.\n\n6. After entering the path, click the '+' symbol to apply, then click **Next >** \n7. Add **SecurityBridgeLogs** as the custom log Name and click **Done**" - }, - { - "description": "Open Log Analytics to check if the logs are received using the SecurityBridgeLogs_CL Custom log table.\n\n>**NOTE:** It may take up to 30 minutes before new logs will appear in SecurityBridgeLogs_CL table.", - "title": "3. Check logs in Microsoft Sentinel" - } - ], - "id": "[variables('_uiConfigId1')]", - "additionalRequirementBanner": "These queries are dependent on a parser based on a Kusto Function deployed as part of the solution." - } - } - }, { "type": "Microsoft.OperationalInsights/workspaces/providers/contentPackages", "apiVersion": "2023-04-01-preview", "location": "[parameters('workspace-location')]", "properties": { - "version": "3.0.0", + "version": "3.0.1", "kind": "Solution", "contentSchemaVersion": "3.0.0", "displayName": "SecurityBridge App", "publisherDisplayName": "Christoph Nagy", - "descriptionHtml": "

Note: Please refer to the following before installing the solution:

\n

• Review the solution Release Notes

\n

• There may be known issues pertaining to this Solution, please refer to them before installing.

\n

The SecurityBridge App solution provides the capability to ingest SecurityBridge Threat Detection events from all on-premise and cloud based SAP instances into Microsoft Sentinel.

\n

This solution is dependent on the Custom logs via AMA connector to collect the logs. The Custom logs solution will be installed as part of this solution installation.

\n

NOTE: Microsoft recommends installation of Custom logs via AMA Connector. Legacy connector uses the Log Analytics agent which is about to be deprecated by Aug 31, 2024. Using MMA and AMA on same machine can cause log duplication and extra ingestion cost more details.

\n

Data Connectors: 1, Parsers: 1, Workbooks: 1, Analytic Rules: 1

\n

Learn more about Microsoft Sentinel | Learn more about Solutions

\n", + "descriptionHtml": "

Note: Please refer to the following before installing the solution:

\n

• Review the solution Release Notes

\n

• There may be known issues pertaining to this Solution, please refer to them before installing.

\n

The SecurityBridge App solution provides the capability to ingest SecurityBridge Threat Detection events from all on-premise and cloud based SAP instances into Microsoft Sentinel.

\n

This solution is dependent on the Custom logs via AMA connector to collect the logs. The Custom logs solution will be installed as part of this solution installation.

\n

NOTE: Microsoft recommends installation of Custom logs via AMA Connector. Legacy connector uses the Log Analytics agent which were deprecated on Aug 31, 2024. Using MMA and AMA on same machine can cause log duplication and extra ingestion cost more details.

\n

Parsers: 1, Workbooks: 1, Analytic Rules: 1

\n

Learn more about Microsoft Sentinel | Learn more about Solutions

\n", "contentKind": "Solution", "contentProductId": "[variables('_solutioncontentProductId')]", "id": "[variables('_solutioncontentProductId')]", @@ -905,11 +459,6 @@ "contentId": "[variables('parserObject1').parserContentId1]", "version": "[variables('parserObject1').parserVersion1]" }, - { - "kind": "DataConnector", - "contentId": "[variables('_dataConnectorContentId1')]", - "version": "[variables('dataConnectorVersion1')]" - }, { "kind": "Solution", "contentId": "azuresentinel.azure-sentinel-solution-customlogsviaama" diff --git a/Solutions/SecurityBridge App/ReleaseNotes.md b/Solutions/SecurityBridge App/ReleaseNotes.md index 9565a491746..1c8f09758e7 100644 --- a/Solutions/SecurityBridge App/ReleaseNotes.md +++ b/Solutions/SecurityBridge App/ReleaseNotes.md @@ -1,3 +1,4 @@ -| **Version** | **Date Modified (DD-MM-YYYY)** | **Change History** | -|-------------|--------------------------------|--------------------------------| -| 3.0.0 | 08-08-2024 | Deprecating data connectors | \ No newline at end of file +| **Version** | **Date Modified (DD-MM-YYYY)** | **Change History** | +|-------------|--------------------------------|-----------------------------------------| +| 3.0.1 | 07-01-2025 | Removed Deprecated **Data connector** | +| 3.0.0 | 08-08-2024 | Deprecating data connectors | \ No newline at end of file diff --git a/Solutions/ZeroFox/Data Connectors/Alerts/alerts_connector.json b/Solutions/ZeroFox/Data Connectors/Alerts/alerts_connector.json index 1d38f557d8e..65ea052bff4 100644 --- a/Solutions/ZeroFox/Data Connectors/Alerts/alerts_connector.json +++ b/Solutions/ZeroFox/Data Connectors/Alerts/alerts_connector.json @@ -1,6 +1,6 @@ { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", - "contentVersion": "1.0.0.0", + "contentVersion": "1.0.1.0", "parameters": { "workspace": { "type": "string", diff --git a/Solutions/ZeroFox/Data Connectors/CTI/AzureFunctionZeroFoxCTI.zip b/Solutions/ZeroFox/Data Connectors/CTI/AzureFunctionZeroFoxCTI.zip index f4e3409c0e9..b6d3e99d490 100644 Binary files a/Solutions/ZeroFox/Data Connectors/CTI/AzureFunctionZeroFoxCTI.zip and b/Solutions/ZeroFox/Data Connectors/CTI/AzureFunctionZeroFoxCTI.zip differ diff --git a/Solutions/ZeroFox/Data/Solution_ZeroFox.json b/Solutions/ZeroFox/Data/Solution_ZeroFox.json index 0d061f1a7f8..705df357000 100644 --- a/Solutions/ZeroFox/Data/Solution_ZeroFox.json +++ b/Solutions/ZeroFox/Data/Solution_ZeroFox.json @@ -1,22 +1,21 @@ { - "Name": "ZeroFox", - "Author": "ZeroFox - integration-support@zerofox.com", - "Logo": "", - "Description": "The [ZeroFox](https://www.zerofox.com/) solution for Microsoft Sentinel enables you to ingest [ZeroFox Alerts](https://www.zerofox.com/platform/) and [ZeroFox CTI events](https://www.zerofox.com/threat-intelligence/) into Microsoft Sentinel using the ZeroFox API. \n\n**Underlying Microsoft Technologies used:**\n\nThis solution takes a dependency on the following technologies, and some of these dependencies either may be in [Preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) state or might result in additional ingestion or operational costs:\n\na. [Azure Monitor HTTP Data Collector API](https://docs.microsoft.com/azure/azure-monitor/logs/data-collector-api)\n\nb. [Azure Functions](https://azure.microsoft.com/services/functions/#overview)", - "Data Connectors": [ - "Data Connectors/CTI/ZeroFoxCTI.json", - "Data Connectors/Alerts/alerts_connector.json" - ], - "Analytic Rules": [ - "Analytic Rules/ZF_Alerts_HighSeverityRule.yaml", - "Analytic Rules/ZF_Alerts_InformationalSeverityRule.yaml", - "Analytic Rules/ZF_Alerts_LowSeverityRule.yaml", - "Analytic Rules/ZF_Alerts_MediumSeverityRule.yaml" - ], - "BasePath": "C:\\GitHub\\Azure-Sentinel\\Solutions\\ZeroFox", - "Version": "3.2.0", - "Metadata": "SolutionMetadata.json", - "TemplateSpec": true, - "Is1Pconnector": false - } - \ No newline at end of file + "Name": "ZeroFox", + "Author": "ZeroFox - integration-support@zerofox.com", + "Logo": "", + "Description": "The [ZeroFox](https://www.zerofox.com/) solution for Microsoft Sentinel enables you to ingest [ZeroFox Alerts](https://www.zerofox.com/platform/) and [ZeroFox CTI events](https://www.zerofox.com/threat-intelligence/) into Microsoft Sentinel using the ZeroFox API. \n\n**Underlying Microsoft Technologies used:**\n\nThis solution takes a dependency on the following technologies, and some of these dependencies either may be in [Preview](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) state or might result in additional ingestion or operational costs:\n\na. [Azure Monitor HTTP Data Collector API](https://docs.microsoft.com/azure/azure-monitor/logs/data-collector-api)\n\nb. [Azure Functions](https://azure.microsoft.com/services/functions/#overview)", + "Data Connectors": [ + "Data Connectors/CTI/ZeroFoxCTI.json", + "Data Connectors/Alerts/alerts_connector.json" + ], + "Analytic Rules": [ + "Analytic Rules/ZF_Alerts_HighSeverityRule.yaml", + "Analytic Rules/ZF_Alerts_InformationalSeverityRule.yaml", + "Analytic Rules/ZF_Alerts_LowSeverityRule.yaml", + "Analytic Rules/ZF_Alerts_MediumSeverityRule.yaml" + ], + "BasePath": "C:\\GitHub\\Azure-Sentinel\\Solutions\\ZeroFox", + "Version": "3.2.1", + "Metadata": "SolutionMetadata.json", + "TemplateSpec": true, + "Is1Pconnector": false +} \ No newline at end of file diff --git a/Solutions/ZeroFox/Package/3.2.1.zip b/Solutions/ZeroFox/Package/3.2.1.zip new file mode 100644 index 00000000000..0fc2b86f198 Binary files /dev/null and b/Solutions/ZeroFox/Package/3.2.1.zip differ diff --git a/Solutions/ZeroFox/Package/mainTemplate.json b/Solutions/ZeroFox/Package/mainTemplate.json index 36fd832d2ad..6d3bfaa31cb 100644 --- a/Solutions/ZeroFox/Package/mainTemplate.json +++ b/Solutions/ZeroFox/Package/mainTemplate.json @@ -33,7 +33,7 @@ "email": "integration-support@zerofox.com", "_email": "[variables('email')]", "_solutionName": "ZeroFox", - "_solutionVersion": "3.2.0", + "_solutionVersion": "3.2.1", "solutionId": "zerofoxinc1695922129370.zerofox-sentinel-connector", "_solutionId": "[variables('solutionId')]", "uiConfigId1": "ZeroFoxCTIDataConnector", @@ -52,35 +52,35 @@ "dataConnectorId2": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId2'))]", "_dataConnectorId2": "[variables('dataConnectorId2')]", "dataConnectorTemplateSpecName2": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentId2'))))]", - "dataConnectorVersion2": "1.0.0", + "dataConnectorVersion2": "1.0.1", "_dataConnectorcontentProductId2": "[concat(take(variables('_solutionId'),50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentId2'),'-', variables('dataConnectorVersion2'))))]", "analyticRuleObject1": { - "analyticRuleVersion1": "1.0.0", + "analyticRuleVersion1": "1.0.1", "_analyticRulecontentId1": "deb45e6d-892f-40bf-9118-e2a6f26b788d", "analyticRuleId1": "[resourceId('Microsoft.SecurityInsights/AlertRuleTemplates', 'deb45e6d-892f-40bf-9118-e2a6f26b788d')]", "analyticRuleTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-ar-',uniquestring('deb45e6d-892f-40bf-9118-e2a6f26b788d')))]", - "_analyticRulecontentProductId1": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','deb45e6d-892f-40bf-9118-e2a6f26b788d','-', '1.0.0')))]" + "_analyticRulecontentProductId1": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','deb45e6d-892f-40bf-9118-e2a6f26b788d','-', '1.0.1')))]" }, "analyticRuleObject2": { - "analyticRuleVersion2": "1.0.0", + "analyticRuleVersion2": "1.0.1", "_analyticRulecontentId2": "6f7a7413-b72f-4361-84ee-897baeb9c6d4", "analyticRuleId2": "[resourceId('Microsoft.SecurityInsights/AlertRuleTemplates', '6f7a7413-b72f-4361-84ee-897baeb9c6d4')]", "analyticRuleTemplateSpecName2": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-ar-',uniquestring('6f7a7413-b72f-4361-84ee-897baeb9c6d4')))]", - "_analyticRulecontentProductId2": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','6f7a7413-b72f-4361-84ee-897baeb9c6d4','-', '1.0.0')))]" + "_analyticRulecontentProductId2": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','6f7a7413-b72f-4361-84ee-897baeb9c6d4','-', '1.0.1')))]" }, "analyticRuleObject3": { - "analyticRuleVersion3": "1.0.0", + "analyticRuleVersion3": "1.0.1", "_analyticRulecontentId3": "e0c7a91a-7aa1-498a-9c20-cd6c721f9345", "analyticRuleId3": "[resourceId('Microsoft.SecurityInsights/AlertRuleTemplates', 'e0c7a91a-7aa1-498a-9c20-cd6c721f9345')]", "analyticRuleTemplateSpecName3": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-ar-',uniquestring('e0c7a91a-7aa1-498a-9c20-cd6c721f9345')))]", - "_analyticRulecontentProductId3": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','e0c7a91a-7aa1-498a-9c20-cd6c721f9345','-', '1.0.0')))]" + "_analyticRulecontentProductId3": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','e0c7a91a-7aa1-498a-9c20-cd6c721f9345','-', '1.0.1')))]" }, "analyticRuleObject4": { - "analyticRuleVersion4": "1.0.0", + "analyticRuleVersion4": "1.0.1", "_analyticRulecontentId4": "a6496de5-911b-4199-b7db-d34ac9d70df3", "analyticRuleId4": "[resourceId('Microsoft.SecurityInsights/AlertRuleTemplates', 'a6496de5-911b-4199-b7db-d34ac9d70df3')]", "analyticRuleTemplateSpecName4": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-ar-',uniquestring('a6496de5-911b-4199-b7db-d34ac9d70df3')))]", - "_analyticRulecontentProductId4": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','a6496de5-911b-4199-b7db-d34ac9d70df3','-', '1.0.0')))]" + "_analyticRulecontentProductId4": "[concat(take(variables('_solutionId'),50),'-','ar','-', uniqueString(concat(variables('_solutionId'),'-','AnalyticsRule','-','a6496de5-911b-4199-b7db-d34ac9d70df3','-', '1.0.1')))]" }, "_solutioncontentProductId": "[concat(take(variables('_solutionId'),50),'-','sl','-', uniqueString(concat(variables('_solutionId'),'-','Solution','-',variables('_solutionId'),'-', variables('_solutionVersion'))))]" }, diff --git a/Solutions/ZeroFox/ReleaseNotes.md b/Solutions/ZeroFox/ReleaseNotes.md index 406f8bcce9e..3e1730c80de 100644 --- a/Solutions/ZeroFox/ReleaseNotes.md +++ b/Solutions/ZeroFox/ReleaseNotes.md @@ -1,5 +1,6 @@ | **Version** | **Date Modified (DD-MM-YYYY)** | **Change History** | |---------------|----------------------------------|-----------------------------------------------------------------------------------------------------| +| 3.2.1 | 26-12-2024 | Update alerts data connector version that fix issues in fetching updates | | 3.2.0 | 26-09-2024 | Changed query parameter in alerts connector for fetching updates | | 3.1.0 | 26-07-2024 | Updated ZeroFox connector to generate result batches and implemented async Sentinel connector logic | | 3.0.1 | 30-04-2024 | Fixed Solution Metadata for deployment | diff --git a/Solutions/iboss/Data/Solution_iboss.json b/Solutions/iboss/Data/Solution_iboss.json index 397789ba72e..1fb7b4b2ee5 100644 --- a/Solutions/iboss/Data/Solution_iboss.json +++ b/Solutions/iboss/Data/Solution_iboss.json @@ -2,9 +2,8 @@ "Name": "iboss", "Author": "iboss", "Logo": "", - "Description": "The iboss Solution provides means to connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.\n\n This solution is dependent on the Common Event Format solution containing the CEF via AMA connector to collect the logs. The CEF solution will be installed as part of this solution installation.\n\n**NOTE:** Microsoft recommends installation of CEF via AMA Connector. The existing connectors are about to be deprecated by **Aug 31, 2024.**", + "Description": "The iboss Solution provides means to connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.\n\n This solution is dependent on the Common Event Format solution containing the CEF via AMA connector to collect the logs. The CEF solution will be installed as part of this solution installation.\n\n**NOTE:** Microsoft recommends installation of CEF via AMA Connector. Legacy connector uses the Log Analytics agent which were deprecated on **Aug 31, 2024.**", "Data Connectors": [ - "Data Connectors/iboss_cef.json", "Data Connectors/template_ibossAMA.json" ], "Parsers": [ @@ -18,7 +17,7 @@ "azuresentinel.azure-sentinel-solution-commoneventformat" ], "BasePath": "C:\\GitHub\\Azure-Sentinel\\Solutions\\iboss", - "Version": "3.1.1", + "Version": "3.1.2", "Metadata": "SolutionMetadata.json", "TemplateSpec": true, "Is1Pconnector": false diff --git a/Solutions/iboss/Package/3.1.2.zip b/Solutions/iboss/Package/3.1.2.zip new file mode 100644 index 00000000000..810109c7a1a Binary files /dev/null and b/Solutions/iboss/Package/3.1.2.zip differ diff --git a/Solutions/iboss/Package/createUiDefinition.json b/Solutions/iboss/Package/createUiDefinition.json index 9add50e41a7..a47851e8dde 100644 --- a/Solutions/iboss/Package/createUiDefinition.json +++ b/Solutions/iboss/Package/createUiDefinition.json @@ -6,7 +6,7 @@ "config": { "isWizard": false, "basics": { - "description": "\n\n**Note:** Please refer to the following before installing the solution: \n\n• Review the solution [Release Notes](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/iboss/ReleaseNotes.md)\n\n • There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing.\n\nThe iboss Solution provides means to connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.\n\n This solution is dependent on the Common Event Format solution containing the CEF via AMA connector to collect the logs. The CEF solution will be installed as part of this solution installation.\n\n**NOTE:** Microsoft recommends installation of CEF via AMA Connector. The existing connectors are about to be deprecated by **Aug 31, 2024.**\n\n**Data Connectors:** 2, **Parsers:** 1, **Workbooks:** 2\n\n[Learn more about Microsoft Sentinel](https://aka.ms/azuresentinel) | [Learn more about Solutions](https://aka.ms/azuresentinelsolutionsdoc)", + "description": "\n\n**Note:** Please refer to the following before installing the solution: \n\n• Review the solution [Release Notes](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/iboss/ReleaseNotes.md)\n\n • There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing.\n\nThe iboss Solution provides means to connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.\n\n This solution is dependent on the Common Event Format solution containing the CEF via AMA connector to collect the logs. The CEF solution will be installed as part of this solution installation.\n\n**NOTE:** Microsoft recommends installation of CEF via AMA Connector. Legacy connector uses the Log Analytics agent which were deprecated on **Aug 31, 2024.**\n\n**Data Connectors:** 1, **Parsers:** 1, **Workbooks:** 2\n\n[Learn more about Microsoft Sentinel](https://aka.ms/azuresentinel) | [Learn more about Solutions](https://aka.ms/azuresentinelsolutionsdoc)", "subscription": { "resourceProviders": [ "Microsoft.OperationsManagement/solutions", @@ -63,13 +63,6 @@ "text": "This Solution installs the data connector for iboss. You can get iboss custom log data in your Microsoft Sentinel workspace. After installing the solution, configure and enable this data connector by following guidance in Manage solution view." } }, - { - "name": "dataconnectors2-text", - "type": "Microsoft.Common.TextBlock", - "options": { - "text": "This Solution installs the data connector for iboss. You can get iboss custom log data in your Microsoft Sentinel workspace. After installing the solution, configure and enable this data connector by following guidance in Manage solution view." - } - }, { "name": "dataconnectors-parser-text", "type": "Microsoft.Common.TextBlock", diff --git a/Solutions/iboss/Package/mainTemplate.json b/Solutions/iboss/Package/mainTemplate.json index 119c6aa69f2..e797835208d 100644 --- a/Solutions/iboss/Package/mainTemplate.json +++ b/Solutions/iboss/Package/mainTemplate.json @@ -47,27 +47,18 @@ }, "variables": { "_solutionName": "iboss", - "_solutionVersion": "3.1.1", + "_solutionVersion": "3.1.2", "solutionId": "iboss.iboss-sentinel-connector", "_solutionId": "[variables('solutionId')]", - "uiConfigId1": "iboss", + "uiConfigId1": "ibossAma", "_uiConfigId1": "[variables('uiConfigId1')]", - "dataConnectorContentId1": "iboss", + "dataConnectorContentId1": "ibossAma", "_dataConnectorContentId1": "[variables('dataConnectorContentId1')]", "dataConnectorId1": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", "_dataConnectorId1": "[variables('dataConnectorId1')]", "dataConnectorTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentId1'))))]", - "dataConnectorVersion1": "1.0.1", + "dataConnectorVersion1": "1.0.2", "_dataConnectorcontentProductId1": "[concat(take(variables('_solutionId'),50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentId1'),'-', variables('dataConnectorVersion1'))))]", - "uiConfigId2": "ibossAma", - "_uiConfigId2": "[variables('uiConfigId2')]", - "dataConnectorContentId2": "ibossAma", - "_dataConnectorContentId2": "[variables('dataConnectorContentId2')]", - "dataConnectorId2": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId2'))]", - "_dataConnectorId2": "[variables('dataConnectorId2')]", - "dataConnectorTemplateSpecName2": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentId2'))))]", - "dataConnectorVersion2": "1.0.2", - "_dataConnectorcontentProductId2": "[concat(take(variables('_solutionId'),50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentId2'),'-', variables('dataConnectorVersion2'))))]", "parserObject1": { "_parserName1": "[concat(parameters('workspace'),'/','ibossUrlEvent')]", "_parserId1": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), 'ibossUrlEvent')]", @@ -100,7 +91,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "iboss data connector with template version 3.1.1", + "description": "iboss data connector with template version 3.1.2", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('dataConnectorVersion1')]", @@ -116,334 +107,6 @@ "properties": { "connectorUiConfig": { "id": "[variables('_uiConfigId1')]", - "title": "[Deprecated] iboss via Legacy Agent", - "publisher": "iboss", - "descriptionMarkdown": "The [iboss](https://www.iboss.com) data connector enables you to seamlessly connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.", - "graphQueries": [ - { - "metricName": "Total data received", - "legend": "ibossUrlEvent", - "baseQuery": "CommonSecurityLog | where DeviceVendor =~ 'iboss' and AdditionalExtensions !contains 'amaExternalLogService=true'" - } - ], - "sampleQueries": [ - { - "description": "Logs Received from the past week", - "query": "CommonSecurityLog | where DeviceVendor =~ 'iboss' and TimeGenerated > ago(7d) and AdditionalExtensions !contains 'amaExternalLogService=true'" - } - ], - "dataTypes": [ - { - "name": "ibossUrlEvent", - "lastDataReceivedQuery": "CommonSecurityLog\n| where DeviceVendor =~ 'iboss' and AdditionalExtensions !contains 'amaExternalLogService=true'\n| summarize Time = max(TimeGenerated)\n| where isnotempty(Time)" - } - ], - "connectivityCriterias": [ - { - "type": "IsConnectedQuery", - "value": [ - "CommonSecurityLog\n | where DeviceVendor =~ 'iboss'\n| summarize LastLogReceived = max(TimeGenerated)\n| project IsConnected = LastLogReceived > ago(30d)" - ] - } - ], - "availability": { - "status": 1, - "isPreview": false - }, - "permissions": { - "resourceProvider": [ - { - "provider": "Microsoft.OperationalInsights/workspaces", - "permissionsDisplayText": "read and write permissions are required.", - "providerDisplayName": "Workspace", - "scope": "Workspace", - "requiredPermissions": { - "read": true, - "write": true, - "delete": true - } - }, - { - "provider": "Microsoft.OperationalInsights/workspaces/sharedKeys", - "permissionsDisplayText": "read permissions to shared keys for the workspace are required. [See the documentation to learn more about workspace keys](https://docs.microsoft.com/azure/azure-monitor/platform/agent-windows#obtain-workspace-id-and-key).", - "providerDisplayName": "Keys", - "scope": "Workspace", - "requiredPermissions": { - "action": true - } - } - ] - }, - "instructionSteps": [ - { - "description": "If using the iboss gov environment or there is a preference to forward the logs to a dedicated proxy Linux machine, proceed with this step. In all other cases, please advance to step two.", - "innerSteps": [ - { - "title": "1.1 Linux Syslog agent configuration", - "description": "Install and configure the Linux agent to collect your Common Event Format (CEF) Syslog messages and forward them to Microsoft Sentinel.\n\n> Notice that the data from all regions will be stored in the selected workspace" - }, - { - "title": "1.2 Select or create a Linux machine", - "description": "Select or create a Linux machine that Microsoft Sentinel will use as the dedicated proxy Linux machine between your security solution and Microsoft Sentinel this machine can be on your on-prem environment, Azure or other clouds." - }, - { - "title": "1.3 Install the CEF collector on the Linux machine", - "description": "Install the Microsoft Monitoring Agent on your Linux machine and configure the machine to listen on the necessary port and forward messages to your Microsoft Sentinel workspace. The CEF collector collects CEF messages on port 514 TCP.\n\n> 1. Make sure that you have Python on your machine using the following command: python -version\n\n> 2. You must have elevated permissions (sudo) on your machine", - "instructions": [ - { - "parameters": { - "fillWith": [ - "WorkspaceId", - "PrimaryKey" - ], - "label": "Run the following command to install and apply the CEF collector:", - "value": "sudo wget -O cef_installer.py https://raw.githubusercontent.com/Azure/Azure-Sentinel/master/DataConnectors/CEF/cef_installer.py&&sudo python cef_installer.py {0} {1}" - }, - "type": "CopyableLabel" - } - ] - } - ], - "title": "1. Configure a dedicated proxy Linux machine" - }, - { - "description": "Set your Threat Console to send Syslog messages in CEF format to your Azure workspace. Make note of your Workspace ID and Primary Key within your Log Analytics Workspace (Select the workspace from the Log Analytics workspaces menu in the Azure portal. Then select Agents management in the Settings section). \n\n>1. Navigate to Reporting & Analytics inside your iboss Console\n\n>2. Select Log Forwarding -> Forward From Reporter\n\n>3. Select Actions -> Add Service\n\n>4. Toggle to Microsoft Sentinel as a Service Type and input your Workspace ID/Primary Key along with other criteria. If a dedicated proxy Linux machine has been configured, toggle to Syslog as a Service Type and configure the settings to point to your dedicated proxy Linux machine\n\n>5. Wait one to two minutes for the setup to complete\n\n>6. Select your Microsoft Sentinel Service and verify the Microsoft Sentinel Setup Status is Successful. If a dedicated proxy Linux machine has been configured, you may proceed with validating your connection", - "title": "2. Forward Common Event Format (CEF) logs" - }, - { - "description": "Open Log Analytics to check if the logs are received using the CommonSecurityLog schema.\n\n>It may take about 20 minutes until the connection streams data to your workspace", - "title": "3. Validate connection" - }, - { - "description": "Make sure to configure the machine's security according to your organization's security policy (Only applicable if a dedicated proxy Linux machine has been configured).\n\n\n[Learn more >](https://aka.ms/SecureCEF)", - "title": "4. Secure your machine " - } - ], - "metadata": { - "id": "f8c448b1-3df4-444d-aded-63e4ad2aec08", - "version": "1.0.1", - "kind": "dataConnector", - "author": { - "name": "iboss" - }, - "support": { - "tier": "Type of support for content item: microsoft | developer | community", - "name": "iboss", - "link": "https://www.iboss.com/" - } - } - } - } - }, - { - "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2023-04-01-preview", - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", - "properties": { - "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", - "contentId": "[variables('_dataConnectorContentId1')]", - "kind": "DataConnector", - "version": "[variables('dataConnectorVersion1')]", - "source": { - "kind": "Solution", - "name": "iboss", - "sourceId": "[variables('_solutionId')]" - }, - "author": { - "name": "iboss" - }, - "support": { - "name": "iboss", - "email": "support@iboss.com", - "tier": "Partner", - "link": "https://www.iboss.com/contact-us/" - } - } - } - ] - }, - "packageKind": "Solution", - "packageVersion": "[variables('_solutionVersion')]", - "packageName": "[variables('_solutionName')]", - "packageId": "[variables('_solutionId')]", - "contentSchemaVersion": "3.0.0", - "contentId": "[variables('_dataConnectorContentId1')]", - "contentKind": "DataConnector", - "displayName": "[Deprecated] iboss via Legacy Agent", - "contentProductId": "[variables('_dataConnectorcontentProductId1')]", - "id": "[variables('_dataConnectorcontentProductId1')]", - "version": "[variables('dataConnectorVersion1')]" - } - }, - { - "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2023-04-01-preview", - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", - "dependsOn": [ - "[variables('_dataConnectorId1')]" - ], - "location": "[parameters('workspace-location')]", - "properties": { - "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", - "contentId": "[variables('_dataConnectorContentId1')]", - "kind": "DataConnector", - "version": "[variables('dataConnectorVersion1')]", - "source": { - "kind": "Solution", - "name": "iboss", - "sourceId": "[variables('_solutionId')]" - }, - "author": { - "name": "iboss" - }, - "support": { - "name": "iboss", - "email": "support@iboss.com", - "tier": "Partner", - "link": "https://www.iboss.com/contact-us/" - } - } - }, - { - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentId1'))]", - "apiVersion": "2021-03-01-preview", - "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", - "location": "[parameters('workspace-location')]", - "kind": "GenericUI", - "properties": { - "connectorUiConfig": { - "title": "[Deprecated] iboss via Legacy Agent", - "publisher": "iboss", - "descriptionMarkdown": "The [iboss](https://www.iboss.com) data connector enables you to seamlessly connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.", - "graphQueries": [ - { - "metricName": "Total data received", - "legend": "ibossUrlEvent", - "baseQuery": "CommonSecurityLog | where DeviceVendor =~ 'iboss' and AdditionalExtensions !contains 'amaExternalLogService=true'" - } - ], - "dataTypes": [ - { - "name": "ibossUrlEvent", - "lastDataReceivedQuery": "CommonSecurityLog\n| where DeviceVendor =~ 'iboss' and AdditionalExtensions !contains 'amaExternalLogService=true'\n| summarize Time = max(TimeGenerated)\n| where isnotempty(Time)" - } - ], - "connectivityCriterias": [ - { - "type": "IsConnectedQuery", - "value": [ - "CommonSecurityLog\n | where DeviceVendor =~ 'iboss'\n| summarize LastLogReceived = max(TimeGenerated)\n| project IsConnected = LastLogReceived > ago(30d)" - ] - } - ], - "sampleQueries": [ - { - "description": "Logs Received from the past week", - "query": "CommonSecurityLog | where DeviceVendor =~ 'iboss' and TimeGenerated > ago(7d) and AdditionalExtensions !contains 'amaExternalLogService=true'" - } - ], - "availability": { - "status": 1, - "isPreview": false - }, - "permissions": { - "resourceProvider": [ - { - "provider": "Microsoft.OperationalInsights/workspaces", - "permissionsDisplayText": "read and write permissions are required.", - "providerDisplayName": "Workspace", - "scope": "Workspace", - "requiredPermissions": { - "read": true, - "write": true, - "delete": true - } - }, - { - "provider": "Microsoft.OperationalInsights/workspaces/sharedKeys", - "permissionsDisplayText": "read permissions to shared keys for the workspace are required. [See the documentation to learn more about workspace keys](https://docs.microsoft.com/azure/azure-monitor/platform/agent-windows#obtain-workspace-id-and-key).", - "providerDisplayName": "Keys", - "scope": "Workspace", - "requiredPermissions": { - "action": true - } - } - ] - }, - "instructionSteps": [ - { - "description": "If using the iboss gov environment or there is a preference to forward the logs to a dedicated proxy Linux machine, proceed with this step. In all other cases, please advance to step two.", - "innerSteps": [ - { - "title": "1.1 Linux Syslog agent configuration", - "description": "Install and configure the Linux agent to collect your Common Event Format (CEF) Syslog messages and forward them to Microsoft Sentinel.\n\n> Notice that the data from all regions will be stored in the selected workspace" - }, - { - "title": "1.2 Select or create a Linux machine", - "description": "Select or create a Linux machine that Microsoft Sentinel will use as the dedicated proxy Linux machine between your security solution and Microsoft Sentinel this machine can be on your on-prem environment, Azure or other clouds." - }, - { - "title": "1.3 Install the CEF collector on the Linux machine", - "description": "Install the Microsoft Monitoring Agent on your Linux machine and configure the machine to listen on the necessary port and forward messages to your Microsoft Sentinel workspace. The CEF collector collects CEF messages on port 514 TCP.\n\n> 1. Make sure that you have Python on your machine using the following command: python -version\n\n> 2. You must have elevated permissions (sudo) on your machine", - "instructions": [ - { - "parameters": { - "fillWith": [ - "WorkspaceId", - "PrimaryKey" - ], - "label": "Run the following command to install and apply the CEF collector:", - "value": "sudo wget -O cef_installer.py https://raw.githubusercontent.com/Azure/Azure-Sentinel/master/DataConnectors/CEF/cef_installer.py&&sudo python cef_installer.py {0} {1}" - }, - "type": "CopyableLabel" - } - ] - } - ], - "title": "1. Configure a dedicated proxy Linux machine" - }, - { - "description": "Set your Threat Console to send Syslog messages in CEF format to your Azure workspace. Make note of your Workspace ID and Primary Key within your Log Analytics Workspace (Select the workspace from the Log Analytics workspaces menu in the Azure portal. Then select Agents management in the Settings section). \n\n>1. Navigate to Reporting & Analytics inside your iboss Console\n\n>2. Select Log Forwarding -> Forward From Reporter\n\n>3. Select Actions -> Add Service\n\n>4. Toggle to Microsoft Sentinel as a Service Type and input your Workspace ID/Primary Key along with other criteria. If a dedicated proxy Linux machine has been configured, toggle to Syslog as a Service Type and configure the settings to point to your dedicated proxy Linux machine\n\n>5. Wait one to two minutes for the setup to complete\n\n>6. Select your Microsoft Sentinel Service and verify the Microsoft Sentinel Setup Status is Successful. If a dedicated proxy Linux machine has been configured, you may proceed with validating your connection", - "title": "2. Forward Common Event Format (CEF) logs" - }, - { - "description": "Open Log Analytics to check if the logs are received using the CommonSecurityLog schema.\n\n>It may take about 20 minutes until the connection streams data to your workspace", - "title": "3. Validate connection" - }, - { - "description": "Make sure to configure the machine's security according to your organization's security policy (Only applicable if a dedicated proxy Linux machine has been configured).\n\n\n[Learn more >](https://aka.ms/SecureCEF)", - "title": "4. Secure your machine " - } - ], - "id": "[variables('_uiConfigId1')]" - } - } - }, - { - "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", - "apiVersion": "2023-04-01-preview", - "name": "[variables('dataConnectorTemplateSpecName2')]", - "location": "[parameters('workspace-location')]", - "dependsOn": [ - "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" - ], - "properties": { - "description": "iboss data connector with template version 3.1.1", - "mainTemplate": { - "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", - "contentVersion": "[variables('dataConnectorVersion2')]", - "parameters": {}, - "variables": {}, - "resources": [ - { - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentId2'))]", - "apiVersion": "2021-03-01-preview", - "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", - "location": "[parameters('workspace-location')]", - "kind": "GenericUI", - "properties": { - "connectorUiConfig": { - "id": "[variables('_uiConfigId2')]", "title": "iboss via AMA", "publisher": "iboss", "descriptionMarkdown": "The [iboss](https://www.iboss.com) data connector enables you to seamlessly connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.", @@ -549,12 +212,12 @@ { "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", "apiVersion": "2023-04-01-preview", - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId2'),'/'))))]", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", "properties": { - "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId2'))]", - "contentId": "[variables('_dataConnectorContentId2')]", + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", + "contentId": "[variables('_dataConnectorContentId1')]", "kind": "DataConnector", - "version": "[variables('dataConnectorVersion2')]", + "version": "[variables('dataConnectorVersion1')]", "source": { "kind": "Solution", "name": "iboss", @@ -578,27 +241,27 @@ "packageName": "[variables('_solutionName')]", "packageId": "[variables('_solutionId')]", "contentSchemaVersion": "3.0.0", - "contentId": "[variables('_dataConnectorContentId2')]", + "contentId": "[variables('_dataConnectorContentId1')]", "contentKind": "DataConnector", "displayName": "iboss via AMA", - "contentProductId": "[variables('_dataConnectorcontentProductId2')]", - "id": "[variables('_dataConnectorcontentProductId2')]", - "version": "[variables('dataConnectorVersion2')]" + "contentProductId": "[variables('_dataConnectorcontentProductId1')]", + "id": "[variables('_dataConnectorcontentProductId1')]", + "version": "[variables('dataConnectorVersion1')]" } }, { "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", "apiVersion": "2023-04-01-preview", - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId2'),'/'))))]", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", "dependsOn": [ - "[variables('_dataConnectorId2')]" + "[variables('_dataConnectorId1')]" ], "location": "[parameters('workspace-location')]", "properties": { - "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId2'))]", - "contentId": "[variables('_dataConnectorContentId2')]", + "parentId": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", + "contentId": "[variables('_dataConnectorContentId1')]", "kind": "DataConnector", - "version": "[variables('dataConnectorVersion2')]", + "version": "[variables('dataConnectorVersion1')]", "source": { "kind": "Solution", "name": "iboss", @@ -616,7 +279,7 @@ } }, { - "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentId2'))]", + "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',variables('_dataConnectorContentId1'))]", "apiVersion": "2021-03-01-preview", "type": "Microsoft.OperationalInsights/workspaces/providers/dataConnectors", "location": "[parameters('workspace-location')]", @@ -709,7 +372,7 @@ "title": "Configure AMA Data Connector" } ], - "id": "[variables('_uiConfigId2')]" + "id": "[variables('_uiConfigId1')]" } } }, @@ -722,7 +385,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "ibossUrlEvent Data Parser with template version 3.1.1", + "description": "ibossUrlEvent Data Parser with template version 3.1.2", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('parserObject1').parserVersion1]", @@ -852,7 +515,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "ibossMalwareAndC2 Workbook with template version 3.1.1", + "description": "ibossMalwareAndC2 Workbook with template version 3.1.2", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('workbookVersion1')]", @@ -870,7 +533,7 @@ }, "properties": { "displayName": "[parameters('workbook1-name')]", - "serializedData": "{\"version\":\"Notebook/1.0\",\"items\":[{\"type\":1,\"content\":{\"json\":\"## iboss Malware and C2 Detections\\n\\n**NOTE:** This workbook uses a parser based on a Kusto Function to normalize fields. [Follow these steps](https://aka.ms/sentinel-iboss-parser) to create the Kusto function alias **ibossUrlEvent**.\"},\"name\":\"text - 2\"},{\"type\":9,\"content\":{\"version\":\"KqlParameterItem/1.0\",\"parameters\":[{\"id\":\"7cf056ef-64cd-41a5-85e0-90c0ec529434\",\"version\":\"KqlParameterItem/1.0\",\"name\":\"time_range_picker\",\"type\":4,\"isRequired\":true,\"value\":{\"durationMs\":604800000},\"typeSettings\":{\"selectableValues\":[{\"durationMs\":3600000},{\"durationMs\":86400000},{\"durationMs\":604800000},{\"durationMs\":2592000000},{\"durationMs\":5184000000},{\"durationMs\":7776000000}],\"allowCustom\":true},\"timeContext\":{\"durationMs\":86400000},\"label\":\"Time Range Picker\"}],\"style\":\"pills\",\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"parameters - 2\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where EventResult == 'Blocked' and MalwareDetected == 1\\r\\n| where isnotempty(ThreatName)\\r\\n| summarize count() by ThreatName\",\"size\":2,\"showAnalytics\":true,\"title\":\"Top Malware Detection Families\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"piechart\"},\"customWidth\":\"50\",\"name\":\"query - malware variants\",\"styleSettings\":{\"margin\":\"0px\"}},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where MalwareDetected == 1 or CNCDetected == 1\\r\\n| extend EventType = case(MalwareDetected == 1, \\\"Malware\\\", CNCDetected == 1, \\\"C2\\\", \\\"NA\\\")\\r\\n| make-series Detections = count() default = 0 on EventTime from {time_range_picker:start} to {time_range_picker:end} step {time_range_picker:grain} by EventType\",\"size\":0,\"showAnalytics\":true,\"title\":\"Malware & C2 Traffic\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"barchart\"},\"customWidth\":\"50\",\"name\":\"query - malware and c2 detections\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where MalwareDetected == 1\\r\\n| project EventTime\\r\\n , SrcUsername\\r\\n , SrcIpAddr\\r\\n , SrcPortNumber\\r\\n , DstIpAddr\\r\\n , DstPortNumber\\r\\n , FileName\\r\\n , FileSHA256\\r\\n , ThreatName\\r\\n| order by EventTime desc\\r\\n\\r\\n\\r\\n\\r\\n\",\"size\":0,\"showAnalytics\":true,\"title\":\"Malware Detections\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"query - malware detections\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where CNCDetected == 1\\r\\n| project EventTime\\r\\n , SrcUsername\\r\\n , SrcIpAddr\\r\\n , SrcPortNumber\\r\\n , DstIpAddr\\r\\n , DstPortNumber\\r\\n , Url\\r\\n| order by EventTime desc\",\"size\":0,\"showAnalytics\":true,\"title\":\"C2 Detections\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"query - c2 detections\"}],\"fromTemplateId\":\"sentinel-ibossMalwareAndC2Workbook\",\"$schema\":\"https://github.com/Microsoft/Application-Insights-Workbooks/blob/master/schema/workbook.json\"}\n", + "serializedData": "{\"version\":\"Notebook/1.0\",\"items\":[{\"type\":1,\"content\":{\"json\":\"## iboss Malware and C2 Detections\\n\\n**NOTE:** This workbook uses a parser based on a Kusto Function to normalize fields. [Follow these steps](https://aka.ms/sentinel-iboss-parser) to create the Kusto function alias **ibossUrlEvent**.\"},\"name\":\"text - 2\"},{\"type\":9,\"content\":{\"version\":\"KqlParameterItem/1.0\",\"parameters\":[{\"id\":\"7cf056ef-64cd-41a5-85e0-90c0ec529434\",\"version\":\"KqlParameterItem/1.0\",\"name\":\"time_range_picker\",\"type\":4,\"isRequired\":true,\"value\":{\"durationMs\":604800000},\"typeSettings\":{\"selectableValues\":[{\"durationMs\":3600000},{\"durationMs\":86400000},{\"durationMs\":604800000},{\"durationMs\":2592000000},{\"durationMs\":5184000000},{\"durationMs\":7776000000}],\"allowCustom\":true},\"timeContext\":{\"durationMs\":86400000},\"label\":\"Time Range Picker\"}],\"style\":\"pills\",\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"parameters - 2\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where EventResult == 'Blocked' and MalwareDetected == 1\\r\\n| where isnotempty(ThreatName)\\r\\n| summarize count() by ThreatName\",\"size\":2,\"showAnalytics\":true,\"title\":\"Top Malware Detection Families\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"piechart\"},\"customWidth\":\"50\",\"name\":\"query - malware variants\",\"styleSettings\":{\"margin\":\"0px\"}},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where MalwareDetected == 1 or CNCDetected == 1\\r\\n| extend EventType = case(MalwareDetected == 1, \\\"Malware\\\", CNCDetected == 1, \\\"C2\\\", \\\"NA\\\")\\r\\n| make-series Detections = count() default = 0 on EventTime from {time_range_picker:start} to {time_range_picker:end} step {time_range_picker:grain} by EventType\",\"size\":0,\"showAnalytics\":true,\"title\":\"Malware & C2 Traffic\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"barchart\"},\"customWidth\":\"50\",\"name\":\"query - malware and c2 detections\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where MalwareDetected == 1\\r\\n| project EventTime\\r\\n , SrcUsername\\r\\n , SrcIpAddr\\r\\n , SrcPortNumber\\r\\n , DstIpAddr\\r\\n , DstPortNumber\\r\\n , FileName\\r\\n , FileSHA256\\r\\n , ThreatName\\r\\n| order by EventTime desc\\r\\n\\r\\n\\r\\n\\r\\n\",\"size\":0,\"showAnalytics\":true,\"title\":\"Malware Detections\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"query - malware detections\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where CNCDetected == 1\\r\\n| project EventTime\\r\\n , SrcUsername\\r\\n , SrcIpAddr\\r\\n , SrcPortNumber\\r\\n , DstIpAddr\\r\\n , DstPortNumber\\r\\n , Url\\r\\n| order by EventTime desc\",\"size\":0,\"showAnalytics\":true,\"title\":\"C2 Detections\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"query - c2 detections\"}],\"fromTemplateId\":\"sentinel-ibossMalwareAndC2Workbook\",\"$schema\":\"https://github.com/Microsoft/Application-Insights-Workbooks/blob/master/schema/workbook.json\"}\r\n", "version": "1.0", "sourceId": "[variables('workspaceResourceId')]", "category": "sentinel" @@ -939,7 +602,7 @@ "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "ibossWebUsage Workbook with template version 3.1.1", + "description": "ibossWebUsage Workbook with template version 3.1.2", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('workbookVersion2')]", @@ -957,7 +620,7 @@ }, "properties": { "displayName": "[parameters('workbook2-name')]", - "serializedData": "{\"version\":\"Notebook/1.0\",\"items\":[{\"type\":1,\"content\":{\"json\":\"## iboss Web Usage\\r\\n\\r\\n**NOTE:** This workbook uses a parser based on a Kusto Function to normalize fields. [Follow these steps](https://aka.ms/sentinel-iboss-parser) to create the Kusto function alias **ibossUrlEvent**.\"},\"name\":\"text - 2\"},{\"type\":9,\"content\":{\"version\":\"KqlParameterItem/1.0\",\"parameters\":[{\"id\":\"7cf056ef-64cd-41a5-85e0-90c0ec529434\",\"version\":\"KqlParameterItem/1.0\",\"name\":\"time_range_picker\",\"type\":4,\"isRequired\":true,\"value\":{\"durationMs\":604800000},\"typeSettings\":{\"selectableValues\":[{\"durationMs\":3600000},{\"durationMs\":86400000},{\"durationMs\":604800000},{\"durationMs\":2592000000},{\"durationMs\":5184000000},{\"durationMs\":7776000000}],\"allowCustom\":true},\"timeContext\":{\"durationMs\":86400000},\"label\":\"Time Range Picker\"}],\"style\":\"pills\",\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"parameters - 2\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where isnotempty(UrlCategory) and UrlCategory != \\\"-\\\"\\r\\n| extend UrlCategory = split(UrlCategory, \\\", \\\")\\r\\n| mv-expand UrlCategory\\r\\n| summarize count() by tostring(UrlCategory)\",\"size\":3,\"showAnalytics\":true,\"title\":\"URL Categories\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"piechart\",\"tileSettings\":{\"showBorder\":false,\"titleContent\":{\"columnMatch\":\"UrlCategory\",\"formatter\":1},\"leftContent\":{\"columnMatch\":\"count_\",\"formatter\":12,\"formatOptions\":{\"palette\":\"auto\"},\"numberFormat\":{\"unit\":17,\"options\":{\"maximumSignificantDigits\":3,\"maximumFractionDigits\":2}}}}},\"customWidth\":\"50\",\"name\":\"query - categories query\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| sort by EventTime\\r\\n| summarize sum(DstBytes), sum(SrcBytes) by bin(EventTime,{time_range_picker:grain})\\r\\n\",\"size\":0,\"showAnalytics\":true,\"title\":\"Bandwidth ({time_range_picker:grain} interval)\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"linechart\",\"chartSettings\":{\"seriesLabelSettings\":[{\"seriesName\":\"sum_DstBytes\",\"label\":\"Received Bytes\"},{\"seriesName\":\"sum_SrcBytes\",\"label\":\"Sent Bytes\"}],\"showDataPoints\":true,\"ySettings\":{\"numberFormatSettings\":{\"unit\":2,\"options\":{\"style\":\"decimal\",\"useGrouping\":true}}}}},\"customWidth\":\"50\",\"name\":\"query - bandwidth\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where isnotempty(Domain)\\r\\n| summarize count() by Domain\\r\\n| sort by count_ desc\\r\\n| project Domain = Domain, count = count_\\r\\n| limit 20\",\"size\":1,\"showAnalytics\":true,\"title\":\"Top 20 Domains\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"tiles\",\"tileSettings\":{\"titleContent\":{\"columnMatch\":\"Domain\",\"formatter\":1},\"leftContent\":{\"columnMatch\":\"count\",\"formatter\":12,\"formatOptions\":{\"palette\":\"auto\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\",\"maximumFractionDigits\":2,\"maximumSignificantDigits\":3}}},\"showBorder\":false,\"rowLimit\":20,\"sortCriteriaField\":\"count\",\"size\":\"auto\"}},\"name\":\"query - top 20 domains\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker} and DvcAction == \\\"Blocked\\\"\\r\\n| make-series Trend = count() default = 0 on EventTime step {time_range_picker:grain} by Domain\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | where DvcAction == \\\"Blocked\\\"\\r\\n | summarize Requests = count() by Domain\\r\\n ) on Domain\\r\\n| project Domain, Requests, Trend\\r\\n| order by Requests desc\\r\\n\\r\\n\",\"size\":0,\"showAnalytics\":true,\"title\":\"Top Blocked Domains\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Requests\",\"formatter\":4,\"formatOptions\":{\"palette\":\"redBright\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"redBright\",\"compositeBarSettings\":{\"labelText\":\"\"}},\"numberFormat\":{\"unit\":0,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"count_\",\"formatter\":4,\"formatOptions\":{\"palette\":\"blue\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"DeviceCustomDate1\",\"formatter\":5,\"formatOptions\":{\"aggregation\":\"Count\"}}]}},\"customWidth\":\"50\",\"name\":\"query - top blocked domains\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker} and DvcAction == \\\"Blocked\\\"\\r\\n| make-series Trend = count() default = 0 on EventTime step {time_range_picker:grain} by SrcUsername\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | where DvcAction == \\\"Blocked\\\"\\r\\n | summarize Requests = count() by SrcUsername\\r\\n ) on SrcUsername\\r\\n| extend User = SrcUsername\\r\\n| project User, Requests, Trend\\r\\n| order by Requests desc\",\"size\":0,\"showAnalytics\":true,\"title\":\"Top Blocked Users\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Requests\",\"formatter\":4,\"formatOptions\":{\"palette\":\"redBright\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"redBright\"}}]}},\"customWidth\":\"50\",\"name\":\"query - top blocked users\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| summarize sum(DstBytes), sum(SrcBytes), sum(NetworkBytes) by SrcUsername\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | make-series Trend = sum(NetworkBytes) default = 0 on EventTime step {time_range_picker:grain} by SrcUsername\\r\\n ) on SrcUsername\\r\\n| order by sum_NetworkBytes desc\\r\\n| project Username=SrcUsername\\r\\n, Received=sum_DstBytes\\r\\n, Sent=sum_SrcBytes\\r\\n, Total=sum_NetworkBytes\\r\\n, Trend\",\"size\":0,\"showAnalytics\":true,\"title\":\"Bandwidth By User\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Received\",\"formatter\":8,\"formatOptions\":{\"palette\":\"green\"},\"numberFormat\":{\"unit\":2,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Sent\",\"formatter\":8,\"formatOptions\":{\"palette\":\"green\"},\"numberFormat\":{\"unit\":2,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Total\",\"formatter\":8,\"formatOptions\":{\"palette\":\"green\"},\"numberFormat\":{\"unit\":2,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"blue\"}}]}},\"customWidth\":\"50\",\"name\":\"query - bandwidth by user\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| make-series Trend = count() default = 0 on EventTime step {time_range_picker:grain} by SrcUsername\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | summarize Requests = count() by SrcUsername\\r\\n ) on SrcUsername\\r\\n| extend User = SrcUsername\\r\\n| project User, Requests, Trend\\r\\n| order by Requests desc\",\"size\":0,\"showAnalytics\":true,\"title\":\"Connections by User\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Requests\",\"formatter\":4,\"formatOptions\":{\"palette\":\"blue\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"blue\"}}]}},\"customWidth\":\"50\",\"name\":\"query - connections by user\"}],\"fromTemplateId\":\"sentinel-ibossWebUsageWorkbook\",\"$schema\":\"https://github.com/Microsoft/Application-Insights-Workbooks/blob/master/schema/workbook.json\"}\n", + "serializedData": "{\"version\":\"Notebook/1.0\",\"items\":[{\"type\":1,\"content\":{\"json\":\"## iboss Web Usage\\r\\n\\r\\n**NOTE:** This workbook uses a parser based on a Kusto Function to normalize fields. [Follow these steps](https://aka.ms/sentinel-iboss-parser) to create the Kusto function alias **ibossUrlEvent**.\"},\"name\":\"text - 2\"},{\"type\":9,\"content\":{\"version\":\"KqlParameterItem/1.0\",\"parameters\":[{\"id\":\"7cf056ef-64cd-41a5-85e0-90c0ec529434\",\"version\":\"KqlParameterItem/1.0\",\"name\":\"time_range_picker\",\"type\":4,\"isRequired\":true,\"value\":{\"durationMs\":604800000},\"typeSettings\":{\"selectableValues\":[{\"durationMs\":3600000},{\"durationMs\":86400000},{\"durationMs\":604800000},{\"durationMs\":2592000000},{\"durationMs\":5184000000},{\"durationMs\":7776000000}],\"allowCustom\":true},\"timeContext\":{\"durationMs\":86400000},\"label\":\"Time Range Picker\"}],\"style\":\"pills\",\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\"},\"name\":\"parameters - 2\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where isnotempty(UrlCategory) and UrlCategory != \\\"-\\\"\\r\\n| extend UrlCategory = split(UrlCategory, \\\", \\\")\\r\\n| mv-expand UrlCategory\\r\\n| summarize count() by tostring(UrlCategory)\",\"size\":3,\"showAnalytics\":true,\"title\":\"URL Categories\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"piechart\",\"tileSettings\":{\"showBorder\":false,\"titleContent\":{\"columnMatch\":\"UrlCategory\",\"formatter\":1},\"leftContent\":{\"columnMatch\":\"count_\",\"formatter\":12,\"formatOptions\":{\"palette\":\"auto\"},\"numberFormat\":{\"unit\":17,\"options\":{\"maximumSignificantDigits\":3,\"maximumFractionDigits\":2}}}}},\"customWidth\":\"50\",\"name\":\"query - categories query\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| sort by EventTime\\r\\n| summarize sum(DstBytes), sum(SrcBytes) by bin(EventTime,{time_range_picker:grain})\\r\\n\",\"size\":0,\"showAnalytics\":true,\"title\":\"Bandwidth ({time_range_picker:grain} interval)\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"linechart\",\"chartSettings\":{\"seriesLabelSettings\":[{\"seriesName\":\"sum_DstBytes\",\"label\":\"Received Bytes\"},{\"seriesName\":\"sum_SrcBytes\",\"label\":\"Sent Bytes\"}],\"showDataPoints\":true,\"ySettings\":{\"numberFormatSettings\":{\"unit\":2,\"options\":{\"style\":\"decimal\",\"useGrouping\":true}}}}},\"customWidth\":\"50\",\"name\":\"query - bandwidth\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| where isnotempty(Domain)\\r\\n| summarize count() by Domain\\r\\n| sort by count_ desc\\r\\n| project Domain = Domain, count = count_\\r\\n| limit 20\",\"size\":1,\"showAnalytics\":true,\"title\":\"Top 20 Domains\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"tiles\",\"tileSettings\":{\"titleContent\":{\"columnMatch\":\"Domain\",\"formatter\":1},\"leftContent\":{\"columnMatch\":\"count\",\"formatter\":12,\"formatOptions\":{\"palette\":\"auto\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\",\"maximumFractionDigits\":2,\"maximumSignificantDigits\":3}}},\"showBorder\":false,\"rowLimit\":20,\"sortCriteriaField\":\"count\",\"size\":\"auto\"}},\"name\":\"query - top 20 domains\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker} and DvcAction == \\\"Blocked\\\"\\r\\n| make-series Trend = count() default = 0 on EventTime step {time_range_picker:grain} by Domain\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | where DvcAction == \\\"Blocked\\\"\\r\\n | summarize Requests = count() by Domain\\r\\n ) on Domain\\r\\n| project Domain, Requests, Trend\\r\\n| order by Requests desc\\r\\n\\r\\n\",\"size\":0,\"showAnalytics\":true,\"title\":\"Top Blocked Domains\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Requests\",\"formatter\":4,\"formatOptions\":{\"palette\":\"redBright\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"redBright\",\"compositeBarSettings\":{\"labelText\":\"\"}},\"numberFormat\":{\"unit\":0,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"count_\",\"formatter\":4,\"formatOptions\":{\"palette\":\"blue\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"DeviceCustomDate1\",\"formatter\":5,\"formatOptions\":{\"aggregation\":\"Count\"}}]}},\"customWidth\":\"50\",\"name\":\"query - top blocked domains\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker} and DvcAction == \\\"Blocked\\\"\\r\\n| make-series Trend = count() default = 0 on EventTime step {time_range_picker:grain} by SrcUsername\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | where DvcAction == \\\"Blocked\\\"\\r\\n | summarize Requests = count() by SrcUsername\\r\\n ) on SrcUsername\\r\\n| extend User = SrcUsername\\r\\n| project User, Requests, Trend\\r\\n| order by Requests desc\",\"size\":0,\"showAnalytics\":true,\"title\":\"Top Blocked Users\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Requests\",\"formatter\":4,\"formatOptions\":{\"palette\":\"redBright\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"redBright\"}}]}},\"customWidth\":\"50\",\"name\":\"query - top blocked users\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| summarize sum(DstBytes), sum(SrcBytes), sum(NetworkBytes) by SrcUsername\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | make-series Trend = sum(NetworkBytes) default = 0 on EventTime step {time_range_picker:grain} by SrcUsername\\r\\n ) on SrcUsername\\r\\n| order by sum_NetworkBytes desc\\r\\n| project Username=SrcUsername\\r\\n, Received=sum_DstBytes\\r\\n, Sent=sum_SrcBytes\\r\\n, Total=sum_NetworkBytes\\r\\n, Trend\",\"size\":0,\"showAnalytics\":true,\"title\":\"Bandwidth By User\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Received\",\"formatter\":8,\"formatOptions\":{\"palette\":\"green\"},\"numberFormat\":{\"unit\":2,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Sent\",\"formatter\":8,\"formatOptions\":{\"palette\":\"green\"},\"numberFormat\":{\"unit\":2,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Total\",\"formatter\":8,\"formatOptions\":{\"palette\":\"green\"},\"numberFormat\":{\"unit\":2,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"blue\"}}]}},\"customWidth\":\"50\",\"name\":\"query - bandwidth by user\"},{\"type\":3,\"content\":{\"version\":\"KqlItem/1.0\",\"query\":\"ibossUrlEvent\\r\\n| where EventTime {time_range_picker}\\r\\n| make-series Trend = count() default = 0 on EventTime step {time_range_picker:grain} by SrcUsername\\r\\n| join kind = inner (ibossUrlEvent\\r\\n | where EventTime {time_range_picker}\\r\\n | summarize Requests = count() by SrcUsername\\r\\n ) on SrcUsername\\r\\n| extend User = SrcUsername\\r\\n| project User, Requests, Trend\\r\\n| order by Requests desc\",\"size\":0,\"showAnalytics\":true,\"title\":\"Connections by User\",\"showExportToExcel\":true,\"queryType\":0,\"resourceType\":\"microsoft.operationalinsights/workspaces\",\"visualization\":\"table\",\"gridSettings\":{\"formatters\":[{\"columnMatch\":\"Requests\",\"formatter\":4,\"formatOptions\":{\"palette\":\"blue\"},\"numberFormat\":{\"unit\":17,\"options\":{\"style\":\"decimal\"}}},{\"columnMatch\":\"Trend\",\"formatter\":9,\"formatOptions\":{\"palette\":\"blue\"}}]}},\"customWidth\":\"50\",\"name\":\"query - connections by user\"}],\"fromTemplateId\":\"sentinel-ibossWebUsageWorkbook\",\"$schema\":\"https://github.com/Microsoft/Application-Insights-Workbooks/blob/master/schema/workbook.json\"}\r\n", "version": "1.0", "sourceId": "[variables('workspaceResourceId')]", "category": "sentinel" @@ -1022,12 +685,12 @@ "apiVersion": "2023-04-01-preview", "location": "[parameters('workspace-location')]", "properties": { - "version": "3.1.1", + "version": "3.1.2", "kind": "Solution", "contentSchemaVersion": "3.0.0", "displayName": "iboss", "publisherDisplayName": "iboss", - "descriptionHtml": "

Note: Please refer to the following before installing the solution:

\n

• Review the solution Release Notes

\n

• There may be known issues pertaining to this Solution, please refer to them before installing.

\n

The iboss Solution provides means to connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.

\n

This solution is dependent on the Common Event Format solution containing the CEF via AMA connector to collect the logs. The CEF solution will be installed as part of this solution installation.

\n

NOTE: Microsoft recommends installation of CEF via AMA Connector. The existing connectors are about to be deprecated by Aug 31, 2024.

\n

Data Connectors: 2, Parsers: 1, Workbooks: 2

\n

Learn more about Microsoft Sentinel | Learn more about Solutions

\n", + "descriptionHtml": "

Note: Please refer to the following before installing the solution:

\n

• Review the solution Release Notes

\n

• There may be known issues pertaining to this Solution, please refer to them before installing.

\n

The iboss Solution provides means to connect your Threat Console to Microsoft Sentinel and enrich your instance with iboss URL event logs. Our logs are forwarded in Common Event Format (CEF) over Syslog and the configuration required can be completed on the iboss platform without the use of a proxy. Take advantage of our connector to garner critical data points and gain insight into security threats.

\n

This solution is dependent on the Common Event Format solution containing the CEF via AMA connector to collect the logs. The CEF solution will be installed as part of this solution installation.

\n

NOTE: Microsoft recommends installation of CEF via AMA Connector. Legacy connector uses the Log Analytics agent which were deprecated on Aug 31, 2024.

\n

Data Connectors: 1, Parsers: 1, Workbooks: 2

\n

Learn more about Microsoft Sentinel | Learn more about Solutions

\n", "contentKind": "Solution", "contentProductId": "[variables('_solutioncontentProductId')]", "id": "[variables('_solutioncontentProductId')]", @@ -1055,11 +718,6 @@ "contentId": "[variables('_dataConnectorContentId1')]", "version": "[variables('dataConnectorVersion1')]" }, - { - "kind": "DataConnector", - "contentId": "[variables('_dataConnectorContentId2')]", - "version": "[variables('dataConnectorVersion2')]" - }, { "kind": "Parser", "contentId": "[variables('parserObject1').parserContentId1]", diff --git a/Solutions/iboss/ReleaseNotes.md b/Solutions/iboss/ReleaseNotes.md index 58d573f3bbc..be36fcc0774 100644 --- a/Solutions/iboss/ReleaseNotes.md +++ b/Solutions/iboss/ReleaseNotes.md @@ -1,4 +1,7 @@ | **Version** | **Date Modified (DD-MM-YYYY)** | **Change History** | |-------------|--------------------------------|--------------------------------------------------------------------| +| 3.1.2 | 07-01-2025 | Removed Deprecated **Data connector** | +| 3.1.1 | 18-09-2024 | Updated AMA and legacy OMS connector to use new iboss field | +| 3.1.0 | 05-09-2024 | Updated AMA connector with iboss specific instructions | | 3.0.1 | 12-07-2024 | Deprecating data connectors | | 3.0.0 | 20-09-2023 | Addition of new Iboss AMA **Data Connector** | diff --git a/Workbooks/WorkbooksMetadata.json b/Workbooks/WorkbooksMetadata.json index 4741a281eb2..252fd0c3a0e 100644 --- a/Workbooks/WorkbooksMetadata.json +++ b/Workbooks/WorkbooksMetadata.json @@ -1066,7 +1066,6 @@ "CommonSecurityLog" ], "dataConnectorsDependencies": [ - "TrendMicro", "CefAma" ], "previewImagesFileNames": [ @@ -1087,7 +1086,6 @@ "CommonSecurityLog" ], "dataConnectorsDependencies": [ - "TrendMicro", "CefAma" ], "previewImagesFileNames": [ @@ -1133,7 +1131,6 @@ "Syslog" ], "dataConnectorsDependencies": [ - "BarracudaCloudFirewall", "SyslogAma" ], "previewImagesFileNames": [ @@ -1601,7 +1598,6 @@ "Syslog" ], "dataConnectorsDependencies": [ - "SymantecProxySG", "SyslogAma" ], "previewImagesFileNames": [ @@ -3681,7 +3677,6 @@ "CommonSecurityLog" ], "dataConnectorsDependencies": [ - "AristaAwakeSecurity", "CefAma" ], "previewImagesFileNames": [ @@ -3973,8 +3968,6 @@ "CommonSecurityLog" ], "dataConnectorsDependencies": [ - "InfobloxCloudDataConnector", - "InfobloxCloudDataConnectorAma", "CefAma" ], "previewImagesFileNames": [ @@ -4104,7 +4097,7 @@ "SecurityBridgeLogs" ], "dataConnectorsDependencies": [ - "SecurityBridgeSAP" + "CustomLogsAma" ], "previewImagesFileNames": [ "" @@ -4166,7 +4159,6 @@ "McAfeeEPOEvent" ], "dataConnectorsDependencies": [ - "McAfeeePO", "SyslogAma" ], "previewImagesFileNames": [ @@ -4642,7 +4634,6 @@ "DigitalGuardianDLPEvent" ], "dataConnectorsDependencies": [ - "DigitalGuardianDLP", "SyslogAma" ], "previewImagesFileNames": [ @@ -4703,7 +4694,6 @@ "Syslog" ], "dataConnectorsDependencies": [ - "CiscoWSA", "SyslogAma" ], "previewImagesFileNames": [ @@ -5790,7 +5780,6 @@ "description": "A workbook providing insights into malware and C2 activity detected by iboss.", "dataTypesDependencies": [], "dataConnectorsDependencies": [ - "ibossAma", "CefAma" ], "previewImagesFileNames": [ @@ -5808,7 +5797,6 @@ "description": "A workbook providing insights into web usage activity detected by iboss.", "dataTypesDependencies": [], "dataConnectorsDependencies": [ - "ibossAma", "CefAma" ], "previewImagesFileNames": [ @@ -7944,7 +7932,7 @@ "Infoblox_Config_Insight_Details_CL" ], "dataConnectorsDependencies": [ - "InfobloxCloudDataConnectorAma", + "CefAma", "InfobloxSOCInsightsDataConnector_AMA", "InfobloxSOCInsightsDataConnector_API", "InfobloxSOCInsightsDataConnector_Legacy"