ShadowTrackr

RSS feed

ShadowTrackr app for Splunk

16 November 2026

Until now, ShadowTrackr data lived in ShadowTrackr. If your SOC lives in Splunk, that meant a second tab, and a lot of copy-pasting an IP address from one to the other. With the new Splunk app access to ShadowTrackr data has drastically improved.

What it does

Most of our integrations pull data in. This one goes the other way: it sends your external attack surface into Splunk. Your SOC can then alert on it, use it to enrich the logs it already has, and explore it in dashboards. It is read-only, so it can't change anything in your ShadowTrackr account. The app is open source (Apache-2.0) and the code is on GitHub.

  • Events. Everything on your timeline (new open ports, vulnerabilities, certificate problems, blacklistings, leaked data, phishy domains) is indexed as CIM-mapped events with the sourcetype shadowtrackr:events.
  • Inventory. Hosts, websites, domains, subnets, certificates, DNS records, mail servers, software, CVEs, suppliers and more are synced into KV Store lookups, including what appeared or disappeared.
  • Dashboards. Six of them, see below.
  • Detections. Twelve scheduled searches and three health checks.
  • Enterprise Security. Every detection also exists as a correlation search that creates notable and risk events with MITRE ATT&CK annotations.
  • Alert webhook (optional). Push ShadowTrackr alerts into Splunk within seconds instead of waiting for the next sync.

The dashboards

  • Overview: events, problems and warnings over time, plus inventory counts and trends.
  • Vulnerabilities & software: CVEs by severity, known exploited and CISA KEV items, vulnerable software and the assets at risk.
  • Certificates: expiry, grades, issuers and weak configurations.
  • Supplier dependency: which suppliers hold your assets, where they are headquartered and who controls them. Handy for NIS2 and digital sovereignty questions. This needs supplier mapping in your plan.
  • Asset 360: one asset from every angle, combined with your own firewall, proxy/WAF, authentication and IDS logs.
  • Search explorer: live API queries that only run when you press Submit.

Your logs, with context

A firewall log tells you that something connected to 203.0.113.10. It doesn't tell you that this is your forgotten staging server, with an exposed admin panel and a known exploited CVE. The app adds a search command that does:

index=firewall action=allowed
| stenrich field=dest_ip
| where st_known=1 AND st_exploited=1

stenrich adds fields such as st_known, st_ports, st_cves, st_max_cvss, st_exploited, st_cisa_kev and st_phishy. It only reads the local lookups and makes no API calls, so it's fast and doesn't eat into your rate limits. If you do want live data, | shadowtrackr query="..." runs ShadowTrackr queries directly from the search bar.

Asset 360 uses the same idea. Point four macros at your own indexes and you can go from an asset to the traffic, logins and IDS hits around it.

Detections

The app ships twelve detections, including:

  • a known exploited vulnerability appears on your attack surface
  • a risky service is exposed
  • a certificate is about to expire
  • there is a subdomain takeover risk
  • an attack hits an asset with a known vulnerability
  • someone browses to a phishy lookalike of your domain
  • a successful external login on an exposed remote access service

The last three combine ShadowTrackr data with your own logs, which is something we can't do on our side.

All detections are disabled by default. I'd rather you switch on the ones you want than wake up to a hundred notables. They are throttled, events older than seven days never fire, and the first inventory sync is treated as a baseline so you don't get an alert for everything you already own. If you use Enterprise Security, enable the "- Rule" version of a detection only, not both.

Setting it up

You need a Business or Enterprise plan (API access), Splunk Enterprise or Splunk Cloud with KV Store enabled, and a read-only API key. We tested on Splunk Enterprise 9.4 and 10.2. MSSPs can use a group read-only key.

  1. Install the app from Splunkbase on your search head.
  2. Create an event index called shadowtrackr.
  3. In ShadowTrackr, create a Read-only key under Settings > API access. It's shown only once.
  4. In the app, add the key under Configuration > Accounts.
  5. Create two inputs: ShadowTrackr Events (every 15 minutes, with a 7-day first backfill) and ShadowTrackr Inventory (four times a day on weekdays).
  6. Check the Data sources panel on the Overview dashboard to see that data is arriving.

Two things that will otherwise bite you: API keys expire after a year by default, and the inputs then quietly stop. (Rolling a key leaves the old one working for a grace period, so you can swap without a gap.) And if your key has an IP restriction, allow your Splunk server's public IP. On Splunk Cloud that's your stack's outbound IPs. The app also has health checks for exactly this: no events for 24 hours, input errors, and failed or stale inventory syncs.

Webhook for real-time alerts

The 15-minute poll is fine for most things, but if you want alerts in Splunk within seconds, add a webhook to an alert in ShadowTrackr using the "Splunk HEC event" payload. In Splunk you enable HEC and create a token for the shadowtrackr index. Your HEC endpoint must be reachable over HTTPS with a certificate from a public CA. Self-signed certificates are refused, and that's not going to change. Retries can occasionally deliver a result twice, so deduplicate on st_result_key. The docs have the full steps.

Security

The API key is stored encrypted in Splunk's credential store, the key is read-only, and the app passes Splunk AppInspect, including the Splunk Cloud checks. Proxies are supported if Splunk can't reach api.shadowtrackr.com directly. And because the source is public, you can read exactly what it does before you install it.

