TheHive-Project / TheHive-Project/Cortex-Analyzers

[FR] New analyzer: macadress.com (MAC address enrichment)

Open
#1,494 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
490
Forks
405
Avg merge
2d 43m
Merged PRs (30d)
8

Description

Feature description
An analyzer for macadress.com that enriches a mac observable with vendor identity, inferred device category, virtualization / container-network detection, special-use address classification, and MAC-randomization confidence.

Describe the solution you'd like
A cortexutils-based analyzer, one required api_key config item (free tier: 1,000 lookups/month, no card). Summary taxonomies: macadress:Vendor, macadress:Device, macadress:Virtualization, macadress:SpecialUse, macadress:Randomized. I have it built and tested and will open the PR.

Additional context
API docs: https://macadress.com/docs

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the macadress.com API documentation and existing cortexutils-based analyzers in the repository. The work is done when the analyzer uses the required api_key and reports the requested Vendor, Device, Virtualization, SpecialUse, and Randomized taxonomies, with the documented behavior tested.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
security
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.