suveren 2.2.2__tar.gz → 2.2.3__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {suveren-2.2.2 → suveren-2.2.3}/CHANGELOG.md +20 -0
- {suveren-2.2.2 → suveren-2.2.3}/PKG-INFO +32 -27
- {suveren-2.2.2 → suveren-2.2.3}/README.en.md +4 -0
- {suveren-2.2.2 → suveren-2.2.3}/README.md +31 -26
- {suveren-2.2.2 → suveren-2.2.3}/pyproject.toml +1 -1
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/__init__.py +1 -1
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cache.py +20 -5
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/catalog.py +2 -1
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cli.py +11 -1
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/geoip.py +29 -7
- suveren-2.2.3/src/suveren/localsoft.py +101 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/net.py +30 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/render.py +3 -2
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/scan.py +2 -1
- {suveren-2.2.2 → suveren-2.2.3}/tests/conftest.py +12 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_geoip.py +53 -0
- suveren-2.2.3/tests/test_localsoft.py +68 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_release_222.py +20 -0
- suveren-2.2.3/tools/mkdocs_hooks.py +20 -0
- {suveren-2.2.2 → suveren-2.2.3}/.gitignore +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/COPYRIGHT +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/LICENSE +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/__main__.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/admarking.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/advice.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/analyze.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/audit.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/blocklist.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/brand.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/checks.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/clirus.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cloud.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cms.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/collect.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/company.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/compliance.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/crawl.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/cutoff.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/fonts/OFL.txt +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/fonts/suveren-mono.woff2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/fonts/suveren-sans.woff2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/laws.json +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/migration.json +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/public_suffix_list.dat +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/report.schema.json +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/retire.json +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/russian-trusted-ca.pem +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/services.json +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/data/takeover.json +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/dataflow.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/discover.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/dnsutil.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/dnszone.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/doctor.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/docx.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/drafts.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/egress.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/errors.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/fines.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/formleaks.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/history.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ignore.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/inn.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/laws.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/leaks.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/logins.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/mailsec.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/menu.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/metanote.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/migration.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/models.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ownership.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ownsite.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/page.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/pdpolicy.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/plan.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/plugins.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/psl.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/recommend.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/registries.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/report.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/research.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/ruregistries.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/sanctions.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/sarif.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/scenarios.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/scriptgraph.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/services.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/subdomains.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/takeover_signatures.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/_logo.j2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/base.html.j2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/batch.html.j2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/company.html.j2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/report.html.j2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/templates/summary.html.j2 +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/trace.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/unknown.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/utils.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/view.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/vulns.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/watch.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/src/suveren/websec.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/eu_sample.csv +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/blog.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/extidp_forms.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/google_apple.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/gsi_only.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/home_with_login_link.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/own_routes.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/russian_only.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/sign_route.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/telegram_login.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/logins/ulogin.html +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/policies/full.txt +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/policies/offer_with_consent.txt +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/policies/partial.txt +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/sdn_sample.xml +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/uk_sample.csv +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/fixtures/un_sample.xml +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/golden.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/lab.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_accuracy_tool.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_admarking.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_analyze.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_audit.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_brand.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_cache.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_catalog.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_check_services.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_cli.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_clirus.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_cloud.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_cms.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_collect.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_collect_offline.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_company.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_company_offline.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_compliance.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_control_chars.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_core.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_corpus.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_crawl.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_cutoff.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_dataflow.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_dnsutil.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_dnszone.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_doctor.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_docx.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_drafts.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_e2e.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_egress.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_errors.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_evidence.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_fines.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_formleaks.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_formleaks_browser.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_fuzz.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_ignore.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_inn.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_lab.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_laws.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_leaks.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_lock.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_logins.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_mailsec.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_menu.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_metanote.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_migration.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_net.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_nightly.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_offline_modules.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_ownsite.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_pdpolicy.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_plugins.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_psl.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_pypi_readme.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_recommend.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_registries_blocklist.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_release_221.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_render_launch.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_report_safety.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_research.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_ruregistries.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_rutls.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_sanctions.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_scenarios.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_schema.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_scriptgraph.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_services.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_subdomains.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_supply_chain.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_update_vulns.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_view.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_visual.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_vulns.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_watch.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tests/test_websec.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/accuracy.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/check_laws.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/check_services.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/ci.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/nightly-sites.txt +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/nightly.bat +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/nightly.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/pypi_readme.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/report_shots.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/update_psl.py +0 -0
- {suveren-2.2.2 → suveren-2.2.3}/tools/update_vulns.py +0 -0
|
@@ -1,5 +1,25 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.2.3 — 2026-11-10
|
|
4
|
+
|
|
5
|
+
- **Без прямого выхода в интернет проверка больше не висит.** Скачивание базы расположения
|
|
6
|
+
серверов DB-IP во время проверки ждёт соединения 5 секунд, ответа 10 секунд, и всё
|
|
7
|
+
скачивание не дольше 45 секунд. Если база не скачалась, проверка идёт дальше, а в отчёте
|
|
8
|
+
сказано, что страна сервера не проверена. Если сеть недоступна совсем («Network is
|
|
9
|
+
unreachable», как у WHOIS), остальные внешние загрузки не ждут своих таймаутов: берётся
|
|
10
|
+
старая копия, если она есть. `suveren update` по-прежнему ждёт долго. Нашёл читатель Хабра.
|
|
11
|
+
- **Скрипт антивируса больше не считается кодом сайта.** Касперский и AdGuard вставляют
|
|
12
|
+
свой скрипт в каждую страницу, и в режиме `--browser` он попадал в «Кто подключает
|
|
13
|
+
сторонний код» и в цепочки сторонних скриптов (SUV-WEB-011), как будто его подключил
|
|
14
|
+
сайт. Теперь такие скрипты (`kaspersky-labs.com`, `local.adguard.org`) убираются из
|
|
15
|
+
того, что увидел браузер, а в отчёте одна строка говорит, что на компьютере проверяющего
|
|
16
|
+
работает программа, которая меняет страницы. Нашёл читатель Хабра.
|
|
17
|
+
- **`--dkim-selector` у `batch`.** Свои селекторы DKIM теперь можно задать и для списка
|
|
18
|
+
сайтов: они проверяются у каждого сайта вместе с распространёнными.
|
|
19
|
+
- **Установка: нужен Python 3.11 и новее.** README и подсказка режима `--browser` советуют
|
|
20
|
+
`python3 -m pip install "suveren[browser]"` (на Windows `py -m pip`): голая команда `pip`
|
|
21
|
+
бывает от старого Python 2, и тогда pip не находит пакет.
|
|
22
|
+
|
|
3
23
|
## 2.2.2 — 2026-11-09
|
|
4
24
|
|
|
5
25
|
- **`--verbose` (`-v`): видно, где зависает.** У `scan`, `company`, `batch`, `research` и
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: suveren
|
|
3
|
-
Version: 2.2.
|
|
3
|
+
Version: 2.2.3
|
|
4
4
|
Summary: Аудит сайта и компании: иностранные сервисы, 152-ФЗ, блокировки РКН, ЕГРЮЛ и санкционные списки
|
|
5
5
|
Project-URL: Homepage, https://github.com/marsilid/suveren
|
|
6
6
|
Project-URL: Documentation, https://github.com/marsilid/suveren/blob/main/docs/guide.md
|
|
@@ -40,8 +40,8 @@ Description-Content-Type: text/markdown
|
|
|
40
40
|
<div align="center">
|
|
41
41
|
|
|
42
42
|
<picture>
|
|
43
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
44
|
-
<img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
43
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-dark.png">
|
|
44
|
+
<img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-light.png" width="300">
|
|
45
45
|
</picture>
|
|
46
46
|
|
|
47
47
|
**Проверка сайта и компании для работы в России**<br>
|
|
@@ -53,7 +53,7 @@ Description-Content-Type: text/markdown
|
|
|
53
53
|