What to do next

  1. Get the app from Splunkbase and follow the setup guide.
  2. Look at the Vulnerabilities & software dashboard first. It's usually the most eye-opening.
  3. Enable one or two detections, watch them for a week, then add more.
  4. Try | stenrich on your firewall or proxy logs.

Scoped API keys and signed webhooks: least privilege, built in

09 November 2026

Until now, an API key in ShadowTrackr could do everything your account could do. That is convenient, but it is not how you want to hand out access to a script, a SIEM or a colleague's dashboard. We added two things to fix that: API keys with a limited scope, and HMAC signatures on webhooks. Both help with the security measures that EU regulation asks of you.

Scoped API keys

When you create an API key, you now choose what it is allowed to do. A key for your reporting dashboard only needs to read. A key for a ticketing integration might only need to read findings. A key that can change settings or delete things is something very few integrations need.

Some examples of how this works in practice:

  • Read-only key for a BI tool or dashboard. If it leaks, nobody can change anything in your account.
  • One key per integration. If you stop using a tool, you revoke its key and nothing else breaks.
  • Narrow keys for contractors and partners, with only the access they need for the job.

Existing keys keep working as before. You can replace them with scoped keys when it suits you. The API documentation lists the available scopes.

Signed webhooks (HMAC)

An alert can call a webhook, but until now the receiving side had no way to know that the call really came from ShadowTrackr. Anyone who found your endpoint URL could send it fake alerts.

You can now turn on HMAC signing for a webhook. ShadowTrackr calculates a signature over the payload with a secret that only you and ShadowTrackr know, and sends it in a header with every call. Your endpoint calculates the same signature and compares. If it does not match, you throw the request away.

This gives you two things:

  • Authenticity. The message really comes from ShadowTrackr.
  • Integrity. The payload was not changed on the way.

The secret is stored encrypted and shown only once, like the custom header values. It works with all payload types, so it also covers JSON results, Splunk HEC and the rest. The documentation has a short verification example you can paste into your own code.

Why this fits EU regulation better

Regulation like NIS2, DORA and the GDPR does not tell you which header to use. It does expect you to show that you control who can access what, and that you protect your data in transit and know where it came from. These two options map onto that quite directly:

  • Least privilege. NIS2 asks for access control and risk-based security measures, and the GDPR asks for appropriate technical measures (Article 32). A key that can only do its one job is the simplest way to show this.
  • Smaller blast radius. If a key leaks, the damage is limited to its scope, and you revoke that one key. That makes incidents easier to contain and easier to report.
  • Supply chain and third parties. NIS2 and DORA both put weight on third-party risk. Giving a partner a narrow key instead of full access is a control you can explain to an auditor.
  • Integrity of security data. Alerts often trigger real actions: a ticket, a page to an on-call engineer, a firewall change. Signed webhooks make sure those actions are triggered by real alerts only.

To be clear, no feature makes you compliant on its own. What these two do is give you controls you can point to, instead of a shared key and an unauthenticated endpoint. ShadowTrackr is hosted in Germany and run by an EU company, so your data stays inside the EU while you do this.

What to do next

  1. Make a list of the places where you use a ShadowTrackr API key.
  2. Create a scoped key for each one, with the least access it needs, and revoke the old key.
  3. Turn on HMAC signing for your webhooks and add the verification to your receiving endpoint.

Spotting subdomain takeovers, and better alert webhooks

02 November 2026

Every domain collects old DNS records. A campaign site that was shut down, a test server that was never removed, a hosting account that expired. The record stays, and it keeps pointing at a server that is no longer yours. That is how subdomain takeovers happen. I added a report for this to ShadowTrackr, and I extended the webhook options so you can get the alerts in the tools you already use.

The Subdomain Takeover Report

The new report lists web addresses of yours that point to a server that is not set up for them. You can run it from the search bar with $subdomain_takeover_report. It also appears in the report library under the DNS category, where you can schedule it.

Each result is one of two things:

  • Possible takeover. The server shows someone else's live website for your name. Whoever runs that server could publish content under your domain.
  • Stale DNS record. Only a placeholder answers: a registrar's "reserved" page, a for-sale page, or the default page of a hosting company or web server. Nobody else's website is there, but the record serves no purpose and could still be taken over later.

Addresses that point to another domain of your own organisation are left out, because those are not findings. Possible takeovers are listed first. The fix is usually simple: remove the DNS record, or point the name back to a server you control.

The weekly PDF report now has a "Subdomain takeover" section too. It sits in the urgent part of the report, so you will see these findings without having to go looking for them.

More webhook options

An alert can call a webhook instead of sending an email. Choose Call webhook as the action and pick a payload:

  • Results as JSON, or No data (just a ping that the alert fired)
  • Microsoft Teams (Adaptive Card), Slack, Mattermost, Discord and Google Chat messages
  • PagerDuty, which creates an incident
  • Splunk HEC event, one event per result row

You can also add up to 10 custom headers to every call, for example an Authorization header to authenticate to the receiving tool. Header values are stored encrypted and shown masked after you save.

A good combination is an alert on $subdomain_takeover_report that posts to your security channel. The same applies to any other query.

One thing to know: ShadowTrackr verifies the TLS certificate of your endpoint, and there is no option to switch that off. A self-signed certificate is refused. This matters for self-managed Splunk, which ships with a self-signed certificate. The documentation has step-by-step instructions for each tool.

Older posts >