mitrecnd/whodatПивотный обратный WhoIs / Объединение PDNS с отслеживанием регистрантов и оповещением плюс API для автоматизированных запросов (JSON/CSV/TXT)
ПРИМЕЧАНИЕ: В ходе разработки PyDat 5 внутренние операции изменили направление, что привело к закрытию проекта PyDat. Хотя было проделано много работы для завершения возможностей PyDat 5, некоторые возможности остаются не полностью протестированными.
Проект WhoDat представляет собой интерфейс для данных whoisxmlapi или любых whois-данных, хранящихся в ElasticSearch. Он объединяет whois-данные, текущие разрешения IP и пассивный DNS. Помимо предоставления интерактивного, сводного приложения для аналитиков, оно также имеет API, который позволяет выводить данные в формате JSON.
WhoDat изначально был написан Chris Clark. Оригинальная реализация на PHP доступна в этом репозитории в каталоге legacy_whodat. Код был полностью переписан Wesley Shields и Murad Khan на Python и доступен в каталоге pydat.
PHP-версия оставлена для тех, кто хочет её запустить, но она не обладает такой же полнотой функций или расширяемостью, как реализация на Python, и не поддерживается.
Для получения дополнительной информации о реализации на PHP см. readme. Для получения дополнительной информации о реализации на Python читайте дальше...
pyDat — это реализация на Python кода WhoDat от Chris Clark. Он разработан так, чтобы быть более расширяемым и иметь больше функций, чем реализация на PHP.
pyDat — это приложение на Python 3.6+, для работы которого требуется следующее:
Для правильного заполнения базы данных предоставляется программа pydat-populator, которая автоматически заполняет данные. Обратите внимание, что данные, поступающие от whoisxmlapi, не всегда кажутся согласованными, поэтому при загрузке данных следует проявлять осторожность. Необходимо провести дополнительные тесты, чтобы гарантировать правильную загрузку всех данных. Любой, кто настраивает свою базу данных, должен прочитать доступные флаги скрипта перед его запуском, чтобы убедиться, что они настроены под их окружение. Ниже приведен вывод pydat-populator -h:
usage: pydat-populator [-h] [-c CONFIG] [--debug] [--debug-level DEBUG_LEVEL]
[-x EXCLUDE [EXCLUDE ...]] [-n INCLUDE [INCLUDE ...]]
[--ignore-field-prefixes [IGNORE_FIELD_PREFIXES [IGNORE_FIELD_PREFIXES ...]]]
[-e EXTENSION] [-v] [-s] [--pipelines PIPELINES]
[--shipper-threads SHIPPER_THREADS]
[--fetcher-threads FETCHER_THREADS]
[--bulk-ship-size BULK_SHIP_SIZE]
[--bulk-fetch-size BULK_FETCH_SIZE]
[-u [ES_URI [ES_URI ...]]] [--es-user ES_USER]
[--es-pass ES_PASSWORD] [--cacert ES_CA_CERT]
[--es-disable-sniffing] [-p ES_INDEX_PREFIX]
[--rollover-size ES_ROLLOVER_DOCS] [--ask-pass]
[-r | --config-template-only | --clear-interrupted-flag]
[-f INGEST_FILE | -d INGEST_DIRECTORY] [-D INGEST_DAY]
[-o COMMENT]
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
location of configuration file for
environmentparameter configuration (example yaml file
in /backend)
--debug Enables debug logging
--debug-level DEBUG_LEVEL
Debug logging level [0-3] (default: 1)
-x EXCLUDE [EXCLUDE ...], --exclude EXCLUDE [EXCLUDE ...]
list of keys to exclude if updating entry
-n INCLUDE [INCLUDE ...], --include INCLUDE [INCLUDE ...]
list of keys to include if updating entry (mutually
exclusive to -x)
--ignore-field-prefixes [IGNORE_FIELD_PREFIXES [IGNORE_FIELD_PREFIXES ...]]
list of fields (in whois data) to ignore when
extracting and inserting into ElasticSearch
-e EXTENSION, --extension EXTENSION
When scanning for CSV files only parse files with
given extension (default: csv)
-v, --verbose Be verbose
-s, --stats Print out Stats after running
-r, --redo Attempt to re-import a failed import or import more
data, uses stored metadata from previous run
--config-template-only
Configure the ElasticSearch template and then exit
--clear-interrupted-flag
Clear the interrupted flag, forcefully (NOT
RECOMMENDED)
-f INGEST_FILE, --file INGEST_FILE
Input CSV file
-d INGEST_DIRECTORY, --directory INGEST_DIRECTORY
Directory to recursively search for CSV files --
mutually exclusive to '-f' option
-D INGEST_DAY, --ingest-day INGEST_DAY
Day to use for metadata, in the format 'YYYY-MM-dd',
e.g., '2021-01-01'. Defaults to todays date, use
'YYYY-MM-00' to indicate a quarterly ingest, e.g.,
2021-04-00
-o COMMENT, --comment COMMENT
Comment to store with metadata
Performance Options:
--pipelines PIPELINES
Number of pipelines (default: 2)
--shipper-threads SHIPPER_THREADS
How many threads per pipeline to spawn to send bulk ES
messages. The larger your cluster, the more you can
increase this, defaults to 1
--fetcher-threads FETCHER_THREADS
How many threads to spawn to search ES. The larger
your cluster, the more you can increase this, defaults
to 2
--bulk-ship-size BULK_SHIP_SIZE
Size of Bulk Elasticsearch Requests (default: 10)
--bulk-fetch-size BULK_FETCH_SIZE
Number of documents to search for at a time (default:
50), note that this will be multiplied by the number
of indices you have, e.g., if you have 10
pydat-<number> indices it results in a request for 500
documents