HPSM User Guide
HPSM User Guide
HPSM User Guide
HP Security Manager
Device Discovery, Determining Device Details and
Exporting Devices
CONTENTS
Overview .......................................................................................................................................... 2
General Description ......................................................................................................................... 2
Adding devices to Security Manager .................................................................................................... 2
Adding devices manually to Security Manager ................................................................................... 4
Overwrite Existing Devices or Create Duplicate IP/Hostname Entries ............................................ 6
Detailed Description......................................................................................................................... 6
Resolve IP Address to Hostname .......................................................................................................... 6
Resolve Hostname/DNS Alias to IP Address ....................................................................................... 7
Add Devices Using a Text or XML File ................................................................................................... 7
Add Devices with a Text File ................................................................................................................... 8
Add Devices with an XML File ................................................................................................................ 8
Add devices to the Security Manager database ............................................................................ 10
Determining Device Details ................................................................................................................. 10
Manually adding devices to the database.......................................................................................... 10
Communicating with the Device.......................................................................................................... 11
Device details: certificate expiration date ......................................................................................... 12
Exporting devices from Security Manager 3.8 and older................................................................ 12
Exporting devices from Security Manager 3.9 and later ................................................................ 22
Other Assessment/remediation data in the SQL database ........................................................... 23
Appendix A ..................................................................................................................................... 25
Other HP Security Manager Whitepapers and Manuals ................................................................... 25
Overview
Devices are added to HP Security Manager manually using the Discover Devices option or
dynamically using the Instant-On Security feature. This whitepaper describes the Discover
Devices option in detail, including device identity tracking in the Security Manager database. For
information about adding devices using the Instant-On Security feature, see the Instant-On
Whitepaper.
General Description
Adding devices to Security Manager
Unless the Instant-On Security feature is in use, adding devices to Security Manager is a manual
process. To set up either automatic or manual device discovery, expand the Discover Devices
menu from the left pane of the Devices tab.
Figure: HP Security Manager Devices tab, Discover Devices menu in the left pane
Devices can be manually added by importing a text or XML file that contains a list of devices or by
manually entering the device information.
A device list exported from HP Web Jetadmin or from other properly formatted sources can also
be used. Device lists can include IP addresses, hostnames, DNS aliases, or a combination of all
three in either an XML or text format. Use the Verify option on the Devices tab to verify support for
a device or group of devices. Unsupported devices are indicated in the devices panel.
To use the Automatic Discovery feature, select the Devices tab, and then expand the Discover
Devices option in the left pane. Select Automatic on the Discover Devices screen.
Select a Discovery Type:
• Number of Network Hops – This method uses a multicast UDP discovery mechanism to ask HP
imaging and printing devices to identify themselves. The user can select the number of
network hops or routers to traverse in the multicast query. The default is 4 hops.
• Range – This discovery method scans the given IP address range for all devices that are
supported by Security Manager.
Figure: HP Security Manager, Discover Devices window, Range discovery option selected
Adjust the Number of Network Hops if an SLP type of discovery is desired. Range is the most
popular option. This method requires typing a Start IP Address, typing an End IP Address, and then
clicking the Add to list for Discovery button.
Multiple ranges can be added to the list at one time and added to the box below. The list of ranges
can be exported to a file by selecting Export Device List and later imported again if desired by
selecting Add from File for Discovery. Discoveries can also be scheduled to occur at a desired
frequency.
The group name that is highlighted during the add devices process is the group that populates the
Group to Add field. To select a different group, select it from the Group to Add drop-down list.
To use the Manual Discovery option, select Manual from the Discovery Type drop-down list.
3
Either type an IP address range to discover devices manually or select Add from File for
Discovery to import a file of devices exported from Web Jetadmin.
Figure: HP Security Manager, Discover Devices window, Devices discovered under the Devices section
using the Manual method
As the final step, devices from the Devices to Add table are added to the database and assigned
a license by selecting Discover. Currently Security Manager interrogates the devices and gathers
minimal data to display in columns such as Model Name.
Figure: HP Security Manager, after clicking Discover a list of Devices is displayed
The Device Status column indicates No Information since the devices have not been verified yet.
When the devices are selected and after selecting the Verify tab, Security Manager performs a
more complete interrogation such as checking credentials to populate the remaining columns.
The System Name column is also populated by taking the sysname object from the device itself.
No DNS lookups are performed here, it is strictly an object returned from the device. This can be
useful for location purposes.
5
Overwrite Existing Devices or Create Duplicate IP/Hostname Entries
In a large fleet of devices, devices are getting changed for other/newer devices. When the new
device has the same IP address and/or hostname as the original device HPSM can either
overwrite the existing device or create a new device.
This Discovery Behavior depends upon the following settings in the HPSM_service.exe.config file
(available from HPSM 3.5 and newer):
<add key="OverwriteDeviceDetailsWhenIPsMatches" value="true" />
<add key="OverwriteDeviceWhenHostNameMatches" value="true" />
When set to true, then the existing device will be overwritten with details from the new device. The
HPSM_service.exe.config file is in the following location:
C:\Program Files (x86)\HP Security Manager
After making changes to this file, a restart of the HP Security Manager service is required.
Detailed Description
Resolve IP Address to Hostname
The tracking of Security Manager device identity depends on how the device was added and
entered in the database. The following section provides a detailed explanation of the process.
When the Resolve IP addresses to hostnames when devices are added option is selected and an
IP address is provided without a correlating hostname, the IP address DNS resolve process is as
follows:
1. A reverse DNS lookup is performed on the IP address.
2. If resolved to a hostname, a forward DNS lookup is performed on that hostname. The
hostname must resolve back to the IP address to be valid.
3. If the above steps fail, then an LLMNR broadcast message will be sent to perform a lookup on
the systemname. If the device responses, then that will be used as the hostname.
NOTE: This requires that LLMNR is enabled on the device and on the operating system.
4. If the above steps fail, then a NBNS (NetBios Name Service message) will be send directly to
the device to query the netbios name of the IP address. If the device sends a NBNS response,
then that will be used as the hostname.
NOTE: this requires that NBNS (called Wins Port in the HP FutureSmart EWS) is enabled on the
device and NBNS is enabled for the NIC of the OS.
5. If any address resolve step fails, the device is still staged displaying the IP address only.
6. If reverse and forward address resolve succeeds, the IP address is staged with the hostname.
7. After the device is entered into the database, Security Manager uses the hostname as the
primary device identifier.
NOTE: A reverse lookup is only done during discovery. If the Hostname column is empty, it will
remain empty, even if DNS entries are created afterwards. To display the hostname in HPSM after
it has been discovered without a hostname, you must delete the device from HPSM and
rediscover.
Typing anything other than a valid IP address is interpreted as a hostname or DNS alias. The
hostname resolve process will ignore the Resolve IP addresses to hostnames when devices are
added setting and always attempt a DNS resolution.
Resolve Hostname/DNS Alias to IP Address
The hostname DNS resolve process is as follows:
1. A hostname or DNS alias is provided.
2. A DNS forward lookup occurs, and the corresponding IP address is paired for database entry.
Unlike the IP address resolve process, only a forward DNS lookup is required by the hostname
resolve process. Failure to resolve the hostname or DNS alias to an IP address produces an error.
Staging devices in the Discover Devices window can assist with device identity validation before
entering that device address into the database.
After a device is added to the Devices list, it can be removed by highlighting it and clicking the
Delete button (multiple rows can by highlighted and removed).
Figure: HP Security Manager, Discover Devices window
7
Add Devices with a Text File
The devices listed in the text file (one per line) can include IP addresses, hostnames, DNS alias
records, or a mixture of all three. The text file is invalid if the following parameters exist:
• An address line exceeds 256 characters,
• An address line contains control characters or symbols, and/or
• It cannot be parsed correctly
Figure: Example Text File using Notepad
If both the hostname and IP address are included in the XML file, the hostname is used during DNS
resolution and the Resolve IP addresses to hostnames when devices are added setting is
ignored. Hostname resolution always occurs when the hostname is provided, regardless of
whether the Resolve IP addresses to hostnames when devices are added option is selected.
HP Security Manager uses the IP address that the provided hostname resolves to, which might be
different than the IP address provided in the same XML file with the hostname. This ensures that
the hostname to IP address pairing is current.
9
Add devices to the Security Manager database
To add the devices listed in the Discover Devices table, click the Discover button. If a license file is
installed in Security Manager, devices are added to the database and automatically assigned a
license.
Without a license file installed, devices are still added to the database. Licenses can be manually
assigned later. A Success message displays the number of new devices added, duplicates
skipped, devices licensed and unlicensed.
11
Figure: Diagram of HP Security Manager communication with the device when starting a task
ConnectivityStatus - Displays the connectivity status of the device using the following numbers:
1 = Unknown, Device Status will display the following status:
HasValidCredentials –Indicates whether HPSM has the correct credentials for the device.
Displays the credentials status using the following numbers:
13
1 = Credentials are valid. Device status can be displayed as:
Good
Connection Refused (Not Supported)
UIDeviceStatusExtended
1 = No information (not verified)
2 = Good
3 = Error
4 = Network Connection Error
5 = Credentials Failed, SNMP invalid, cannot retrieve device model or NIC
6 = Not Supported
7 = Connection Refused
8 = Credentials Failed, SNMP valid
9 = Device Not Authorized
10 = License Required for Assessment
11 = Hostname Resolution Error
IsNewDevice – As long as no manual changes are made to the device, the device will be listed as New.
Displays as false/true.
ExactModelName – This is the column Exact Model Name in the Security Manager UI. For example: HP
LaserJet 500 color M551
This can be changed as part of the device configuration in the Embedded Web Server on the
General tab:
NOTE: On HP FutureSmart 3, this is called Device Name in the Embedded Web Server (EWS).
NOTE: On the Networking tab, a different name will display below the printer’s name. See
DeviceHostName.
15
MacAddress – This is the MacAddress which is used for communication with the device. For
example: 3CD92BA0F064
WasHdapDiscovered – Indicates whether the device is discovered via Instant On (HP device
announcement protocol). Displays as false/true.
HasCredentialsSet – No longer used, always holds the default value of false. Displays as
false/true.
NetworkAddress – Hostname of the device, if hostname is not present then the IP address will be
used.
AdminCredentialWorks
0 = None
1 = Success
2 = Failed
3 = NotTried (Not Verified, perhaps because no SNMP read access)
4 = NotTriedReadOnly
5 = Inconclusive
6 = TimeOut (available from HPSM 3.6 and newer)
SnmpV1ReadWorks
0 = None
1 = Success
2 = Failed
3 = NotTried (Not Verified, perhaps because no OID support)
4 = NotTriedReadOnly
5 = Inconclusive
6 = TimeOut (available from HPSM 3.6 and newer)
17
SnmpV1ReadWriteWorks
0 = None
1 = Success
2 = Failed
3 = NotTried
4 = NotTriedReadOnly
5 = Inconclusive
6 = TimeOut (available from HPSM 3.6 and newer)
SnmpV3Works
0 = None
1 = Success
2 = Failed
3 = NotTried
4 = NotTriedReadOnly
5 = Inconclusive
6 = TimeOut (available from HPSM 3.6 and newer)
PjlCredentialWorks
0 = None
1 = Success
2 = Failed
3 = NotTried
4 = NotTriedReadOnly
5 = Inconclusive
BootLoaderCredentialWorks
0 = None
1 = Success
2 = Failed
3 = NotTried
4 = NotTriedReadOnly
5 = Inconclusive
DiskEncryptionCredentialWorks
0 = None
1 = Success
2 = Failed
3 = NotTried
4 = NotTriedReadOnly
5 = Inconclusive
SslValidCert – Indicates whether the installed ID certificate is valid using the following numbers:
0 =true
1 = false (a self-signed certificate is always displaying SslValidCert as false)
LastChangedWhen – Displays when the latest date when a change was made on the device with
an HPSM policy.
NOTE: A date of 9999-12-31T23:59:59 means that HPSM has not made any changes to the device
configuration. When a device is reset to Not Assessed, the lastChangedWhen entry remains
unchanged. Example: 2021-02-24T09:40:38
19
EnforceSSLManual – Not available in UI, is managed only internally in HPSM code. Displays as
false/true.
DeviceHostName - This is the column System Name in the Security Manager UI and the configured Host
Name on the device.
NOTE: In the EWS, the Host Name will be displayed as well below the printer’s name.
NOTE: If on a different tab than the Networking tab, a different name will display below the
printer’s name. See DeviceName.
DeviceLocation – This is the column Device Location in HPSM and is the configured device location on
the device. In the EWS.
ConnectivityStatusText – This is the textual status which will be displayed in the Device Status column:
The exported values are always truncated (meaning no spaces between the different words).
DeviceStatusText – This is related to the text which is displayed in the Assessment Status column
None.
o Pass = Passed
o NotAssessed = Not Assessed
o Low = Low Risk
o Medium = Medium Risk
o High = High Risk
o Error =
FirmwareSecurityStatus – Only after running an assessment with Check for Latest Firmware set to
Firmware Security Service, you can see one of the following values. If no assessment with Firmware
Security Service had been running, then the value will always be None.
o OK = the device firmware is OK
o Vulnerable = there are one or more vulnerabilities in the firmware
o OutOfSupport = the firmware for the model is no longer actively being updated by HP
o OutOfDate = the firmware is more than two revisions out-of-date
o NonHP = the model in question is a non-hp product
o NoFirmware = the model in question does not have upgradeable firmware
o NotEvaluated = the firmware was not evaluated because there was not enough data to
evaluate (as printer might be too old and might not be listed in firmware security service)
o NotDefined = Indicates either a new status or an invalid response.
Bulletins – Displays more details about the relevant bulletins for the corresponding Firmware
Security Status
21
Exporting devices from Security Manager 3.9 and later
The values in the exported device list have a clear textual meaning since HPSM 3.9. From HPSM 3.10
onwards it’s possible to select which columns should be exported and the following selection screen
will come up during export:
NOTE: Even if you have permissions to write information to the database such as DBO rights,
never alter any of the information in the SQL tables for fear of breaking the software. Reading
information is fine but altering any data in the tables could affect the functionality of the software
itself.
The Security Manager database is always named HPIPSC. The database includes many tables,
but the one table containing the most valuable device data is named dbo_DeviceTable. The table
listed earlier in this appendix describes the columns and values in this table responsible for
storing information pertaining to which devices have been assessed or unassessed and the risk
levels for each that has been assessed.
Besides the information, which is exported when you select export devices, the following columns
are also available in the dbo_DeviceTable:
State - Indicates if device is present in All Devices List or not
2 = Valid and present in All Devices List
3 = Deleted and no longer present.
There is a nightly process that cleans up and removes devices in State=3, but you will want
to exclude these from queries if they exist since they represent deleted devices.
uiDeviceStatus
1 = No information
2 = Good
4 = Connection Refused, Credentials Failed, Error, Not Supported, Network Connection
Error, Hostname Resolution Error
uiAssessmentStatus
1 = Passed, no remediation necessary as device is in compliance with policy
23
2 = Not Assessed because of statuses such as Error, Network Connection Error,
Connection Refused, Not Supported, No Information, Credentials Failed, Hostname
Resolution Error
3 = Low Risk
4 = Medium Risk
5 = High Risk
HostnameResolutionFailed
1 = Yes
2 = No
3 = Not Verified, perhaps because no OID support
Appendix A
Other HP Security Manager Whitepapers and Manuals
There are a lot of guides and whitepapers available for HP Security Manager.
The view them, go to the HP Security Manager Support page and click the Manuals tab. The following
list of documents is available at the above location:
The section Product Information on the HP Security Manager Support page contains the
following information:
• Supported device features matrix (.xls)
hp.com/go/support
Current HP driver, support, and security alerts delivered directly to your desktop.
© Copyright 2020 HP Development Company, L.P. The information contained herein is subject to change without notice. The only
warranties for HP products and services are set forth in the express warranty statements accompanying such products and services.
Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or
omissions contained herein.
25