timespotter

README

timespotter

First seen / last seen web service based on sha256

Values is stored in memory, saved to disk with SIGHUP or /save API call. Keep track of hash value, first seen, last seen and count.

Usage of ./timespotter:
  -address string
        listen address (default "127.0.0.1")
  -dnsport string
        dns port (default "5300")
  -port string
        listen port (default "5000")
  -state string
        statefile name (default "timespotter.state")

State is saved as gzip'ed GOB. State will be saved if interupt is caught or if /save endpoint is called.

Example usage

[root@host ~]# curl  "http://127.0.0.1:5000/info"
{
"status": "OK",
"keys": "29508"
}
[root@host ~]# curl  -X POST "http://127.0.0.1:5000/seen/test"
404 page not found
[root@cert-mgmt04 ~]# curl  -X POST "http://127.0.0.1:5000/seen/value/test"
{
"status": "OK",
"hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"count": "2",
"first": "1649145977",
"last": "1668017778"
}
[root@host ~]# curl  "http://127.0.0.1:5000/check/value/test"
{
"status": "OK",
"found": true,
"first": "1649145977",
"last": "1668017778",
"count": "2",
"hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
[root@host ~]# curl  "http://127.0.0.1:5000/check/value/test2"
{
"status": "NOT FOUND",
"found": false
}   
[root@host ~]# echo -n test | sha256sum 
9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08  -

API

POST

• /seen/value/<value> - add (string) to seen map
• /seen/hash/<hash> - add (sha256) to seen map
• /post/value - add vaules in post to seen map, one value pr. line
• /post/hash - add hashes in post to seen map, one hash pr. line
• /unseen/value/<value> - remove value (string) from seen map
• /unseen/hash/<hash> - remove hash (sha256) from seen map
• /save - save state to statefile
• /load - load state from (last) saved statefile
• /expire/first/<limit> - remove all entries with firstseen < limit (unixtime)
• /expire/last/<limit> - remove all entries with lastseen < limit (unixtime)
• /override/first/<hash>/<time> - override first timestamp for hash
• /override/last/<hash>/<time> - override last timestamp for hash
• /override/count/<hash>/<count> - override count value for hash

GET

• /check/value/<value> - check if value is seen
• /check/hash/<hash> - check if hash is seen
• /info - list info
• /dump - dump all entries

DNS

Values can be queried by DNS.

Query: <0-31>.<32-63>.some.random.name

If found, return 127.0.0.1, if not SERVFAIL