Huntress: protected endpoints, EDR coverage, and SOC incidents
Huntress is managed detection and response: an agent on each endpoint, and a security operations centre of human analysts who investigate what it finds and write up what mattered. This connector reads three things out of it: which endpoints are protected and how well, the SOC incident reports raised against them, and the per-product counts Huntress keeps for each of your organizations. Each one hangs off the matching Current company, so it feeds your security business reviews and the company alert band. Current reads Huntress and can never change anything in it.
What Current syncs
| Data set | What Current stores | Where it lands |
|---|---|---|
| Organizations | Each Huntress organization (your partner) by id and name, plus the counts Huntress keeps on it: agents, lifetime incident reports, identity seats, security-awareness learners, and log sources | The mapping panel on the Huntress card, and the products shown on the company's security card |
| Agents | Per endpoint: hostname, platform, operating system, agent version, serial number, when it last called home, and whether managed EDR is installed | The mapped company's posture panel, SBR packs, and the dashboard endpoint metrics |
| Endpoint coverage | Per endpoint, whether the firewall is enabled, whether tamper protection is actually on, and the Windows Defender status strings Huntress reports | The company's posture panel and the SBR security chapter |
| Incident reports | Per report: severity, status, which platform it came from, the one-line subject Huntress generates, what kind of indicators were involved, and when it was sent and closed | The company alert band, the security card, and the incident metrics |
Generate the API credentials in Huntress
- 11 · Open API Credentials in your Huntress portalSign in at your own Huntress address, which looks like your-subdomain.huntress.io, as an account administrator. Open the menu at the top right and choose API Credentials; the same page also sits under Account Settings. If there is no such menu item, your Huntress account has not been granted API access yet — that is the first thing to ask Huntress about, and nothing below will work until it is sorted.
- 22 · Generate an ACCOUNT key pair, not a user keyThe page has two sections: account credentials and user credentials. Generate the account pair. Huntress makes the account key read-only by design and has never added write capability to it, so that credential cannot change anything in Huntress even in theory. A user key is different: it carries whatever permissions its person's role carries today, and it gains more the moment somebody promotes them, without telling Current. If you must use a user key, make it belong to a user whose account-level role is Read-Only.
- 33 · Copy the secret before you leave the pageHuntress shows the API secret key exactly once, at the moment you generate it. There is no way to look it up afterwards — a lost secret means generating a fresh pair. Copy both halves now.
- 44 · Paste both halves into Current and testIntegrations → Huntress → Connect. Paste the key and the secret and press Test connection. Current makes one read against Huntress to confirm the credentials work and can actually see your account, then stores them server-side only; they are never shown again and never reach your browser.
Map organizations to your companies
In Huntress each end-customer is an organization under your account. Current lists all of them and links each to a Current company by normalized name — lowercased, with punctuation and Inc/LLC/Ltd-style suffixes stripped — and only when exactly one company matches. Two companies that both fit stay unmapped for you to decide.
- 1Let the auto-matcher run firstEvery sync links each organization to the one Current company whose normalized name matches. Most organizations map themselves; only the ambiguous ones need a hand.
- 2Open the mapping panelIntegrations → Huntress → Manage → Customer mapping. It opens on the Unmapped tab, which lists every organization the matcher could not place.
- 3Map an organization to its companyOn an unmapped row press Map, type a few letters of the Current company, and pick it. That organization's endpoints and incidents attach to the company right away, rather than waiting for the next six-hour sync.
- 4Ignore internal or test organizationsFor an organization that should never map to a partner — your own internal fleet, a lab, a demo — press Ignore. It moves to the Ignored tab and stops counting against the card's unmapped badge.
- 5Fix a wrong match laterThe Mapped tab lists every linked organization; Unmap corrects a bad auto-match, and the Ignored tab's Un-ignore brings a dismissed one back. A mapping you set by hand is never overwritten by a later auto-match, and neither is a manual unlink. Mapping an organization once also teaches Current its identity tenant id, so a later rename on either side does not break the link.
Where the data shows up
- +The company's posture panel: protected endpoints, how many are online, EDR coverage, and the open incident count by severity for the mapped organization.
- +The company's security card, alongside your other endpoint-security feeds, with coverage gaps listed one line each: endpoints with no EDR installed, firewall disabled, or tamper protection off.
- +The Security posture chapter of a Strategic Business Review, beside your other security feeds.
- +Dashboard security metrics — endpoint coverage and open-critical counts read from Huntress once it is connected and mapped.
- +The company alert band: an open critical Huntress incident joins the same critical-security entry your other endpoint-security feeds already fire, rather than adding a second line that says the same thing twice.
When something looks wrong
| What you see | What it means |
|---|---|
| "Huntress rejected the credentials" | The key or the secret is wrong, or the pair was regenerated in Huntress and the old one stopped working. Generate a fresh pair on the API Credentials page and paste both halves again — remember the secret is only shown once. |
| "Huntress refused this credential" | Huntress answers the same way for a wrong credential and for a right credential without permission, so the message names both. Check the key and secret first, then check that the pair was generated on the Huntress account that actually owns your organizations. A user key belonging to someone whose role was narrowed will read this way too. |
| "Couldn't reach Huntress" | A network or firewall problem between Current and api.huntress.io, not a credential problem. Current retries on its own at the next scheduled sync. |
| "Huntress is rate-limiting the request" | Huntress allows sixty requests a minute across your whole Huntress account, shared with anything else you have connected to it. Current paces itself well under that, but a burst from another tool can still use the budget up. Nothing is wrong with the credentials; wait and press Test again. |
| Connected, but no organizations listed | The credential authenticates but cannot see the organization list. That is usually a key generated on the wrong Huntress account, or a user key whose person has no read permission. |
| A company shows no Huntress data | Its organization is not mapped yet, or the organization genuinely has no agents. Check the Unmapped tab on the card. |
| Endpoint counts are blank rather than zero | Huntress did not answer for that part of the run. Current shows blank rather than zero, because a zero would read as "nothing to protect here" when the truth is "we could not ask". The figure fills in on the next sync. |
| An endpoint shows no online state | Huntress reports when an agent last called home, and Current works out online from that: within a day is online, longer is not. An endpoint that has never reported a callback shows neither, because guessing either way would be wrong. |
