Skip to content

Commit 5e88e0d

Browse files
cf-rhettranbel
andauthored
Add UBR details to device posture (#25988)
* PCX-19793: Add UBR details to device posture * Move to spaces not tabs * Rename version extra * Separate commands for retreiving versions * Apply suggestions from code review * fix tabs --------- Co-authored-by: ranbel <[email protected]>
1 parent eb97045 commit 5e88e0d

File tree

1 file changed

+35
-15
lines changed
  • src/content/docs/cloudflare-one/reusable-components/posture-checks/warp-client-checks

1 file changed

+35
-15
lines changed

src/content/docs/cloudflare-one/reusable-components/posture-checks/warp-client-checks/os-version.mdx

Lines changed: 35 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -31,23 +31,26 @@ The OS Version device posture attribute checks whether the version of a device's
3131

3232
5. (Optional) Configure additional OS-specific fields:
3333

34-
<Tabs> <TabItem label="macOS">
34+
<Tabs>
35+
<TabItem label="Windows">
36+
To check that Windows devices have required security patches and features installed, include an Update Build Revision (UBR) number in the OS version check.
37+
- **Update Build Revision**: Enter the Windows UBR you want devices to match (for example, `3803`). The UBR is the fourth part of the full Windows version number (for example, in `10.0.19045.3803`, the UBR is `3803`).
38+
</TabItem>
3539

36-
- **Version extra**: Enter the macOS [Rapid Security Response (RSR)](https://support.apple.com/guide/deployment/rapid-security-responses-dep93ff7ea78/web) version you want devices to match (for example, `(a)`). Be sure to include the parenthesis around the letter.
40+
<TabItem label="macOS">
41+
- **Rapid Security Response Version**: Enter the macOS [Rapid Security Response (RSR)](https://support.apple.com/guide/deployment/rapid-security-responses-dep93ff7ea78/web) version you want devices to match (for example, `(a)`). Be sure to include the parenthesis around the letter.
42+
</TabItem>
3743

38-
</TabItem> <TabItem label="iOS">
44+
<TabItem label="Linux">
45+
- **Distro name** and **Distro revision**: Enter the Linux distribution you want devices to match (for example, `ubuntu 22.04`). The distro version always matches with an equal-to operator (==) regardless of the **Operator** setting.
3946

40-
- **Version extra**: Enter the iOS [Rapid Security Response (RSR)](https://support.apple.com/guide/deployment/rapid-security-responses-dep93ff7ea78/web) version you want devices to match (for example, `(a)`). Be sure to include the parenthesis around the letter.
47+
- **Patch Version**: Enter the [patch version](#linux) of the kernel. For example, if the kernel is `6.50.0-1007-oem`, enter `1007`.
48+
</TabItem>
4149

42-
</TabItem>
43-
44-
<TabItem label="Linux">
45-
46-
- **Distro name** and **Distro revision**: Enter the Linux distribution you want devices to match (for example, `ubuntu 22.04`). The distro version always matches with an equal-to operator (==) regardless of the **Operator** setting.
47-
48-
- **Version extra**: Enter the [patch version](#linux) of the kernel. For example, if the kernel is `6.50.0-1007-oem`, enter `1007`.
49-
50-
</TabItem> </Tabs>
50+
<TabItem label="iOS">
51+
- **Rapid Security Response Version**: Enter the iOS [Rapid Security Response (RSR)](https://support.apple.com/guide/deployment/rapid-security-responses-dep93ff7ea78/web) version you want devices to match (for example, `(a)`). Be sure to include the parenthesis around the letter.
52+
</TabItem>
53+
</Tabs>
5154

5255
6. Select **Save**.
5356

@@ -68,13 +71,30 @@ Operating systems display version numbers in different ways. This section covers
6871

6972
### Windows
7073

74+
Windows version numbers consist of four parts: `Major.Minor.Build.UBR`. For example, `10.0.19045.3803` where:
75+
- `10.0` is the **Version** (Major.Minor)
76+
- `19045` is the **Build** number
77+
- `3803` is the **UBR** (Update Build Revision)
78+
79+
To determine the Windows version on your device:
80+
7181
1. Open a PowerShell window.
72-
2. Use the `Get-CimInstance` command to get the version property of the `Win32_OperatingSystem` class.
82+
2. Get the **Version** (Major.Minor.Build):
7383

7484
```bash
7585
(Get-CimInstance Win32_OperatingSystem).version
7686
```
7787

88+
This returns the version in the format `Major.Minor.Build` (for example, `10.0.19045`).
89+
90+
3. Get the **UBR** (Update Build Revision):
91+
92+
```bash
93+
(Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion" -Name UBR).UBR
94+
```
95+
96+
This returns the UBR value (for example, `3803`).
97+
7898
### Linux
7999

80100
#### OS version
@@ -92,7 +112,7 @@ The Linux OS version check reads the system kernel version.
92112

93113
3. **Version** is the first three numbers of the output in SemVer format (`5.14.0`).
94114

95-
4. **Version extra** is the first number after the SemVer (`25`).
115+
4. **Patch Version** is the first number after the SemVer (`25`).
96116

97117
#### Distro version
98118

0 commit comments

Comments
 (0)