Fingerbank device fingerprinting in deep-check #16

Closed
opened 2026-07-12 23:30:28 -06:00 by jhodgkin · 1 comment
Owner

MAC OUI vendor lookup only gives the manufacturer (e.g. "Nintendo Co.,Ltd"), not the specific product. Fingerbank's API can identify the actual device (e.g. "Nintendo Switch") from MAC + any local signals (mDNS/SSDP) our existing deep-check already gathers. On-demand only, folded into the existing Deep check button. Needs a free Fingerbank API key from the user (external account, cannot self-provision).

MAC OUI vendor lookup only gives the manufacturer (e.g. "Nintendo Co.,Ltd"), not the specific product. Fingerbank's API can identify the actual device (e.g. "Nintendo Switch") from MAC + any local signals (mDNS/SSDP) our existing deep-check already gathers. On-demand only, folded into the existing Deep check button. Needs a free Fingerbank API key from the user (external account, cannot self-provision).
Author
Owner

Done. Fingerbank folded into the existing Deep check button (mac + SSDP SERVER header when found). Honest finding from direct testing: without DHCP fingerprint data (structurally unavailable to us -- not the DHCP server), MAC-only queries often bottom out at manufacturer-level confidence, same as the free OUI lookup. Documented plainly in docs/device-discovery.md rather than overselling it; UI shows the confidence band (low/moderate/high/very high per Fingerbank's own bands) so a low-confidence guess is never mistaken for a confirmed ID. Still valuable as opt-in enrichment for devices with richer signals. 15/15 e2e tests green.

Done. Fingerbank folded into the existing Deep check button (mac + SSDP SERVER header when found). Honest finding from direct testing: without DHCP fingerprint data (structurally unavailable to us -- not the DHCP server), MAC-only queries often bottom out at manufacturer-level confidence, same as the free OUI lookup. Documented plainly in docs/device-discovery.md rather than overselling it; UI shows the confidence band (low/moderate/high/very high per Fingerbank's own bands) so a low-confidence guess is never mistaken for a confirmed ID. Still valuable as opt-in enrichment for devices with richer signals. 15/15 e2e tests green.
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jhodgkin/homelab-monitor#16