Skip to content

Commit b067dc0

Browse files
authored
Merge pull request #226845 from batamig/new-update-screen
New update screen
2 parents 1d649cc + e676425 commit b067dc0

33 files changed

+362
-273
lines changed

articles/defender-for-iot/organizations/cli-ot-sensor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ Version: 22.2.5.9-r-2121448
113113

114114
#### Update sensor software from CLI
115115

116-
For more information, see [Update your sensors](update-ot-software.md#update-your-sensors).
116+
For more information, see [Update your sensors](update-ot-software.md#update-ot-sensors).
117117

118118
### Date, time, and NTP
119119
#### Show current system date/time

articles/defender-for-iot/organizations/how-to-activate-and-set-up-your-on-premises-management-console.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ After activating an on-premises management console, you'll need to apply new act
7070
|Location |Activation process |
7171
|---------|---------|
7272
|**On-premises management console** | Apply a new activation file on your on-premises management console if you've [modified the number of committed devices](how-to-manage-subscriptions.md#edit-a-plan-for-ot-networks) in your subscription. |
73-
|**Cloud-connected sensors** | Cloud-connected sensors remain activated for as long as your Azure subscription with your Defender for IoT plan is active. <br><br>However, you'll also need to apply a new activation file when [updating your sensor software](update-ot-software.md#download-and-apply-a-new-activation-file) from a legacy version to version 22.2.x. |
73+
|**Cloud-connected sensors** | Cloud-connected sensors remain activated for as long as your Azure subscription with your Defender for IoT plan is active. <br><br>If you're [updating an OT sensor from a legacy version](update-ot-software.md#update-legacy-ot-sensor-software), you'll need to re-activate your updated sensor. |
7474
| **Locally-managed** | Apply a new activation file to locally managed sensors every year. After a sensor's activation file has expired, the sensor will continue to monitor your network, but you'll see a warning message when signing in to the sensor. |
7575

7676
For more information, see [Manage Defender for IoT subscriptions](how-to-manage-subscriptions.md).

articles/defender-for-iot/organizations/how-to-activate-and-set-up-your-sensor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ After activating a sensor, you'll need to apply new activation files as follows:
135135

136136
|Location |Activation process |
137137
|---------|---------|
138-
|**Cloud-connected sensors** | Cloud-connected sensors remain activated for as long as your Azure subscription with your Defender for IoT plan is active. <br><br>However, you'll also need to apply a new activation file when [updating your sensor software](update-ot-software.md#download-and-apply-a-new-activation-file) from a legacy version to version 22.2.x. |
138+
|**Cloud-connected sensors** | Cloud-connected sensors remain activated for as long as your Azure subscription with your Defender for IoT plan is active. <br><br>If you're [updating an OT sensor from a legacy version](update-ot-software.md#update-legacy-ot-sensor-software), you'll need to re-activate your updated sensor. |
139139
| **Locally managed** | Apply a new activation file to locally managed sensors every year. After a sensor's activation file has expired, the sensor will continue to monitor your network, but you'll see a warning message when signing in to the sensor. |
140140

141141
For more information, see [Manage Defender for IoT subscriptions](how-to-manage-subscriptions.md) and [Manage the on-premises management console](how-to-manage-the-on-premises-management-console.md).

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

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,21 @@ If there are any connection issues, a disconnection message is shown in the **Ge
4949

5050
:::image type="content" source="media/how-to-manage-individual-sensors/system-messages.png" alt-text="Screenshot of the system messages pane." lightbox="media/how-to-manage-individual-sensors/system-messages.png":::
5151

52+
53+
## Download software for OT sensors
54+
55+
You may need to download software for your OT sensor if you're [installing Defender for IoT software](ot-deploy/install-software-ot-sensor.md) on your own appliances, or [updating software versions](update-ot-software.md).
56+
57+
In Defender for IoT in the Azure portal, use one of the following options:
58+
59+
- For a new installation, select **Getting started** > **Sensor**. Select a version in the **Purchase an appliance and install software** area, and then select **Download**.
60+
61+
- If you're updating your OT sensor, use the options in the **Sites and sensors** page > **Sensor update (Preview)** menu.
62+
63+
[!INCLUDE [root-of-trust](includes/root-of-trust.md)]
64+
65+
For more information, see [Update Defender for IoT OT monitoring software](update-ot-software.md).
66+
5267
## Manage sensor activation files
5368

5469
Your sensor was onboarded with Microsoft Defender for IoT from the Azure portal. Each sensor was onboarded as either a locally connected sensor or a cloud-connected sensor.

articles/defender-for-iot/organizations/how-to-manage-sensors-from-the-on-premises-management-console.md

Lines changed: 1 addition & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -53,30 +53,6 @@ You can define the following sensor system settings from the management console:
5353

5454
1. Select **Save**.
5555

56-
## Update threat intelligence packages
57-
58-
The data package for threat intelligence is provided with each new Defender for IoT version, or if needed between releases. The package contains signatures (including malware signatures), CVEs, and other security content.
59-
60-
You can manually upload this file in the Azure portal and automatically update it to sensors.
61-
62-
[!INCLUDE [root-of-trust](includes/root-of-trust.md)]
63-
64-
**To update the threat intelligence data:**
65-
66-
1. Go to the Defender for IoT **Updates** page.
67-
68-
1. Download and save the file.
69-
70-
1. Sign in to the management console.
71-
72-
1. On the side menu, select **System Settings**.
73-
74-
1. Select the sensors that should receive the update in the **Sensor Engine Configuration** section.
75-
76-
1. In the **Select Threat Intelligence Data** section, select the plus sign (**+**).
77-
78-
1. Upload the package that you downloaded from the Defender for IoT **Updates** page.
79-
8056
## Understand sensor disconnection events
8157

8258
The **Site Manager** window displays disconnection information if sensors disconnect from their assigned on-premises management console. The following sensor disconnection information is available:
@@ -283,5 +259,5 @@ For more information, see:
283259
- [Track sensor activity](how-to-track-sensor-activity.md)
284260
- [Update OT system software](update-ot-software.md)
285261
- [Manage sensors with Defender for IoT in the Azure portal](how-to-manage-sensors-on-the-cloud.md)
286-
- [Threat intelligence research and packages](how-to-work-with-threat-intelligence-packages.md)
262+
- [Maintain threat intelligence packages on OT network sensors](how-to-work-with-threat-intelligence-packages.md)
287263
- [Troubleshoot the sensor and on-premises management console](how-to-troubleshoot-the-sensor-and-on-premises-management-console.md)

articles/defender-for-iot/organizations/how-to-manage-sensors-on-the-cloud.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Details about each sensor are listed in the following columns:
3434
|**Sensor health**| Displays a [sensor health message](sensor-health-messages.md). For more information, see [Understand sensor health](how-to-manage-sensors-on-the-cloud.md#understand-sensor-health).|
3535
|**Last connected (UTC)**| Displays how long ago the sensor was last connected.|
3636
|**Threat Intelligence version**| Displays the [Threat Intelligence version](how-to-work-with-threat-intelligence-packages.md) installed on an OT sensor. The name of the version is based on the day the package was built by Defender for IoT. |
37-
|**Threat Intelligence mode**| Displays whether the Threat Intelligence update mode is manual or automatic. If it's manual that means that you can [push newly released packages directly to sensors](how-to-work-with-threat-intelligence-packages.md) as needed. Otherwise, the new packages will be automatically installed on all OT, cloud-connected sensors. |
37+
|**Threat Intelligence mode**| Displays whether the Threat Intelligence update mode is manual or automatic. If it's manual that means that you can [push newly released packages directly to sensors](how-to-work-with-threat-intelligence-packages.md) as needed. Otherwise, the new packages are automatically installed on all OT, cloud-connected sensors. |
3838
|**Threat Intelligence update status**| Displays the update status of the Threat Intelligence package on an OT sensor. The status can be either **Failed**, **In Progress**, **Update Available**, or **Ok**.|
3939

4040
## Site management options from the Azure portal
@@ -65,9 +65,10 @@ Use the options on the **Sites and sensor** page and a sensor details page to do
6565

6666
|Task |Description |
6767
|---------|---------|
68-
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-threat-intelligence.png" border="false"::: **Push threat intelligence updates** | OT sensors only. <br><br>Available for bulk actions from the **Sites and sensors** toolbar, for individual sensors from the **...** options menu, or from a sensor details page. <br><br>For more information, see [Threat intelligence research and packages](how-to-work-with-threat-intelligence-packages.md). |
68+
| :::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-update.png" border="false"::: **Sensor update (Preview)** | OT sensors only. <br><br>Run remote updates on OT sensors directly from the Azure portal, or download update packages to update manually. <br><br>For more information, see [Update Defender for IoT OT monitoring software](update-ot-software.md). |
69+
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-threat-intelligence.png" border="false"::: **Threat intelligence update (Preview)** | OT sensors only. <br><br>Available for bulk actions from the **Sites and sensors** toolbar, for individual sensors from the **...** options menu, or from a sensor details page. <br><br>For more information, see [Threat intelligence research and packages](how-to-work-with-threat-intelligence-packages.md). |
6970
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-edit.png" border="false"::: **Edit automatic threat intelligence updates** | Individual, OT sensors only. <br><br>Available from the **...** options menu or a sensor details page. <br><br>Select **Edit** and then toggle the **Automatic Threat Intelligence Updates (Preview)** option on or off as needed. Select **Submit** to save your changes. |
70-
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-prepare-to-update.png" border="false"::: **Prepare an OT sensor to update to software version 22.x or higher** | Individual, OT sensors only. <br><br>Available from the **Sites and sensors** toolbar, the **...** options menu, or a sensor details page. <br><br>For more information, see: <br>- [Reactivate a sensor for upgrades to version 22.x from a legacy version](how-to-manage-sensors-on-the-cloud.md#reactivate-an-ot-sensor-for-upgrades-to-version-22x-from-a-legacy-version)<br>- [Update Defender for IoT OT monitoring software](update-ot-software.md#download-and-apply-a-new-activation-file) |
71+
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-prepare-to-update.png" border="false"::: **Prepare an OT sensor to update to software version 22.x or higher** | Individual, OT sensors only. <br><br>Available from the **Sites and sensors** toolbar, the **...** options menu, or a sensor details page. <br><br>For more information, see [Update legacy OT sensor software](update-ot-software.md#update-legacy-ot-sensor-software). |
7172

7273
### Sensor deployment and access
7374

@@ -79,28 +80,28 @@ Use the options on the **Sites and sensor** page and a sensor details page to do
7980
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-edit.png" border="false"::: **Edit a sensor zone** | For individual sensors only, from the **...** options menu or a sensor details page. <br><br>Select **Edit**, and then select a new zone from the **Zone** menu or select **Create new zone**. Select **Submit** to save your changes. |
8081
| **Download SNMP MIB file** | Available from the **Sites and sensors** toolbar **More actions** menu. <br><br>For more information, see [Set up OT sensor health monitoring via SNMP](how-to-set-up-snmp-mib-monitoring.md).|
8182
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-edit.png" border="false"::: **Create an activation command** | Individual, Enterprise IoT sensors only. <br><br>Available from the **...** options menu or a sensor details page. Select **Edit** and then select **Create activation command**. <br><br>For more information, see [Install Enterprise IoT sensor software](eiot-sensor.md#install-enterprise-iot-sensor-software). |
82-
|<a name="endpoint"></a> **Download endpoint details** (Public preview) | Available from the **Sites and sensors** toolbar **More actions** menu, for OT sensor versions 22.x only. <br><br>Download the list of endpoints that must be enabled as secure endpoints from OT network sensors. Make sure that HTTPS traffic is enabled over port 443 to the listed endpoints for your sensor to connect to Azure. Outbound allow rules are defined once for all OT sensors onboarded to the same subscription.<br><br>To enable this option, select a sensor with a supported software version, or a site with one or more sensors with supported versions. |
83-
| **Define OT network sensor settings** (Preview) | Define selected sensor settings for one or more cloud-connected OT network sensors. For more information, see [Define and view OT sensor settings from the Azure portal (Public preview)](configure-sensor-settings-portal.md). <br><br>Other settings are also available directly from the [OT sensor console](how-to-manage-individual-sensors.md), or the [on-premises management console](how-to-manage-sensors-from-the-on-premises-management-console.md).|
83+
|<a name="endpoint"></a> **Download endpoint details** (Public preview) | OT sensors only, with versions 22.x and higher only.<br><br>Available from the **Sites and sensors** toolbar **More actions** menu. <br><br>Download the list of endpoints that must be enabled as secure endpoints from OT network sensors. Make sure that HTTPS traffic is enabled over port 443 to the listed endpoints for your sensor to connect to Azure. Outbound allow rules are defined once for all OT sensors onboarded to the same subscription.<br><br>To enable this option, select a sensor with a supported software version, or a site with one or more sensors with supported versions. |
8484

8585
### Sensor maintenance and troubleshooting
8686

8787
|Task |Description |
8888
|---------|---------|
89+
| :::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-settings.png" border="false"::: **Sensor settings (Preview)** | OT sensors only. <br><br> Define selected sensor settings for one or more cloud-connected OT network sensors. For more information, see [Define and view OT sensor settings from the Azure portal (Public preview)](configure-sensor-settings-portal.md). <br><br>Other settings are also available directly from the [OT sensor console](how-to-manage-individual-sensors.md), or the [on-premises management console](how-to-manage-sensors-from-the-on-premises-management-console.md).|
8990
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-export.png" border="false"::: **Export sensor data** | Available from the **Sites and sensors** toolbar only, to download a CSV file with details about all the sensors listed. |
9091
|:::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-delete.png" border="false"::: **Delete a sensor** | For individual sensors only, from the **...** options menu or a sensor details page. |
9192
| :::image type="icon" source="media/how-to-manage-sensors-on-the-cloud/icon-diagnostics.png" border="false"::: **Send diagnostic files to support** | Individual, locally managed OT sensors only. <br><br>Available from the **...** options menu. <br><br>For more information, see [Upload a diagnostics log for support](#upload-a-diagnostics-log-for-support).|
9293

9394
## Retrieve forensics data stored on the sensor
9495

95-
Use Azure Monitor workbooks on an OT network sensor to retrieve forensic data from that sensor’s storage. The following types of forensic data is stored locally on OT sensors, for devices detected by that sensor:
96+
Use Azure Monitor workbooks on an OT network sensor to retrieve forensic data from that sensor’s storage. The following types of forensic data are stored locally on OT sensors, for devices detected by that sensor:
9697

9798
- Device data
9899
- Alert data
99100
- Alert PCAP files
100101
- Event timeline data
101102
- Log files
102103

103-
Each type of data has a different retention period and maximum capacity. For more information see [Visualize Microsoft Defender for IoT data with Azure Monitor workbooks](workbooks.md) and [Data retention across Microsoft Defender for IoT](references-data-retention.md).
104+
Each type of data has a different retention period and maximum capacity. For more information, see [Visualize Microsoft Defender for IoT data with Azure Monitor workbooks](workbooks.md) and [Data retention across Microsoft Defender for IoT](references-data-retention.md).
104105

105106
## Reactivate an OT sensor
106107

@@ -149,7 +150,7 @@ This procedure describes how to view sensor health data from the Azure portal. S
149150
- Sensor fails regular sanity tests
150151
- No traffic detected by the sensor
151152
- Sensor software version is no longer supported
152-
- A [remote sensor upgrade from the Azure portal](update-ot-software.md#update-your-sensors) fails
153+
- A [remote sensor upgrade from the Azure portal](update-ot-software.md#update-ot-sensors) fails
153154

154155
For more information, see our [Sensor health message reference](sensor-health-messages.md).
155156

articles/defender-for-iot/organizations/how-to-manage-the-on-premises-management-console.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,22 +9,22 @@ ms.topic: article
99

1010
This article covers on-premises management console options like backup and restore, downloading committee device activation file, updating certificates, and setting up a proxy to sensors.
1111

12-
You onboard the on-premises management console from the Azure portal.
13-
1412
## Download software for the on-premises management console
1513

16-
You may need to download software for your on-premises management console if you're installing Defender for IoT software on your own appliances, or updating software versions.
14+
You may need to download software for your on-premises management console if you're [installing Defender for IoT software](ot-deploy/install-software-on-premises-management-console.md) on your own appliances, or [updating software versions](update-ot-software.md).
1715

18-
**To download on-premises management console software**:
16+
In Defender for IoT in the Azure portal, use one of the following options:
1917

20-
1. In the Azure portal, go to **Defender for IoT** > **Getting started** > **On-premises management console** or **Updates**.
18+
- For a new installation or standalone update, select **Getting started** > **On-premises management console**.
2119

22-
1. Select **Download** for your on-premises management console software update. Save your `management-secured-patcher-<version>.tar` file locally. For example:
20+
- For a new installation, select a version in the **Purchase an appliance and install software** area, and then select **Download**.
21+
- For an update, select your update scenario in the **On-premises management console** area and then select **Download**.
2322

24-
:::image type="content" source="media/update-ot-software/on-premises-download.png" alt-text="Screenshot of the Download option for the on-premises management console." lightbox="media/update-ot-software/on-premises-download.png":::
23+
- If you're updating your on-premises management console together with connected OT sensors, use the options in the **Sites and sensors** page > **Sensor update (Preview)** menu.
2524

2625
[!INCLUDE [root-of-trust](includes/root-of-trust.md)]
2726

27+
For more information, see [Update Defender for IoT OT monitoring software](update-ot-software.md#update-an-on-premises-management-console).
2828
## Upload an activation file
2929

3030
When you first sign in, an activation file for the on-premises management console is downloaded. This file contains the aggregate committed devices that are defined during the onboarding process. The list includes sensors associated with multiple subscriptions.

0 commit comments

Comments
 (0)