Skip to main content
IT BIBLESign in

Honeypot data

The honeypot badge

Put a live honeypot number on your own page or README with one line.

The badge shows one of the honeypot's live numbers, the same ones the public honeypot page shows for the last 24 hours. It is free, needs no sign-up and holds nothing but a count.

Use it

In a README or any Markdown:

[![Honeypot attackers](https://itbible.org/tools/honeypot/badge.svg)](https://itbible.org/tools/honeypot)

In HTML:

<a href="https://itbible.org/tools/honeypot"><img src="https://itbible.org/tools/honeypot/badge.svg" alt="Different addresses that attacked the IT Bible honeypot in the last 24 hours"></a>

Choices

Add them to the address, such as badge.svg?metric=countries&color=amber.

Parameter Choices
metric attackers (the default: different addresses), attempts (login attempts), breaches (logins the decoys accepted) or countries
color blue (the default), amber, green or red
style flat (the default) or flat-square
label Your own text for the left side, up to 32 letters, numbers and simple punctuation

Anything else is refused with a 422, so a broken address shows up when you try it.

With shields.io

badge.json gives the same number in the shape shields.io reads, so you can style it with their options:

![attackers](https://img.shields.io/endpoint?url=https%3A%2F%2Fitbible.org%2Ftools%2Fhoneypot%2Fbadge.json)

Good to know

  • The numbers are cached for about five minutes, and browsers and image proxies may keep a badge a little longer.
  • They are counts of what reached our few decoy servers, so they say what attackers tried against us, not how the internet as a whole is doing.
  • Please do not make decisions about security from a badge. For addresses to block, see the free blocklist.

Stuck on a step?

Create a free account to ask the community. Members who run the real thing answer questions every day.