Page tree
Skip to end of metadata
Go to start of metadata

Device profile information is collected about a remote computing device for the purpose of identification. Lumeta ships with an extensive preconfigured library of vendors, device types, operating systems, and OS versions. Your enterprise can customize this library of device profiles and use it to label devices in reports and maps.  When you import a custom device profile, that profile does not modify or delete the original signature files provided with Lumeta. Customized device profiles override defaults for reporting purposes only.  If, for example, a customized device file were removed after being applied, the system would revert to using the original default values. As soon as the import is complete, all current and future reports reflect the new custom device profile. There is no need to make additional adjustments to see the updated profiles in reports.

This page details how to manage custom profiles via these Settings > Device Profile Patterns options:


  • Import - Ingest fingerprints/patterns from Lumeta or your enterprise. 
  • Export - Produce a backup file of all fingerprints/patterns defined by your enterprise
  • Delete - Removes all custom fingerprints/patterns.
  • Download Sample File - Useful as template to create your own customized fingerprints. 
  • Download XSD - Useful as template to create your own customized fingerprints. 

Imported fingerprints/patterns are applied globally to all organizations in Lumeta. When a customized fingerprint is imported, it is applied to all existing device profiles. Those device profiles are "re-profiled" using your newly imported custom device profiles. 

Only a system administrator with the SuperUser profile can upload, download, and delete custom fingerprints. Users can upload custom fingerprints.

Exporting Device Profile Patterns Using Curl

To export all user-defined patterns:

  1. Enter this command on any system, replacing the IP address in the command with the system name or IP address of your system:
    curl -k -u "admin:admin" https://10.9.0.254/api/rest/config/profile/patterns?filter.pattern.userDefined=true

To export all standard patterns:

  1. Enter this command on any system, replacing the IP address in the command with the system name or IP address of your system:
    curl -k -u "admin:admin" https://10.9.0.254/api/rest/config/profile/patterns?filter.pattern.userDefined=false

Importing Custom Device Profiles

Import custom profiles as follows:  

  1. Browse to the Settings > Device Profile Patterns page.
  2. In Device Profile Patterns, click Import.
  3. Import a file of fingerprints containing entries for the IP/CIDR address, Label, and Value. 
    Profile files contain profile_cifs, profile_sysDescr, profile_sysObjectID, profile_http and look like this:



    You can download a sample file to use as a template.
  4.  Indicate whether you would like to replace the global list of custom fingerprints or add onto it.

  5.  Your imported device profiles display in reports.

Exporting Custom Device Profiles

Export custom device profiles as follows:  

  1. Browse to Settings > Device Profile Patterns.
  2. In Device Profile Patterns, click Export.
  3. The ConfigManagement.getPatterns.xml file containing your custom device profile patterns is saved.
    Following is an example of one device profile pattern.



    These files can be imported after an Lumeta upgrade.  
     

Editing a Device Profile

After an initial upload of customer-supplied device profile patterns, the file can simply be downloaded, modified further and re-uploaded. Additional patterns may be added to the Customer Patterns file simply by copying the appropriate section (e.g., hardware) and appending it to the end of the document. 

XML requires the use of both opening and closing tags to create a complete and accurate XML expression. During the upload process, the syntax of the file is checked for accuracy and may fail if standard XML formatting practices are not used.

  1. Download a sample file to use as a template



  2. Modify the sample in any text editor.

  3. Indicate whether you would like to replace the global list of custom fingerprints or add onto it.


  4. Save your work.

Downloading Custom Fingerprints

Click Download XSD to download the patterns.xsd file, which contains all of your company's custom patterns. The XSD file facilitates using an XML parser. The parser aids in the editing process by ensuring that edits meet Lumeta requirements for the custom device profile file. There are many XML parsers available and each has its own conventions. Overall, a parser provides the main advantages of color-coding text, checking syntax and providing and organized interface for editing. The procedures and steps for modifying the profiling file are identical to those above but are done so in a more structured editing environment. Lumeta recommends using an XML parser and the XSD file to reduce errors. Once the XSD file has been edited it can be importing using the Import procedure provided above.

Deleting Custom Fingerprints

Here's how:

  1. Click Delete to remove all custom fingerprints.



  2. Confirm your selection.


    Lumeta-sourced fingerprints are retained.  Custom fingerprints are deleted. 


  • No labels
Write a comment...