diff --git a/Solutions/TheHive/Data Connectors/TheHive_Webhooks_FunctionApp.json b/Solutions/TheHive/Data Connectors/TheHive_Webhooks_FunctionApp.json index 496e600825e..3f16f4ee983 100644 --- a/Solutions/TheHive/Data Connectors/TheHive_Webhooks_FunctionApp.json +++ b/Solutions/TheHive/Data Connectors/TheHive_Webhooks_FunctionApp.json @@ -63,7 +63,8 @@ } ] }, - "instructionSteps": [{ + "instructionSteps": [ + { "title": "", "description": ">**NOTE:** This data connector uses Azure Functions based on HTTP Trigger for waiting POST requests with logs to pull its logs into Microsoft Sentinel. This might result in additional data ingestion costs. Check the [Azure Functions pricing page](https://azure.microsoft.com/pricing/details/functions/) for details." }, @@ -102,20 +103,40 @@ ] }, { - "title": "Option 1 - Azure Resource Manager (ARM) Template", - "description": "Use this method for automated deployment of the TheHive data connector using an ARM Template.\n\n1. Click the **Deploy to Azure** button below. \n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://aka.ms/sentinel-TheHive-azuredeploy)\n2. Select the preferred **Subscription**, **Resource Group** and **Location**. \n> **NOTE:** Within the same resource group, you can't mix Windows and Linux apps in the same region. Select existing resource group without Windows apps in it or create new resource group.\n3. Enter the **TheHiveBearerToken** and deploy. \n4. Mark the checkbox labeled **I agree to the terms and conditions stated above**. \n5. Click **Purchase** to deploy.\n6. After deploying open Function App page, select your app, go to the **Functions** and click **Get Function Url** copy it and follow p.7 from STEP 1." - }, - { - "title": "Option 2 - Manual Deployment of Azure Functions", - "description": "Use the following step-by-step instructions to deploy the TheHive data connector manually with Azure Functions (Deployment via Visual Studio Code)." - }, - { - "title": "", - "description": "**1. Deploy a Function App**\n\n> **NOTE:** You will need to [prepare VS code](https://docs.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.\n\n1. Download the [Azure Function App](https://aka.ms/sentinel-TheHive-functionapp) file. Extract archive to your local development computer.\n2. Start VS Code. Choose File in the main menu and select Open Folder.\n3. Select the top level folder from extracted files.\n4. Choose the Azure icon in the Activity bar, then in the **Azure: Functions** area, choose the **Deploy to function app** button.\nIf you aren't already signed in, choose the Azure icon in the Activity bar, then in the **Azure: Functions** area, choose **Sign in to Azure**\nIf you're already signed in, go to the next step.\n5. Provide the following information at the prompts:\n\n\ta. **Select folder:** Choose a folder from your workspace or browse to one that contains your function app.\n\n\tb. **Select Subscription:** Choose the subscription to use.\n\n\tc. Select **Create new Function App in Azure** (Don't choose the Advanced option)\n\n\td. **Enter a globally unique name for the function app:** Type a name that is valid in a URL path. The name you type is validated to make sure that it's unique in Azure Functions. (e.g. TheHiveXXXXX).\n\n\te. **Select a runtime:** Choose Python 3.8.\n\n\tf. Select a location for new resources. For better performance and lower costs choose the same [region](https://azure.microsoft.com/regions/) where Microsoft Sentinel is located.\n\n6. Deployment will begin. A notification is displayed after your function app is created and the deployment package is applied.\n7. Go to Azure Portal for the Function App configuration." - }, - { - "title": "", - "description": "**2. Configure the Function App**\n\n1. In the Function App, select the Function App Name and select **Configuration**.\n2. In the **Application settings** tab, select ** New application setting**.\n3. Add each of the following application settings individually, with their respective string values (case-sensitive): \n\t\tTheHiveBearerToken\n\t\tWorkspaceID\n\t\tWorkspaceKey\n\t\tlogAnalyticsUri (optional)\n> - Use logAnalyticsUri to override the log analytics API endpoint for dedicated cloud. For example, for public cloud, leave the value empty; for Azure GovUS cloud environment, specify the value in the following format: `https://.ods.opinsights.azure.us`.\n4. Once all application settings have been entered, click **Save**." + "instructions": [ + { + "parameters": { + "instructionSteps": [ + { + "title": "Option 1 - Azure Resource Manager (ARM) Template", + "description": "Use this method for automated deployment of the TheHive data connector using an ARM Template.\n\n1. Click the **Deploy to Azure** button below. \n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://aka.ms/sentinel-TheHive-azuredeploy)\n2. Select the preferred **Subscription**, **Resource Group** and **Location**. \n> **NOTE:** Within the same resource group, you can't mix Windows and Linux apps in the same region. Select existing resource group without Windows apps in it or create new resource group.\n3. Enter the **TheHiveBearerToken** and deploy. \n4. Mark the checkbox labeled **I agree to the terms and conditions stated above**. \n5. Click **Purchase** to deploy.\n6. After deploying open Function App page, select your app, go to the **Functions** and click **Get Function Url** copy it and follow p.7 from STEP 1." + }, + { + "title": "Option 2 - Manual Deployment of Azure Functions", + "description": "Use the following step-by-step instructions to deploy the TheHive data connector manually with Azure Functions (Deployment via Visual Studio Code).", + "instructions": [ + { + "parameters": { + "instructionSteps": [ + { + "title": "Step 1 - Deploy a Function App", + "description": "**NOTE:** You will need to [prepare VS code](https://docs.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.\n\n1. Download the [Azure Function App](https://aka.ms/sentinel-TheHive-functionapp) file. Extract archive to your local development computer.\n2. Follow the [function app manual deployment instructions](https://github.com/Azure/Azure-Sentinel/blob/master/DataConnectors/AzureFunctionsManualDeployment.md#function-app-manual-deployment-instructions) to deploy the Azure Functions app using VSCode.\n3. After successful deployment of the function app, follow next steps for configuring it." + }, + { + "title": "Step 2 - Configure the Function App", + "description": "1. Go to Azure Portal for the Function App configuration.\n2. In the Function App, select the Function App Name and select **Configuration**.\n2. In the **Application settings** tab, select ** New application setting**.\n3. Add each of the following application settings individually, with their respective string values (case-sensitive): \n\t\tTheHiveBearerToken\n\t\tWorkspaceID\n\t\tWorkspaceKey\n\t\tlogAnalyticsUri (optional)\n> - Use logAnalyticsUri to override the log analytics API endpoint for dedicated cloud. For example, for public cloud, leave the value empty; for Azure GovUS cloud environment, specify the value in the following format: `https://.ods.opinsights.azure.us`.\n4. Once all application settings have been entered, click **Save**." + } + ] + }, + "type": "InstructionStepsGroup" + } + ] + } + ] + }, + "type": "InstructionStepsGroup" + } + ] } ] } \ No newline at end of file diff --git a/Solutions/TheHive/Data/Solution_TheHive.json b/Solutions/TheHive/Data/Solution_TheHive.json index 4771e424edc..96101b0b222 100644 --- a/Solutions/TheHive/Data/Solution_TheHive.json +++ b/Solutions/TheHive/Data/Solution_TheHive.json @@ -7,7 +7,7 @@ "Data Connectors/TheHive_Webhooks_FunctionApp.json" ], "Parsers": [ - "Parsers/TheHive.txt" + "Parsers/TheHive.yaml" ], "Playbooks": [ "Playbooks/TheHiveConnector/azuredeploy.json", @@ -17,7 +17,7 @@ ], "Metadata": "SolutionMetadata.json", "BasePath": "C:\\GitHub\\Azure-Sentinel\\Solutions\\TheHive", - "Version": "2.0.2", + "Version": "3.0.0", "TemplateSpec": true, "Is1PConnector": false } \ No newline at end of file diff --git a/Solutions/TheHive/Data/system_generated_metadata.json b/Solutions/TheHive/Data/system_generated_metadata.json new file mode 100644 index 00000000000..a7c784fc1f2 --- /dev/null +++ b/Solutions/TheHive/Data/system_generated_metadata.json @@ -0,0 +1,36 @@ +{ + "Name": "TheHive", + "Author": "Microsoft - support@microsoft.com", + "Logo": "", + "Description": "[TheHive](http://thehive-project.org/) solution provides the capability to ingest common The Hive events into Microsoft Sentinel through Webhooks. The Hive can notify external system of modification events (case creation, alert update, task assignment) in real time. When a change occurs in The Hive, an HTTPS POST request with event information is sent to a callback data connector URL. Refer to [Webhooks documentation](https://docs.thehive-project.org/thehive/legacy/thehive3/admin/webhooks/) for more information.\r\n \r\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: \r\n \r\n a. [Azure Monitor HTTP Data Collector API](https://docs.microsoft.com/azure/azure-monitor/logs/data-collector-api) b. [Azure Functions ](https://azure.microsoft.com/services/functions/#overview)", + "Metadata": "SolutionMetadata.json", + "BasePath": "C:\\GitHub\\Azure-Sentinel\\Solutions\\TheHive", + "Version": "3.0.0", + "TemplateSpec": true, + "Is1PConnector": false, + "publisherId": "azuresentinel", + "offerId": "azure-sentinel-solution-thehive", + "providers": [ + "TheHive" + ], + "categories": { + "domains": [ + "Application" + ] + }, + "firstPublishDate": "2021-10-23", + "support": { + "name": "Microsoft Corporation", + "email": "support@microsoft.com", + "tier": "Microsoft", + "link": "https://support.microsoft.com" + }, + "Data Connectors": "[\n \"Data Connectors/TheHive_Webhooks_FunctionApp.json\"\n]", + "Parsers": "[\n \"TheHive.txt\"\n]", + "Playbooks": [ + "Playbooks/TheHiveConnector/azuredeploy.json", + "Playbooks/TheHive-CreateAlert/azuredeploy.json", + "Playbooks/TheHive-CreateCase/azuredeploy.json", + "Playbooks/TheHive-LockUser/azuredeploy.json" + ] +} diff --git a/Solutions/TheHive/Package/3.0.0.zip b/Solutions/TheHive/Package/3.0.0.zip new file mode 100644 index 00000000000..cf7374ef3bf Binary files /dev/null and b/Solutions/TheHive/Package/3.0.0.zip differ diff --git a/Solutions/TheHive/Package/createUiDefinition.json b/Solutions/TheHive/Package/createUiDefinition.json index 6cd21ac2199..1fc6de00efa 100644 --- a/Solutions/TheHive/Package/createUiDefinition.json +++ b/Solutions/TheHive/Package/createUiDefinition.json @@ -6,7 +6,7 @@ "config": { "isWizard": false, "basics": { - "description": "\n\n**Note:** _There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing._\n\n[TheHive](http://thehive-project.org/) solution provides the capability to ingest common The Hive events into Microsoft Sentinel through Webhooks. The Hive can notify external system of modification events (case creation, alert update, task assignment) in real time. When a change occurs in The Hive, an HTTPS POST request with event information is sent to a callback data connector URL. Refer to [Webhooks documentation](https://docs.thehive-project.org/thehive/legacy/thehive3/admin/webhooks/) for more information.\r\n \r\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: \r\n \r\n a. [Azure Monitor HTTP Data Collector API](https://docs.microsoft.com/azure/azure-monitor/logs/data-collector-api) \r\n \r\n b. [Azure Functions ](https://azure.microsoft.com/services/functions/#overview)\n\n**Data Connectors:** 1, **Parsers:** 1, **Custom Azure Logic Apps Connectors:** 1, **Playbooks:** 3\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: \r \n • Review the solution [Release Notes](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/TheHive/ReleaseNotes.md)\r \n • There may be [known issues](https://aka.ms/sentinelsolutionsknownissues) pertaining to this Solution, please refer to them before installing.\n\n[TheHive](http://thehive-project.org/) solution provides the capability to ingest common The Hive events into Microsoft Sentinel through Webhooks. The Hive can notify external system of modification events (case creation, alert update, task assignment) in real time. When a change occurs in The Hive, an HTTPS POST request with event information is sent to a callback data connector URL. Refer to [Webhooks documentation](https://docs.thehive-project.org/thehive/legacy/thehive3/admin/webhooks/) for more information.\r\n \r\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: \r\n \r\n a. [Azure Monitor HTTP Data Collector API](https://docs.microsoft.com/azure/azure-monitor/logs/data-collector-api) b. [Azure Functions ](https://azure.microsoft.com/services/functions/#overview)\n\n**Data Connectors:** 1, **Parsers:** 1, **Custom Azure Logic Apps Connectors:** 1, **Playbooks:** 3\n\n[Learn more about Microsoft Sentinel](https://aka.ms/azuresentinel) | [Learn more about Solutions](https://aka.ms/azuresentinelsolutionsdoc)", "subscription": { "resourceProviders": [ "Microsoft.OperationsManagement/solutions", @@ -60,14 +60,14 @@ "name": "dataconnectors1-text", "type": "Microsoft.Common.TextBlock", "options": { - "text": "This solution installs the data connector for ingesting The Hive logs into Microsoft Sentinel, using The Hive API. After installing the solution, configure and enable this data connector by following guidance in Manage solution view." + "text": "This Solution installs the data connector for TheHive. You can get TheHive 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", "options": { - "text": "The solution installs a parser that transforms ingested data. The transformed logs can be accessed using the TheHive Kusto Function alias." + "text": "The Solution installs a parser that transforms the ingested data into Microsoft Sentinel normalized format. The normalized format enables better correlation of different types of data from different data sources to drive end-to-end outcomes seamlessly in security monitoring, hunting, incident investigation and response scenarios in Microsoft Sentinel." } }, { diff --git a/Solutions/TheHive/Package/mainTemplate.json b/Solutions/TheHive/Package/mainTemplate.json index e76171576ef..5f965e49260 100644 --- a/Solutions/TheHive/Package/mainTemplate.json +++ b/Solutions/TheHive/Package/mainTemplate.json @@ -30,84 +30,77 @@ } }, "variables": { - "solutionId": "azuresentinel.azure-sentinel-solution-thehive", - "_solutionId": "[variables('solutionId')]", "email": "support@microsoft.com", "_email": "[variables('email')]", - "workspaceResourceId": "[resourceId('microsoft.OperationalInsights/Workspaces', parameters('workspace'))]", + "_solutionName": "TheHive", + "_solutionVersion": "3.0.0", + "solutionId": "azuresentinel.azure-sentinel-solution-thehive", + "_solutionId": "[variables('solutionId')]", "uiConfigId1": "TheHiveProjectTheHive", "_uiConfigId1": "[variables('uiConfigId1')]", "dataConnectorContentId1": "TheHiveProjectTheHive", "_dataConnectorContentId1": "[variables('dataConnectorContentId1')]", "dataConnectorId1": "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/dataConnectors', variables('_dataConnectorContentId1'))]", "_dataConnectorId1": "[variables('dataConnectorId1')]", - "dataConnectorTemplateSpecName1": "[concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentId1')))]", + "dataConnectorTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-dc-',uniquestring(variables('_dataConnectorContentId1'))))]", "dataConnectorVersion1": "1.0.0", - "parserVersion1": "1.0.0", - "parserContentId1": "TheHive-Parser", - "_parserContentId1": "[variables('parserContentId1')]", + "_dataConnectorcontentProductId1": "[concat(take(variables('_solutionId'),50),'-','dc','-', uniqueString(concat(variables('_solutionId'),'-','DataConnector','-',variables('_dataConnectorContentId1'),'-', variables('dataConnectorVersion1'))))]", "parserName1": "TheHive Data Parser", "_parserName1": "[concat(parameters('workspace'),'/',variables('parserName1'))]", "parserId1": "[resourceId('Microsoft.OperationalInsights/workspaces/savedSearches', parameters('workspace'), variables('parserName1'))]", "_parserId1": "[variables('parserId1')]", - "parserTemplateSpecName1": "[concat(parameters('workspace'),'-pr-',uniquestring(variables('_parserContentId1')))]", + "parserTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-pr-',uniquestring(variables('_parserContentId1'))))]", + "parserVersion1": "1.0.0", + "parserContentId1": "TheHive-Parser", + "_parserContentId1": "[variables('parserContentId1')]", + "_parsercontentProductId1": "[concat(take(variables('_solutionId'),50),'-','pr','-', uniqueString(concat(variables('_solutionId'),'-','Parser','-',variables('_parserContentId1'),'-', variables('parserVersion1'))))]", "TheHiveConnector": "TheHiveConnector", "_TheHiveConnector": "[variables('TheHiveConnector')]", + "TemplateEmptyArray": "[json('[]')]", + "blanks": "[replace('b', 'b', '')]", "playbookVersion1": "1.0", "playbookContentId1": "TheHiveConnector", "_playbookContentId1": "[variables('playbookContentId1')]", - "playbookTemplateSpecName1": "[concat(parameters('workspace'),'-lc-',uniquestring(variables('_playbookContentId1')))]", + "playbookTemplateSpecName1": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat(parameters('workspace'),'-lc-',uniquestring(variables('_playbookContentId1'))))]", + "workspaceResourceId": "[resourceId('microsoft.OperationalInsights/Workspaces', parameters('workspace'))]", + "_playbookcontentProductId1": "[concat(take(variables('_solutionId'),50),'-','lc','-', uniqueString(concat(variables('_solutionId'),'-','LogicAppsCustomConnector','-',variables('_playbookContentId1'),'-', variables('playbookVersion1'))))]", "TheHive-CreateAlert": "TheHive-CreateAlert", "_TheHive-CreateAlert": "[variables('TheHive-CreateAlert')]", "playbookVersion2": "1.0", "playbookContentId2": "TheHive-CreateAlert", "_playbookContentId2": "[variables('playbookContentId2')]", "playbookId2": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId2'))]", - "playbookTemplateSpecName2": "[concat(parameters('workspace'),'-pl-',uniquestring(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'))))]", "TheHive-CreateCase": "TheHive-CreateCase", "_TheHive-CreateCase": "[variables('TheHive-CreateCase')]", "playbookVersion3": "1.0", "playbookContentId3": "TheHive-CreateCase", "_playbookContentId3": "[variables('playbookContentId3')]", "playbookId3": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId3'))]", - "playbookTemplateSpecName3": "[concat(parameters('workspace'),'-pl-',uniquestring(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'))))]", "TheHive-LockUser": "TheHive-LockUser", "_TheHive-LockUser": "[variables('TheHive-LockUser')]", "playbookVersion4": "1.0", "playbookContentId4": "TheHive-LockUser", "_playbookContentId4": "[variables('playbookContentId4')]", "playbookId4": "[resourceId('Microsoft.Logic/workflows', variables('playbookContentId4'))]", - "playbookTemplateSpecName4": "[concat(parameters('workspace'),'-pl-',uniquestring(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'))))]", + "_solutioncontentProductId": "[concat(take(variables('_solutionId'),50),'-','sl','-', uniqueString(concat(variables('_solutionId'),'-','Solution','-',variables('_solutionId'),'-', variables('_solutionVersion'))))]" }, "resources": [ { - "type": "Microsoft.Resources/templateSpecs", - "apiVersion": "2021-05-01", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", "name": "[variables('dataConnectorTemplateSpecName1')]", "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "DataConnector" - }, - "properties": { - "description": "TheHive data connector with template", - "displayName": "TheHive template" - } - }, - { - "type": "Microsoft.Resources/templateSpecs/versions", - "apiVersion": "2021-05-01", - "name": "[concat(variables('dataConnectorTemplateSpecName1'),'/',variables('dataConnectorVersion1'))]", - "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "DataConnector" - }, "dependsOn": [ - "[resourceId('Microsoft.Resources/templateSpecs', variables('dataConnectorTemplateSpecName1'))]" + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "TheHive data connector with template version 2.0.2", + "description": "TheHive data connector with template version 3.0.0", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('dataConnectorVersion1')]", @@ -123,7 +116,7 @@ "properties": { "connectorUiConfig": { "id": "[variables('_uiConfigId1')]", - "title": "TheHive Project - TheHive (using Azure Function)", + "title": "TheHive Project - TheHive (using Azure Functions)", "publisher": "TheHive Project", "descriptionMarkdown": "The [TheHive](http://thehive-project.org/) data connector provides the capability to ingest common TheHive events into Microsoft Sentinel through Webhooks. TheHive can notify external system of modification events (case creation, alert update, task assignment) in real time. When a change occurs in the TheHive, an HTTPS POST request with event information is sent to a callback data connector URL. Refer to [Webhooks documentation](https://docs.thehive-project.org/thehive/legacy/thehive3/admin/webhooks/) for more information. The connector provides ability to get events which helps to examine potential security risks, analyze your team's use of collaboration, diagnose configuration problems and more.", "additionalRequirementBanner": ">This data connector depends on a parser based on a Kusto Function to work as expected [**TheHive**](https://aka.ms/sentinel-TheHive-parser) which is deployed with the Microsoft Sentinel Solution.", @@ -137,7 +130,7 @@ "sampleQueries": [ { "description": "TheHive Events - All Activities.", - "query": "TheHive\n | sort by TimeGenerated desc" + "query": "TheHive_CL\n | sort by TimeGenerated desc" } ], "dataTypes": [ @@ -229,18 +222,40 @@ ] }, { - "description": "Use this method for automated deployment of the TheHive data connector using an ARM Template.\n\n1. Click the **Deploy to Azure** button below. \n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://aka.ms/sentinel-TheHive-azuredeploy)\n2. Select the preferred **Subscription**, **Resource Group** and **Location**. \n> **NOTE:** Within the same resource group, you can't mix Windows and Linux apps in the same region. Select existing resource group without Windows apps in it or create new resource group.\n3. Enter the **TheHiveBearerToken** and deploy. \n4. Mark the checkbox labeled **I agree to the terms and conditions stated above**. \n5. Click **Purchase** to deploy.\n6. After deploying open Function App page, select your app, go to the **Functions** and click **Get Function Url** copy it and follow p.7 from STEP 1.", - "title": "Option 1 - Azure Resource Manager (ARM) Template" - }, - { - "description": "Use the following step-by-step instructions to deploy the TheHive data connector manually with Azure Functions (Deployment via Visual Studio Code).", - "title": "Option 2 - Manual Deployment of Azure Functions" - }, - { - "description": "**1. Deploy a Function App**\n\n> **NOTE:** You will need to [prepare VS code](https://docs.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.\n\n1. Download the [Azure Function App](https://aka.ms/sentinel-TheHive-functionapp) file. Extract archive to your local development computer.\n2. Start VS Code. Choose File in the main menu and select Open Folder.\n3. Select the top level folder from extracted files.\n4. Choose the Azure icon in the Activity bar, then in the **Azure: Functions** area, choose the **Deploy to function app** button.\nIf you aren't already signed in, choose the Azure icon in the Activity bar, then in the **Azure: Functions** area, choose **Sign in to Azure**\nIf you're already signed in, go to the next step.\n5. Provide the following information at the prompts:\n\n\ta. **Select folder:** Choose a folder from your workspace or browse to one that contains your function app.\n\n\tb. **Select Subscription:** Choose the subscription to use.\n\n\tc. Select **Create new Function App in Azure** (Don't choose the Advanced option)\n\n\td. **Enter a globally unique name for the function app:** Type a name that is valid in a URL path. The name you type is validated to make sure that it's unique in Azure Functions. (e.g. TheHiveXXXXX).\n\n\te. **Select a runtime:** Choose Python 3.8.\n\n\tf. Select a location for new resources. For better performance and lower costs choose the same [region](https://azure.microsoft.com/regions/) where Microsoft Sentinel is located.\n\n6. Deployment will begin. A notification is displayed after your function app is created and the deployment package is applied.\n7. Go to Azure Portal for the Function App configuration." - }, - { - "description": "**2. Configure the Function App**\n\n1. In the Function App, select the Function App Name and select **Configuration**.\n2. In the **Application settings** tab, select ** New application setting**.\n3. Add each of the following application settings individually, with their respective string values (case-sensitive): \n\t\tTheHiveBearerToken\n\t\tWorkspaceID\n\t\tWorkspaceKey\n\t\tlogAnalyticsUri (optional)\n> - Use logAnalyticsUri to override the log analytics API endpoint for dedicated cloud. For example, for public cloud, leave the value empty; for Azure GovUS cloud environment, specify the value in the following format: `https://.ods.opinsights.azure.us`.\n4. Once all application settings have been entered, click **Save**." + "instructions": [ + { + "parameters": { + "instructionSteps": [ + { + "title": "Option 1 - Azure Resource Manager (ARM) Template", + "description": "Use this method for automated deployment of the TheHive data connector using an ARM Template.\n\n1. Click the **Deploy to Azure** button below. \n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://aka.ms/sentinel-TheHive-azuredeploy)\n2. Select the preferred **Subscription**, **Resource Group** and **Location**. \n> **NOTE:** Within the same resource group, you can't mix Windows and Linux apps in the same region. Select existing resource group without Windows apps in it or create new resource group.\n3. Enter the **TheHiveBearerToken** and deploy. \n4. Mark the checkbox labeled **I agree to the terms and conditions stated above**. \n5. Click **Purchase** to deploy.\n6. After deploying open Function App page, select your app, go to the **Functions** and click **Get Function Url** copy it and follow p.7 from STEP 1." + }, + { + "title": "Option 2 - Manual Deployment of Azure Functions", + "description": "Use the following step-by-step instructions to deploy the TheHive data connector manually with Azure Functions (Deployment via Visual Studio Code).", + "instructions": [ + { + "parameters": { + "instructionSteps": [ + { + "title": "Step 1 - Deploy a Function App", + "description": "**NOTE:** You will need to [prepare VS code](https://docs.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.\n\n1. Download the [Azure Function App](https://aka.ms/sentinel-TheHive-functionapp) file. Extract archive to your local development computer.\n2. Follow the [function app manual deployment instructions](https://github.com/Azure/Azure-Sentinel/blob/master/DataConnectors/AzureFunctionsManualDeployment.md#function-app-manual-deployment-instructions) to deploy the Azure Functions app using VSCode.\n3. After successful deployment of the function app, follow next steps for configuring it." + }, + { + "title": "Step 2 - Configure the Function App", + "description": "1. Go to Azure Portal for the Function App configuration.\n2. In the Function App, select the Function App Name and select **Configuration**.\n2. In the **Application settings** tab, select ** New application setting**.\n3. Add each of the following application settings individually, with their respective string values (case-sensitive): \n\t\tTheHiveBearerToken\n\t\tWorkspaceID\n\t\tWorkspaceKey\n\t\tlogAnalyticsUri (optional)\n> - Use logAnalyticsUri to override the log analytics API endpoint for dedicated cloud. For example, for public cloud, leave the value empty; for Azure GovUS cloud environment, specify the value in the following format: `https://.ods.opinsights.azure.us`.\n4. Once all application settings have been entered, click **Save**." + } + ] + }, + "type": "InstructionStepsGroup" + } + ] + } + ] + }, + "type": "InstructionStepsGroup" + } + ] } ] } @@ -248,7 +263,7 @@ }, { "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2022-01-01-preview", + "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'))]", @@ -273,12 +288,23 @@ } } ] - } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_dataConnectorContentId1')]", + "contentKind": "DataConnector", + "displayName": "TheHive Project - TheHive (using Azure Functions)", + "contentProductId": "[variables('_dataConnectorcontentProductId1')]", + "id": "[variables('_dataConnectorcontentProductId1')]", + "version": "[variables('dataConnectorVersion1')]" } }, { "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2022-01-01-preview", + "apiVersion": "2023-04-01-preview", "name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/',concat('DataConnector-', last(split(variables('_dataConnectorId1'),'/'))))]", "dependsOn": [ "[variables('_dataConnectorId1')]" @@ -314,7 +340,7 @@ "kind": "GenericUI", "properties": { "connectorUiConfig": { - "title": "TheHive Project - TheHive (using Azure Function)", + "title": "TheHive Project - TheHive (using Azure Functions)", "publisher": "TheHive Project", "descriptionMarkdown": "The [TheHive](http://thehive-project.org/) data connector provides the capability to ingest common TheHive events into Microsoft Sentinel through Webhooks. TheHive can notify external system of modification events (case creation, alert update, task assignment) in real time. When a change occurs in the TheHive, an HTTPS POST request with event information is sent to a callback data connector URL. Refer to [Webhooks documentation](https://docs.thehive-project.org/thehive/legacy/thehive3/admin/webhooks/) for more information. The connector provides ability to get events which helps to examine potential security risks, analyze your team's use of collaboration, diagnose configuration problems and more.", "graphQueries": [ @@ -341,7 +367,7 @@ "sampleQueries": [ { "description": "TheHive Events - All Activities.", - "query": "TheHive\n | sort by TimeGenerated desc" + "query": "TheHive_CL\n | sort by TimeGenerated desc" } ], "availability": { @@ -419,18 +445,40 @@ ] }, { - "description": "Use this method for automated deployment of the TheHive data connector using an ARM Template.\n\n1. Click the **Deploy to Azure** button below. \n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://aka.ms/sentinel-TheHive-azuredeploy)\n2. Select the preferred **Subscription**, **Resource Group** and **Location**. \n> **NOTE:** Within the same resource group, you can't mix Windows and Linux apps in the same region. Select existing resource group without Windows apps in it or create new resource group.\n3. Enter the **TheHiveBearerToken** and deploy. \n4. Mark the checkbox labeled **I agree to the terms and conditions stated above**. \n5. Click **Purchase** to deploy.\n6. After deploying open Function App page, select your app, go to the **Functions** and click **Get Function Url** copy it and follow p.7 from STEP 1.", - "title": "Option 1 - Azure Resource Manager (ARM) Template" - }, - { - "description": "Use the following step-by-step instructions to deploy the TheHive data connector manually with Azure Functions (Deployment via Visual Studio Code).", - "title": "Option 2 - Manual Deployment of Azure Functions" - }, - { - "description": "**1. Deploy a Function App**\n\n> **NOTE:** You will need to [prepare VS code](https://docs.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.\n\n1. Download the [Azure Function App](https://aka.ms/sentinel-TheHive-functionapp) file. Extract archive to your local development computer.\n2. Start VS Code. Choose File in the main menu and select Open Folder.\n3. Select the top level folder from extracted files.\n4. Choose the Azure icon in the Activity bar, then in the **Azure: Functions** area, choose the **Deploy to function app** button.\nIf you aren't already signed in, choose the Azure icon in the Activity bar, then in the **Azure: Functions** area, choose **Sign in to Azure**\nIf you're already signed in, go to the next step.\n5. Provide the following information at the prompts:\n\n\ta. **Select folder:** Choose a folder from your workspace or browse to one that contains your function app.\n\n\tb. **Select Subscription:** Choose the subscription to use.\n\n\tc. Select **Create new Function App in Azure** (Don't choose the Advanced option)\n\n\td. **Enter a globally unique name for the function app:** Type a name that is valid in a URL path. The name you type is validated to make sure that it's unique in Azure Functions. (e.g. TheHiveXXXXX).\n\n\te. **Select a runtime:** Choose Python 3.8.\n\n\tf. Select a location for new resources. For better performance and lower costs choose the same [region](https://azure.microsoft.com/regions/) where Microsoft Sentinel is located.\n\n6. Deployment will begin. A notification is displayed after your function app is created and the deployment package is applied.\n7. Go to Azure Portal for the Function App configuration." - }, - { - "description": "**2. Configure the Function App**\n\n1. In the Function App, select the Function App Name and select **Configuration**.\n2. In the **Application settings** tab, select ** New application setting**.\n3. Add each of the following application settings individually, with their respective string values (case-sensitive): \n\t\tTheHiveBearerToken\n\t\tWorkspaceID\n\t\tWorkspaceKey\n\t\tlogAnalyticsUri (optional)\n> - Use logAnalyticsUri to override the log analytics API endpoint for dedicated cloud. For example, for public cloud, leave the value empty; for Azure GovUS cloud environment, specify the value in the following format: `https://.ods.opinsights.azure.us`.\n4. Once all application settings have been entered, click **Save**." + "instructions": [ + { + "parameters": { + "instructionSteps": [ + { + "title": "Option 1 - Azure Resource Manager (ARM) Template", + "description": "Use this method for automated deployment of the TheHive data connector using an ARM Template.\n\n1. Click the **Deploy to Azure** button below. \n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)](https://aka.ms/sentinel-TheHive-azuredeploy)\n2. Select the preferred **Subscription**, **Resource Group** and **Location**. \n> **NOTE:** Within the same resource group, you can't mix Windows and Linux apps in the same region. Select existing resource group without Windows apps in it or create new resource group.\n3. Enter the **TheHiveBearerToken** and deploy. \n4. Mark the checkbox labeled **I agree to the terms and conditions stated above**. \n5. Click **Purchase** to deploy.\n6. After deploying open Function App page, select your app, go to the **Functions** and click **Get Function Url** copy it and follow p.7 from STEP 1." + }, + { + "title": "Option 2 - Manual Deployment of Azure Functions", + "description": "Use the following step-by-step instructions to deploy the TheHive data connector manually with Azure Functions (Deployment via Visual Studio Code).", + "instructions": [ + { + "parameters": { + "instructionSteps": [ + { + "title": "Step 1 - Deploy a Function App", + "description": "**NOTE:** You will need to [prepare VS code](https://docs.microsoft.com/azure/azure-functions/functions-create-first-function-python#prerequisites) for Azure function development.\n\n1. Download the [Azure Function App](https://aka.ms/sentinel-TheHive-functionapp) file. Extract archive to your local development computer.\n2. Follow the [function app manual deployment instructions](https://github.com/Azure/Azure-Sentinel/blob/master/DataConnectors/AzureFunctionsManualDeployment.md#function-app-manual-deployment-instructions) to deploy the Azure Functions app using VSCode.\n3. After successful deployment of the function app, follow next steps for configuring it." + }, + { + "title": "Step 2 - Configure the Function App", + "description": "1. Go to Azure Portal for the Function App configuration.\n2. In the Function App, select the Function App Name and select **Configuration**.\n2. In the **Application settings** tab, select ** New application setting**.\n3. Add each of the following application settings individually, with their respective string values (case-sensitive): \n\t\tTheHiveBearerToken\n\t\tWorkspaceID\n\t\tWorkspaceKey\n\t\tlogAnalyticsUri (optional)\n> - Use logAnalyticsUri to override the log analytics API endpoint for dedicated cloud. For example, for public cloud, leave the value empty; for Azure GovUS cloud environment, specify the value in the following format: `https://.ods.opinsights.azure.us`.\n4. Once all application settings have been entered, click **Save**." + } + ] + }, + "type": "InstructionStepsGroup" + } + ] + } + ] + }, + "type": "InstructionStepsGroup" + } + ] } ], "id": "[variables('_uiConfigId1')]", @@ -439,33 +487,15 @@ } }, { - "type": "Microsoft.Resources/templateSpecs", - "apiVersion": "2021-05-01", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", "name": "[variables('parserTemplateSpecName1')]", "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Parser" - }, - "properties": { - "description": "TheHive Data Parser with template", - "displayName": "TheHive Data Parser template" - } - }, - { - "type": "Microsoft.Resources/templateSpecs/versions", - "apiVersion": "2021-05-01", - "name": "[concat(variables('parserTemplateSpecName1'),'/',variables('parserVersion1'))]", - "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Parser" - }, "dependsOn": [ - "[resourceId('Microsoft.Resources/templateSpecs', variables('parserTemplateSpecName1'))]" + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "TheHive Data Parser with template version 2.0.2", + "description": "TheHive Data Parser with template version 3.0.0", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('parserVersion1')]", @@ -474,20 +504,21 @@ "resources": [ { "name": "[variables('_parserName1')]", - "apiVersion": "2020-08-01", + "apiVersion": "2022-10-01", "type": "Microsoft.OperationalInsights/workspaces/savedSearches", "location": "[parameters('workspace-location')]", "properties": { "eTag": "*", "displayName": "TheHive Data Parser", - "category": "Samples", + "category": "Microsoft Sentinel Parser", "functionAlias": "TheHive", - "query": "\nlet TheHive_view = view () { \r\n TheHive_CL\r\n | extend \r\n EventVendor=\"TheHive Project\",\r\n EventProduct=\"TheHive\",\r\n ObjectUpdatedBy=column_ifexists('object_updatedBy_s', ''),\r\n ObjectUpdatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_updatedAt_d', '')),\r\n Operation=column_ifexists('operation_s', ''),\r\n ObjectType=column_ifexists('objectType_s', column_ifexists('object__type_s', '')),\r\n ObjectId=column_ifexists('objectId_s', column_ifexists('object_id_s', '')),\r\n StartDate=unixtime_milliseconds_todatetime(column_ifexists('startDate_d', '')),\r\n RequestId=column_ifexists('requestId_s', ''),\r\n DetailsDescription=column_ifexists('details_description_s', ''),\r\n DetailsFlag=column_ifexists('details_flag_b', ''),\r\n DetailsTitle=column_ifexists('details_title_s', ''),\r\n DetailsStatus=column_ifexists('details_status_s', ''),\r\n DetailsOwner=column_ifexists('details_owner_s', ''),\r\n DetailsCaseId=column_ifexists('details_caseId_d', ''),\r\n DetailsSeverity=column_ifexists('details_severity_d', ''),\r\n DetailsTlp=column_ifexists('details_tlp_d', ''),\r\n DetailsStartDate=unixtime_milliseconds_todatetime(column_ifexists('details_startDate_d', '')),\r\n DetailsTags=column_ifexists('details_tags_s', ''),\r\n Base=column_ifexists('base_b', ''),\r\n RootId=column_ifexists('rootId_s', ''),\r\n ObjectCreatedBy=column_ifexists('object_createdBy_s', ''),\r\n ObjectDescription=column_ifexists('object_description_s', ''),\r\n ObjectFlag=column_ifexists('object_flag_b', ''),\r\n ObjectUser=column_ifexists('object_user_s', ''),\r\n ObjectTitle=column_ifexists('object_title_s', ''),\r\n ObjectStatus=column_ifexists('object_status_s', ''),\r\n ObjectOwner=column_ifexists('object_owner_s', ''),\r\n ObjectCreatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_createdAt_d', '')),\r\n ObjectCaseId=column_ifexists('object_caseId_d', ''),\r\n ObjectSeverity=column_ifexists('object_severity_d', ''),\r\n ObjectTlp=column_ifexists('object_tlp_d', ''),\r\n ObjectStartDate=unixtime_milliseconds_todatetime(column_ifexists('object_startDate_d', '')),\r\n ObjectTags=column_ifexists('object_tags_s', '')\r\n | project\r\n TimeGenerated, \r\n EventVendor,\r\n EventProduct,\r\n ObjectUpdatedBy,\r\n ObjectUpdatedAt,\r\n Operation,\r\n ObjectType,\r\n ObjectId,\r\n StartDate,\r\n RequestId,\r\n DetailsDescription,\r\n DetailsFlag,\r\n DetailsTitle,\r\n DetailsStatus,\r\n DetailsOwner,\r\n DetailsCaseId,\r\n DetailsSeverity,\r\n DetailsTlp,\r\n DetailsStartDate,\r\n DetailsTags,\r\n Base,\r\n RootId,\r\n ObjectCreatedBy,\r\n ObjectDescription,\r\n ObjectFlag,\r\n ObjectUser,\r\n ObjectTitle,\r\n ObjectStatus,\r\n ObjectOwner,\r\n ObjectCreatedAt,\r\n ObjectCaseId,\r\n ObjectSeverity,\r\n ObjectTlp,\r\n ObjectStartDate,\r\n ObjectTags \r\n};\r\nTheHive_view", - "version": 1, + "query": "let TheHive_view = view () { \n TheHive_CL\n | extend \n EventVendor=\"TheHive Project\",\n EventProduct=\"TheHive\",\n ObjectUpdatedBy=column_ifexists('object_updatedBy_s', ''),\n ObjectUpdatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_updatedAt_d', '')),\n Operation=column_ifexists('operation_s', ''),\n ObjectType=column_ifexists('objectType_s', column_ifexists('object__type_s', '')),\n ObjectId=column_ifexists('objectId_s', column_ifexists('object_id_s', '')),\n StartDate=unixtime_milliseconds_todatetime(column_ifexists('startDate_d', '')),\n RequestId=column_ifexists('requestId_s', ''),\n DetailsDescription=column_ifexists('details_description_s', ''),\n DetailsFlag=column_ifexists('details_flag_b', ''),\n DetailsTitle=column_ifexists('details_title_s', ''),\n DetailsStatus=column_ifexists('details_status_s', ''),\n DetailsOwner=column_ifexists('details_owner_s', ''),\n DetailsCaseId=column_ifexists('details_caseId_d', ''),\n DetailsSeverity=column_ifexists('details_severity_d', ''),\n DetailsTlp=column_ifexists('details_tlp_d', ''),\n DetailsStartDate=unixtime_milliseconds_todatetime(column_ifexists('details_startDate_d', '')),\n DetailsTags=column_ifexists('details_tags_s', ''),\n Base=column_ifexists('base_b', ''),\n RootId=column_ifexists('rootId_s', ''),\n ObjectCreatedBy=column_ifexists('object_createdBy_s', ''),\n ObjectDescription=column_ifexists('object_description_s', ''),\n ObjectFlag=column_ifexists('object_flag_b', ''),\n ObjectUser=column_ifexists('object_user_s', ''),\n ObjectTitle=column_ifexists('object_title_s', ''),\n ObjectStatus=column_ifexists('object_status_s', ''),\n ObjectOwner=column_ifexists('object_owner_s', ''),\n ObjectCreatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_createdAt_d', '')),\n ObjectCaseId=column_ifexists('object_caseId_d', ''),\n ObjectSeverity=column_ifexists('object_severity_d', ''),\n ObjectTlp=column_ifexists('object_tlp_d', ''),\n ObjectStartDate=unixtime_milliseconds_todatetime(column_ifexists('object_startDate_d', '')),\n ObjectTags=column_ifexists('object_tags_s', '')\n | project\n TimeGenerated, \n EventVendor,\n EventProduct,\n ObjectUpdatedBy,\n ObjectUpdatedAt,\n Operation,\n ObjectType,\n ObjectId,\n StartDate,\n RequestId,\n DetailsDescription,\n DetailsFlag,\n DetailsTitle,\n DetailsStatus,\n DetailsOwner,\n DetailsCaseId,\n DetailsSeverity,\n DetailsTlp,\n DetailsStartDate,\n DetailsTags,\n Base,\n RootId,\n ObjectCreatedBy,\n ObjectDescription,\n ObjectFlag,\n ObjectUser,\n ObjectTitle,\n ObjectStatus,\n ObjectOwner,\n ObjectCreatedAt,\n ObjectCaseId,\n ObjectSeverity,\n ObjectTlp,\n ObjectStartDate,\n ObjectTags \n};\nTheHive_view\n", + "functionParameters": "", + "version": 2, "tags": [ { "name": "description", - "value": "TheHive Data Parser" + "value": "" } ] } @@ -522,21 +553,39 @@ } } ] - } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_parserContentId1')]", + "contentKind": "Parser", + "displayName": "TheHive Data Parser", + "contentProductId": "[variables('_parsercontentProductId1')]", + "id": "[variables('_parsercontentProductId1')]", + "version": "[variables('parserVersion1')]" } }, { "type": "Microsoft.OperationalInsights/workspaces/savedSearches", - "apiVersion": "2021-06-01", + "apiVersion": "2022-10-01", "name": "[variables('_parserName1')]", "location": "[parameters('workspace-location')]", "properties": { "eTag": "*", "displayName": "TheHive Data Parser", - "category": "Samples", + "category": "Microsoft Sentinel Parser", "functionAlias": "TheHive", - "query": "\nlet TheHive_view = view () { \r\n TheHive_CL\r\n | extend \r\n EventVendor=\"TheHive Project\",\r\n EventProduct=\"TheHive\",\r\n ObjectUpdatedBy=column_ifexists('object_updatedBy_s', ''),\r\n ObjectUpdatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_updatedAt_d', '')),\r\n Operation=column_ifexists('operation_s', ''),\r\n ObjectType=column_ifexists('objectType_s', column_ifexists('object__type_s', '')),\r\n ObjectId=column_ifexists('objectId_s', column_ifexists('object_id_s', '')),\r\n StartDate=unixtime_milliseconds_todatetime(column_ifexists('startDate_d', '')),\r\n RequestId=column_ifexists('requestId_s', ''),\r\n DetailsDescription=column_ifexists('details_description_s', ''),\r\n DetailsFlag=column_ifexists('details_flag_b', ''),\r\n DetailsTitle=column_ifexists('details_title_s', ''),\r\n DetailsStatus=column_ifexists('details_status_s', ''),\r\n DetailsOwner=column_ifexists('details_owner_s', ''),\r\n DetailsCaseId=column_ifexists('details_caseId_d', ''),\r\n DetailsSeverity=column_ifexists('details_severity_d', ''),\r\n DetailsTlp=column_ifexists('details_tlp_d', ''),\r\n DetailsStartDate=unixtime_milliseconds_todatetime(column_ifexists('details_startDate_d', '')),\r\n DetailsTags=column_ifexists('details_tags_s', ''),\r\n Base=column_ifexists('base_b', ''),\r\n RootId=column_ifexists('rootId_s', ''),\r\n ObjectCreatedBy=column_ifexists('object_createdBy_s', ''),\r\n ObjectDescription=column_ifexists('object_description_s', ''),\r\n ObjectFlag=column_ifexists('object_flag_b', ''),\r\n ObjectUser=column_ifexists('object_user_s', ''),\r\n ObjectTitle=column_ifexists('object_title_s', ''),\r\n ObjectStatus=column_ifexists('object_status_s', ''),\r\n ObjectOwner=column_ifexists('object_owner_s', ''),\r\n ObjectCreatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_createdAt_d', '')),\r\n ObjectCaseId=column_ifexists('object_caseId_d', ''),\r\n ObjectSeverity=column_ifexists('object_severity_d', ''),\r\n ObjectTlp=column_ifexists('object_tlp_d', ''),\r\n ObjectStartDate=unixtime_milliseconds_todatetime(column_ifexists('object_startDate_d', '')),\r\n ObjectTags=column_ifexists('object_tags_s', '')\r\n | project\r\n TimeGenerated, \r\n EventVendor,\r\n EventProduct,\r\n ObjectUpdatedBy,\r\n ObjectUpdatedAt,\r\n Operation,\r\n ObjectType,\r\n ObjectId,\r\n StartDate,\r\n RequestId,\r\n DetailsDescription,\r\n DetailsFlag,\r\n DetailsTitle,\r\n DetailsStatus,\r\n DetailsOwner,\r\n DetailsCaseId,\r\n DetailsSeverity,\r\n DetailsTlp,\r\n DetailsStartDate,\r\n DetailsTags,\r\n Base,\r\n RootId,\r\n ObjectCreatedBy,\r\n ObjectDescription,\r\n ObjectFlag,\r\n ObjectUser,\r\n ObjectTitle,\r\n ObjectStatus,\r\n ObjectOwner,\r\n ObjectCreatedAt,\r\n ObjectCaseId,\r\n ObjectSeverity,\r\n ObjectTlp,\r\n ObjectStartDate,\r\n ObjectTags \r\n};\r\nTheHive_view", - "version": 1 + "query": "let TheHive_view = view () { \n TheHive_CL\n | extend \n EventVendor=\"TheHive Project\",\n EventProduct=\"TheHive\",\n ObjectUpdatedBy=column_ifexists('object_updatedBy_s', ''),\n ObjectUpdatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_updatedAt_d', '')),\n Operation=column_ifexists('operation_s', ''),\n ObjectType=column_ifexists('objectType_s', column_ifexists('object__type_s', '')),\n ObjectId=column_ifexists('objectId_s', column_ifexists('object_id_s', '')),\n StartDate=unixtime_milliseconds_todatetime(column_ifexists('startDate_d', '')),\n RequestId=column_ifexists('requestId_s', ''),\n DetailsDescription=column_ifexists('details_description_s', ''),\n DetailsFlag=column_ifexists('details_flag_b', ''),\n DetailsTitle=column_ifexists('details_title_s', ''),\n DetailsStatus=column_ifexists('details_status_s', ''),\n DetailsOwner=column_ifexists('details_owner_s', ''),\n DetailsCaseId=column_ifexists('details_caseId_d', ''),\n DetailsSeverity=column_ifexists('details_severity_d', ''),\n DetailsTlp=column_ifexists('details_tlp_d', ''),\n DetailsStartDate=unixtime_milliseconds_todatetime(column_ifexists('details_startDate_d', '')),\n DetailsTags=column_ifexists('details_tags_s', ''),\n Base=column_ifexists('base_b', ''),\n RootId=column_ifexists('rootId_s', ''),\n ObjectCreatedBy=column_ifexists('object_createdBy_s', ''),\n ObjectDescription=column_ifexists('object_description_s', ''),\n ObjectFlag=column_ifexists('object_flag_b', ''),\n ObjectUser=column_ifexists('object_user_s', ''),\n ObjectTitle=column_ifexists('object_title_s', ''),\n ObjectStatus=column_ifexists('object_status_s', ''),\n ObjectOwner=column_ifexists('object_owner_s', ''),\n ObjectCreatedAt=unixtime_milliseconds_todatetime(column_ifexists('object_createdAt_d', '')),\n ObjectCaseId=column_ifexists('object_caseId_d', ''),\n ObjectSeverity=column_ifexists('object_severity_d', ''),\n ObjectTlp=column_ifexists('object_tlp_d', ''),\n ObjectStartDate=unixtime_milliseconds_todatetime(column_ifexists('object_startDate_d', '')),\n ObjectTags=column_ifexists('object_tags_s', '')\n | project\n TimeGenerated, \n EventVendor,\n EventProduct,\n ObjectUpdatedBy,\n ObjectUpdatedAt,\n Operation,\n ObjectType,\n ObjectId,\n StartDate,\n RequestId,\n DetailsDescription,\n DetailsFlag,\n DetailsTitle,\n DetailsStatus,\n DetailsOwner,\n DetailsCaseId,\n DetailsSeverity,\n DetailsTlp,\n DetailsStartDate,\n DetailsTags,\n Base,\n RootId,\n ObjectCreatedBy,\n ObjectDescription,\n ObjectFlag,\n ObjectUser,\n ObjectTitle,\n ObjectStatus,\n ObjectOwner,\n ObjectCreatedAt,\n ObjectCaseId,\n ObjectSeverity,\n ObjectTlp,\n ObjectStartDate,\n ObjectTags \n};\nTheHive_view\n", + "functionParameters": "", + "version": 2, + "tags": [ + { + "name": "description", + "value": "" + } + ] } }, { @@ -570,33 +619,15 @@ } }, { - "type": "Microsoft.Resources/templateSpecs", - "apiVersion": "2021-05-01", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", "name": "[variables('playbookTemplateSpecName1')]", "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "LogicAppsCustomConnector" - }, - "properties": { - "description": "TheHiveConnector", - "displayName": "TheHiveConnector" - } - }, - { - "type": "Microsoft.Resources/templateSpecs/versions", - "apiVersion": "2021-05-01", - "name": "[concat(variables('playbookTemplateSpecName1'),'/',variables('playbookVersion1'))]", - "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "LogicAppsCustomConnector" - }, "dependsOn": [ - "[resourceId('Microsoft.Resources/templateSpecs', variables('playbookTemplateSpecName1'))]" + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "TheHiveConnector Playbook with template version 2.0.2", + "description": "TheHiveConnector Playbook with template version 3.0.0", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('playbookVersion1')]", @@ -631,7 +662,7 @@ } }, "variables": { - "serviceUrl": "[[uri(concat(parameters('Http Scheme'), '://', parameters('API Hostname'), ':'), parameters('API Port'))]", + "service": "[[concat(parameters('Http Scheme'), '://', parameters('API Hostname'), ':', parameters('API Port'))]", "operationId-create_alert": "create_alert", "_operationId-create_alert": "[[variables('operationId-create_alert')]", "operationId-create_case": "create_case", @@ -647,8 +678,8 @@ "operationId-create_observable_alert": "create_observable_alert", "_operationId-create_observable_alert": "[[variables('operationId-create_observable_alert')]", "workspace-location-inline": "[concat('[resourceGroup().locatio', 'n]')]", - "playbookContentId": "TheHiveConnector", - "playbookId": "[[resourceId('Microsoft.Web/customApis', parameters('ConnectorName'))]", + "playbookContentId1": "TheHiveConnector", + "playbookId1": "[[resourceId('Microsoft.Web/customApis', parameters('ConnectorName'))]", "workspace-name": "[parameters('workspace')]", "workspaceResourceId": "[[resourceId('microsoft.OperationalInsights/Workspaces', variables('workspace-name'))]" }, @@ -712,7 +743,8 @@ "gateway": { "type": "gatewaySetting", "gatewaySettings": { - "dataSourceType": "CustomConnector" + "dataSourceType": "CustomConnector", + "connectionDetails": "[variables('TemplateEmptyArray')]" }, "uiDefinition": { "constraints": { @@ -733,13 +765,14 @@ "displayName": "[[parameters('ConnectorName')]", "iconUri": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAGUAAABzCAYAAACB88xJAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAAEnQAABJ0Ad5mH3gAAAwmSURBVHhe7Z35kyRFHcX9j9Q1QEEkBBVQFDVQwQvxxAvvQFBRPBARL1AxvPAKdEFXMSRUUDG8XRXcnvvo6emd6Tl6uiuzqkZ+bvPVRC+dVa+qK4/qqVn6h09sxM6rzKx6XXl+M+sp/fDxwZR6MTWlhkxNqSFTU2rI1JQaMjWlhkxNqSFTU2rI1JQaMjWlhkxNqSFTU2rI1JQaMjWlhhyaKXLzxwPZvrN2iM59g6C3TMs8KQ7FlGj1/YP9U0+tLdHKe2i5J8XETRGbJ+iDqBty62e0/JNgoqYEUgzihVfSh1A34oUrVXn79D6qZqKmyPbdmZtn9fphETfOTZXtq/Q+qmZipgS9pcH+7IXaTUerH6Taw0JufF8r3/7Mearcs1RbJRMzJVy7Rb9hRb+/RrWHCaqt0TKGqzdRXZVMxBSx+2ftRpObbX+Fag+bYPv3mbKK7YeptiomYkq08g7tJuPZ51NdXYhW3quVN1q6luqqonJTROen2g0C2fk51dYF0V/OlnnjB1RbBZWagi5luo6e9K/OlnD9Dq3c8dxlgyDYoFrfVGqKbH9NuzEQdP9FtXUjkDLTWwxbn6Na31RmStBbUDd1gX5TzZuptq6IzZ9o5Qeie5JqfVKZKeHazdrNxI3zBn2xS7UMsf2bpKpDm8T+bkqS3sr1A7l5D/17HtHia7T7iFbfR3U+qcSUYOeP2o2AcOPbVMvAAxy9Vuz+lepK02+qgeCznyjL2me5jhDsZLvzovMA1fqiElPi5eu0m4jmr6S6POTGPfr1jp2DsHmjlp6JKSBs3qBdHy9elbQ5TOsD76aIznHtBoDc+S3V5iH2TmXSsH5bRFd7S5K0OmZVIu0it++mWh94NSWQvUE8/zKt8BiIMe048HZo6Vi+LWH7Li2deO5SqhuHXE+lM/Mc1ZlZpFpXvJqSfgAg2Jun2nHgzUinhbaBaXMhbwmqRqodA6qrePYFWlrozDCtK95MCXpzSQ9LK/T67VRblvTbgraB6fLIzCbMnJ8YxbRlYLMTYucRqnXBmylR86NaYTEC7st9qi2L69uCqmr0WrzJTGdCtPRGLc1o+S1U54IXU9jMKgIjmNYU2wdLDXV4S4awLnK4eS/V2uLFFPxaRgsZLb2Z6mxIVxm2pphWfUWEax/X0o7nXzwIgi2qtcHZFLwRowUEous42EsxHGckPTCDXzvGI8l1C2qc5OEtGXLQRX7amfsFcv0OqrXBzRSxO4gXrtAKh18R1XoGsVli61fqzfmy6na/cxC2Pq3eqhPq/2eo3jey/XXtvv/XeMYg6P6Hak1xMgUPZLRg8cwF6jVuU61Phm9AHvHS65J2jl3ri6SLPP8SLV9fMQfWpuAXGTeeqRUqPP0tqvVGvzWI5l6k5VlE2PoMT8cTtIus3l6mNcHalKh5k1aYaOEqqvOG2NHyK0vVayDxytu1/DCr3A/dhgJWpiCQYLQgQGw/SLW+iBauzuRZlmD3nzRNH9AussGMOMPKlGjpTVohqo7fCk9/U8vPFLQxfdGjafsg00WevUj10FaotgzGpsjNH2kF2D/19EGw91+q9UU8//JUnub4Gswy0EWOG8/S8gtbn6LaMpiZIrZVQ3u5nnn7S1zrCTZtbkPUvIGm74t0FxkEO3+i2nEYmRKuf1HLNFIj2b6srloAGHuM5mmN5ZR9WQ66yPobHalOANOOo7QpQfcx9Yqeo2UqO/dRrU/SS8O2oJ5n6fuEdpE7x6m2iNKmhGuf1DKLlq+jOu+Irnqgl2h524CNSjR9z2S6yCvvoroiSpuSiUhXDRvCiJjWN4hO1PK2gKXrmwABGplYMfMBbPk2JVCNfGpaIWx+mGsrQG7dn+lklCFcfjdNrwrCtVu1vDHjYTMXZ9TQiw4JTlN1PtNWRbDziOrp3Kmqz7dlVjpBPH+5eji3qLLen/TcWBpVIPYeVfnrM8fh+heodhxGpoBMBP3iq6nuyUakag3tucxdoqozu9hjY1OwVjKaOZBqxM20TxZ48OF3qLYMxqaAqKVPnaMaqSrc5iiQrj2ihVep8VtEtWWwMqUftNVg7DK9IM2PcO1Zjtx6QHsOQHbctnvbmaKQGz/MFsYwEvJsIF58rfYMouW3Up0J1qYABEhoBVIFZLqzlezkLHqjv6NaE5xMEaSBk1WtPgqp8vuD6mZ+fhAE61wzAqY30Nj6WjfPIHrZ+ITmh7jWECdTQHr6Zd9zjK3Y/vUgXL1xEM8+N0k/WRshOsawTNH8FckKpOj+nepsoLPCnnapOZsS9FdVn/xirXCIlmTasmAghhnpWD3M0XSByRp42PxY5vpo8RrVHqo3yHIMATCdMvyRDAlbt1KtDc6mALnxXa2AwKbRl6o+xipmOq0hyW4wcl0eYu8xmk7C3KUH4yuLpYdw7TY9rdkLlVH+Zg+8mALSwdjx0uupjiE2j2euZ4St2+j1suDwgfTWjDTxwkuTniS7lnFg9DEtDWy4ZVpbvJkidh7SCgqCMevUCKiLVj+QuS6PvAa+aHqcRXAyosVr1T2MXylMh8Oiiu2LPaq1xZspIByNvJ99XuEMqdz6hdE6SV50O4zF33MDFcR2Jq0isH++6EipJN5t9qIzenSLmc4Fr6YAzIyiR5ZbpagbRojp6IMoQ14DL1u3J38vihVgDX4RiGErahMxM46Zaqw0sr+74t2UIkT332oEfA19EEVgHYWlB84sKql/2d8BxjfpNMvgM2jbhImZggMz49RWt7LInBOPsGai6TonqA6Ma/DzsN1r6cJETMHAjd1wKRrH8hv4xTdo2qIHyAZ7ZUHAyKSi+UHlprierJq35BzsnqT6QFWRVN+bp3oTkAZL2zeVmuLjqNu8LQ3omubB9ADr9SwPEyZhTGWm+DAE1RNL2xYca8vyMaJxbuXGVGKKr8OgTUbapVDd8fTinA3oNFRpjHdTnBr1EWI1+MSeFJaHC9JX+RAwEmzTPFzxagq6vewGbMib53IFe1VYfjaEq37WT9J4MyUZGFqOQxhIj+Xjg/T+Gheq2HXgxxScFWkxUs8jXC6YYGzflUxxPPFvPux6wOILXLAJ4i7Ciyn4tbDC2oIIEZYPVjSZPo+8jwhggcvnWx3PXqwGuC2alw3OpuDY8fQuJhcwFd6TMc0rff7LOJL4K5IOiAwnKcdhG6LKcDYlSp0V6UrRof8YI7BrihDdf9C0JDlPxoUkIHHPzy4EJ1OwfYwV0Bqc2pATdIF2AHNbxhScyRJ5/myIr337TqZEK+7TFqMgSJrlUxXh6eynQ5xoHEuWi1leJjiZMroC5wMfgWwmJGcnk3K4ULR8UBZrU3zfULR4Nc2natInqbpS1BUvi70pW7+khbJFnnY7pcEWHDfIymMLjkdh+ZhgbYogsV7WqC618aGdHknHRLuAzgXLwwT7N8XjHFLur6vfUl3avylOJotXQffRgeg1krERup/oqSGKJQjWktVJDAqDoDMIxI5i7yDQTgo17glVevmH2MhOdqu1LT4O6LFv6EUv6cKygpkid/hCVnpzkiu50+1qsIqgPHaNKQidonkYYG+KAsHWrGAmFDXw+2SjqQsIfWL5gPD0N+g1pvgIbncyhe1iMiVv+RZfI2J6V/LOqEe1F8+9kF5TFuxKZmmb4mQKSH+/ygRRcJo2zoVk17giN75H8wPpDx8YMXNOUqWzdE1xNgXQQo6hqJeSHNqZCobwCctziO1Sts+9L15MAdKgTvb1mleFiTFx4/xkYxNLxxZvpgDsJz/YmKlvFRiC6PiibQt1AiNzBKmz+xiCmGh2rSteTTmDqltRTWDHFA67EWr0jw9wUm2NwdfqYE649gn1g7o+OaEIM8EINi+z79KWakyZ4sTUlBpSO1OwrMrqb98g/ovlXwdqZ4owDI6wxcdiVFXUsvrCIQHsQfrC56dEqqCWprBNrT7Bl05ZvnWhtg19vGh/jHoR+HJRIAOaZ12orSli9y/JfBJ7sC5UtXnUJ7U1BcjNe+mDteWonOBXa1OAr60LVX9LxSe1NwWYhqumQRQnS7euHAlTAA4bwHkv7KHngbMdxa7dRwAOkyNjyhAc8hYtvCLZRs2MwGdpYZ6PoLjD4siZcgaclLfXSGagMZOLozl8Hv52mBxdU85ipqbUkKkpNWRqSg2ZmlJDpqbUjscH/wfV/O1o6PFdEQAAAABJRU5ErkJggg==", "backendService": { - "serviceUrl": "[[variables('serviceUrl')]" + "serviceUrl": "[[variables('service')]" }, "apiType": "Rest", "swagger": { "swagger": "2.0", "info": { "title": "Default title", + "description": "[variables('blanks')]", "version": "1.0" }, "host": "[[concat(parameters('API Hostname'), ':', parameters('API Port'))]", @@ -747,6 +780,8 @@ "schemes": [ "[[parameters('Http Scheme')]" ], + "consumes": "[variables('TemplateEmptyArray')]", + "produces": "[variables('TemplateEmptyArray')]", "paths": { "/api/alert": { "post": { @@ -1778,17 +1813,20 @@ } }, "security": [ - {} - ] + { + "basic_auth": "[variables('TemplateEmptyArray')]" + } + ], + "tags": "[variables('TemplateEmptyArray')]" } } }, { "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", "apiVersion": "2022-01-01-preview", - "name": "[[concat(variables('workspace-name'),'/Microsoft.SecurityInsights/',concat('LogicAppsCustomConnector-', last(split(variables('playbookId'),'/'))))]", + "name": "[[concat(variables('workspace-name'),'/Microsoft.SecurityInsights/',concat('LogicAppsCustomConnector-', last(split(variables('playbookId1'),'/'))))]", "properties": { - "parentId": "[[variables('playbookId')]", + "parentId": "[[variables('playbookId1')]", "contentId": "[variables('_playbookContentId1')]", "kind": "LogicAppsCustomConnector", "version": "[variables('playbookVersion1')]", @@ -1810,37 +1848,30 @@ } } ] - } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId1')]", + "contentKind": "LogicAppsCustomConnector", + "displayName": "TheHiveConnector", + "contentProductId": "[variables('_playbookcontentProductId1')]", + "id": "[variables('_playbookcontentProductId1')]", + "version": "[variables('playbookVersion1')]" } }, { - "type": "Microsoft.Resources/templateSpecs", - "apiVersion": "2021-05-01", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", "name": "[variables('playbookTemplateSpecName2')]", "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Playbook" - }, - "properties": { - "description": "TheHive-CreateAlert playbook", - "displayName": "TheHive-CreateAlert playbook" - } - }, - { - "type": "Microsoft.Resources/templateSpecs/versions", - "apiVersion": "2021-05-01", - "name": "[concat(variables('playbookTemplateSpecName2'),'/',variables('playbookVersion2'))]", - "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Playbook" - }, "dependsOn": [ - "[resourceId('Microsoft.Resources/templateSpecs', variables('playbookTemplateSpecName2'))]" + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "TheHive-CreateAlert Playbook with template version 2.0.2", + "description": "TheHive-CreateAlert Playbook with template version 3.0.0", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('playbookVersion2')]", @@ -1898,6 +1929,8 @@ }, "displayName": "[[variables('TheHiveConnectionName')]", "parameterValues": { + "username": "[variables('blanks')]", + "password": "[variables('blanks')]", "authType": "basic", "gateway": { "id": "[[concat('/subscriptions/',subscription().subscriptionId,'/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Web/connectionGateways/',parameters('onPremiseGatewayName'))]" @@ -2121,7 +2154,7 @@ "description": "Once a new Microsoft Sentinel incident is created, this playbook gets triggered and performs the following actions:\n 1. Parses alert extended properties. \n 2. Parses alert custom details.\n 3. Creates alert in TheHive with description, source, sourceRef, title and type passed.", "prerequisites": [ "1. TheHive API Connector has to be deployed prior to the deployment of this playbook under the same subscription.", - "2. Data gateway should be deployed under the same subscription and resource group as playbooks.", + "2. Data gateway should be deployed under the same subscription and resource group as playbooks.", "3. TheHive API credentials are required. Refer to the TheHive API Connector documentation." ], "postDeployment": [ @@ -2151,37 +2184,30 @@ } ] } - } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId2')]", + "contentKind": "Playbook", + "displayName": "TheHive-CreateAlert", + "contentProductId": "[variables('_playbookcontentProductId2')]", + "id": "[variables('_playbookcontentProductId2')]", + "version": "[variables('playbookVersion2')]" } }, { - "type": "Microsoft.Resources/templateSpecs", - "apiVersion": "2021-05-01", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", "name": "[variables('playbookTemplateSpecName3')]", "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Playbook" - }, - "properties": { - "description": "TheHive-CreateCase playbook", - "displayName": "TheHive-CreateCase playbook" - } - }, - { - "type": "Microsoft.Resources/templateSpecs/versions", - "apiVersion": "2021-05-01", - "name": "[concat(variables('playbookTemplateSpecName3'),'/',variables('playbookVersion3'))]", - "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Playbook" - }, "dependsOn": [ - "[resourceId('Microsoft.Resources/templateSpecs', variables('playbookTemplateSpecName3'))]" + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "TheHive-CreateCase Playbook with template version 2.0.2", + "description": "TheHive-CreateCase Playbook with template version 3.0.0", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('playbookVersion3')]", @@ -2239,6 +2265,8 @@ }, "displayName": "[[variables('TheHiveConnectionName')]", "parameterValues": { + "username": "[variables('blanks')]", + "password": "[variables('blanks')]", "authType": "basic", "gateway": { "id": "[[concat('/subscriptions/',subscription().subscriptionId,'/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Web/connectionGateways/',parameters('onPremiseGatewayName'))]" @@ -2483,7 +2511,7 @@ "description": "Once a new Microsoft Sentinel incident is created, this playbook gets triggered and performs the following actions:\n 1. Creates case in TheHive instance with enriched description and title.\n2. Gets Hosts, IPs entities.\n3. Creates task and bind it to case.\n4. Creates observables with hosts and IPs for created case.", "prerequisites": [ "1. TheHive API Connector has to be deployed prior to the deployment of this playbook under the same subscription.", - "2. Data gateway should be deployed under the same subscription and resource group as playbooks.", + "2. Data gateway should be deployed under the same subscription and resource group as playbooks.", "3. TheHive API credentials are required. Refer to the TheHive API Connector documentation." ], "postDeployment": [ @@ -2517,37 +2545,30 @@ } ] } - } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId3')]", + "contentKind": "Playbook", + "displayName": "TheHive-CreateCase", + "contentProductId": "[variables('_playbookcontentProductId3')]", + "id": "[variables('_playbookcontentProductId3')]", + "version": "[variables('playbookVersion3')]" } }, { - "type": "Microsoft.Resources/templateSpecs", - "apiVersion": "2021-05-01", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentTemplates", + "apiVersion": "2023-04-01-preview", "name": "[variables('playbookTemplateSpecName4')]", "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Playbook" - }, - "properties": { - "description": "TheHive-LockUser playbook", - "displayName": "TheHive-LockUser playbook" - } - }, - { - "type": "Microsoft.Resources/templateSpecs/versions", - "apiVersion": "2021-05-01", - "name": "[concat(variables('playbookTemplateSpecName4'),'/',variables('playbookVersion4'))]", - "location": "[parameters('workspace-location')]", - "tags": { - "hidden-sentinelWorkspaceId": "[variables('workspaceResourceId')]", - "hidden-sentinelContentType": "Playbook" - }, "dependsOn": [ - "[resourceId('Microsoft.Resources/templateSpecs', variables('playbookTemplateSpecName4'))]" + "[extensionResourceId(resourceId('Microsoft.OperationalInsights/workspaces', parameters('workspace')), 'Microsoft.SecurityInsights/contentPackages', variables('_solutionId'))]" ], "properties": { - "description": "TheHive-LockUser Playbook with template version 2.0.2", + "description": "TheHive-LockUser Playbook with template version 3.0.0", "mainTemplate": { "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "[variables('playbookVersion4')]", @@ -2605,6 +2626,8 @@ }, "displayName": "[[variables('TheHiveConnectionName')]", "parameterValues": { + "username": "[variables('blanks')]", + "password": "[variables('blanks')]", "authType": "basic", "gateway": { "id": "[[concat('/subscriptions/',subscription().subscriptionId,'/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Web/connectionGateways/',parameters('onPremiseGatewayName'))]" @@ -2957,7 +2980,7 @@ "description": "Once a new Microsoft Sentinel incident is created, this playbook gets triggered and performs the following actions:\n 1. Parses alerts custom details \n 2. Locks Users by UserId or UserLogin passed from alert.", "prerequisites": [ "1. TheHive API Connector has to be deployed prior to the deployment of this playbook under the same subscription.", - "2. Data gateway should be deployed under the same subscription and resource group as playbooks.", + "2. Data gateway should be deployed under the same subscription and resource group as playbooks.", "3. TheHive API credentials are required. Refer to the TheHive API Connector documentation." ], "postDeployment": [ @@ -2987,17 +3010,35 @@ } ] } - } + }, + "packageKind": "Solution", + "packageVersion": "[variables('_solutionVersion')]", + "packageName": "[variables('_solutionName')]", + "packageId": "[variables('_solutionId')]", + "contentSchemaVersion": "3.0.0", + "contentId": "[variables('_playbookContentId4')]", + "contentKind": "Playbook", + "displayName": "TheHive-LockUser", + "contentProductId": "[variables('_playbookcontentProductId4')]", + "id": "[variables('_playbookcontentProductId4')]", + "version": "[variables('playbookVersion4')]" } }, { - "type": "Microsoft.OperationalInsights/workspaces/providers/metadata", - "apiVersion": "2022-01-01-preview", + "type": "Microsoft.OperationalInsights/workspaces/providers/contentPackages", + "apiVersion": "2023-04-01-preview", "location": "[parameters('workspace-location')]", "properties": { - "version": "2.0.2", + "version": "3.0.0", "kind": "Solution", - "contentSchemaVersion": "2.0.0", + "contentSchemaVersion": "3.0.0", + "displayName": "TheHive", + "publisherDisplayName": "Microsoft Sentinel, Microsoft Corporation", + "descriptionHtml": "

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

\n

TheHive solution provides the capability to ingest common The Hive events into Microsoft Sentinel through Webhooks. The Hive can notify external system of modification events (case creation, alert update, task assignment) in real time. When a change occurs in The Hive, an HTTPS POST request with event information is sent to a callback data connector URL. Refer to Webhooks documentation for more information.

\n

Underlying Microsoft Technologies used:

\n

This solution takes a dependency on the following technologies, and some of these dependencies either may be in Preview state or might result in additional ingestion or operational costs:

\n
    \n
  1. Azure Monitor HTTP Data Collector API b. Azure Functions
    2. \n
\n

Data Connectors: 1, Parsers: 1, Custom Azure Logic Apps Connectors: 1, Playbooks: 3

\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": { diff --git a/Solutions/TheHive/Playbooks/TheHiveConnector/azuredeploy.json b/Solutions/TheHive/Playbooks/TheHiveConnector/azuredeploy.json index 12d7c373cc1..9dfc6cafedd 100644 --- a/Solutions/TheHive/Playbooks/TheHiveConnector/azuredeploy.json +++ b/Solutions/TheHive/Playbooks/TheHiveConnector/azuredeploy.json @@ -31,7 +31,7 @@ } }, "variables": { - "serviceUrl": "[uri(parameters('Http Scheme'), '://', parameters('API Hostname'), ':', parameters('API Port'))]" + "serviceUrl": "[concat(parameters('Http Scheme'), '://', parameters('API Hostname'), ':', parameters('API Port'))]" }, "resources":[ { diff --git a/Solutions/TheHive/ReleaseNotes.md b/Solutions/TheHive/ReleaseNotes.md new file mode 100644 index 00000000000..6c1f40e5e37 --- /dev/null +++ b/Solutions/TheHive/ReleaseNotes.md @@ -0,0 +1,4 @@ +| **Version** | **Date Modified (DD-MM-YYYY)** | **Change History** | +|-------------|--------------------------------|--------------------------------------------------------------------| +| 3.0.0 | 05-09-2023 | Manual deployment instructions updated for **Data Connector** | +