Skip to main content
Applies to BloodHound Enterprise and CE

​
Introduction

Since arbitrary nodes don’t have predefined types, there needs to be a way to specify custom icons. Here are a few possible approaches.

​
Icon Selection

​
Predefined icon set

  • Provide a set of icons (from Font Awesome) and allow users to specify an icon name
  • Users can optionally specify a color per node kind. Acceptable values are #RGB or #RRGGBB
  • The entirety of the free, solid icons that font awesome offers are available. Supported icons can be viewed on the official Font Awesome docs.
  • User must correctly specify the icon name using Font Awesome’s naming conventions.
    • A valid icon name will be something like “house” or “smile” without any fa-, fas-, etc. prefixes
  • Render a (?) icon on failed mappings.
  • Provide a PUT endpoint for users to correct erroneous mappings (ie. feUser instead of faUser)

​
Example payload for custom icons

{
  "custom_types": {
    "person": {
      "icon": {
        "type": "font-awesome",
        "name": "user",
        "color": "#FFF"
      }
    },
    "device": {
      "icon": {
        "type": "font-awesome",
        "name": "desktop"
      }
    },
    "alert": {
      "icon": {
        "type": "font-awesome",
        "name": "house"
      }
    }
  }
}

​
Example with API Explorer

You can set custom icons directly from the BloodHound API Explorer without writing any code.
1

Open the API Explorer

Navigate to the API Explorer from the BloodHound menu.BloodHound menu showing the API Explorer option
2

Select the POST endpoint

Under Custom Node Management, expand the POST /api/v2/custom-nodes endpoint and click Try it out.API Explorer showing the POST custom-nodes endpoint
3

Enter your payload and execute

Enter your custom icon configuration in the Request body field and click Execute.API Explorer with a custom icon payload ready to execute
4

Verify the response

A 201 response confirms your custom icons were created successfully.API Explorer showing a successful 201 response with the custom icon configuration

​
Example with Python

Here’s a simple Python script to help you customize your icons.
You will need to generate a Bearer Token Note Make sure to adjust the url and replace the place holder token in the script. 
import requests
import json
import urllib3

urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)

url = "http://127.0.0.1:8080/api/v2/custom-nodes"

headers = {
    "Authorization": "Bearer ey<REDACTED>scduDoG7TmxU",
    "Content-Type": "application/json"
}

def define_icon(icon_type, icon_name, icon_color):
    payload = {
        "custom_types": {
            icon_type: {
                "icon": {
                    "type": "font-awesome",
                    "name": icon_name,
                    "color": icon_color
                }
            }
        }
    }

    response = requests.post(
        url,
        headers=headers,
        json=payload,
        verify=False  # Disables SSL verification
    )

    print(f"🔹 Sent icon for: {icon_type}")
    print("Status Code:", response.status_code)
    print("Response Body:", response.text)
    print("---")

# Call function for each icon type you want to send
define_icon("Node1", "burst", "#03CEFC")
define_icon("Node2", "home", "#D67500")
You can call define_icon as many time as you need for each of your node type.