Documentation

    {{docApp.userSession.userId}}
    {{docApp.userSession.userName}}
    {{docApp.userSession.email}}
    Issuer : {{docApp.userSession.issuerInstance}}
    Expires : {{new Date(docApp.userSession.validUntil).toLocaleDateString()}}

{{docApp.title}}

{{docApp.description}}

Connect an AI assistant

Your AI assistant can read this documentation directly, so it answers from the current content instead of guessing. Add one of the servers below to your client — they use the Model Context Protocol (MCP). Each one covers a different body of content, so add the one you need.

The catalog did not load. Refresh the page to try again.

Loading…

How can we help?

{{docApp.searchError}}

Searching in {{docApp.searchFilterBySpecificBookTitle}}

 {{docApp.currentResultsSearchText}}  in {{docApp.searchFilterBySpecificBookTitle}}
Found {{docApp.searchResponse.totalResultsAvailable}} matches. Showing the top {{docApp.searchResponse.results ? docApp.searchResponse.results.length : 0}}. Use a more specific search to further narrow down the results.
No documentation pages match this search, so all content types are shown. Most matches are in {{docApp.searchDocTypeRescue.best.name}}.
There is no book with the ID "{{docApp.searchBookRescue.bid}}", so the book filter from this link was ignored and results from all books are shown.

You have an odd number of " characters in your search terms - each one needs closing with a matching " character!

  • {{resultItem.title}} {{resultItem.matchedBy === 'semantic' ? 'semantic' : (resultItem.matchedBy === 'both' ? 'keyword + semantic' : 'keyword')}}

    {{resultItem.url}}

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

Configuration Example - Jamf

The following is an example of the SourceConfig, AssetTypes and data mapping configuration that could be used to import computer-type or mobile device assets from Jamf.

Important

The configuration example is provided as-is, and may not be suitable to import your organization’s Jamf asset data. We highly recommend that a Jamf administrator review the query and mappings against your Jamf account before using this in a production environment.

For Computer Assests:

{
  "KeysafeKeyID": 0,
  "LogSizeBytes": 1000000,
  "HornbillUserIDColumn": "h_user_id",
  "SourceConfig": {
    "Source": "jamf",
    "Jamf": {
      "inventoryType": "Computer",
      "Query": ""
    }
  },
  "AssetTypes": [
    {
      "AssetType": "Laptop",
      "OperationType": "both",
      "PreserveShared": false,
      "Query": "",
      "AssetIdentifier": {
        "SourceColumn": "id",
        "Entity": "Asset",
        "EntityColumn": "h_name"
      }
    }
  ],
  "AssetGenericFieldMapping": {
    "h_name": "{{.id}}",
    "h_asset_tag": "{{.general.assetTag}}",
    "h_description": "From Jamf: {{.general.name}} ({{.general.platform}})"
  },
  "AssetTypeFieldMapping": {
    "h_name": "{{.id}}",
    "h_mac_address": "{{.general.macAddress}}",
    "h_net_ip_address": "{{.general.lastIpAddress}}",
    "h_net_computer_name": "{{.general.name}}",
    "h_description": "From Jamf: {{.general.name}} ({{.hardware.model}})",
    "h_memory_info": "{{.storage}}",
    "h_os_description": "{{.hardware.batteryHealth}}",
    "h_serial_number": "{{.hardware.serialNumber}}",
    "h_os_version": "{{.operatingSystem}}"
  }
}

For Mobile Assets:

{
  "KeysafeKeyID": 0,
  "LogSizeBytes": 1000000,
  "HornbillUserIDColumn": "h_user_id",
  "SourceConfig": {
    "Source": "jamf",
    "Jamf": {
      "inventoryType": "Mobile",
      "Query": ""
    }
  },
  "AssetTypes": [
    {
      "AssetType": "Smart Phone",
      "OperationType": "both",
      "PreserveShared": false,
      "Query": "",
      "AssetIdentifier": {
        "SourceColumn": "mobileDeviceId",
        "Entity": "Asset",
        "EntityColumn": "h_name"
      }
    }
  ],
  "AssetGenericFieldMapping": {
    "h_name": "{{.mobileDeviceId}}",
    "h_asset_tag": "{{.hardware.assetTag}}",
    "h_description": "From Jamf: {{.userAndLocation.username}} ({{.hardware.model}})"
  },
  "AssetTypeFieldMapping": {
    "h_name": "{{.mobileDeviceId}}",
    "h_mac_address": "{{.hardware.bluetoothMacAddress}}",
    "h_net_ip_address": "{{.hardware.wifiMacAddress}}",
    "h_net_computer_name": "{{.userAndLocation.name}}",
    "h_description": "From Jamf: {{.userAndLocation.username}} ({{.hardware.model}})",
    "h_memory_info": "{{.hardware.availableSpaceMb}}",
    "h_serial_number": "{{.hardware.serialNumber}}",
    "h_model": "{{.hardware.model}}",
    "h_physical_disk_size": "{{.hardware.capacityMb}}"
  }
}
  • Version {{docApp.book.version}}
  • Node {{docApp.node}} / {{docApp.build}}
In This Document