|
|
54
54
|

|
|
55
55
|
|
|
56
|
-
[English version](https://github.com/marsilid/suveren/blob/v2.2.
|
|
56
|
+
[Сайт](https://marsilid.github.io/suveren/) · [English version](https://github.com/marsilid/suveren/blob/v2.2.3/README.en.md)
|
|
57
57
|
|
|
58
58
|
</div>
|
|
59
59
|
|
|
@@ -62,7 +62,7 @@ Description-Content-Type: text/markdown
|
|
|
62
62
|
письмо от имени компании и что исправить в первую очередь. Каждый вывод подкреплён
|
|
63
63
|
доказательством: DNS-записью, заголовком ответа, цитатой из политики, адресом скрипта.
|
|
64
64
|
|
|
65
|
-

|
|
66
66
|
|
|
67
67
|
<sub>На картинках — выдуманные сайты в зарезервированной зоне `.test`: это данные настоящих
|
|
68
68
|
проверок, в которых имена, адреса и IP заменены, чтобы не показывать чужие компании.</sub>
|
|
@@ -77,10 +77,15 @@ Description-Content-Type: text/markdown
|
|
|
77
77
|
**Любая система** (Python 3.11+):
|
|
78
78
|
|
|
79
79
|
```bash
|
|
80
|
-
pip install "suveren[browser]"
|
|
80
|
+
python3 -m pip install "suveren[browser]"
|
|
81
81
|
suveren scan example.ru
|
|
82
82
|
```
|
|
83
83
|
|
|
84
|
+
На Windows вместо `python3` пишите `py`. Ставьте именно через `python3 -m pip`: голая команда
|
|
85
|
+
`pip` бывает от старого Python 2 или 3.8. Если pip отвечает `Could not find a version that
|
|
86
|
+
satisfies the requirement suveren` («from versions: none»), значит его Python старше 3.11:
|
|
87
|
+
проверьте `python3 --version` и обновите Python или скачайте готовый exe.
|
|
88
|
+
|
|
84
89
|
<details>
|
|
85
90
|
<summary>Другие способы: из исходного кода и Docker</summary>
|
|
86
91
|
|
|
@@ -92,7 +97,7 @@ docker build -t suveren https://github.com/marsilid/suveren.git
|
|
|
92
97
|
docker run --rm -v "$PWD:/work" suveren scan example.ru
|
|
93
98
|
```
|
|
94
99
|
|
|
95
|
-

|
|
96
101
|
|
|
97
102
|
</details>
|
|
98
103
|
|
|
@@ -113,7 +118,7 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
|
|
|
113
118
|
- **С кем мы имеем дело?** Компания в ЕГРЮЛ, санкционные списки США, ЕС, Великобритании и ООН,
|
|
114
119
|
перечень Росфинмониторинга.
|
|
115
120
|
|
|
116
|
-
Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.
|
|
121
|
+
Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md)) и база из 300 с лишним сервисов.
|
|
117
122
|
Находки из разных разделов собираются в сценарии атак: «почту можно подделать» + «на сайте есть
|
|
118
123
|
оплата» = фишинг от имени компании.
|
|
119
124
|
|
|
@@ -128,26 +133,26 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
|
|
|
128
133
|
оформить отчёт под брендом своей студии.
|
|
129
134
|
|
|
130
135
|
<picture>
|
|
131
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
132
|
-
<img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
136
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-dark.png">
|
|
137
|
+
<img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-light.png">
|
|
133
138
|
</picture>
|
|
134
139
|
|
|
135
140
|
<details>
|
|
136
141
|
<summary>Раздел 152-ФЗ, проверка компании и сводка по списку сайтов</summary>
|
|
137
142
|
|
|
138
143
|
<picture>
|
|
139
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
140
|
-
<img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
144
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-dark.png">
|
|
145
|
+
<img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-light.png">
|
|
141
146
|
</picture>
|
|
142
147
|
|
|
143
148
|
<picture>
|
|
144
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
145
|
-
<img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
149
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-dark.png">
|
|
150
|
+
<img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-light.png">
|
|
146
151
|
</picture>
|
|
147
152
|
|
|
148
153
|
<picture>
|
|
149
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
150
|
-
<img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
154
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-dark.png">
|
|
155
|
+
<img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-light.png">
|
|
151
156
|
</picture>
|
|
152
157
|
|
|
153
158
|
</details>
|
|
@@ -166,7 +171,7 @@ suveren scan сайт.ru -v # каждый сетевой шаг
|
|
|
166
171
|
suveren scan сайт.ru --dkim-selector ew # проверить и ваш селектор DKIM, а не только типовые
|
|
167
172
|
```
|
|
168
173
|
|
|
169
|
-
Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
174
|
+
Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#все-команды), а также в
|
|
170
175
|
`suveren --help` и `suveren scan --help`.
|
|
171
176
|
|
|
172
177
|
## Что Suveren делает с сайтом
|
|
@@ -186,9 +191,9 @@ Suveren в основном смотрит то же, что любой посе
|
|
|
186
191
|
почтовые серверы, а с `--form-leaks` — утечки данных из форм. Запускается только после
|
|
187
192
|
подтверждения владения (`suveren verify`).
|
|
188
193
|
|
|
189
|
-
У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.
|
|
194
|
+
У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md) указано, что она делает с сайтом и чем
|
|
190
195
|
рискует тот, кто её запускает. Куда уходят данные при `--dns ru` — в
|
|
191
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
196
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#параметры-проверки), чем рискуют плагины — в [docs/plugins.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/plugins.md).
|
|
192
197
|
|
|
193
198
|
## Для CI
|
|
194
199
|
|
|
@@ -199,7 +204,7 @@ suveren scan example.ru --no-open --sarif suveren.sarif --fail-on fail
|
|
|
199
204
|
SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку, которую решили пока не
|
|
200
205
|
исправлять, можно принять в `.suveren-ignore` с причиной, автором и сроком: она остаётся в
|
|
201
206
|
отчёте, но не валит сборку, а после срока снова считается. Подробнее — в
|
|
202
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
207
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ci-и-другие-инструменты).
|
|
203
208
|
|
|
204
209
|
## Источники данных и ограничения
|
|
205
210
|
|
|
@@ -212,21 +217,21 @@ SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку,
|
|
|
212
217
|
Отчёт помогает расставить приоритеты и **не является юридическим заключением**: у каждой
|
|
213
218
|
проверки 152-ФЗ указана статья закона со ссылкой на текст. Где проверить не удалось, Suveren
|
|
214
219
|
пишет «не проверено», а не ложное «в порядке». Все ограничения — в
|
|
215
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
220
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ограничения).
|
|
216
221
|
|
|
217
222
|
## Участие
|
|
218
223
|
|
|
219
224
|
Чтобы добавить сервис в базу, программировать не нужно: это файл
|
|
220
|
-
[`services.json`](https://github.com/marsilid/suveren/blob/v2.2.
|
|
221
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
222
|
-
«Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.
|
|
223
|
-
об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.
|
|
225
|
+
[`services.json`](https://github.com/marsilid/suveren/blob/v2.2.3/src/suveren/data/services.json), как его заполнить — в
|
|
226
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#как-добавить-сервис-в-базу). Можно и просто открыть issue
|
|
227
|
+
«Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.3/CONTRIBUTING.md),
|
|
228
|
+
об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.3/SECURITY.md).
|
|
224
229
|
|
|
225
230
|
## Лицензия
|
|
226
231
|
|
|
227
|
-
[GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.
|
|
232
|
+
[GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.3/LICENSE) или более поздняя, начиная с версии 1.1: код открыт, и любая изменённая
|
|
228
233
|
версия, в том числе работающая как сервис, тоже должна быть открыта. Для закрытых продуктов и
|
|
229
|
-
SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.
|
|
234
|
+
SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.3/COPYRIGHT). Версии до 1.0.x остаются
|
|
230
235
|
под MIT.
|
|
231
236
|
|
|
232
237
|
Связанный проект: [ReconLens](https://github.com/marsilid/reconlens) — пассивная OSINT-разведка
|
|
@@ -44,6 +44,10 @@ pip install "suveren[browser]"
|
|
|
44
44
|
suveren scan example.ru
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
+
If pip says `Could not find a version that satisfies the requirement suveren`
|
|
48
|
+
("from versions: none"), your Python is older than 3.11: check `python --version` and upgrade
|
|
49
|
+
it, or download the ready exe.
|
|
50
|
+
|
|
47
51
|
<details>
|
|
48
52
|
<summary>Other ways: from source and Docker</summary>
|
|
49
53
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
3
|
<picture>
|
|
4
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
5
|
-
<img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-dark.png">
|
|
5
|
+
<img alt="Suveren" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/logo-light.png" width="300">
|
|
6
6
|
</picture>
|
|
7
7
|
|
|
8
8
|
**Проверка сайта и компании для работы в России**<br>
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|

|
|
15
15
|

|
|
16
16
|
|
|
17
|
-
[English version](https://github.com/marsilid/suveren/blob/v2.2.
|
|
17
|
+
[Сайт](https://marsilid.github.io/suveren/) · [English version](https://github.com/marsilid/suveren/blob/v2.2.3/README.en.md)
|
|
18
18
|
|
|
19
19
|
</div>
|
|
20
20
|
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
письмо от имени компании и что исправить в первую очередь. Каждый вывод подкреплён
|
|
24
24
|
доказательством: DNS-записью, заголовком ответа, цитатой из политики, адресом скрипта.
|
|
25
25
|
|
|
26
|
-

|
|
27
27
|
|
|
28
28
|
<sub>На картинках — выдуманные сайты в зарезервированной зоне `.test`: это данные настоящих
|
|
29
29
|
проверок, в которых имена, адреса и IP заменены, чтобы не показывать чужие компании.</sub>
|
|
@@ -38,10 +38,15 @@
|
|
|
38
38
|
**Любая система** (Python 3.11+):
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
|
-
pip install "suveren[browser]"
|
|
41
|
+
python3 -m pip install "suveren[browser]"
|
|
42
42
|
suveren scan example.ru
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
+
На Windows вместо `python3` пишите `py`. Ставьте именно через `python3 -m pip`: голая команда
|
|
46
|
+
`pip` бывает от старого Python 2 или 3.8. Если pip отвечает `Could not find a version that
|
|
47
|
+
satisfies the requirement suveren` («from versions: none»), значит его Python старше 3.11:
|
|
48
|
+
проверьте `python3 --version` и обновите Python или скачайте готовый exe.
|
|
49
|
+
|
|
45
50
|
<details>
|
|
46
51
|
<summary>Другие способы: из исходного кода и Docker</summary>
|
|
47
52
|
|
|
@@ -53,7 +58,7 @@ docker build -t suveren https://github.com/marsilid/suveren.git
|
|
|
53
58
|
docker run --rm -v "$PWD:/work" suveren scan example.ru
|
|
54
59
|
```
|
|
55
60
|
|
|
56
|
-

|
|
57
62
|
|
|
58
63
|
</details>
|
|
59
64
|
|
|
@@ -74,7 +79,7 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
|
|
|
74
79
|
- **С кем мы имеем дело?** Компания в ЕГРЮЛ, санкционные списки США, ЕС, Великобритании и ООН,
|
|
75
80
|
перечень Росфинмониторинга.
|
|
76
81
|
|
|
77
|
-
Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.
|
|
82
|
+
Около 70 проверок с постоянными ID ([список](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md)) и база из 300 с лишним сервисов.
|
|
78
83
|
Находки из разных разделов собираются в сценарии атак: «почту можно подделать» + «на сайте есть
|
|
79
84
|
оплата» = фишинг от имени компании.
|
|
80
85
|
|
|
@@ -89,26 +94,26 @@ docker run --rm -v "$PWD:/work" suveren scan example.ru
|
|
|
89
94
|
оформить отчёт под брендом своей студии.
|
|
90
95
|
|
|
91
96
|
<picture>
|
|
92
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
93
|
-
<img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
97
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-dark.png">
|
|
98
|
+
<img alt="HTML-отчёт" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/report-light.png">
|
|
94
99
|
</picture>
|
|
95
100
|
|
|
96
101
|
<details>
|
|
97
102
|
<summary>Раздел 152-ФЗ, проверка компании и сводка по списку сайтов</summary>
|
|
98
103
|
|
|
99
104
|
<picture>
|
|
100
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
101
|
-
<img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
105
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-dark.png">
|
|
106
|
+
<img alt="Проверка 152-ФЗ" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/compliance-light.png">
|
|
102
107
|
</picture>
|
|
103
108
|
|
|
104
109
|
<picture>
|
|
105
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
106
|
-
<img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
110
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-dark.png">
|
|
111
|
+
<img alt="Проверка компании" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/company-light.png">
|
|
107
112
|
</picture>
|
|
108
113
|
|
|
109
114
|
<picture>
|
|
110
|
-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
111
|
-
<img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.
|
|
115
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-dark.png">
|
|
116
|
+
<img alt="Сводка по списку сайтов" src="https://raw.githubusercontent.com/marsilid/suveren/v2.2.3/docs/batch-light.png">
|
|
112
117
|
</picture>
|
|
113
118
|
|
|
114
119
|
</details>
|
|
@@ -127,7 +132,7 @@ suveren scan сайт.ru -v # каждый сетевой шаг
|
|
|
127
132
|
suveren scan сайт.ru --dkim-selector ew # проверить и ваш селектор DKIM, а не только типовые
|
|
128
133
|
```
|
|
129
134
|
|
|
130
|
-
Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
135
|
+
Все команды и параметры — в [руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#все-команды), а также в
|
|
131
136
|
`suveren --help` и `suveren scan --help`.
|
|
132
137
|
|
|
133
138
|
## Что Suveren делает с сайтом
|
|
@@ -147,9 +152,9 @@ Suveren в основном смотрит то же, что любой посе
|
|
|
147
152
|
почтовые серверы, а с `--form-leaks` — утечки данных из форм. Запускается только после
|
|
148
153
|
подтверждения владения (`suveren verify`).
|
|
149
154
|
|
|
150
|
-
У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.
|
|
155
|
+
У каждой проверки в [docs/checks.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/checks.md) указано, что она делает с сайтом и чем
|
|
151
156
|
рискует тот, кто её запускает. Куда уходят данные при `--dns ru` — в
|
|
152
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
157
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#параметры-проверки), чем рискуют плагины — в [docs/plugins.md](https://github.com/marsilid/suveren/blob/v2.2.3/docs/plugins.md).
|
|
153
158
|
|
|
154
159
|
## Для CI
|
|
155
160
|
|
|
@@ -160,7 +165,7 @@ suveren scan example.ru --no-open --sarif suveren.sarif --fail-on fail
|
|
|
160
165
|
SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку, которую решили пока не
|
|
161
166
|
исправлять, можно принять в `.suveren-ignore` с причиной, автором и сроком: она остаётся в
|
|
162
167
|
отчёте, но не валит сборку, а после срока снова считается. Подробнее — в
|
|
163
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
168
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ci-и-другие-инструменты).
|
|
164
169
|
|
|
165
170
|
## Источники данных и ограничения
|
|
166
171
|
|
|
@@ -173,21 +178,21 @@ SARIF читают GitHub и GitLab code scanning и DefectDojo. Находку,
|
|
|
173
178
|
Отчёт помогает расставить приоритеты и **не является юридическим заключением**: у каждой
|
|
174
179
|
проверки 152-ФЗ указана статья закона со ссылкой на текст. Где проверить не удалось, Suveren
|
|
175
180
|
пишет «не проверено», а не ложное «в порядке». Все ограничения — в
|
|
176
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
181
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#ограничения).
|
|
177
182
|
|
|
178
183
|
## Участие
|
|
179
184
|
|
|
180
185
|
Чтобы добавить сервис в базу, программировать не нужно: это файл
|
|
181
|
-
[`services.json`](https://github.com/marsilid/suveren/blob/v2.2.
|
|
182
|
-
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.
|
|
183
|
-
«Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.
|
|
184
|
-
об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.
|
|
186
|
+
[`services.json`](https://github.com/marsilid/suveren/blob/v2.2.3/src/suveren/data/services.json), как его заполнить — в
|
|
187
|
+
[руководстве](https://github.com/marsilid/suveren/blob/v2.2.3/docs/guide.md#как-добавить-сервис-в-базу). Можно и просто открыть issue
|
|
188
|
+
«Добавить сервис». Как устроен код и как запускать тесты — в [CONTRIBUTING.md](https://github.com/marsilid/suveren/blob/v2.2.3/CONTRIBUTING.md),
|
|
189
|
+
об уязвимостях — по правилам [SECURITY.md](https://github.com/marsilid/suveren/blob/v2.2.3/SECURITY.md).
|
|
185
190
|
|
|
186
191
|
## Лицензия
|
|
187
192
|
|
|
188
|
-
[GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.
|
|
193
|
+
[GNU AGPL-3.0](https://github.com/marsilid/suveren/blob/v2.2.3/LICENSE) или более поздняя, начиная с версии 1.1: код открыт, и любая изменённая
|
|
189
194
|
версия, в том числе работающая как сервис, тоже должна быть открыта. Для закрытых продуктов и
|
|
190
|
-
SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.
|
|
195
|
+
SaaS есть коммерческая лицензия — подробности в [COPYRIGHT](https://github.com/marsilid/suveren/blob/v2.2.3/COPYRIGHT). Версии до 1.0.x остаются
|
|
191
196
|
под MIT.
|
|
192
197
|
|
|
193
198
|
Связанный проект: [ReconLens](https://github.com/marsilid/reconlens) — пассивная OSINT-разведка
|
|
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "suveren"
|
|
7
|
-
version = "2.2.
|
|
7
|
+
version = "2.2.3"
|
|
8
8
|
description = "Аудит сайта и компании: иностранные сервисы, 152-ФЗ, блокировки РКН, ЕГРЮЛ и санкционные списки"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.11"
|
|
@@ -12,7 +12,7 @@ from pathlib import Path
|
|
|
12
12
|
import httpx
|
|
13
13
|
|
|
14
14
|
from suveren.errors import ModuleError, describe
|
|
15
|
-
from suveren.net import MAX_BODY_KEY
|
|
15
|
+
from suveren.net import MAX_BODY_KEY, note_unreachable, offline
|
|
16
16
|
|
|
17
17
|
DEFAULT_TTL = 24 * 3600
|
|
18
18
|
# Sanctions lists change weekly and the block register daily: a "not found" against an
|
|
@@ -69,23 +69,37 @@ async def fetch_cached(
|
|
|
69
69
|
ttl: float = DEFAULT_TTL,
|
|
70
70
|
refresh: bool = False,
|
|
71
71
|
html: bool = False,
|
|
72
|
+
timeout: httpx.Timeout | None = None,
|
|
72
73
|
) -> tuple[Path, str | None]:
|
|
73
74
|
"""Return the cached file, downloading it when missing or stale.
|
|
74
75
|
|
|
75
76
|
If the download fails but an old copy exists, the old copy is returned with
|
|
76
|
-
a note. Without any copy a :class:`ModuleError` is raised.
|
|
77
|
+
a note. Without any copy a :class:`ModuleError` is raised. Once the network is
|
|
78
|
+
known to be unreachable (``net.offline``), nothing is downloaded: it would only
|
|
79
|
+
wait for its timeout.
|
|
77
80
|
"""
|
|
78
81
|
path = cache_dir() / name
|
|
79
82
|
if not refresh and is_fresh(path, ttl):
|
|
80
83
|
return path, None
|
|
84
|
+
down = offline()
|
|
85
|
+
if down:
|
|
86
|
+
if path.exists():
|
|
87
|
+
return path, f"сеть недоступна, использована копия {name} от {age_text(path)}"
|
|
88
|
+
raise ModuleError(f"не удалось скачать {url} (сеть недоступна: {down})")
|
|
81
89
|
async with _lock(name):
|
|
82
90
|
if not refresh and is_fresh(path, ttl): # another caller has just fetched it
|
|
83
91
|
return path, None
|
|
84
|
-
return await _download(client, url, name, path, html=html)
|
|
92
|
+
return await _download(client, url, name, path, html=html, timeout=timeout)
|
|
85
93
|
|
|
86
94
|
|
|
87
95
|
async def _download(
|
|
88
|
-
client: httpx.AsyncClient,
|
|
96
|
+
client: httpx.AsyncClient,
|
|
97
|
+
url: str,
|
|
98
|
+
name: str,
|
|
99
|
+
path: Path,
|
|
100
|
+
*,
|
|
101
|
+
html: bool,
|
|
102
|
+
timeout: httpx.Timeout | None = None,
|
|
89
103
|
) -> tuple[Path, str | None]:
|
|
90
104
|
path.parent.mkdir(parents=True, exist_ok=True)
|
|
91
105
|
# A name of its own, so another process downloading the same list does not collide.
|
|
@@ -93,7 +107,7 @@ async def _download(
|
|
|
93
107
|
try:
|
|
94
108
|
# Sanctions lists and the block list are far bigger than a page.
|
|
95
109
|
big = {MAX_BODY_KEY: 1 << 30}
|
|
96
|
-
timeout = httpx.Timeout(30.0, read=120.0)
|
|
110
|
+
timeout = timeout or httpx.Timeout(30.0, read=120.0)
|
|
97
111
|
async with client.stream("GET", url, timeout=timeout, extensions=big) as resp:
|
|
98
112
|
resp.raise_for_status()
|
|
99
113
|
with tmp.open("wb") as fh:
|
|
@@ -106,6 +120,7 @@ async def _download(
|
|
|
106
120
|
tmp.replace(path)
|
|
107
121
|
return path, None
|
|
108
122
|
except (httpx.HTTPError, OSError, _NotData) as exc:
|
|
123
|
+
note_unreachable(exc)
|
|
109
124
|
tmp.unlink(missing_ok=True)
|
|
110
125
|
why = "вместо списка пришла пустая страница или HTML" if isinstance(exc, _NotData) else ""
|
|
111
126
|
if path.exists():
|
|
@@ -170,7 +170,8 @@ CATALOG: tuple[CheckSpec, ...] = (
|
|
|
170
170
|
"retire.js."),
|
|
171
171
|
_spec("SUV-WEB-011", WEB, "Цепочки сторонних скриптов", "security",
|
|
172
172
|
"web scripts supply-chain browser",
|
|
173
|
-
"Код, который подключил не сайт, а чужие скрипты (только в режиме --browser)."
|
|
173
|
+
"Код, который подключил не сайт, а чужие скрипты (только в режиме --browser). "
|
|
174
|
+
"Скрипты антивируса на компьютере проверяющего (Kaspersky, AdGuard) не учитываются."),
|
|
174
175
|
_spec("SUV-WEB-012", WEB, "Ограничение центров сертификации (CAA)", "security",
|
|
175
176
|
"web tls dns", "Запись CAA: какие центры сертификации могут выпускать сертификаты "
|
|
176
177
|
"сайта (RFC 8659)."),
|
|
@@ -965,15 +965,24 @@ def batch(
|
|
|
965
965
|
brand_logo: BrandLogo = None,
|
|
966
966
|
brand_url: BrandUrl = None,
|
|
967
967
|
ignore_file: IgnorePath = None,
|
|
968
|
+
dkim_selector: Annotated[
|
|
969
|
+
list[str] | None,
|
|
970
|
+
typer.Option(
|
|
971
|
+
"--dkim-selector",
|
|
972
|
+
help="Свой селектор DKIM, можно несколько раз: проверяется у каждого сайта "
|
|
973
|
+
"списка вместе с распространёнными.",
|
|
974
|
+
),
|
|
975
|
+
] = None,
|
|
968
976
|
verbose: VerboseOpt = False,
|
|
969
977
|
) -> None:
|
|
970
978
|
"""Проверить список сайтов: сводная таблица, CSV и отчёт по каждому сайту."""
|
|
971
979
|
_trace(verbose)
|
|
972
980
|
brand = _brand(brand_name, brand_logo, brand_url)
|
|
973
981
|
try:
|
|
982
|
+
selectors = dkim_selectors(dkim_selector or [])
|
|
974
983
|
threshold = _validate_grade(fail_under)
|
|
975
984
|
accepted = load_ignore(ignore_file)
|
|
976
|
-
except SuverenError as exc:
|
|
985
|
+
except (SuverenError, ValueError) as exc:
|
|
977
986
|
raise _fail(str(exc)) from exc
|
|
978
987
|
try:
|
|
979
988
|
hosts, skipped = read_targets(file)
|
|
@@ -1026,6 +1035,7 @@ def batch(
|
|
|
1026
1035
|
host,
|
|
1027
1036
|
timeout=timeout,
|
|
1028
1037
|
dns_mode=dns_mode.value,
|
|
1038
|
+
dkim_selectors=selectors,
|
|
1029
1039
|
**plan.kwargs(), # type: ignore[arg-type]
|
|
1030
1040
|
),
|
|
1031
1041
|
max_time,
|
|
@@ -36,6 +36,11 @@ URL = "https://download.db-ip.com/free/dbip-country-lite-{month}.csv.gz"
|
|
|
36
36
|
TTL = 31 * 24 * 3600 # a new file comes out on the 1st of each month
|
|
37
37
|
# Two missed months: addresses move between countries, an old answer is not used.
|
|
38
38
|
STALE_DAYS = 70
|
|
39
|
+
# During a scan the file is a nicety: without it the server's country is "не определена".
|
|
40
|
+
# A network that drops packets left the download hanging for minutes (redfox0, 2.2.2),
|
|
41
|
+
# so a scan waits briefly; `suveren update` keeps the long default.
|
|
42
|
+
SCAN_TIMEOUT = httpx.Timeout(5.0, read=10.0)
|
|
43
|
+
SCAN_BUDGET = 45.0 # the whole download, a slow trickle included
|
|
39
44
|
|
|
40
45
|
|
|
41
46
|
def month_urls(today: date | None = None) -> list[str]:
|
|
@@ -122,15 +127,32 @@ def read(path: Path) -> GeoDb:
|
|
|
122
127
|
return db
|
|
123
128
|
|
|
124
129
|
|
|
125
|
-
async def
|
|
126
|
-
|
|
127
|
-
path: Path | None = None
|
|
130
|
+
async def _fetch(client: httpx.AsyncClient, refresh: bool) -> Path | None:
|
|
131
|
+
timeout = None if refresh else SCAN_TIMEOUT
|
|
128
132
|
for url in month_urls():
|
|
129
133
|
try:
|
|
130
|
-
path, _ = await fetch_cached(
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
+
path, _ = await fetch_cached(
|
|
135
|
+
client, url, FILENAME, ttl=TTL, refresh=refresh, timeout=timeout
|
|
136
|
+
)
|
|
137
|
+
return path
|
|
138
|
+
except ModuleError as exc:
|
|
139
|
+
# Last month's file is worth asking for only when the server answered
|
|
140
|
+
# (404 before the 1st's file is out); a dead connection stays dead.
|
|
141
|
+
if not isinstance(exc.__cause__, httpx.HTTPStatusError):
|
|
142
|
+
return None
|
|
143
|
+
return None
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
async def load(client: httpx.AsyncClient, *, refresh: bool = False) -> GeoDb:
|
|
147
|
+
"""The database, or an empty one whose ``problem`` says why; a scan never fails on it."""
|
|
148
|
+
try:
|
|
149
|
+
if refresh:
|
|
150
|
+
path = await _fetch(client, refresh)
|
|
151
|
+
else:
|
|
152
|
+
async with asyncio.timeout(SCAN_BUDGET):
|
|
153
|
+
path = await _fetch(client, refresh)
|
|
154
|
+
except TimeoutError:
|
|
155
|
+
path = None
|
|
134
156
|
if path is None:
|
|
135
157
|
return GeoDb(problem=f"база {NAME} не скачалась")
|
|
136
158
|
age = (time.time() - path.stat().st_mtime) / 86400
|