Skip to content

Commit c7f81f7

Browse files
authored
Merge pull request #260149 from batamig/remove-horizon
D4IoT removing horizon
2 parents 41d8040 + 3a8a360 commit c7f81f7

8 files changed

+37
-137
lines changed

.openpublishing.redirection.defender-for-iot.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path_from_root": "/articles/defender-for-iot/organizations/resources-manage-proprietary-protocols.md",
5+
"redirect_url": "/azure/defender-for-iot/organizations/how-to-manage-individual-sensors#manage-custom-plugins-legacy",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path_from_root": "/articles/defender-for-iot/organizations/how-to-set-up-high-availability.md",
510
"redirect_url": "/azure/defender-for-iot/organizations/legacy-central-management/how-to-set-up-high-availability",

articles/defender-for-iot/organizations/TOC.yml

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -288,9 +288,6 @@
288288
displayName: activation, time zone, SMTP, PCAP, SSH, ERSPAN
289289
- name: Configure SNMP monitoring
290290
href: how-to-set-up-snmp-mib-monitoring.md
291-
- name: Add support for proprietary protocols
292-
href: resources-manage-proprietary-protocols.md
293-
displayName: Horizon
294291
- name: Maintain threat intelligence packages
295292
href: how-to-work-with-threat-intelligence-packages.md
296293
- name: Troubleshoot OT sensors

