Tripp Lite B097016 Owners Manual for B093- B097- and B098-Series Console Serve - Page 269

Set Up an Untrusted LAN, 15.4 How it Works

Page 269 highlights

15. Advanced Configuration 15.15.3 Set Up an Untrusted LAN If network security is a concern, you can have remote hands insert a trusted USB flash drive into the Tripp Lite device during provisioning. A summary of the steps required for deploying configuration in an untrusted network is outlined below: 1. Generate an X.509 certificate for the client. Place it and its private key file onto a USB flash drive (concatenated as a single file, client.pem). 2. Set up an HTTPS server that restricts access to the .opg or .xml file for HTTPS connections, providing the client certificate. 3. Save a copy of the CA cert (that signed the HTTP server's certificate) onto the USB flash drive as well (ca-bundle.crt). 4. Insert the USB flash drive into the Tripp Lite device before connecting to power or the network. 5. Continue with the steps above, but using only a https URL. 6. A detailed step-by-step document for preparing a USB flash drive and using OpenSSL to create keys is at Howto: set up a USB key for authenticated restore. 15.15.4 How it Works This section explains in detail how the Tripp Lite device uses DHCP to obtain its initial configuration. A Tripp Lite console manager is either configured or unconfigured. ZTP needs it to be in an unconfigured state, which is only obtained in the following ways: • Firmware programming at factory. • Pressing the Config Erase button twice during operation. • Selecting Config Erase under System: Administration in the web UI, and rebooting. • Creating the file /etc/config/.init and then rebooting (command-line). When an unconfigured Tripp Lite boots, it performs these steps to find a configuration: • The Tripp Lite device transmits a DHCP DISCOVER request onto its primary network interface (WAN). This DHCP request will carry a vendor class identifier of the form Tripp Lite/model-name (for example, Tripp Lite/B098) and its parameter request list will include option 43 (vendor-specific information). • On receipt of a DHCP OFFER, the device will use the information in the offer to assign an IPv4 address to its primary network interface, add a default route, and prepare its DNS resolver. • If the offer also contained an option 43 with sub-option 1, the device interprets the sub-option as a whitespace-separated list of URLs to configuration files to try to restore. • If an NTP server option was provided in the DHCP offer, the system clock is (quickly) synchronized with the NTP server. • The system now searches all attached USB storage devices for two optional certificate files. The first file is named ca-bundle. crt, and the second one is whichever one of the following filenames is found first: o client-AABBCCDDEEFF.pem (where AABBCCDDEEFF is the MAC address of the primary network interace); or o client-MODEL.pem (where MODEL is the (vendor class) model name in lowercase, truncated to before the first hyphen); or o client.pem • If both files are found (ca-bundle.crt and a client.pem), then secure mode is enabled for the next section. • Each URL in the list obtained from option 43 sub-option 1 is tried in sequence until one succeeds: o The URL undergoes substring replacement from the following table: Substring Replaced by ${mac} The 12-digit MAC address of the device, in lowercase ${model} The full model name, in lowercase ${class} The firmware hardware class ${version} The firmware version number o The resulting URL must end in .opg or .xml (an optional ?query-string is permitted). If it does not, it is skipped and the next URL is tried. 269

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288

269
15. Advanced Configuration
15.15.3 Set Up an Untrusted LAN
If network security is a concern, you can have remote hands insert a trusted USB flash drive into the Tripp Lite device during
provisioning. A summary of the steps required for deploying configuration in an untrusted network is outlined below:
1. Generate an X.509 certificate for the client. Place it and its private key file onto a USB flash drive (concatenated as a single
file, client.pem).
2. Set up an HTTPS server that restricts access to the .opg or .xml file for HTTPS connections, providing the client certificate.
3. Save a copy of the CA cert (that signed the HTTP server’s certificate) onto the USB flash drive as well (ca-bundle.crt).
4. Insert the USB flash drive into the Tripp Lite device
before connecting to power or the network
.
5. Continue with the steps above, but using only a https URL.
6. A detailed step-by-step document for preparing a USB flash drive and using OpenSSL to create keys is at Howto: set up a
USB key for authenticated restore.
15.15.4 How it Works
This section explains in detail how the Tripp Lite device uses DHCP to obtain its initial configuration.
A Tripp Lite console manager is either configured or unconfigured. ZTP needs it to be in an unconfigured state, which is only
obtained in the following ways:
• Firmware programming at factory.
• Pressing the
Config Erase
button twice during operation.
• Selecting
Config Erase
under
System: Administration
in the web UI, and rebooting.
• Creating the file
/etc/config/.init
and then rebooting (command-line).
When an unconfigured Tripp Lite boots, it performs these steps to find a configuration:
• The Tripp Lite device transmits a DHCP DISCOVER request onto its primary network interface (WAN). This DHCP request will
carry a vendor class identifier of the form Tripp Lite/model-name (for example, Tripp Lite/B098) and its parameter request list
will include option 43 (vendor-specific information).
• On receipt of a DHCP OFFER, the device will use the information in the offer to assign an IPv4 address to its primary network
interface, add a default route, and prepare its DNS resolver.
• If the offer also contained an option 43 with sub-option 1, the device interprets the sub-option as a whitespace-separated
list of URLs to configuration files to try to restore.
• If an NTP server option was provided in the DHCP offer, the system clock is (quickly) synchronized with the NTP server.
• The system now searches all attached USB storage devices for two optional certificate files. The first file is named ca-bundle.
crt, and the second one is whichever one of the following filenames is found first:
o client-AABBCCDDEEFF.pem (where AABBCCDDEEFF is the MAC address of the primary network interace); or
o client-MODEL.pem (where MODEL is the (vendor class) model name in lowercase, truncated to before the first hyphen); or
o client.pem
• If both files are found (ca-bundle.crt and a client.pem), then secure mode is enabled for the next section.
• Each URL in the list obtained from option 43 sub-option 1 is tried in sequence until one succeeds:
o The URL undergoes substring replacement from the following table:
Substring
Replaced by
${mac}
The 12-digit MAC address of the device, in lowercase
${model}
The full model name, in lowercase
${class}
The firmware hardware class
${version}
The firmware version number
o The resulting URL must end in .opg or .xml (an optional ?query-string is permitted). If it does not, it is skipped and the next
URL is tried.