local-triage 0.0.0-stage → 0.10.0-dev.33
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.
- package/LICENSE +21 -0
- package/README.md +194 -2
- package/THIRD-PARTY-NOTICES.md +61 -0
- package/app/__init__.py +3 -0
- package/app/affiliation.py +137 -0
- package/app/ask.py +300 -0
- package/app/build_info.py +99 -0
- package/app/capec.py +168 -0
- package/app/capec_view.py +27 -0
- package/app/codecmp.py +59 -0
- package/app/config.py +411 -0
- package/app/context.py +1493 -0
- package/app/cvss.py +357 -0
- package/app/db.py +6382 -0
- package/app/defect.py +670 -0
- package/app/defect_check.py +323 -0
- package/app/defect_drafts.py +612 -0
- package/app/defect_dto.py +149 -0
- package/app/defect_fields.py +248 -0
- package/app/defect_form.py +124 -0
- package/app/defect_links.py +107 -0
- package/app/defect_local_text.py +103 -0
- package/app/defect_references.py +164 -0
- package/app/defect_where.py +147 -0
- package/app/ecosystem.py +51 -0
- package/app/example_tree.py +48 -0
- package/app/examples.py +622 -0
- package/app/executors.py +670 -0
- package/app/feeds.py +1231 -0
- package/app/guard.py +164 -0
- package/app/hub_block_builder.py +200 -0
- package/app/hub_block_version.py +220 -0
- package/app/hub_defects.py +4469 -0
- package/app/hub_effects.py +421 -0
- package/app/hub_entity_versions.py +108 -0
- package/app/hub_import.py +2054 -0
- package/app/hub_onboarding.py +114 -0
- package/app/hub_ops.py +330 -0
- package/app/hub_pull.py +1195 -0
- package/app/hub_state.py +255 -0
- package/app/hub_status.py +237 -0
- package/app/hub_sync.py +619 -0
- package/app/hub_sync_api.py +241 -0
- package/app/hub_sync_compare.py +1054 -0
- package/app/hub_sync_contract.py +75 -0
- package/app/hub_template_model.py +74 -0
- package/app/hub_text_scale.py +159 -0
- package/app/journal.py +250 -0
- package/app/llm.py +850 -0
- package/app/llm_chat.py +596 -0
- package/app/llm_http.py +319 -0
- package/app/llm_messages.py +401 -0
- package/app/llm_net.py +764 -0
- package/app/llm_ollama.py +571 -0
- package/app/lockfile.py +510 -0
- package/app/logsafe.py +54 -0
- package/app/main.py +373 -0
- package/app/mask_display.py +132 -0
- package/app/masking.py +814 -0
- package/app/metrics.py +194 -0
- package/app/model_traffic.py +519 -0
- package/app/models.py +483 -0
- package/app/navigation.py +121 -0
- package/app/osv.py +279 -0
- package/app/package_identity.py +189 -0
- package/app/package_transition.py +824 -0
- package/app/profile_gate.py +71 -0
- package/app/prompts.py +1108 -0
- package/app/provider_keys.py +189 -0
- package/app/providers.py +529 -0
- package/app/routes/__init__.py +10 -0
- package/app/routes/api.py +153 -0
- package/app/routes/capec.py +186 -0
- package/app/routes/common.py +407 -0
- package/app/routes/components.py +1499 -0
- package/app/routes/cwe.py +168 -0
- package/app/routes/decision_selected.py +153 -0
- package/app/routes/defect_add.py +223 -0
- package/app/routes/defect_card_routes.py +363 -0
- package/app/routes/defect_selected.py +342 -0
- package/app/routes/examples.py +661 -0
- package/app/routes/feeds.py +155 -0
- package/app/routes/findings.py +2758 -0
- package/app/routes/hub.py +402 -0
- package/app/routes/hub_bulk.py +288 -0
- package/app/routes/hub_defect_routes.py +1945 -0
- package/app/routes/hub_status_routes.py +1132 -0
- package/app/routes/hub_sync_routes.py +463 -0
- package/app/routes/journal.py +132 -0
- package/app/routes/projects.py +1665 -0
- package/app/routes/providers.py +403 -0
- package/app/routes/references.py +26 -0
- package/app/routes/runs.py +219 -0
- package/app/routes/sca.py +2722 -0
- package/app/routes/settings.py +163 -0
- package/app/run_errors.py +151 -0
- package/app/sca.py +1662 -0
- package/app/sca_contract.py +1289 -0
- package/app/sca_research.py +1089 -0
- package/app/sca_research_net.py +1007 -0
- package/app/sca_text.py +965 -0
- package/app/serve.py +70 -0
- package/app/settings_store.py +262 -0
- package/app/static/app.css +2820 -0
- package/app/static/app.js +3772 -0
- package/app/static/capec-license.txt +9 -0
- package/app/static/favicon.svg +1 -0
- package/app/static/fonts/Golos-Text_DemiBold.woff2 +0 -0
- package/app/static/fonts/Golos-Text_Regular.woff2 +0 -0
- package/app/static/fonts/OFL.txt +90 -0
- package/app/static/navigation.js +234 -0
- package/app/static/observability.js +121 -0
- package/app/static/theme.js +82 -0
- package/app/storage/__init__.py +16 -0
- package/app/storage/local_state.py +246 -0
- package/app/storage/migrate.py +110 -0
- package/app/storage/migrations/postgresql/0001_baseline.sql +896 -0
- package/app/storage/migrations/postgresql/0002_feeds_and_secrets.sql +55 -0
- package/app/storage/migrations/postgresql/0003_project_mask_display.sql +5 -0
- package/app/storage/migrations/postgresql/0004_package_identity.sql +36 -0
- package/app/storage/postgresql.py +573 -0
- package/app/storage/schema.py +619 -0
- package/app/storage/sql.py +57 -0
- package/app/storage/tools.py +254 -0
- package/app/telemetry.py +307 -0
- package/app/templates/base.html +93 -0
- package/app/templates/capec/context.html +3 -0
- package/app/templates/capec/detail.html +27 -0
- package/app/templates/capec/index.html +128 -0
- package/app/templates/components/_archive.html +11 -0
- package/app/templates/components/archived.html +19 -0
- package/app/templates/components/batch.html +35 -0
- package/app/templates/components/detail.html +332 -0
- package/app/templates/components/index.html +338 -0
- package/app/templates/components/research_preview.html +80 -0
- package/app/templates/components/research_run.html +54 -0
- package/app/templates/cwe/bdu.html +56 -0
- package/app/templates/cwe/detail.html +233 -0
- package/app/templates/cwe/index.html +97 -0
- package/app/templates/error.html +8 -0
- package/app/templates/examples/index.html +67 -0
- package/app/templates/examples/mapping.html +26 -0
- package/app/templates/feeds/index.html +65 -0
- package/app/templates/findings/card.html +641 -0
- package/app/templates/findings/decision_selected.html +41 -0
- package/app/templates/findings/defect_add.html +46 -0
- package/app/templates/findings/defect_selected.html +47 -0
- package/app/templates/findings/list.html +153 -0
- package/app/templates/findings/send_selected.html +53 -0
- package/app/templates/findings/trace.html +72 -0
- package/app/templates/help.html +50 -0
- package/app/templates/journal/detail.html +19 -0
- package/app/templates/journal/index.html +19 -0
- package/app/templates/macros.html +440 -0
- package/app/templates/navigation-fields.html +1 -0
- package/app/templates/navigation.html +11 -0
- package/app/templates/projects/_identity_summary.html +42 -0
- package/app/templates/projects/defect_card.html +153 -0
- package/app/templates/projects/defect_create_preview.html +17 -0
- package/app/templates/projects/defect_fields_diff.html +6 -0
- package/app/templates/projects/defect_fields_form.html +40 -0
- package/app/templates/projects/defect_references.html +17 -0
- package/app/templates/projects/defect_sync_preview.html +28 -0
- package/app/templates/projects/defect_update_actions.html +6 -0
- package/app/templates/projects/defect_update_preview.html +24 -0
- package/app/templates/projects/defects.html +126 -0
- package/app/templates/projects/delete.html +31 -0
- package/app/templates/projects/external.html +62 -0
- package/app/templates/projects/folders.html +64 -0
- package/app/templates/projects/hub_accepted.html +10 -0
- package/app/templates/projects/hub_assignment.html +50 -0
- package/app/templates/projects/hub_pending.html +20 -0
- package/app/templates/projects/hub_pending_list.html +17 -0
- package/app/templates/projects/hub_state_note.html +23 -0
- package/app/templates/projects/hub_step_note.html +5 -0
- package/app/templates/projects/hub_sync.html +105 -0
- package/app/templates/projects/hub_sync_confirm.html +32 -0
- package/app/templates/projects/hub_sync_worker.html +5 -0
- package/app/templates/projects/hub_text_rules.html +64 -0
- package/app/templates/projects/identity_report.html +74 -0
- package/app/templates/projects/list.html +90 -0
- package/app/templates/projects/project.html +436 -0
- package/app/templates/reference-missing.html +14 -0
- package/app/templates/runs/run.html +166 -0
- package/app/templates/sca/card.html +476 -0
- package/app/templates/sca/index.html +321 -0
- package/app/templates/settings/hub_url.html +31 -0
- package/app/templates/settings/index.html +216 -0
- package/app/templates/settings/provider.html +231 -0
- package/app/templates/settings/providers.html +37 -0
- package/app/templates/worklists.html +52 -0
- package/app/textsafe.py +117 -0
- package/app/timing.py +245 -0
- package/app/triage.py +1746 -0
- package/app/view.py +430 -0
- package/app/worklists.py +204 -0
- package/examples/catalog/NOTICE.md +70 -0
- package/examples/catalog/catalog.json +978 -0
- package/examples/catalog/crapi/export.xlsx +0 -0
- package/examples/catalog/dvga/export.xlsx +0 -0
- package/examples/catalog/dvwa/export.xlsx +0 -0
- package/examples/catalog/go-test-bench/export.xlsx +0 -0
- package/examples/catalog/juice-shop/export.xlsx +0 -0
- package/examples/catalog/nodegoat/export.xlsx +0 -0
- package/examples/catalog/pygoat/export.xlsx +0 -0
- package/examples/catalog/railsgoat/export.xlsx +0 -0
- package/examples/catalog/vulnerablelightapp/export.xlsx +0 -0
- package/examples/catalog/webgoat/export.xlsx +0 -0
- package/examples/demo/demo-hub-report-v2.xlsx +0 -0
- package/examples/demo/demo-hub-report.xlsx +0 -0
- package/examples/demo/repos/billing-core/pom.xml +30 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/Invoice.java +9 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceRepository.java +51 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceStatus.java +11 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/config/DatabaseSettings.java +18 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/payment/PaymentTokenService.java +35 -0
- package/examples/demo/repos/billing-core/src/main/java/org/example/billing/web/InvoiceExportController.java +57 -0
- package/examples/demo/repos/catalog-api/catalog_api/__init__.py +1 -0
- package/examples/demo/repos/catalog-api/catalog_api/products.py +24 -0
- package/examples/demo/repos/catalog-api/catalog_api/tasks.py +24 -0
- package/examples/demo/repos/catalog-api/catalog_api/views.py +17 -0
- package/examples/demo/repos/catalog-api/requirements.txt +3 -0
- package/npm/build.json +5 -0
- package/npm/cli.js +357 -0
- package/npm/files.manifest +242 -0
- package/npm/lib/binding.js +65 -0
- package/npm/lib/cluster.js +330 -0
- package/npm/lib/env.js +88 -0
- package/npm/lib/fsx.js +125 -0
- package/npm/lib/http.js +53 -0
- package/npm/lib/metrics.js +73 -0
- package/npm/lib/paths.js +150 -0
- package/npm/lib/pg.js +348 -0
- package/npm/lib/proc.js +101 -0
- package/npm/lib/python.js +133 -0
- package/npm/lib/stand.js +46 -0
- package/npm/lib/supervisor.js +1200 -0
- package/npm/lib/version.js +21 -0
- package/npm/requirements.txt +476 -0
- package/npm-shrinkwrap.json +111 -0
- package/package.json +37 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Vitaly Pikov
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,195 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Локальный триаж – учебный стенд
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
## Что это
|
|
4
|
+
|
|
5
|
+
Программы проверки безопасности кода (анализаторы) находят в нём подозрительные места: возможную SQL-инъекцию,
|
|
6
|
+
пароль, записанный прямо в коде, устаревшую библиотеку с известной уязвимостью. Таких находок обычно сотни, и часть из
|
|
7
|
+
них ложные. Человек должен разобрать каждую: посмотреть код, понять, есть ли настоящая проблема, и записать решение.
|
|
8
|
+
Этот разбор называется **триажем**.
|
|
9
|
+
|
|
10
|
+
Учебный стенд «Локальный триаж» – приложение, на котором этому учатся. В нём уже есть десять открытых учебных
|
|
11
|
+
приложений с намеренно оставленными уязвимостями и готовые результаты их проверки. Вы открываете находку, смотрите код,
|
|
12
|
+
читаете подсказку языковой модели и принимаете решение сами: «ложное срабатывание» или «подтверждаю дефект».
|
|
13
|
+
|
|
14
|
+
Что разбирается на стенде:
|
|
15
|
+
|
|
16
|
+
- **SAST** – находки в исходном коде (инъекции, межсайтовый скриптинг, обход пути, секреты в коде и другие);
|
|
17
|
+
- **SCA** – уязвимости сторонних компонентов, которые использует приложение (например, старая версия библиотеки);
|
|
18
|
+
- **лицензии компонентов** – компоненты, условия лицензии которых нужно учитывать.
|
|
19
|
+
|
|
20
|
+
Всё работает на вашем компьютере, в браузере. Стенд ставится одной командой, Docker не нужен.
|
|
21
|
+
|
|
22
|
+
## Что нужно заранее
|
|
23
|
+
|
|
24
|
+
1. **Компьютер:** Windows 10 или 11 (64-разрядная) или Linux. На macOS стенд не проверялся. Windows на процессорах ARM
|
|
25
|
+
не поддерживается.
|
|
26
|
+
2. **Node.js версии 20 или новее.** Скачайте установщик версии LTS с https://nodejs.org/ и установите с настройками по
|
|
27
|
+
умолчанию.
|
|
28
|
+
3. **Около 2 ГБ свободного места и интернет** при первом запуске: стенд сам скачает Python и всё, что ему нужно.
|
|
29
|
+
|
|
30
|
+
## Установка и первый запуск
|
|
31
|
+
|
|
32
|
+
1. Откройте терминал: на Windows – PowerShell (нажмите «Пуск», наберите «PowerShell»), на Linux – «Терминал».
|
|
33
|
+
2. Введите команду и нажмите Enter:
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
npx local-triage
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Если появится вопрос `Ok to proceed? (y)`, нажмите `y` и Enter.
|
|
40
|
+
|
|
41
|
+
3. Подождите несколько минут. В окне будут появляться строки о ходе установки. Когда всё будет готово, появится строка
|
|
42
|
+
«Стенд работает: http://127.0.0.1:8765/» и откроется браузер со страницей стенда. Если браузер не открылся,
|
|
43
|
+
скопируйте этот адрес в браузер сами.
|
|
44
|
+
4. **Не закрывайте окно терминала, пока работаете.** В нём работает стенд. Закрыли окно – стенд остановился.
|
|
45
|
+
5. Закончили работу – нажмите в окне терминала Ctrl+C или просто закройте окно. Все ваши решения сохраняются.
|
|
46
|
+
|
|
47
|
+
В следующий раз запускайте стенд той же командой `npx local-triage`: запуск займёт несколько секунд.
|
|
48
|
+
|
|
49
|
+
## Первые шаги в стенде
|
|
50
|
+
|
|
51
|
+
### 1. Подключите языковую модель
|
|
52
|
+
|
|
53
|
+
Модель читает код находки и предлагает свой вердикт. Без модели тоже можно работать: решения принимаете вы, просто
|
|
54
|
+
без подсказки.
|
|
55
|
+
|
|
56
|
+
Откройте в стенде вкладку **«Примеры»**, блок **«Начало работы»**, и выберите один из двух вариантов.
|
|
57
|
+
|
|
58
|
+
- **Ollama – модель на вашем компьютере.** Подходит, если у видеокарты 16 ГБ памяти или больше. Код никуда не уходит.
|
|
59
|
+
1. Установите Ollama с https://ollama.com.
|
|
60
|
+
2. В терминале выполните `ollama pull gpt-oss:20b` – модель скачивается один раз, это несколько гигабайт.
|
|
61
|
+
3. В стенде нажмите ссылку «заготовка «Ollama на этом компьютере»», затем «Проверить» и «Сохранить».
|
|
62
|
+
- **DeepSeek – модель в интернете.** Подходит для любого компьютера. Нужен свой ключ API DeepSeek
|
|
63
|
+
(https://platform.deepseek.com), запросы к модели платные.
|
|
64
|
+
1. Получите ключ в кабинете DeepSeek и сразу поставьте там лимит расхода.
|
|
65
|
+
2. В стенде нажмите ссылку «заготовка DeepSeek»: адрес и модель уже заполнены.
|
|
66
|
+
3. Вставьте ключ в поле «Ключ», нажмите «Проверить», затем «Сохранить».
|
|
67
|
+
|
|
68
|
+
Код учебного примера уйдёт в DeepSeek только после того, как вы сами разрешите это на странице предпросмотра
|
|
69
|
+
проекта: там видно, что именно получит модель. Данные обрабатываются провайдером в Китае.
|
|
70
|
+
|
|
71
|
+

|
|
72
|
+
|
|
73
|
+

|
|
74
|
+
|
|
75
|
+
В том же блоке выберите сохранённый профиль в поле **«Профиль для примеров»** и нажмите «Сохранить» – тогда модель
|
|
76
|
+
будет подключаться к каждому новому проекту из десяти учебных приложений сама. Demo Library работает с профилем по
|
|
77
|
+
умолчанию: другой профиль выбирается в параметрах её проекта.
|
|
78
|
+
|
|
79
|
+
### 2. Выберите пример и создайте проект
|
|
80
|
+
|
|
81
|
+
На вкладке «Примеры» – карточки учебных приложений: OWASP Juice Shop, OWASP WebGoat, PyGoat, OWASP NodeGoat, DVWA,
|
|
82
|
+
OWASP RailsGoat, DVGA, go-test-bench, VulnerableLightApp, OWASP crAPI. Есть и небольшой выдуманный пример Demo Library –
|
|
83
|
+
с него удобно начать.
|
|
84
|
+
|
|
85
|
+

|
|
86
|
+
|
|
87
|
+
1. После первого запуска стенд сам скачивает исходный код примеров с GitHub. Подождите, пока на карточке появится
|
|
88
|
+
«Скачан». Если написано «Не скачан», нажмите «Скачать».
|
|
89
|
+
2. Нажмите **«Создать проект»**. Стенд загрузит находки примера и откроет страницу проекта.
|
|
90
|
+
|
|
91
|
+
### 3. Разберите находки
|
|
92
|
+
|
|
93
|
+
1. На странице проекта откройте вкладку **«Находки»** – это находки SAST в коде.
|
|
94
|
+
2. Откройте находку. В карточке – правило, которое сработало, класс уязвимости (CWE) со ссылкой на описание и код
|
|
95
|
+
вокруг строки срабатывания. Кнопка **«Открыть в VS Code»** открывает файл на нужной строке, если установлен
|
|
96
|
+
редактор VS Code.
|
|
97
|
+
3. Нажмите «Разобрать моделью», чтобы получить подсказку, или разберитесь сами.
|
|
98
|
+
4. Выберите решение: **«Ложное срабатывание»** (с короткой причиной) или **«Подтверждаю дефект»**.
|
|
99
|
+
5. Уязвимости компонентов – на вкладке **«SCA»**, находки о лицензиях – в общем списке находок.
|
|
100
|
+
|
|
101
|
+

|
|
102
|
+
|
|
103
|
+

|
|
104
|
+
|
|
105
|
+

|
|
106
|
+
|
|
107
|
+
Подробная справка и словарь терминов – кнопка **«Справка»** в верхней строке стенда.
|
|
108
|
+
|
|
109
|
+
## Где лежат файлы
|
|
110
|
+
|
|
111
|
+
Стенд создаёт две папки:
|
|
112
|
+
|
|
113
|
+
- **Папка кода** – папка `local-triage` в вашей личной папке: `%USERPROFILE%\local-triage` на Windows,
|
|
114
|
+
`~/local-triage` на Linux. Здесь лежит исходный код
|
|
115
|
+
примеров. Эту папку можно открыть в VS Code и менять код: стенд ваши правки не трогает. Чтобы получить чистую копию
|
|
116
|
+
примера, нажмите на его карточке «Скачать заново» – новая копия появится рядом, старая останется.
|
|
117
|
+
- **Служебная папка** – `%LOCALAPPDATA%\local-triage` на Windows, `~/.local/share/local-triage` на Linux. Здесь база с вашими решениями, Python и журналы. Менять в ней ничего не нужно.
|
|
118
|
+
|
|
119
|
+
Команда `npx local-triage --where` покажет обе папки полными путями. На Windows путь вида `%USERPROFILE%\local-triage`
|
|
120
|
+
можно вставить в адресную строку Проводника – откроется нужная папка.
|
|
121
|
+
|
|
122
|
+
## Если что-то пошло не так
|
|
123
|
+
|
|
124
|
+
- **Команда `npx` не найдена.** Node.js не установлен или терминал открыт до установки. Установите Node.js, закройте
|
|
125
|
+
терминал и откройте его снова.
|
|
126
|
+
- **Стенд уже запущен в другом окне.** Тогда команда `npx local-triage` просто откроет браузер со стендом: второй
|
|
127
|
+
стенд не нужен.
|
|
128
|
+
- **Пример не скачивается.** Нужен прямой доступ в интернет к github.com. Нажмите на карточке «Повторить».
|
|
129
|
+
- **Проверка окружения:** `npx local-triage --doctor` проверит окружение и напечатает результат.
|
|
130
|
+
- Журналы работы лежат в папке `logs` служебной папки – их можно приложить к вопросу преподавателю.
|
|
131
|
+
|
|
132
|
+
## Параметры команды
|
|
133
|
+
|
|
134
|
+
Обычно параметры не нужны. Пишутся после команды, например `npx local-triage --no-open`.
|
|
135
|
+
|
|
136
|
+
| Параметр | Что делает |
|
|
137
|
+
|---|---|
|
|
138
|
+
| `--no-open` | не открывать браузер при запуске |
|
|
139
|
+
| `--port 8800` | открыть стенд на другом порту, если 8765 занят |
|
|
140
|
+
| `--local-only` | запретить модели в интернете (DeepSeek): работают только модели на вашем компьютере и в локальной сети |
|
|
141
|
+
| `--where` | показать, где лежат папки стенда |
|
|
142
|
+
| `--doctor` | проверить окружение |
|
|
143
|
+
| `--new-database` | начать с чистой базы; прежняя база сохраняется в служебной папке, в `pg\backups` |
|
|
144
|
+
| `--home ПАПКА` | держать служебные файлы в другой папке – получится отдельный стенд со своей базой; указывайте новую пустую папку |
|
|
145
|
+
| `--code-dir ПАПКА` | другая папка кода; задаётся при первом запуске и потом не меняется |
|
|
146
|
+
| `--version`, `--help` | версия и краткая справка |
|
|
147
|
+
|
|
148
|
+
## Что стенд не умеет
|
|
149
|
+
|
|
150
|
+
- **Не передаёт решения во внешние системы.** В организациях результаты всех анализаторов собирают в системе класса
|
|
151
|
+
ASOC (Application Security Orchestration and Correlation – оркестрация и корреляция результатов анализа
|
|
152
|
+
защищённости). Одна из таких систем – AppSec.Hub, и приложение «Локальный триаж» умеет отправлять в неё решения. На
|
|
153
|
+
учебном стенде этой связи нет: все решения остаются только в базе на вашем компьютере. Находки примеров подготовлены
|
|
154
|
+
в формате выгрузки AppSec.Hub, поэтому в программе встречаются слова «Hub» и «Перенос в Hub (ASOC)».
|
|
155
|
+
- **Не работает через прокси-сервер.** К DeepSeek и к GitHub (скачивание примеров) стенд подключается напрямую.
|
|
156
|
+
- **На Linux не запускается от пользователя root** – запускайте от обычного пользователя.
|
|
157
|
+
|
|
158
|
+
## Вернуть базу, какой она была до обновления
|
|
159
|
+
|
|
160
|
+
Когда выходит новая версия стенда, она может обновить устройство базы. Перед этим стенд сохраняет копию прежней базы
|
|
161
|
+
в папке `pg\backups\<имя копии>` служебной папки. Рядом лежат файл `<имя копии>.json` (в поле `npm_version` – версия
|
|
162
|
+
стенда, которая работала с этой базой) и файл `<имя копии>.pg.pw` – пароль этой базы. Чтобы вернуться к копии:
|
|
163
|
+
|
|
164
|
+
1. Закройте окно стенда.
|
|
165
|
+
2. В служебной папке переименуйте папку `pg\data` в `pg\data-new` и файл `secrets\pg.pw` в `secrets\pg.pw-new`.
|
|
166
|
+
3. Переименуйте папку копии в `pg\data`, а её файл пароля `<имя копии>.pg.pw` скопируйте в `secrets\pg.pw`.
|
|
167
|
+
4. Запустите ту версию стенда, что указана в поле `npm_version`: `npx local-triage@<версия>`. Если там `unknown`,
|
|
168
|
+
версию можно найти в журнале `logs\supervisor-<дата>.log` за день, когда работала эта база, в строке
|
|
169
|
+
«Учебный стенд «Локальный триаж» … (пакет npm <версия>)». Если запустить прежнюю версию нельзя, новая версия снова
|
|
170
|
+
обновит базу, а копия до обновления опять сохранится.
|
|
171
|
+
|
|
172
|
+
Копии, которые делает параметр `--new-database`, называются `<время>-replaced-v<версия>`: база и пароль лежат внутри
|
|
173
|
+
папки копии (`data` и `pg.pw`), версия – в файле `<имя копии>.json`.
|
|
174
|
+
|
|
175
|
+
## Как удалить стенд
|
|
176
|
+
|
|
177
|
+
1. Закройте окно стенда.
|
|
178
|
+
2. Удалите служебную папку (её покажет `npx local-triage --where`).
|
|
179
|
+
3. Папку кода удаляйте, только если в ней нет вашей работы.
|
|
180
|
+
4. Стенд ставил Python через программу uv. Если uv вам больше не нужен, удалите и её папки: команда `uv python dir`
|
|
181
|
+
покажет папку Python, `uv cache dir` – папку кэша.
|
|
182
|
+
|
|
183
|
+
## Для тех, кто хочет посмотреть код стенда
|
|
184
|
+
|
|
185
|
+
Исходный код – https://github.com/pikov-vitaliy/local-triage-for-students. Чтобы запустить стенд из исходников, нужен
|
|
186
|
+
ещё Git:
|
|
187
|
+
|
|
188
|
+
```
|
|
189
|
+
git clone https://github.com/pikov-vitaliy/local-triage-for-students.git
|
|
190
|
+
cd local-triage-for-students
|
|
191
|
+
npm install
|
|
192
|
+
npx local-triage
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
Источники учебных примеров и их лицензии – в файле `examples/catalog/NOTICE.md`.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Сторонние компоненты учебного стенда «Локальный триаж»
|
|
2
|
+
|
|
3
|
+
Перечень того, что входит в пакет npm или ставится им на компьютер пользователя. Перечень дополняется с каждой сборкой
|
|
4
|
+
стенда; полные тексты уведомлений библиотек из сборок PostgreSQL добавляются к выпуску пакета.
|
|
5
|
+
|
|
6
|
+
## Входит в пакет
|
|
7
|
+
|
|
8
|
+
- **Golos Text** – шрифт интерфейса, файлы `app/static/fonts/Golos-Text_*.woff2`. Авторы – Paratype и соавторы.
|
|
9
|
+
SIL Open Font License 1.1, полный текст – `app/static/fonts/OFL.txt`.
|
|
10
|
+
- **CAPEC** – каталог шаблонов атак, Copyright © The MITRE Corporation. Условия использования –
|
|
11
|
+
`app/static/capec-license.txt`.
|
|
12
|
+
- **Значки интерфейса** – из набора Lucide (лицензия ISC); часть значков Lucide происходит из набора Feather
|
|
13
|
+
(лицензия MIT).
|
|
14
|
+
|
|
15
|
+
## Ставится на компьютер пользователя при первом запуске
|
|
16
|
+
|
|
17
|
+
- **PostgreSQL 17.12** – бинарники из пакетов `@embedded-postgres/<платформа>@17.12.0-beta.19` (лицензия MIT
|
|
18
|
+
обёртки пакетов, автор Lei Nelissen). Сам PostgreSQL распространяется по PostgreSQL License; в сборках для каждой
|
|
19
|
+
платформы есть сторонние библиотеки (OpenSSL, ICU, zlib, libxml2, libxslt, gettext, libiconv, lz4, zstd, curl, на
|
|
20
|
+
Windows также wxWidgets).
|
|
21
|
+
- **Python 3.12 и uv** – ставятся их собственными установщиками (uv – с сайта astral.sh) или берутся с компьютера.
|
|
22
|
+
- **Зависимости приложения** – из PyPI по перечню `npm/requirements.txt` с хешами; в пакет npm они не вкладываются.
|
|
23
|
+
Лицензии – по метаданным установленных пакетов:
|
|
24
|
+
|
|
25
|
+
| Пакет | Версия | Лицензия |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| annotated-doc | 0.0.5 | MIT |
|
|
28
|
+
| annotated-types | 0.8.0 | MIT |
|
|
29
|
+
| anyio | 4.15.1 | MIT |
|
|
30
|
+
| click | 8.5.0 | BSD-3-Clause |
|
|
31
|
+
| colorama (только Windows) | 0.4.6 | BSD |
|
|
32
|
+
| et-xmlfile | 2.0.0 | MIT |
|
|
33
|
+
| fastapi | 0.141.1 | MIT |
|
|
34
|
+
| h11 | 0.16.0 | MIT |
|
|
35
|
+
| idna | 3.20 | BSD-3-Clause |
|
|
36
|
+
| Jinja2 | 3.1.6 | BSD |
|
|
37
|
+
| MarkupSafe | 3.0.4 | BSD-3-Clause |
|
|
38
|
+
| openpyxl | 3.1.5 | MIT |
|
|
39
|
+
| psycopg, psycopg-binary | 3.3.7 | LGPL-3.0-only |
|
|
40
|
+
| psycopg-pool | 3.3.3 | LGPL-3.0-only |
|
|
41
|
+
| pydantic | 2.14.1 | MIT |
|
|
42
|
+
| pydantic-core | 2.50.1 | MIT |
|
|
43
|
+
| python-multipart | 0.0.32 | Apache-2.0 |
|
|
44
|
+
| starlette | 1.8.0 | BSD-3-Clause |
|
|
45
|
+
| typing-extensions | 4.16.0 | PSF-2.0 |
|
|
46
|
+
| typing-inspection | 0.4.4 | MIT |
|
|
47
|
+
| tzdata (только Windows) | 2026.6 | Apache-2.0 |
|
|
48
|
+
| uvicorn | 0.54.0 | BSD-3-Clause |
|
|
49
|
+
|
|
50
|
+
## Каталог учебных примеров
|
|
51
|
+
|
|
52
|
+
В пакет входят описание каталога (`examples/catalog/catalog.json`), выгрузки `examples/catalog/*/export.xlsx` и
|
|
53
|
+
`examples/catalog/NOTICE.md`. Выгрузки содержат номера находок, идентификаторы правил, пути, номера строк, имена и
|
|
54
|
+
версии компонентов, без строк кода примеров. Код примеров в пакет не входит: стенд скачивает его с GitHub по
|
|
55
|
+
закреплённому коммиту, примеры распространяют их авторы на условиях своих лицензий (MIT, Apache-2.0,
|
|
56
|
+
GPL-2.0-or-later, GPL-3.0-or-later, GPL-3.0-only – по примерам в `examples/catalog/NOTICE.md`).
|
|
57
|
+
|
|
58
|
+
Выгрузки собраны анализаторами, которые в пакет не входят: Semgrep CE (LGPL-2.1) с собственными учебными правилами
|
|
59
|
+
репозитория, Bandit (Apache-2.0), gosec (Apache-2.0), OSV-Scanner (Apache-2.0). Сведения об уязвимостях – из базы OSV
|
|
60
|
+
(https://osv.dev), о лицензиях компонентов – из deps.dev (https://deps.dev) на дату сборки каталога; источники записей
|
|
61
|
+
OSV по примерам перечислены в `examples/catalog/NOTICE.md`.
|
package/app/__init__.py
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
"""Маска принадлежности (ADR-0118): слова, по которым код можно отнести к организации – её название, сокращение,
|
|
2
|
+
город, домен, – заменяются на «org»/«орг» в каждом запросе к модели, локальной или внешней. Это важнее секретов:
|
|
3
|
+
секреты в коде уже проверены до выгрузки, а связь кода с организацией – то, что
|
|
4
|
+
прежде всего нельзя отдавать наружу.
|
|
5
|
+
|
|
6
|
+
Список слов – настройка «Слова принадлежности» (таблица settings, ключ affiliation_words); в репозитории списка
|
|
7
|
+
нет, он задаётся на установке. Слово сравнивается без учёта регистра с частями идентификаторов и словами текста:
|
|
8
|
+
«AcmeRuClient» делится на Acme, Ru, Client; «ACME города Exampletown» – на три слова. Поэтому «acmeist» и
|
|
9
|
+
«Contora» не трогаются. Слово с «*» в конце совпадает по началу («Контор*» – Контора, Конторы, Конторский).
|
|
10
|
+
Замена сохраняет вид части: ACME → ORG, Acme → Org, acme → org, кириллица – орг. Части выделяются по регистру
|
|
11
|
+
Unicode (любой алфавит): строчная → Прописная и прописные перед Прописной+строчная (ACMEData → ACME, Data).
|
|
12
|
+
|
|
13
|
+
Граница – app/llm_http.py ServerClient._request: в теле запроса к серверу модели маскируются сообщения
|
|
14
|
+
(`messages[].content`, в том числе блоки Messages API и ответы инструментов) и системный текст (`system`);
|
|
15
|
+
служебные поля протокола – имя модели, схема ответа, описания и имена инструментов, роли – не трогаются, иначе
|
|
16
|
+
запрос ушёл бы к несуществующей модели или с противоречивой схемой. Журнал обмена записывает уже заменённый текст.
|
|
17
|
+
Точный запрос OSV (app/osv.py) идёт тем же транспортом без маски: ему нужны настоящие имена пакетов.
|
|
18
|
+
Карточка и база приложения хранят код как есть: оператор – сотрудник организации, маска ему не нужна; отпечатки
|
|
19
|
+
срезов и решений от маски не зависят.
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
from __future__ import annotations
|
|
23
|
+
|
|
24
|
+
import re
|
|
25
|
+
from collections.abc import Iterable
|
|
26
|
+
from typing import Any
|
|
27
|
+
|
|
28
|
+
MAX_WORDS = 200 # слов в списке
|
|
29
|
+
MAX_WORD = 50 # букв в слове
|
|
30
|
+
# слово списка: буквы любого алфавита (без цифр, точек и «_»), в конце допустима «*» – совпадение по началу
|
|
31
|
+
WORD_RE = re.compile(r"[^\W\d_]{2,50}\*?")
|
|
32
|
+
|
|
33
|
+
_LETTERS = re.compile(r"[^\W\d_]+") # буквенные части текста: идентификаторы режутся по цифрам, «_», точкам
|
|
34
|
+
_CYRILLIC = re.compile(r"[А-Яа-яЁё]")
|
|
35
|
+
_TEXT_KEYS = ("content", "text") # поля с текстом для модели внутри сообщений и блоков
|
|
36
|
+
|
|
37
|
+
_rules: tuple[tuple[str, bool], ...] = () # (слово в casefold, по началу?)
|
|
38
|
+
_given: tuple[str, ...] = () # слова как заданы – для страниц и проверок
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def configure(words: Iterable[str]) -> None:
|
|
42
|
+
"""Задать список слов (при запуске приложения и после сохранения «Настроек»). Пустой список – маски нет."""
|
|
43
|
+
global _rules, _given
|
|
44
|
+
rules = []
|
|
45
|
+
given = []
|
|
46
|
+
for word in words:
|
|
47
|
+
text = str(word or "").strip()
|
|
48
|
+
if not text.rstrip("*"):
|
|
49
|
+
continue
|
|
50
|
+
rules.append((text.rstrip("*").casefold(), text.endswith("*")))
|
|
51
|
+
given.append(text)
|
|
52
|
+
_rules = tuple(rules)
|
|
53
|
+
_given = tuple(given)
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def words() -> tuple[str, ...]:
|
|
57
|
+
"""Действующие слова списка (как заданы: с «*» у совпадений по началу) – для проверок и страниц."""
|
|
58
|
+
return _given
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def active() -> bool:
|
|
62
|
+
return bool(_rules)
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def _matches(part: str) -> bool:
|
|
66
|
+
folded = part.casefold()
|
|
67
|
+
return any(folded == word or (prefix and folded.startswith(word)) for word, prefix in _rules)
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def _replacement(part: str) -> str:
|
|
71
|
+
base = "орг" if _CYRILLIC.match(part[0]) else "org"
|
|
72
|
+
if len(part) > 1 and part.isupper():
|
|
73
|
+
return base.upper()
|
|
74
|
+
if part[0].isupper():
|
|
75
|
+
return base.capitalize()
|
|
76
|
+
return base
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def _parts(segment: str) -> list[str]:
|
|
80
|
+
"""Части буквенной последовательности по регистру Unicode: граница между строчной и Прописной и перед последней
|
|
81
|
+
прописной в ряду прописных, за которой идёт строчная (getACMEData → get, ACME, Data). Буквы без регистра
|
|
82
|
+
(иероглифы и т. п.) границ не дают – такая последовательность сравнивается целиком."""
|
|
83
|
+
parts = []
|
|
84
|
+
start = 0
|
|
85
|
+
n = len(segment)
|
|
86
|
+
for i in range(1, n):
|
|
87
|
+
prev, cur = segment[i - 1], segment[i]
|
|
88
|
+
if (prev.islower() and cur.isupper()) or (
|
|
89
|
+
prev.isupper() and cur.isupper() and i + 1 < n and segment[i + 1].islower()):
|
|
90
|
+
parts.append(segment[start:i])
|
|
91
|
+
start = i
|
|
92
|
+
parts.append(segment[start:])
|
|
93
|
+
return parts
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def mask_text(text: str) -> str:
|
|
97
|
+
"""Текст с заменёнными словами принадлежности; без списка или без текста – тот же объект."""
|
|
98
|
+
if not _rules or not text:
|
|
99
|
+
return text
|
|
100
|
+
|
|
101
|
+
def segment(m: re.Match) -> str:
|
|
102
|
+
return "".join(_replacement(p) if _matches(p) else p for p in _parts(m.group(0)))
|
|
103
|
+
|
|
104
|
+
return _LETTERS.sub(segment, text)
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
def _mask_block(value: Any) -> Any:
|
|
108
|
+
"""Строка – текст; словарь-блок – его поля content/text (строка или вложенные блоки); список – поэлементно."""
|
|
109
|
+
if isinstance(value, str):
|
|
110
|
+
return mask_text(value)
|
|
111
|
+
if isinstance(value, list):
|
|
112
|
+
return [_mask_block(item) for item in value]
|
|
113
|
+
if isinstance(value, dict):
|
|
114
|
+
out = dict(value)
|
|
115
|
+
for key in _TEXT_KEYS:
|
|
116
|
+
if key in out:
|
|
117
|
+
out[key] = _mask_block(out[key])
|
|
118
|
+
return out
|
|
119
|
+
return value
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
def mask_payload(payload: Any) -> Any:
|
|
123
|
+
"""Тело запроса к модели с заменой в сообщениях (`messages`) и системном тексте (`system`); остальные поля –
|
|
124
|
+
имя модели, схема ответа, инструменты, параметры – как есть. Без списка или не словарь – тот же объект."""
|
|
125
|
+
if not _rules or not isinstance(payload, dict):
|
|
126
|
+
return payload
|
|
127
|
+
out = dict(payload)
|
|
128
|
+
if isinstance(out.get("messages"), list):
|
|
129
|
+
out["messages"] = [_mask_block(m) for m in out["messages"]]
|
|
130
|
+
if "system" in out:
|
|
131
|
+
out["system"] = _mask_block(out["system"])
|
|
132
|
+
return out
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
def mask_messages(messages: list[dict]) -> list[dict]:
|
|
136
|
+
"""Сообщения как уйдут модели (предпросмотр)."""
|
|
137
|
+
return [_mask_block(m) for m in messages] if _rules else messages
|