🚫 ⚠️ [Deprecated] WithSecure Elements via Connector
⚠️ Unpublished: This item is from a solution that is not yet published on Azure Marketplace or not installed in Content Hub.
🚫 Deprecated: This connector has been deprecated and may be removed in future versions.
Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · 📊
| Attribute | Value |
|---|---|
| Connector ID | WithSecureElementsViaConnector |
| Publisher | WithSecure |
| Used in Solutions | WithSecureElementsViaConnector |
| Collection Method | MMA |
| Connector Definition Files | WithSecureElementsViaConnector.json |
WithSecure Elements is a unified cloud-based cyber security platform.
By connecting WithSecure Elements via Connector to Microsoft Sentinel, security events can be received in Common Event Format (CEF) over syslog.
It requires deploying "Elements Connector" either on-prem or in cloud.
The Common Event Format (CEF) provides natively search & correlation, alerting and threat intelligence enrichment for each data log.
Tables Ingested
This connector ingests data into the following tables:
| Table | Selection Criteria | Transformations | Ingestion API | Lake-Only |
|---|---|---|---|---|
CommonSecurityLog |
DeviceVendor == "WithSecure™" |
✓ | ✓ | ? |
💡 Tip: Tables with Ingestion API support allow data ingestion via the Azure Monitor Data Collector API, which also enables custom transformations during ingestion.
Permissions
Resource Provider Permissions: - Workspace (Workspace): read and write permissions are required. - Keys (Workspace): read permissions to shared keys for the workspace are required. See the documentation to learn more about workspace keys.
Setup Instructions
⚠️ Note: These instructions were automatically generated from the connector's user interface definition file using AI and may not be fully accurate. Please verify all configuration steps in the Microsoft Sentinel portal.
1. Linux Syslog agent configuration
Install and configure the Linux agent to collect your Common Event Format (CEF) Syslog messages and forward them to Microsoft Sentinel.
Notice that the data from all regions will be stored in the selected workspace 1.1 Select or create a Linux machine
Select or create a Linux machine that Microsoft Sentinel will use as the proxy between your WithSecurity solution and Sentinel. The machine can be on-prem environment, Microsoft Azure or other cloud based.
Linux needs to have
syslog-ngandpython/python3installed.
1.2 Install the CEF collector on the Linux machine
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.
Make sure that you have Python on your machine using the following command: python -version.
You must have elevated permissions (sudo) on your machine. - Run the following command to install and apply the CEF collector::
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}- For python3 use command below::sudo wget -O cef_installer.py https://raw.githubusercontent.com/Azure/Azure-Sentinel/master/DataConnectors/CEF/cef_installer.py&&sudo python3 cef_installer.py {0} {1}2. Forward data from WithSecure Elements Connector to Syslog agent
This describes how to install and configure Elements Connector step by step. 2.1 Order Connector subscription
If Connector subscription has not been ordered yet go to EPP in Elements Portal. Then navigate to Downloads and in Elements Connector section click 'Create subscription key' button. You can check Your subscription key in Subscriptions.
2.2 Download Connector
Go to Downloads and in WithSecure Elements Connector section select correct installer.
2.3 Create management API key
When in EPP open account settings in top right corner. Then select Get management API key. If key has been created earlier it can be read there as well.
2.4 Install Connector
To install Elements Connector follow Elements Connector Docs.
2.5 Configure event forwarding
If api access has not been configured during installation follow Configuring API access for Elements Connector. Then go to EPP, then Profiles, then use For Connector from where you can see the connector profiles. Create a new profile (or edit an existing not read-only profile). In Event forwarding enable it. SIEM system address: 127.0.0.1:514. Set format to Common Event Format. Protocol is TCP. Save profile and assign it to Elements Connector in Devices tab. 3. Validate connection
Follow the instructions to validate your connectivity:
Open Log Analytics to check if the logs are received using the CommonSecurityLog schema.
It may take about 20 minutes until the connection streams data to your workspace.
If the logs are not received, run the following connectivity validation script:
Make sure that you have Python on your machine using the following command: python -version
You must have elevated permissions (sudo) on your machine - Run the following command to validate your connectivity::
sudo wget -O cef_troubleshoot.py https://raw.githubusercontent.com/Azure/Azure-Sentinel/master/DataConnectors/CEF/cef_troubleshoot.py&&sudo python cef_troubleshoot.py {0}- For python3 use command below::sudo wget -O cef_troubleshoot.py https://raw.githubusercontent.com/Azure/Azure-Sentinel/master/DataConnectors/CEF/cef_troubleshoot.py&&sudo python3 cef_troubleshoot.py {0}
4. Secure your machine
Make sure to configure the machine's security according to your organization's security policy
Additional Documentation
📄 Source: WithSecureElementsViaConnector\Data Connectors\WithSecureElementsViaConnnector.md
Connect your WithSecure Elements Connector to Microsoft Sentinel
This article explains how to connect your WithSecure Elements Connector appliance to Microsoft Sentinel. The WithSecure Elements Connector data connector allows you to easily connect your WithSecure Elements logs with Microsoft Sentinel, to view dashboards, create custom alerts, and improve investigation.
Note: Data will be stored in the geographic location of the workspace on which you are running Microsoft Sentinel.
Forward WithSecure Elements logs to the Syslog agent
Configure With Secure Elements Connector to forward Syslog messages in CEF format to your Log Analytics workspace via the Syslog agent.
1. Select or create a Linux machine that Microsoft Sentinel will use as the proxy between your WithSecurity solution and Sentinel. The machine can be on-prem environment, Microsoft Azure or other cloud based. Linux needs to have syslog-ng and python/python3 installed.
2. 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. You must have elevated permissions (sudo) on your machine.
3. Go to EPP in WithSecure Elements Portal. Then navigate to Downloads and in Elements Connector section click 'Create subscription key' button. You can check Your subscription key in Subscriptions.
4. In Downloads in WithSecure Elements Connector section select correct installer and download it.
5. When in EPP open account settings in top right corner. Then select Get management API key. If key has been created earlier it can be read there as well.
6. To install Elements Connector follow Elements Connector Docs.
7. If api access has not been configured during installation follow Configuring API access for Elements Connector.
8. Go to EPP, then Profiles, then use For Connector from where you can see the connector profiles. Create a new profile (or edit an existing not read-only profile). In Event forwarding enable it. SIEM system address: 127.0.0.1:514. Set format to Common Event Format. Protocol is TCP. Save profile and assign it to Elements Connector in Devices tab.
9. To use the relevant schema in Log Analytics for the WithSecure Elements Connector, search for CommonSecurityLog.
10. Continue with validating your CEF connectivity.
Next steps
In this document, you learned how to connect WithSecurity Elements Connector to Microsoft Sentinel. To learn more about Microsoft Sentinel, see the following articles: - Learn how to get visibility into your data, and potential threats. - Get started detecting threats with Microsoft Sentinel. - Use workbooks to monitor your data.
Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · 📊