Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tuokri/spoofspy
Experimental app for detecting and displaying spoofed and "redirect" servers on Steam.
https://github.com/tuokri/spoofspy
celery fastapi postgresql psycopg3 redis sqlalchemy steam svelte timescaledb
Last synced: 19 days ago
JSON representation
Experimental app for detecting and displaying spoofed and "redirect" servers on Steam.
- Host: GitHub
- URL: https://github.com/tuokri/spoofspy
- Owner: tuokri
- License: agpl-3.0
- Created: 2023-06-26T09:42:25.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-11-08T08:56:30.000Z (about 2 months ago)
- Last Synced: 2024-11-08T09:37:47.776Z (about 2 months ago)
- Topics: celery, fastapi, postgresql, psycopg3, redis, sqlalchemy, steam, svelte, timescaledb
- Language: Python
- Homepage:
- Size: 409 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# spoofspy
Experimental app for detecting and displaying spoofed/redirect servers on Steam.
Calculates a trust score based on multiple criteria to determine
a rolling average that indicates which servers are trustworthy i.e.
real servers vs. fake severs with low trust score that often have spoofed
information such as player counts.
Trust score evaluation currently supported on the following games:
- Rising Storm 2: Vietnam
## Technical details
The backend core is implemented as multiple Celery jobs and a
PostgreSQL+TimescaleDB cluster that perform the following actions:
1. A periodic job request Steam Web API
[(IGameServersService/GetServerList)](https://steamapi.xpaw.me/#IGameServersService/GetServerList)
for a list of dedicated servers
based on some query criteria stored in the database. The result of this
query is stored in the database.
2. For each server discovered, an individual Celery job is started to
perform A2S_INFO, A2S_RULES and A2S_PLAYERS queries. The results of these
queries are stored in the database as timeseries.
3. A periodic Celery job calculates the trust scores for the servers
based on the above queries. The heuristic trust score algorithm details
can be seen [here](spoofspy/heuristics/trust.py).
Data model defined in detail for Timescale
[here](spoofspy/db/timescale.sql) and for SQLAlchemy
[here](spoofspy/db/models.py).
## Future improvements
- Public web GUI
- Currently only has backend functionality
and private APIs for development and testing
## TODO
- Check this example and adapt it for setting kernel options as root
before running the actual app as non-root:
https://community.fly.io/t/cant-change-permissions-on-run-directory/1154/2
- Import `_version.py` to make it available in releases.
- Actually, consider if we want to do this? There seem to
be many opinions on whether having a __version__ attribute
is the right way to do it.
- Run jobs more frequently for low score servers. Fewer jobs can be ran for
servers with a history of high trust score.
# License
```
Copyright (C) 2023-2024 Tuomo Kriikkula
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
```