articles/defender-for-iot/organizations/api/sensor-inventory-apis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -639,7 +639,7 @@ This section lists the supported fields for the [protocols](#protocol) object in
639639
| Name | Type | Nullable / Not nullable | List of values |
640640
|--|--|--|--|
641641
| **id** | Numeric. Defines the protocol's internal ID. | Not nullable | - |
642-
|<a name="protocol-name"></a>**name** |String. Defines the device name. |Not nullable | For more information, see below. <br><br>**Note**: To extend Defender for IoT support to proprietary protocols, create a Horizon plugin. For more information, see [Extend support to proprietary protocols](../overview.md#extend-support-to-proprietary-ot-protocols).|
642+
|<a name="protocol-name"></a>**name** |String. Defines the device name. |Not nullable | For more information, see below. |
643643
|**ipAddresses** | JSON array of strings of protocol IP addresses. |Not nullable | - |
644644

645645
The following values are supported as [protocol names](#protocol-name) out-of-the-box:

articles/defender-for-iot/organizations/concept-supported-protocols.md

Lines changed: 2 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Protocols supported by Microsoft Defender for IoT
33
description: Learn about protocols that Microsoft Defender for IoT supports.
4-
ms.date: 08/31/2023
4+
ms.date: 12/04/2023
55
ms.topic: concept-article
66
ms.custom: enterprise-iot
77
---
88

99
# Microsoft Defender for IoT - supported IoT, OT, ICS, and SCADA protocols
1010

11-
This article lists the protocols that are supported by default in Microsoft Defender for IoT. If your organization uses proprietary protocols or other protocols not listed here, use the Defender for IoT Horizon SDK to extend support as needed.
11+
This article lists the protocols that are supported by default in Microsoft Defender for IoT.
1212

1313
## Supported protocols for OT device discovery
1414

@@ -32,7 +32,6 @@ OT network sensors can detect the following protocols when identifying assets an
3232
|**ISO** | CLNP (ISO 8473)<br> COTP (ISO 8073)<br> ISO Industrial Protocol<br> MQTT (IEC 20922) |
3333
| **Jenesys** |FOX <br>Niagara |
3434
|**Medical** |ASTM<br> HL7 <br> DICOM <br> POCT1 |
35-
|**Microsoft** | Horizon community dissectors<br> Horizon proprietary dissectors (developed by customers) |
3635
|**Mitsubishi** | Melsoft / Melsec (Mitsubishi Electric) |
3736
|**Omron** | FINS <br>HTTP |
3837
|**OPC** | AE <br>Common <br> DA <br>HDA <br> UA |
@@ -65,23 +64,6 @@ Enterprise IoT network sensors can detect the following protocols when identifyi
6564
|**Medical** |DICOM <br>HL7 <br>POCT1 |
6665
| **SWARM** | swarm |
6766

68-
## Don't see your protocol here?
69-
70-
### Build support for proprietary OT protocols with the Horizon SDK
71-
72-
Asset vendors, partners, or platform owners can use Defender for IoT's Horizon Protocol SDK to secure any OT protocol used in IoT and ICS environments that's not isn't already supported by default.
73-
74-
Horizon helps you to write plugins for OT sensors that enable Deep Packet Inspection (DPI) on the traffic and detect threats in real-time. Customize your plugins localize and customize text for alerts, events, and protocol parameters.
75-
76-
Horizon provides:
77-
78-
- Support for common, proprietary, or custom protocols that deviate from standards
79-
- Extra flexibility and scope for DPI development
80-
- Extra visibility and control over your OT assets without needing to update your Defender for IoT version
81-
- The security of allowing proprietary development without divulging sensitive information
82-
83-
:::image type="content" source="media/concept-supported-protocols/sdk-horizon.png" alt-text="Infographic that describes features provided by the Horizon SDK." border="false":::
84-
8567
## Next steps
8668

8769
For more information:

articles/defender-for-iot/organizations/how-to-manage-individual-sensors.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Maintain Defender for IoT OT network sensors from the GUI - Microsoft Defender for IoT
33
description: Learn how to perform maintenance activities on individual OT network sensors using the OT sensor console.
4-
ms.date: 07/04/2023
4+
ms.date: 12/12/2023
55
ms.topic: how-to
66
---
77

@@ -427,6 +427,33 @@ After clearing data on a cloud-connected sensor:
427427

428428
A confirmation message appears that the action was successful. All learned data, allowlists, policies, and configuration settings are cleared from the sensor.
429429

430+
## Manage sensor plugins and monitor plugin performance
431+
432+
View data for each protocol monitored by your sensor using the **Protocols DPI (Horizon Plugins)** page in the sensor console.
433+
434+
1. Sign into your OT sensor console and select **System settings > Network monitoring > Protocols DPI (Horizon Plugins)**.
435+
436+
1. Do one of the following:
437+
438+
- To limit the protocols monitored by your sensor, select the **Enable/Disable** toggle for each plugin as needed.
439+
440+
- To monitor plugin performance, view the data shown on the **Protocols DPI (Horizon Plugins)** page for each plugin. To help locate a specific plugin, use the **Search** box to enter part or all of a plugin name.
441+
442+
The **Protocols DPI (Horizon Plugins)** lists the following data per plugin:
443+
444+
|Column name |Description |
445+
|---------|---------|
446+
|**Plugin** | Defines the plugin name. |
447+
|**Type** | The plugin type, including APPLICATION or INFRASTRUCTURE. |
448+
|**Time** | The time that data was last analyzed using the plugin. The time stamp is updated every five seconds. |
449+
|**PPS** | The number of packets analyzed per second by the plugin. |
450+
|**Bandwidth** | The average bandwidth detected by the plugin within the last five seconds. |
451+
|**Malforms** | The number of malform errors detected in the last five seconds. Malformed validations are used after the protocol has been positively validated. If there's a failure to process the packets based on the protocol, a failure response is returned. |
452+
|**Warnings** | The number of warnings detected, such as when packets match the structure and specifications, but unexpected behavior is detected, based on the plugin warning configuration. |
453+
| **Errors** | The number of errors detected in the last five seconds for packets that failed basic protocol validations for the packets that match protocol definitions. |
454+
455+
Log data is available for export in the **Dissection statistics** and **Dissection Logs**, log files. For more information, see [Export troubleshooting logs](how-to-troubleshoot-sensor.md).
456+
430457
## Next steps
431458

432459
For more information, see:

articles/defender-for-iot/organizations/overview.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -65,16 +65,6 @@ Install OT network sensors on-premises, at strategic locations in your network t
6565

6666
For more information, see [System architecture for OT system monitoring](architecture.md).
6767

68-
## Extend support to proprietary OT protocols
69-
70-
IoT and industrial control system (ICS) devices can be secured using both embedded protocols and proprietary, custom, or nonstandard protocols. If you have devices that run on protocols that aren't supported by Defender for IoT out-of-the-box, use the Horizon Open Development Environment (ODE) SDK to develop dissector plug-ins to decode network traffic for your protocols.
71-
72-
Create custom alerts for your plugin to pinpoint specific network activity and effectively update your security, IT, and operational teams. For example, have alerts triggered when:
73-
74-
- The sensor detects a write command to a memory register on a specific IP address and Ethernet destination.
75-
- Any access is performed to a specific IP address.
76-
77-
For more information, see [Manage proprietary protocols with Horizon plugins](resources-manage-proprietary-protocols.md).
7868

7969
## Protect enterprise IoT networks
8070

articles/defender-for-iot/organizations/resources-manage-proprietary-protocols.md

Lines changed: 0 additions & 93 deletions
This file was deleted.

articles/defender-for-iot/organizations/whats-new.md

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -785,7 +785,7 @@ For more information, see [Understand sensor health](how-to-manage-sensors-on-th
785785
|Service area |Updates |
786786
|---------|---------|
787787
|**Enterprise IoT networks** | - [Enterprise IoT and Defender for Endpoint integration in GA](#enterprise-iot-and-defender-for-endpoint-integration-in-ga) |
788-
|**OT networks** |**Sensor software version 22.2.4**: <br>- [Device inventory enhancements](#device-inventory-enhancements)<br>- [Enhancements for the ServiceNow integration API](#enhancements-for-the-servicenow-integration-api)<br><br>**Sensor software version 22.2.3**:<br>- [OT appliance hardware profile updates](#ot-appliance-hardware-profile-updates)<br>- [PCAP access from the Azure portal](#pcap-access-from-the-azure-portal-public-preview)<br>- [Bi-directional alert synch between sensors and the Azure portal](#bi-directional-alert-synch-between-sensors-and-the-azure-portal-public-preview)<br>- [Sensor connections restored after certificate rotation](#sensor-connections-restored-after-certificate-rotation)<br>- [Support diagnostic log enhancements](#support-diagnostic-log-enhancements-public-preview)<br>- [Improved security for uploading protocol plugins](#improved-security-for-uploading-protocol-plugins)<br>- [Sensor names shown in browser tabs](#sensor-names-shown-in-browser-tabs)<br><br>**Sensor software version 22.1.7**: <br>- [Same passwords for *cyberx_host* and *cyberx* users](#same-passwords-for-cyberx_host-and-cyberx-users) |
788+
|**OT networks** |**Sensor software version 22.2.4**: <br>- [Device inventory enhancements](#device-inventory-enhancements)<br>- [Enhancements for the ServiceNow integration API](#enhancements-for-the-servicenow-integration-api)<br><br>**Sensor software version 22.2.3**:<br>- [OT appliance hardware profile updates](#ot-appliance-hardware-profile-updates)<br>- [PCAP access from the Azure portal](#pcap-access-from-the-azure-portal-public-preview)<br>- [Bi-directional alert synch between sensors and the Azure portal](#bi-directional-alert-synch-between-sensors-and-the-azure-portal-public-preview)<br>- [Sensor connections restored after certificate rotation](#sensor-connections-restored-after-certificate-rotation)<br>- [Support diagnostic log enhancements](#support-diagnostic-log-enhancements-public-preview)<br>- [Sensor names shown in browser tabs](#sensor-names-shown-in-browser-tabs)<br><br>**Sensor software version 22.1.7**: <br>- [Same passwords for *cyberx_host* and *cyberx* users](#same-passwords-for-cyberx_host-and-cyberx-users) |
789789
|**Cloud-only features** | - [Microsoft Sentinel incident synch with Defender for IoT alerts](#microsoft-sentinel-incident-synch-with-defender-for-iot-alerts) |
790790

791791
### Enterprise IoT and Defender for Endpoint integration in GA
@@ -901,14 +901,6 @@ For more information, see:
901901
- [Download a diagnostics log for support](how-to-troubleshoot-sensor.md#download-a-diagnostics-log-for-support)
902902
- [Upload a diagnostics log for support](how-to-manage-sensors-on-the-cloud.md#upload-a-diagnostics-log-for-support)
903903

904-
### Improved security for uploading protocol plugins
905-
906-
This version of the sensor provides an improved security for uploading proprietary plugins you've created using the Horizon SDK.
907-
908-
:::image type="content" source="media/release-notes/horizon.png" alt-text="Screenshot of the new Protocols DPI (Horizon Plugins) page." lightbox="media/release-notes/horizon.png":::
909-
910-
For more information, see [Manage proprietary protocols with Horizon plugins](resources-manage-proprietary-protocols.md).
911-
912904
### Sensor names shown in browser tabs
913905

914906
Starting in sensor version 22.2.3, your sensor's name is displayed in the browser tab, making it easier for you to identify the sensors you're working with.

0 commit comments

Comments
 (0)