|
| 1 | +--- |
| 2 | +title: "Blackberry CylancePROTECT connector for Microsoft Sentinel" |
| 3 | +description: "Learn how to install the connector Blackberry CylancePROTECT to connect your data source to Microsoft Sentinel." |
| 4 | +author: cwatson-cat |
| 5 | +ms.topic: how-to |
| 6 | +ms.date: 04/26/2024 |
| 7 | +ms.service: microsoft-sentinel |
| 8 | +ms.author: cwatson |
| 9 | +ms.collection: sentinel-data-connector |
| 10 | +--- |
| 11 | + |
| 12 | +# Blackberry CylancePROTECT connector for Microsoft Sentinel |
| 13 | + |
| 14 | +The [Blackberry CylancePROTECT](https://www.blackberry.com/us/en/products/blackberry-protect) connector allows you to easily connect your CylancePROTECT logs with Microsoft Sentinel. This gives you more insight into your organization's network and improves your security operation capabilities. |
| 15 | + |
| 16 | +This is autogenerated content. For changes, contact the solution provider. |
| 17 | + |
| 18 | +## Connector attributes |
| 19 | + |
| 20 | +| Connector attribute | Description | |
| 21 | +| --- | --- | |
| 22 | +| **Log Analytics table(s)** | Syslog (CylancePROTECT)<br/> | |
| 23 | +| **Data collection rules support** | [Workspace transform DCR](/azure/azure-monitor/logs/tutorial-workspace-transformations-portal) | |
| 24 | +| **Supported by** | [Microsoft Corporation](https://support.microsoft.com) | |
| 25 | + |
| 26 | +## Query samples |
| 27 | + |
| 28 | +**Top 10 Event Types** |
| 29 | + |
| 30 | + ```kusto |
| 31 | +CylancePROTECT |
| 32 | + |
| 33 | + | summarize count() by EventName |
| 34 | + |
| 35 | + | top 10 by count_ |
| 36 | + ``` |
| 37 | + |
| 38 | +**Top 10 Triggered Policies** |
| 39 | + |
| 40 | + ```kusto |
| 41 | +CylancePROTECT |
| 42 | + |
| 43 | + | where EventType == "Threat" |
| 44 | + |
| 45 | + | summarize count() by PolicyName |
| 46 | + |
| 47 | + | top 10 by count_ |
| 48 | + ``` |
| 49 | + |
| 50 | + |
| 51 | + |
| 52 | +## Prerequisites |
| 53 | + |
| 54 | +To integrate with Blackberry CylancePROTECT make sure you have: |
| 55 | + |
| 56 | +- **CylancePROTECT**: must be configured to export logs via Syslog. |
| 57 | + |
| 58 | + |
| 59 | +## Vendor installation instructions |
| 60 | + |
| 61 | + |
| 62 | +> [!NOTE] |
| 63 | + > 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 CyclanePROTECT and load the function code or click [here](https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/Blackberry%20CylancePROTECT/Parsers/CylancePROTECT.txt), on the second line of the query, enter the hostname(s) of your CyclanePROTECT device(s) and any other unique identifiers for the logstream. The function usually takes 10-15 minutes to activate after solution installation/update. |
| 64 | +
|
| 65 | +1. Install and onboard the agent for Linux |
| 66 | + |
| 67 | +Typically, you should install the agent on a different computer from the one on which the logs are generated. |
| 68 | + |
| 69 | +> Syslog logs are collected only from **Linux** agents. |
| 70 | +
|
| 71 | + |
| 72 | +2. Configure the logs to be collected |
| 73 | + |
| 74 | +Configure the facilities you want to collect and their severities. |
| 75 | + |
| 76 | +1. Select the link below to open your workspace **agents configuration**, and select the **Syslog** tab. |
| 77 | +2. Select **Add facility** and choose from the drop-down list of facilities. Repeat for all the facilities you want to add. |
| 78 | +3. Mark the check boxes for the desired severities for each facility. |
| 79 | +4. Click **Apply**. |
| 80 | + |
| 81 | + |
| 82 | +3. Configure and connect the CylancePROTECT |
| 83 | + |
| 84 | +[Follow these instructions](https://docs.blackberry.com/) to configure the CylancePROTECT to forward syslog. Use the IP address or hostname for the Linux device with the Linux agent installed as the Destination IP address. |
| 85 | + |
| 86 | + |
| 87 | + |
| 88 | +## Next steps |
| 89 | + |
| 90 | +For more information, go to the [related solution](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/azuresentinel.azure-sentinel-solution-blackberrycylanceprotect?tab=Overview) in the Azure Marketplace. |
0 commit comments