Snoopy is a very lightweight and simplistic, anonomised usage tracker
In order to be able to track users through IP whilst also anonymising the records, the identifier stored in the database consists of a salted IP hashed using SHA512. This can be seen here
Whilst any system is vulnerable if the underlying server is fully breached, server security is the concern of the admin and not this project.
The recomended way to run this service is through using the provided Dockerfile. However feel free to run it from source.
This project serves my needs and as such support will be limited, though feel free to reach out with issues or pull requests.
The project will connect to a mysql compatible database as defined by the following environment variables:
- MARIA_HOST
- MARIA_USER
- MARIA_PASS
- MARIA_DATABASE
(note, this does not have to be mariadb)
Also expected is an environment variable SALT which is used to salt IP addresses prior to hashing.
Lastly, you can adjust the session time (default 10 minutes) using the SESS_TIME env var.
The session time is how long of a gap is required between hits to the same service
The following endpoints are configured for the service
Accessible as a system health endpoint, returns a period (.).
This is the tracking enpoint, the DB record consists of a salted and hashed IP, and the slug identifier. It will return the following css
.snoopy {
color: #28a745 !important;
}