local-triage 0.0.0-stage → 0.10.0-dev.32

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.
Files changed (223) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +90 -2
  3. package/THIRD-PARTY-NOTICES.md +48 -0
  4. package/app/__init__.py +3 -0
  5. package/app/affiliation.py +137 -0
  6. package/app/ask.py +300 -0
  7. package/app/build_info.py +98 -0
  8. package/app/capec.py +168 -0
  9. package/app/capec_view.py +27 -0
  10. package/app/codecmp.py +59 -0
  11. package/app/config.py +411 -0
  12. package/app/context.py +1451 -0
  13. package/app/cvss.py +357 -0
  14. package/app/db.py +6234 -0
  15. package/app/defect.py +670 -0
  16. package/app/defect_check.py +323 -0
  17. package/app/defect_drafts.py +612 -0
  18. package/app/defect_dto.py +149 -0
  19. package/app/defect_fields.py +248 -0
  20. package/app/defect_form.py +124 -0
  21. package/app/defect_links.py +107 -0
  22. package/app/defect_local_text.py +103 -0
  23. package/app/defect_references.py +164 -0
  24. package/app/defect_where.py +147 -0
  25. package/app/ecosystem.py +51 -0
  26. package/app/executors.py +660 -0
  27. package/app/feeds.py +1231 -0
  28. package/app/guard.py +164 -0
  29. package/app/hub_block_builder.py +200 -0
  30. package/app/hub_block_version.py +220 -0
  31. package/app/hub_defects.py +4469 -0
  32. package/app/hub_effects.py +421 -0
  33. package/app/hub_entity_versions.py +108 -0
  34. package/app/hub_import.py +2054 -0
  35. package/app/hub_onboarding.py +114 -0
  36. package/app/hub_ops.py +330 -0
  37. package/app/hub_pull.py +1195 -0
  38. package/app/hub_state.py +255 -0
  39. package/app/hub_status.py +237 -0
  40. package/app/hub_sync.py +619 -0
  41. package/app/hub_sync_api.py +241 -0
  42. package/app/hub_sync_compare.py +1054 -0
  43. package/app/hub_sync_contract.py +75 -0
  44. package/app/hub_template_model.py +74 -0
  45. package/app/hub_text_scale.py +159 -0
  46. package/app/journal.py +250 -0
  47. package/app/llm.py +850 -0
  48. package/app/llm_chat.py +596 -0
  49. package/app/llm_http.py +319 -0
  50. package/app/llm_messages.py +401 -0
  51. package/app/llm_net.py +764 -0
  52. package/app/llm_ollama.py +571 -0
  53. package/app/lockfile.py +505 -0
  54. package/app/logsafe.py +54 -0
  55. package/app/main.py +367 -0
  56. package/app/mask_display.py +132 -0
  57. package/app/masking.py +814 -0
  58. package/app/metrics.py +194 -0
  59. package/app/model_traffic.py +519 -0
  60. package/app/models.py +483 -0
  61. package/app/navigation.py +121 -0
  62. package/app/osv.py +279 -0
  63. package/app/package_identity.py +189 -0
  64. package/app/package_transition.py +824 -0
  65. package/app/profile_gate.py +71 -0
  66. package/app/prompts.py +1108 -0
  67. package/app/provider_keys.py +189 -0
  68. package/app/providers.py +511 -0
  69. package/app/routes/__init__.py +10 -0
  70. package/app/routes/api.py +153 -0
  71. package/app/routes/capec.py +186 -0
  72. package/app/routes/common.py +407 -0
  73. package/app/routes/components.py +1499 -0
  74. package/app/routes/cwe.py +168 -0
  75. package/app/routes/decision_selected.py +153 -0
  76. package/app/routes/defect_add.py +223 -0
  77. package/app/routes/defect_card_routes.py +363 -0
  78. package/app/routes/defect_selected.py +342 -0
  79. package/app/routes/feeds.py +155 -0
  80. package/app/routes/findings.py +2736 -0
  81. package/app/routes/hub.py +402 -0
  82. package/app/routes/hub_bulk.py +288 -0
  83. package/app/routes/hub_defect_routes.py +1945 -0
  84. package/app/routes/hub_status_routes.py +1132 -0
  85. package/app/routes/hub_sync_routes.py +463 -0
  86. package/app/routes/journal.py +132 -0
  87. package/app/routes/projects.py +1601 -0
  88. package/app/routes/providers.py +336 -0
  89. package/app/routes/references.py +26 -0
  90. package/app/routes/runs.py +219 -0
  91. package/app/routes/sca.py +2722 -0
  92. package/app/routes/settings.py +163 -0
  93. package/app/run_errors.py +151 -0
  94. package/app/sca.py +1662 -0
  95. package/app/sca_contract.py +1289 -0
  96. package/app/sca_research.py +1089 -0
  97. package/app/sca_research_net.py +1007 -0
  98. package/app/sca_text.py +965 -0
  99. package/app/serve.py +70 -0
  100. package/app/settings_store.py +262 -0
  101. package/app/static/app.css +2802 -0
  102. package/app/static/app.js +3772 -0
  103. package/app/static/capec-license.txt +9 -0
  104. package/app/static/favicon.svg +1 -0
  105. package/app/static/fonts/Golos-Text_DemiBold.woff2 +0 -0
  106. package/app/static/fonts/Golos-Text_Regular.woff2 +0 -0
  107. package/app/static/fonts/OFL.txt +90 -0
  108. package/app/static/navigation.js +234 -0
  109. package/app/static/observability.js +121 -0
  110. package/app/static/theme.js +49 -0
  111. package/app/storage/__init__.py +16 -0
  112. package/app/storage/local_state.py +246 -0
  113. package/app/storage/migrate.py +110 -0
  114. package/app/storage/migrations/postgresql/0001_baseline.sql +896 -0
  115. package/app/storage/migrations/postgresql/0002_feeds_and_secrets.sql +55 -0
  116. package/app/storage/migrations/postgresql/0003_project_mask_display.sql +5 -0
  117. package/app/storage/migrations/postgresql/0004_package_identity.sql +36 -0
  118. package/app/storage/postgresql.py +573 -0
  119. package/app/storage/schema.py +619 -0
  120. package/app/storage/sql.py +57 -0
  121. package/app/storage/tools.py +254 -0
  122. package/app/telemetry.py +307 -0
  123. package/app/templates/base.html +91 -0
  124. package/app/templates/capec/context.html +3 -0
  125. package/app/templates/capec/detail.html +27 -0
  126. package/app/templates/capec/index.html +128 -0
  127. package/app/templates/components/_archive.html +11 -0
  128. package/app/templates/components/archived.html +19 -0
  129. package/app/templates/components/batch.html +35 -0
  130. package/app/templates/components/detail.html +332 -0
  131. package/app/templates/components/index.html +338 -0
  132. package/app/templates/components/research_preview.html +80 -0
  133. package/app/templates/components/research_run.html +54 -0
  134. package/app/templates/cwe/bdu.html +56 -0
  135. package/app/templates/cwe/detail.html +233 -0
  136. package/app/templates/cwe/index.html +97 -0
  137. package/app/templates/error.html +8 -0
  138. package/app/templates/feeds/index.html +65 -0
  139. package/app/templates/findings/card.html +639 -0
  140. package/app/templates/findings/decision_selected.html +41 -0
  141. package/app/templates/findings/defect_add.html +46 -0
  142. package/app/templates/findings/defect_selected.html +47 -0
  143. package/app/templates/findings/list.html +153 -0
  144. package/app/templates/findings/send_selected.html +53 -0
  145. package/app/templates/findings/trace.html +72 -0
  146. package/app/templates/journal/detail.html +19 -0
  147. package/app/templates/journal/index.html +19 -0
  148. package/app/templates/macros.html +440 -0
  149. package/app/templates/navigation-fields.html +1 -0
  150. package/app/templates/navigation.html +11 -0
  151. package/app/templates/projects/_identity_summary.html +42 -0
  152. package/app/templates/projects/defect_card.html +153 -0
  153. package/app/templates/projects/defect_create_preview.html +17 -0
  154. package/app/templates/projects/defect_fields_diff.html +6 -0
  155. package/app/templates/projects/defect_fields_form.html +40 -0
  156. package/app/templates/projects/defect_references.html +17 -0
  157. package/app/templates/projects/defect_sync_preview.html +28 -0
  158. package/app/templates/projects/defect_update_actions.html +6 -0
  159. package/app/templates/projects/defect_update_preview.html +24 -0
  160. package/app/templates/projects/defects.html +126 -0
  161. package/app/templates/projects/delete.html +31 -0
  162. package/app/templates/projects/external.html +61 -0
  163. package/app/templates/projects/folders.html +64 -0
  164. package/app/templates/projects/hub_accepted.html +10 -0
  165. package/app/templates/projects/hub_assignment.html +50 -0
  166. package/app/templates/projects/hub_pending.html +20 -0
  167. package/app/templates/projects/hub_pending_list.html +17 -0
  168. package/app/templates/projects/hub_state_note.html +23 -0
  169. package/app/templates/projects/hub_step_note.html +5 -0
  170. package/app/templates/projects/hub_sync.html +105 -0
  171. package/app/templates/projects/hub_sync_confirm.html +32 -0
  172. package/app/templates/projects/hub_sync_worker.html +5 -0
  173. package/app/templates/projects/hub_text_rules.html +64 -0
  174. package/app/templates/projects/identity_report.html +74 -0
  175. package/app/templates/projects/list.html +90 -0
  176. package/app/templates/projects/project.html +433 -0
  177. package/app/templates/reference-missing.html +14 -0
  178. package/app/templates/runs/run.html +166 -0
  179. package/app/templates/sca/card.html +476 -0
  180. package/app/templates/sca/index.html +321 -0
  181. package/app/templates/settings/hub_url.html +31 -0
  182. package/app/templates/settings/index.html +216 -0
  183. package/app/templates/settings/provider.html +229 -0
  184. package/app/templates/settings/providers.html +37 -0
  185. package/app/templates/worklists.html +52 -0
  186. package/app/textsafe.py +117 -0
  187. package/app/timing.py +245 -0
  188. package/app/triage.py +1743 -0
  189. package/app/view.py +430 -0
  190. package/app/worklists.py +204 -0
  191. package/examples/demo/demo-hub-report-v2.xlsx +0 -0
  192. package/examples/demo/demo-hub-report.xlsx +0 -0
  193. package/examples/demo/repos/billing-core/pom.xml +30 -0
  194. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/Invoice.java +9 -0
  195. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceRepository.java +51 -0
  196. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/InvoiceStatus.java +11 -0
  197. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/config/DatabaseSettings.java +18 -0
  198. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/payment/PaymentTokenService.java +35 -0
  199. package/examples/demo/repos/billing-core/src/main/java/org/example/billing/web/InvoiceExportController.java +57 -0
  200. package/examples/demo/repos/catalog-api/catalog_api/__init__.py +1 -0
  201. package/examples/demo/repos/catalog-api/catalog_api/products.py +24 -0
  202. package/examples/demo/repos/catalog-api/catalog_api/tasks.py +24 -0
  203. package/examples/demo/repos/catalog-api/catalog_api/views.py +17 -0
  204. package/examples/demo/repos/catalog-api/requirements.txt +3 -0
  205. package/npm/build.json +5 -0
  206. package/npm/cli.js +346 -0
  207. package/npm/files.manifest +224 -0
  208. package/npm/lib/binding.js +64 -0
  209. package/npm/lib/cluster.js +330 -0
  210. package/npm/lib/env.js +88 -0
  211. package/npm/lib/fsx.js +125 -0
  212. package/npm/lib/http.js +53 -0
  213. package/npm/lib/metrics.js +73 -0
  214. package/npm/lib/paths.js +150 -0
  215. package/npm/lib/pg.js +351 -0
  216. package/npm/lib/proc.js +101 -0
  217. package/npm/lib/python.js +133 -0
  218. package/npm/lib/stand.js +46 -0
  219. package/npm/lib/supervisor.js +1141 -0
  220. package/npm/lib/version.js +21 -0
  221. package/npm/requirements.txt +476 -0
  222. package/npm-shrinkwrap.json +111 -0
  223. package/package.json +37 -4
package/app/defect.py ADDED
@@ -0,0 +1,670 @@
1
+ """Текст дефекта для AppSec.Hub: заголовок и тело, которые человек вставляет в Hub, создавая дефект вручную.
2
+
3
+ Формат – docs/hub-format.md, разделы «Дефект: заголовок» и «Дефект: тело».
4
+
5
+ * SAST (с 0.9.6, ADR-0089) – два исхода. Ложное срабатывание закрывается коротким комментарием оператора
6
+ (sast_comment), дефект не создаётся. Подтверждённая находка – дефект: заголовок `ID<n> - <Category> (SAST)`,
7
+ тело – стандартная фраза команды, «Обоснование:» и «Рекомендация:» по пунктам «1)», «2)» (sast_body). Ничего
8
+ больше: ни внутренних номеров Hub, ни требований ГОСТ к конвейеру, ни справки по CWE.
9
+ * SCA – дефект для итога «истинная» или «ложная»; для «неясно», «Отложить» и «Риск принят» не создаётся.
10
+ * SCA – один дефект на библиотеку и версию: заголовок `ID<n> - <Component name> | Component version: <версия> (SCA)`;
11
+ тело – сводная таблица связанных уязвимостей и блок по каждой (CWE, CVSS, связанная уязвимость, описание,
12
+ объяснение, рекомендации, источники). Сведения – из выгрузки, ответа внешнего агента и справочников (БДУ ФСТЭК
13
+ России по CVE).
14
+
15
+ Ветка и коммит клона в текст не входят: сведения об объекте сканирования Hub добавляет сам. Номер `ID<n>` вводит
16
+ человек, приложение предлагает следующий по счётчику проекта (Database.next_defect_number). Все функции здесь
17
+ чистые: сведения из базы и справочников передаёт вызывающий.
18
+ """
19
+
20
+ from __future__ import annotations
21
+
22
+ import json
23
+ import re
24
+ from collections.abc import Iterable, Mapping
25
+ from typing import Any
26
+
27
+ from app import cvss
28
+ from app.models import Finding
29
+ from app.textsafe import hub_clean, is_invisible
30
+
31
+ READY_VERDICTS = ("true_positive", "false_positive")
32
+ # SAST с 0.9.6: дефект – только для подтверждённой находки, ложное срабатывание – короткий комментарий (ADR-0089)
33
+ SAST_READY_VERDICTS = ("true_positive",)
34
+ DEFAULT_RECOMMENDATION = "Исправить код так, чтобы недостаток не мог быть использован для реализации угроз."
35
+ CATEGORY = {"true_positive": "True Positive", "false_positive": "False Positive"}
36
+ NO_INFO = "Нет информации"
37
+ SEPARATOR = "-" * 10
38
+ # Пробелов после самого длинного значения колонки сводной таблицы SCA (ID, Компонент, Серьёзность, Уязвимость) –
39
+ # как в образце дефекта Hub (docs/hub-format.md)
40
+ COLUMN_GAPS = (3, 5, 3, 4)
41
+ MAX_SOURCES = 10
42
+ MAX_DESCRIPTION = 1500 # знаков описания из справочника в одном блоке
43
+ MAX_CWE_DESCRIPTION = 600
44
+
45
+ # Длинное тире и неразрывный дефис в тексте для Hub не нужны
46
+ _DASHES = str.maketrans({chr(0x2014): "–", chr(0x2011): "-", chr(0x2010): "-"})
47
+ # Начало комментария модели для Hub («Подтверждено: …»): в обосновании дефекта оно лишнее – категория уже названа
48
+ _VERDICT_PREFIX = re.compile(r"^\s*(?:подтверждено|ложное срабатывание|нужна проверка|требуется (?:дополнительная )?"
49
+ r"проверка|риск принят)\s*[:.–-]\s*", re.I)
50
+ # маркер пункта: «2)» – и без пробела («2)текст»), «2.», «-», «*», «•» – только с пробелом, чтобы не резать «1.5 раза»,
51
+ # «-x» и «*args»; цифры только ASCII, пробелы – только пробел и табуляция (одинаково в Python и JS); то же выражение –
52
+ # в предпросмотре app/static/app.js (recommendationPoints)
53
+ _LIST_ITEM = re.compile(r"^[ \t]*(?:[0-9]{1,2}\)[ \t]*|[0-9]{1,2}\.[ \t]+|[-*•][ \t]+)")
54
+ # правило до 0.9.11: «2)текст» оставалось пунктом «2)текст» – по нему узнаётся, что текст изменился из-за маркера
55
+ _LIST_ITEM_0910 = re.compile(r"^\s*(?:\d{1,2}[.)]|[-*•])\s+")
56
+ _FENCE = re.compile(r"^\s*(?:```|~~~)")
57
+ _INDENTED_CODE = re.compile(r"^(?: {4}|\t)")
58
+ _FENCE_MARK = re.compile(r"^\s{0,3}(`{3,}|~{3,})")
59
+ _LETTERS = re.compile(r"[A-Za-zА-Яа-яЁё]")
60
+
61
+
62
+ def defect_key_sast(hub_id: str) -> str:
63
+ return f"sast:{hub_id}"
64
+
65
+
66
+ def defect_key_sca(component: str, version: str, ecosystem: str = "") -> str:
67
+ """Ключ номера дефекта SCA: пакет – это экосистема, имя и версия; тройка кодируется JSON-массивом `["экосистема","имя",
68
+ "версия"]` (`sca:v3|…`), поэтому границы компонентов однозначны для любых значений: `("npm", "a@b", "c")` и
69
+ `("npm", "a", "b@c")` дают разные ключи, «@» и «|» в имени и версии ничего не ломают, пустая экосистема – пустая строка.
70
+ Пространство `sca:v3|` текущее: прежние ключи (`sca:имя@версия`, `sca:экосистема|имя@версия`, `sca:v2|…`) остаются
71
+ историей и текущими не бывают; однозначно распознаваемые v2 переносит шаг обновления 12 (Database.migrate_12)."""
72
+ return "sca:v3|" + json.dumps([str(ecosystem), str(component), str(version)], ensure_ascii=True,
73
+ separators=(",", ":"))
74
+
75
+
76
+ def ready(outcome: str) -> bool:
77
+ """Дефект SCA готовится только для итога «истинная» или «ложная» (hub_verdict решения)."""
78
+ return outcome in READY_VERDICTS
79
+
80
+
81
+ def sast_ready(outcome: str) -> bool:
82
+ """Дефект SAST готовится только для итога «истинная»: ложное срабатывание закрывается комментарием (ADR-0089)."""
83
+ return outcome in SAST_READY_VERDICTS
84
+
85
+
86
+ def one_line(value: Any, limit: int = 300) -> str:
87
+ return " ".join(str(value or "").split())[:limit]
88
+
89
+
90
+ def edges(text: str) -> str:
91
+ """Формат текста оператора для Hub (ADR-0149 п. 5): переводы строк «\\n», без хвостовых пробелов строк и без пустых
92
+ строк по краям текста; отступ первой содержательной строки и пустые строки внутри остаются как написаны."""
93
+ lines = [line.rstrip() for line in str(text or "").replace("\r\n", "\n").split("\n")]
94
+ while lines and not lines[0].strip():
95
+ lines.pop(0)
96
+ while lines and not lines[-1].strip():
97
+ lines.pop()
98
+ return "\n".join(lines)
99
+
100
+
101
+ def _finish(text: str, *, clean: bool = False) -> str:
102
+ """Вид текста для Hub целиком (edges): переводы строк «\\n», без хвостовых пробелов строк и без пустых строк по
103
+ краям текста – формат, слова, отступы и пустые строки внутри не меняются. Текст оператора уходит в Hub как написан: приложение
104
+ не правит тексты оператора без его ведома.
105
+
106
+ clean=True – прежние правила (до 0.10.0.dev21): ещё и без тегов HTML, схем javascript:, vbscript:, data: и
107
+ невидимых знаков (hub_clean), длинное тире – «–», не больше одной пустой строки подряд. Только для текстов из
108
+ данных выгрузки (заголовки дефектов) и для прежних форматов, по которым узнаются отметки «Внесено в Hub». Прежний
109
+ формат hub_text_v1 сюда не идёт: его отпечатки сверяются как были."""
110
+ text = str(text or "")
111
+ if not clean:
112
+ return edges(text)
113
+ # прежние правила – как были, с обрезкой краёв (по ним узнаются прежние отметки)
114
+ text = hub_clean(text).translate(_DASHES)
115
+ text = "\n".join(line.rstrip() for line in text.replace("\r\n", "\n").split("\n"))
116
+ return re.sub(r"\n{3,}", "\n\n", text).strip()
117
+
118
+
119
+ # ============================================================================ заключение для Hub (ГОСТ)
120
+
121
+ # Короткие нормативные опоры текста для Hub (docs/hub-verdict-text.md)
122
+ GOST_DEADLINE_SAST = ("Срок – исправить либо запланировать сроки устранения не позже 10 рабочих дней после разметки; "
123
+ "при гибкой методологии план устранения включается в ближайший цикл разработки; потенциальные "
124
+ "критические ошибки, выявленные при анализе ПО целиком, устраняются не позднее начала "
125
+ "квалификационного тестирования (ГОСТ Р 71207-2024, п. 5.9).")
126
+ GOST_TRUE_NO_FIX = ("«истинные, но не требующие исправлений кода предупреждения» (ГОСТ Р 71207-2024, п. 5.5)")
127
+ DEADLINE_SCA = "Срок – по регламенту композиционного анализа."
128
+ # Уточнение решения SCA по ГОСТ Р КАПО (окончательная редакция, пп. 6.12, 6.14) – подписи для текста и карточки
129
+ KAPO_LABELS = {"not_finished": "анализ не завершён – актуальность не установлена",
130
+ "actual": "актуальна", "not_actual": "неактуальна для продукта",
131
+ "neutralized": "нейтрализована принятыми мерами",
132
+ "false_positive": "ложноположительное срабатывание"}
133
+
134
+
135
+ # соответствие статусов Hub и ГОСТ для подсказок в карточках и настройках (docs/hub-verdict-text-plan.md)
136
+ GOST_STATUS_NOTES = {
137
+ "sast": {"true_positive": "истинное срабатывание: ошибка в программе, требуется исправление",
138
+ "false_positive": "ложное срабатывание",
139
+ "risk_accepted": "истинное срабатывание, не требующее исправлений кода",
140
+ "uncertain": "решение не принято"},
141
+ "sca": {"true_positive": "уязвимость актуальна или анализ не завершён: требуется обновление или обоснование "
142
+ "неактуальности",
143
+ "false_positive": "ложноположительное: компонент или сведения об уязвимости определены ошибочно",
144
+ "risk_accepted": "уязвимость неактуальна (с обоснованием) или нейтрализована принятыми мерами",
145
+ "uncertain": "решение не принято"},
146
+ }
147
+ GOST_STATUS_BASIS = {"sast": "ГОСТ Р 71207-2024, п. 5.5", "sca": "ГОСТ Р КАПО, пп. 6.12, 6.14"}
148
+
149
+
150
+ def effective_kapo(outcome: str, kapo_state: str) -> str:
151
+ """Уточнение по ГОСТ Р КАПО с учётом итога: у прежних решений его нет – «Подтверждено» считается «анализ не
152
+ завершён», «Ложное срабатывание» – ложноположительным; у остальных итогов – как сохранено."""
153
+ if kapo_state:
154
+ return kapo_state
155
+ return {"true_positive": "not_finished", "false_positive": "false_positive"}.get(outcome, "")
156
+
157
+
158
+ def where_text(f: Finding) -> str:
159
+ """«<правило> в <файл>:<строка>» – место срабатывания SAST одной строкой (без HTML и переводов строк)."""
160
+ rule = hub_clean(one_line(f.rule)) or "срабатывание анализатора"
161
+ place = hub_clean(one_line(f.file))
162
+ if place and f.line:
163
+ place += f":{f.line}"
164
+ return f"{rule} в {place}" if place else rule
165
+
166
+
167
+ def cwe_phrase(f: Finding) -> str:
168
+ """« класса CWE-89» или « классов CWE-89, CWE-564»; без CWE – ""."""
169
+ keys = [k for k in (cwe_id(c) for c in f.cwe) if k]
170
+ keys = list(dict.fromkeys(keys))
171
+ if not keys:
172
+ return ""
173
+ return f" {'классов' if len(keys) > 1 else 'класса'} {', '.join(keys)}"
174
+
175
+
176
+ def sast_comment(f: Finding, outcome: str, comment: str) -> str:
177
+ """Текст для Hub по находке SAST (формат 0.9.6, ADR-0089): только обоснование оператора его словами – без
178
+ «Статус: …», места срабатывания и требований. У ложного срабатывания это комментарий к смене статуса в Hub, одна-две
179
+ фразы («Имя таблицы берётся из заранее заданной строки, поэтому SQL-инъекция исключена»). У подтверждённой находки
180
+ тот же текст – обоснование дефекта (по нему считается отпечаток отметки «Внесено в Hub»); дефект – sast_body.
181
+ f и outcome в тексте не участвуют: подпись общая с прежними форматами. С 0.10.0.dev21 текст оператора уходит как
182
+ написан; меняется только первая буква – заглавная (sast_reason, ADR-0101 п. 7)."""
183
+ return _finish(sast_reason(comment))
184
+
185
+
186
+ def sast_comment_v4(f: Finding, outcome: str, comment: str) -> str:
187
+ """Формат 0.9.11–0.10.0.dev20: вводное «Подтверждено:» и подобное снято, первая буква заглавная, прежняя чистка
188
+ (теги, схемы, невидимые знаки, длинное тире, лишние пустые строки). По нему узнаются отметки «Внесено в Hub»,
189
+ поставленные до 0.10.0.dev21 (причина «формат текста»)."""
190
+ return _finish(sast_reason(comment, legacy=True), clean=True)
191
+
192
+
193
+ def sast_comment_v3(f: Finding, outcome: str, comment: str) -> str:
194
+ """Формат 0.9.6–0.9.10: обоснование как написал оператор, без поднятия первой буквы, с прежней чисткой. По нему
195
+ узнаются отметки «Внесено в Hub», поставленные до 0.9.11 (причина «формат текста»)."""
196
+ return _finish(reason_text(comment, clean=True), clean=True)
197
+
198
+
199
+ def sast_comment_v2(f: Finding, outcome: str, comment: str) -> str:
200
+ """Формат 0.9.0–0.9.5 (по нему узнаются отметки «Внесено в Hub», поставленные до 0.9.6).
201
+
202
+ Короткое заключение по находке SAST – текст поля «Комментарий» для «Скопировать для Hub». Зависит только от
203
+ находки, итога решения и комментария оператора: отпечаток отметки «Внесено в Hub» не меняется от справочников
204
+ и соседних находок. Обоснование – комментарий оператора без вводного «Подтверждено:», не сокращается. Чистка –
205
+ прежняя (формат узнавания, clean=True)."""
206
+ reason = reason_text(comment, clean=True)
207
+ where = where_text(f)
208
+ lines: list[str] = []
209
+ if outcome == "true_positive":
210
+ lines.append(f"Подтверждена ошибка в программе{cwe_phrase(f)}: {where}.")
211
+ if reason:
212
+ lines.append(f"Обоснование: {reason}")
213
+ lines.append("Требуется от разработчика: исправить код по рекомендациям дефекта, проверить такие же места "
214
+ "в кодовой базе, добавить тест. " + GOST_DEADLINE_SAST)
215
+ elif outcome == "false_positive":
216
+ lines.append(f"Срабатывание признано ложным: {where}.")
217
+ if reason:
218
+ lines.append(f"Обоснование: {reason}")
219
+ elif outcome == "risk_accepted":
220
+ lines.append(f"Подтверждена ошибка в программе{cwe_phrase(f)}: {where}; исправление кода не требуется – "
221
+ f"{GOST_TRUE_NO_FIX}.")
222
+ if reason:
223
+ lines.append(f"Обоснование: {reason}")
224
+ else:
225
+ lines.append(f"Требуется дополнительная проверка: {where}.")
226
+ if reason:
227
+ lines.append(reason)
228
+ return _finish("\n".join(lines), clean=True)
229
+
230
+
231
+ def hub_lines(status: str, comment: str) -> str:
232
+ """«Статус: …» (если статус задан) и «Комментарий: …» – текст формата 0.9.0–0.9.7 (только узнавание прежних отметок
233
+ «Внесено в Hub»), с прежней чисткой."""
234
+ lines = [f"Статус: {status}"] if status else []
235
+ lines.append(f"Комментарий: {comment}")
236
+ return _finish("\n".join(lines), clean=True)
237
+
238
+
239
+ GOST_VULNERABILITY = ("Что это значит: если ошибку можно использовать для реализации угроз, это уязвимость программы – "
240
+ "«Недостаток программы, который может быть использован для реализации угроз безопасности "
241
+ "информации» (ГОСТ Р 56939-2024, п. 3.20). Есть ли у недостатка публичный идентификатор (CVE, BDU), "
242
+ "на необходимость исправления не влияет.")
243
+ GOST_KAPO_BASIS = ("Нормативная опора: правила анализа устанавливают «необходимость присвоения каждой уязвимости статуса "
244
+ "о ее актуальности и критичности, в случае неактуальности уязвимости - обоснование неактуальности»; "
245
+ "на основании отчета по результатам КАПО разработчик «должен определять и принимать компенсирующие "
246
+ "меры» (ГОСТ Р КАПО, окончательная редакция, пп. 6.14, 7.11).")
247
+ NOT_ACTUAL_PROOF = ("Обоснование неактуальности должно показать для проверенной версии продукта: где подключён компонент "
248
+ "(прямая или транзитивная зависимость, модуль); вызывается ли уязвимая функция – места в коде или "
249
+ "результат анализа графа вызовов с названием инструмента и его ограничениями; может ли нарушитель "
250
+ "прямо или косвенно влиять на её входные данные; от какой конфигурации это зависит. Учитываются все "
251
+ "пути выполнения, а не только основной.")
252
+ REFERENCE_HEAD = "Справочно (класс слабости; применимость к продукту отдельно не оценивалась):"
253
+ REFERENCE_BUDGET = 6000 # знаков справки на дефект: при превышении она сокращается с пометкой
254
+ REFERENCE_LIMITS = {"consequences": 5, "mitigations": 5, "capec": 5, "observed": 3}
255
+ MAX_MITIGATION = 300
256
+ _DATE_IN_NAME = re.compile(r"(?<!\d)(\d{2})[_.-](\d{2})[_.-](\d{4})(?!\d)")
257
+
258
+
259
+ def export_label(filename: str, created_at: str) -> str:
260
+ """Подпись выгрузки находки: дата из имени файла выгрузки Hub («…_15_10_2026_…» – «от 15.10.2026 (по имени
261
+ файла)», только настоящая календарная дата), иначе – дата загрузки в приложение."""
262
+ import datetime as _dt
263
+ for day, month, year in _DATE_IN_NAME.findall(str(filename or "")):
264
+ try:
265
+ _dt.date(int(year), int(month), int(day))
266
+ except ValueError:
267
+ continue
268
+ return f"от {day}.{month}.{year} (по имени файла)"
269
+ loaded = str(created_at or "")[:10]
270
+ if re.fullmatch(r"\d{4}-\d{2}-\d{2}", loaded):
271
+ return f"загружена в приложение {loaded[8:10]}.{loaded[5:7]}.{loaded[:4]}"
272
+ return ""
273
+
274
+
275
+ def area_text(codebases: Iterable[str], exports: Iterable[str], decided_at: str | None) -> str:
276
+ """«Область: кодовая база …; текущая выгрузка находки – …; решение от ДД.ММ.ГГГГ.» – то, что известно; дату решения
277
+ у прежних решений не знаем и не выводим."""
278
+ parts: list[str] = []
279
+ bases = list(dict.fromkeys(hub_clean(one_line(c, 200)) for c in codebases if one_line(c)))
280
+ if bases:
281
+ parts.append(("кодовые базы " if len(bases) > 1 else "кодовая база ") + ", ".join(bases))
282
+ labels = list(dict.fromkeys(x for x in exports if x))
283
+ if labels:
284
+ parts.append("текущая выгрузка находки – " + "; ".join(labels))
285
+ decided = str(decided_at or "")[:10]
286
+ if re.fullmatch(r"\d{4}-\d{2}-\d{2}", decided):
287
+ parts.append(f"решение от {decided[8:10]}.{decided[5:7]}.{decided[:4]}")
288
+ return ("Область: " + "; ".join(parts) + ".") if parts else ""
289
+
290
+
291
+ def _paragraphs(value: Any, limit: int) -> str:
292
+ if isinstance(value, (list, tuple)):
293
+ value = " ".join(str(x) for x in value)
294
+ return hub_clean(one_line(value, limit))
295
+
296
+
297
+ def reference_block(cwes: Iterable[str], catalog: Mapping[str, Mapping[str, Any]],
298
+ capec_names: Mapping[str, str] | None = None, *, budget: int = REFERENCE_BUDGET,
299
+ seen: set[str] | None = None) -> str:
300
+ """Справка по классам CWE из каталогов MITRE (содержимое фидов – как в источнике, без перевода; русское название –
301
+ из БДУ ФСТЭК России с пометкой): название, Likelihood Of Exploit, описание, Common Consequences, Potential
302
+ Mitigations, Related Attack Patterns (CAPEC с названиями), Observed Examples и ссылки. Нет в каталоге – не
303
+ выводится; seen – уже показанные CWE (в групповом дефекте справка по классу – один раз). Больше budget знаков –
304
+ сокращается: сначала Observed Examples, затем Mitigations, Consequences и CAPEC, с пометкой."""
305
+ keys = [k for k in dict.fromkeys(cwe_id(c) for c in cwes) if k and catalog.get(k)
306
+ and (seen is None or k not in seen)]
307
+ if not keys:
308
+ return ""
309
+ names = capec_names or {}
310
+ limits = dict(REFERENCE_LIMITS)
311
+
312
+ def build() -> str:
313
+ lines = [REFERENCE_HEAD]
314
+ links: list[str] = []
315
+ for key in keys:
316
+ info = catalog[key]
317
+ name = hub_clean(one_line(info.get("name"), 300))
318
+ head = f"{key} – {name}" if name else key
319
+ ru = hub_clean(one_line(info.get("name_ru"), 300))
320
+ if ru:
321
+ head += f" (по БДУ ФСТЭК России: {ru})"
322
+ likelihood = hub_clean(one_line(info.get("likelihood"), 40))
323
+ lines.append(head + (f". Likelihood Of Exploit: {likelihood}." if likelihood else "."))
324
+ description = hub_clean(one_line(info.get("description"), MAX_CWE_DESCRIPTION))
325
+ if description:
326
+ lines.append(description)
327
+ consequences = []
328
+ for c in (info.get("consequences") or [])[:limits["consequences"]]:
329
+ scope = ", ".join(hub_clean(one_line(s, 100)) for s in c.get("scope") or [] if one_line(s))
330
+ impact = "; ".join(hub_clean(one_line(i, 150)) for i in c.get("impact") or [] if one_line(i))
331
+ if impact:
332
+ consequences.append(f"- {scope}: {impact}" if scope else f"- {impact}")
333
+ if consequences:
334
+ lines += ["Common Consequences:", *consequences]
335
+ mitigations = []
336
+ for m in (info.get("mitigations") or [])[:limits["mitigations"]]:
337
+ phases = ", ".join(hub_clean(one_line(x, 60)) for x in m.get("phases") or [] if one_line(x))
338
+ strategy = hub_clean(one_line(m.get("strategy"), 100))
339
+ text = _paragraphs(m.get("description"), MAX_MITIGATION)
340
+ label = " – ".join(x for x in (phases, strategy) if x)
341
+ if text or label:
342
+ mitigations.append(f"- {label}: {text}" if label and text else f"- {label or text}")
343
+ if mitigations:
344
+ lines += ["Potential Mitigations:", *mitigations]
345
+ capec = []
346
+ for pattern in (info.get("attack_patterns") or [])[:limits["capec"]]:
347
+ pid = hub_clean(one_line(pattern, 20))
348
+ if not re.fullmatch(r"CAPEC-\d{1,7}", pid):
349
+ continue
350
+ title = hub_clean(one_line(names.get(pid), 200))
351
+ capec.append(f"- {pid}: {title}" if title else f"- {pid}")
352
+ links.append(f"https://capec.mitre.org/data/definitions/{pid.split('-')[1]}.html")
353
+ if capec:
354
+ lines += ["Related Attack Patterns (CAPEC):", *capec]
355
+ observed = []
356
+ for o in (info.get("observed") or [])[:limits["observed"]]:
357
+ ref = hub_clean(one_line(o.get("reference"), 60))
358
+ text = hub_clean(one_line(o.get("description"), 200))
359
+ if ref or text:
360
+ observed.append(f"- {ref}: {text}" if ref and text else f"- {ref or text}")
361
+ if observed:
362
+ lines += ["Observed Examples (другие продукты):", *observed]
363
+ links.insert(0, f"https://cwe.mitre.org/data/definitions/{key.split('-')[1]}.html")
364
+ lines.append("Ссылки: " + ", ".join(dict.fromkeys(links)))
365
+ return "\n".join(lines)
366
+
367
+ note = "\nСправка сокращена: полный текст – на cwe.mitre.org и capec.mitre.org."
368
+ text = build()
369
+ if len(text) > budget: # итог с пометкой не длиннее budget
370
+ for part in ("observed", "mitigations", "consequences", "capec"):
371
+ limits[part] = 0
372
+ text = build()
373
+ if len(text) + len(note) <= budget:
374
+ break
375
+ lines = text.split("\n")
376
+ while len(lines) > 1 and len("\n".join(lines)) + len(note) > budget:
377
+ lines.pop() # и после сокращения разделов – по строкам с конца, заголовок справки остаётся
378
+ text = "\n".join(lines) + note
379
+ if seen is not None:
380
+ seen.update(keys)
381
+ return text
382
+
383
+
384
+ # ============================================================================ заголовки
385
+
386
+ def sast_title(number: int, f: Finding) -> str:
387
+ # заголовок собирается из данных выгрузки (правило), не из текста оператора: чистка прежняя
388
+ return _finish(f"ID{number} - {one_line(f.rule) or 'Правило не указано'} (SAST)", clean=True)
389
+
390
+
391
+ def sca_title(number: int, component: str, version: str) -> str:
392
+ return _finish(f"ID{number} - {one_line(component) or 'Библиотека не указана'} | Component version: "
393
+ f"{one_line(version) or NO_INFO} (SCA)", clean=True)
394
+
395
+
396
+ # ============================================================================ SAST
397
+
398
+ def reason_text(comment: str, *, clean: bool = True) -> str:
399
+ """Комментарий человека без вводного «Подтверждено:», «Ложное срабатывание:» и подобного и с прежней чисткой
400
+ тегов, схем и невидимых знаков – только для проверки, есть ли обоснование (ADR-0089 п. 6: одно вводное слово,
401
+ пустой тег или невидимый знак обоснованием не считаются; критерий тот же, что до 0.10.0.dev21) и для прежних
402
+ форматов. В Hub с 0.10.0.dev21 уходит комментарий как написан. clean=False – без чистки
403
+ (ссылки «строка N» в обосновании и т. п.)."""
404
+ text = (hub_clean(str(comment or "")) if clean else str(comment or "")).strip()
405
+ return _VERDICT_PREFIX.sub("", text, count=1).strip()
406
+
407
+
408
+ def sast_reason(comment: str, *, legacy: bool = False) -> str:
409
+ """Обоснование SAST, как оно уходит в Hub: как написал оператор, с одной правкой
410
+ (ADR-0101 п. 7) – первая буква заглавная, если это строчная кириллическая («строка 26 формирует…» → «Строка 26
411
+ формирует…»). Латиница и имена из кода (owner, customerId) не трогаются.
412
+
413
+ Комментарий из одного вводного слова («Ложное срабатывание:») обоснованием не считается (ADR-0089 п. 6): тогда "".
414
+
415
+ legacy=True – формат 0.9.11–0.10.0.dev20 (только узнавание прежних отметок): вводное слово снято, прежняя чистка
416
+ тегов, схем и невидимых знаков."""
417
+ if legacy:
418
+ text = reason_text(comment, clean=True)
419
+ else:
420
+ text = edges(comment) if reason_text(comment) else "" # отступ первой строки остаётся (ревью Kimi)
421
+ # первая видимая буква: невидимые знаки перед ней остаются на месте (их прежде вырезала чистка, ревью Kimi)
422
+ k = 0
423
+ while k < len(text) and (is_invisible(text[k]) or text[k].isspace()):
424
+ k += 1
425
+ if k < len(text) and ("а" <= text[k] <= "я" or text[k] == "ё"):
426
+ return text[:k] + text[k].upper() + text[k + 1:]
427
+ return text
428
+
429
+
430
+ def recommendations(fix: str) -> list[str]:
431
+ """Рекомендации по пунктам из поля «Как исправить»: пункты списка и абзацы – отдельными пунктами; пример кода
432
+ в ограде ``` – строками под пунктом (с отступом), без строк ограды."""
433
+ items: list[list[str]] = []
434
+ in_code = False
435
+ for raw in str(fix or "").replace("\r\n", "\n").split("\n"):
436
+ if _FENCE.match(raw):
437
+ in_code = not in_code
438
+ if in_code and not items:
439
+ items.append([])
440
+ continue
441
+ if in_code:
442
+ if raw.strip():
443
+ items[-1].append(" " + raw.rstrip())
444
+ continue
445
+ line = raw.strip()
446
+ if not line:
447
+ if items and items[-1]:
448
+ items.append([]) # пустая строка – конец абзаца
449
+ continue
450
+ if _LIST_ITEM.match(line):
451
+ items.append([_LIST_ITEM.sub("", line, count=1)])
452
+ elif items and items[-1]:
453
+ if items[-1][-1].startswith(" "): # после кода – новый пункт
454
+ items.append([line])
455
+ else:
456
+ items[-1][-1] += " " + line
457
+ else:
458
+ if items and not items[-1]:
459
+ items[-1].append(line)
460
+ else:
461
+ items.append([line])
462
+ result = []
463
+ for item in items:
464
+ lines = [x for x in item if x.strip()]
465
+ if lines:
466
+ result.append("\n".join([hub_clean(lines[0]).strip(), *lines[1:]]))
467
+ return result
468
+
469
+
470
+ def fix_items(fix: str, *, clean: bool = False) -> list[str]:
471
+ """Пункты рекомендации дефекта SAST: в Hub идут только меры словами (ADR-0098) – то же
472
+ правило, что у recommendation_points: строки вне ограды ``` или ~~~ и вне отступа кода, маркер «1.», «2)», «-»
473
+ снят, в строке есть буква. Пример кода в текст дефекта не переносится."""
474
+ return recommendation_points(fix, clean=clean)[0]
475
+
476
+
477
+ def recommendation_points(fix: str, marker: re.Pattern = _LIST_ITEM, *, clean: bool = False) -> tuple[list[str], bool]:
478
+ """Пункты рекомендации словами (ADR-0092): строки вне блоков кода, маркер списка снят. Блок кода – в ограде ``` или
479
+ ~~~ (незакрытая ограда – до конца текста) или строки с отступом в четыре пробела или табуляцию. Строка без букв
480
+ пунктом не считается. Второе значение – был ли в тексте код, который в пункты не вошёл. По этим пунктам кнопка
481
+ «Взять пункты из рекомендации модели» заполняет поле, и по ним же проверяется, что рекомендация есть. marker –
482
+ правило маркера пункта (прежнее – только для причины «Текст для Hub изменился»). Слова пункта – как написал оператор;
483
+ clean=True – прежняя чистка тегов и схем: заготовка из ответа модели и прежние форматы
484
+ для узнавания отметок."""
485
+ points: list[str] = []
486
+ dropped = False
487
+ fence = "" # открывающая ограда: блок закрывает только ограда из тех же знаков не короче её (как в CommonMark)
488
+ for raw in str(fix or "").replace("\r\n", "\n").split("\n"):
489
+ mark = _FENCE_MARK.match(raw)
490
+ if mark:
491
+ dropped = True
492
+ if not fence:
493
+ fence = mark.group(1)
494
+ continue
495
+ if mark.group(1)[0] == fence[0] and len(mark.group(1)) >= len(fence) and not raw.strip()[len(mark.group(1)):]:
496
+ fence = ""
497
+ continue
498
+ if fence or (_INDENTED_CODE.match(raw) and raw.strip()):
499
+ dropped = dropped or bool(raw.strip())
500
+ continue
501
+ bare = marker.sub("", raw.strip(), count=1)
502
+ cleaned = hub_clean(bare).strip() # прежние правила – как были
503
+ # пункт ли это – по прежнему критерию (ADR-0149 п. 3): пустой тег или одни невидимые знаки пунктом не
504
+ # считаются и рядом с другим пунктом (ревью Codex круга 6); слова пункта – как написаны (clean=False), с
505
+ # отступом строки в 1–3 пробела (ADR-0149 п. 5; четыре пробела и табуляция – код, выше)
506
+ if cleaned and _LETTERS.search(cleaned):
507
+ points.append(cleaned if clean else raw[:len(raw) - len(raw.lstrip(" "))] + bare.strip())
508
+ return points, dropped
509
+
510
+
511
+ def marker_rule_changed(fix: str) -> bool:
512
+ """Пункты рекомендации по правилу маркера 0.9.11 не те, что по прежнему (например, «2)текст»): текст дефекта,
513
+ внесённого в Hub до 0.9.11, изменился из-за этого."""
514
+ return (recommendation_points(fix, clean=True)[0]
515
+ != recommendation_points(fix, _LIST_ITEM_0910, clean=True)[0])
516
+
517
+
518
+ def as_written_changed(comment: str, fix: str = "") -> bool:
519
+ """Прежние правила (срез вводного «Подтверждено:», теги HTML, схемы javascript:, vbscript:, data:, невидимые
520
+ знаки, длинное тире, лишние пустые строки) меняли обоснование или пункты рекомендации: текст, внесённый в Hub до
521
+ 0.10.0.dev21, отличается от нынешнего этим (текст оператора уходит как написан)."""
522
+ return (_finish(sast_reason(comment, legacy=True), clean=True) != _finish(sast_reason(comment))
523
+ or [_finish(x, clean=True) for x in fix_items(fix, clean=True)] != [_finish(x) for x in fix_items(fix)])
524
+
525
+
526
+ def has_recommendation(fix: str) -> bool:
527
+ """Есть ли в рекомендации хотя бы один пункт словами (ADR-0092): пробелы, пустой список и один код – нет. Критерий
528
+ – с прежней чисткой (пустой тег или невидимые знаки пунктом не считаются, как до 0.10.0.dev21); пункты, которые
529
+ уходят в Hub, – как написаны (fix_items)."""
530
+ return bool(recommendation_points(fix, clean=True)[0])
531
+
532
+
533
+ def sast_effective(outcome: str, comment: str, final_fix: str, decision: str = "", model_fix: str = "") -> tuple:
534
+ """Итоговый текст решения SAST, который уходит в Hub, – для сравнения находок одной группы (ADR-0089):
535
+ (итог, обоснование, пункты рекомендации). У ложного срабатывания рекомендации нет. У дефекта рекомендация – только
536
+ своя (final_fix, ADR-0092): «Как исправить» модели и общий пункт в текст не подставляются. decision и model_fix не
537
+ участвуют: параметры остались от прежних вызовов. Тексты нормализованы так же, как в Hub (_finish)."""
538
+ reason = _finish(sast_reason(comment))
539
+ if outcome != "true_positive":
540
+ return (outcome, reason, ())
541
+ return (outcome, reason, tuple(_finish(item) for item in fix_items(final_fix)))
542
+
543
+
544
+ def cwe_id(value: Any) -> str:
545
+ """«89», «CWE-89», «cwe 89» -> «CWE-89»; не похоже – ""."""
546
+ m = re.search(r"(\d{1,5})", str(value or ""))
547
+ return f"CWE-{int(m.group(1))}" if m else ""
548
+
549
+
550
+ def _phrase(team: str, outcome: str) -> str:
551
+ who = f"команда {hub_clean(one_line(team, 100))}" if hub_clean(one_line(team)) else "команда"
552
+ return f"После тщательного анализа уязвимости {who} приняла решение присвоить данной уязвимости категорию " \
553
+ f"{CATEGORY[outcome]}."
554
+
555
+
556
+ def sast_phrase(team: str = "", outcome: str = "true_positive") -> str:
557
+ """Стандартная фраза команды – первая строка тела дефекта SAST (ADR-0089) так, как её выдаёт sast_body: с ней
558
+ проверка текста перед Hub сверяет первую строку (ADR-0123, требование S2)."""
559
+ return _finish(_phrase(team, outcome))
560
+
561
+
562
+ def sast_body(f: Finding, outcome: str, comment: str, fix: str, team: str = "", legacy_0910: bool = False,
563
+ legacy_0911: bool = False) -> str:
564
+ """Полный текст дефекта SAST (формат 0.9.6, ADR-0089) – классическая структура команды AppSec:
565
+
566
+ После тщательного анализа уязвимости команда <команда> приняла решение присвоить данной уязвимости категорию
567
+ True Positive.
568
+
569
+ Обоснование:
570
+ <комментарий оператора: откуда приходят данные, что за ошибка и чем опасна>
571
+
572
+ Рекомендация:
573
+ 1) …
574
+ 2) …
575
+
576
+ Рекомендации – только пункты оператора (поле «Рекомендация» решения, ADR-0092); без них текст не готовится.
577
+ Внутренних номеров Hub, требований ГОСТ к конвейеру, срока и справки по CWE в тексте нет: сведения об объекте
578
+ сканирования и находки, из которых создан дефект, Hub показывает сам. f в тексте не участвует (заголовок – sast_title).
579
+ Обоснование – как написал оператор (первая буква заглавная, ADR-0101 п. 7), пункты – меры словами (ADR-0098);
580
+ других правок текста оператора нет.
581
+ legacy_0910 – текст по правилам 0.9.6–0.9.10 (обоснование без поднятой первой буквы, маркер «N)» только с пробелом),
582
+ legacy_0911 – по правилам 0.9.11–0.10.0.dev20 (вводное слово снято, прежняя чистка): только для узнавания отметок
583
+ «Внесено в Hub», поставленных до 0.9.11 и до 0.10.0.dev21."""
584
+ if not sast_ready(outcome):
585
+ raise ValueError("дефект SAST готовится только для подтверждённой находки (итог «истинная»)")
586
+ if not has_recommendation(fix):
587
+ raise ValueError("дефект SAST готовится только с рекомендацией оператора (ADR-0092)")
588
+ if legacy_0910:
589
+ reason, items = reason_text(comment, clean=True), recommendation_points(fix, _LIST_ITEM_0910, clean=True)[0]
590
+ elif legacy_0911:
591
+ reason, items = sast_reason(comment, legacy=True), fix_items(fix, clean=True)
592
+ else:
593
+ reason, items = sast_reason(comment), fix_items(fix)
594
+ parts = [_phrase(team, outcome), "", "Обоснование:", reason or NO_INFO, "", "Рекомендация:"]
595
+ parts += [_point(n, item) for n, item in enumerate(items, 1)]
596
+ return _finish("\n".join(parts), clean=legacy_0910 or legacy_0911)
597
+
598
+
599
+ def _point(n: int, item: str) -> str:
600
+ """Пункт рекомендации с номером: отступ строки оператора – в начале строки, перед номером (ADR-0149 п. 5), чтобы
601
+ он остался виден в Hub (command_html переводит в неразрывные пробелы отступ в начале строки)."""
602
+ text = item.lstrip(" ")
603
+ return f"{item[:len(item) - len(text)]}{n}) {text}"
604
+
605
+
606
+ # ============================================================================ SCA
607
+
608
+ def fmt_cvss(value: Any) -> str:
609
+ try:
610
+ number = float(value)
611
+ except (TypeError, ValueError):
612
+ return NO_INFO
613
+ return f"{number:.1f}"
614
+
615
+
616
+ def sca_conclusion(rows: list[Finding], outcome: str, kapo_state: str, *, ids_text: str, area: str = "",
617
+ catalog: Mapping[str, Mapping[str, Any]] | None = None,
618
+ capec_names: Mapping[str, str] | None = None) -> str:
619
+ """Заключение AppSec для дефекта SCA по группе (одна библиотека и версия, одинаковые итог и уточнение у всех
620
+ участников): статус по ГОСТ Р КАПО, критичность, область, что обнаружено (пути зависимости по выгрузке), что не
621
+ установлено и что требуется, нормативная опора, справка по CWE. Обоснования участников – в их блоках
622
+ («Объяснение»), поэтому текст одинаков, из какой бы карточки группы его ни открыли."""
623
+ first = rows[0]
624
+ ids_text = hub_clean(one_line(ids_text, 600)) or "уязвимость"
625
+ # короткое имя пакета, как у заголовка и тела дефекта SCA (ADR-0150): у Maven по сведениям Hub – artifactId
626
+ component = hub_clean(one_line(first.package_display_name, 200)) or "компонент"
627
+ named = f"{component} {hub_clean(one_line(first.version, 100))}".strip()
628
+ state = effective_kapo(outcome, kapo_state if kapo_state in KAPO_LABELS else "")
629
+ if outcome == "false_positive":
630
+ head = f"Заключение AppSec: ложноположительное срабатывание (ГОСТ Р КАПО, п. 6.12): {ids_text} в {named} не подтверждена."
631
+ else:
632
+ head = (f"Заключение AppSec: по выгрузке Hub в продукте используется компонент {named} с известной уязвимостью "
633
+ f"{ids_text}. Статус уязвимости по ГОСТ Р КАПО: {KAPO_LABELS.get(state, 'не указан')}.")
634
+ lines = [head]
635
+ scores = [r.cvss for r in rows if r.cvss is not None]
636
+ if outcome == "false_positive":
637
+ lines.append("Критичность: не оценивалась – уязвимость в компоненте не подтверждена.")
638
+ elif scores:
639
+ lines.append("Критичность: не определена – оценка по регламенту КАПО не выполнена; CVSS по выгрузке Hub – до "
640
+ f"{cvss.number(max(scores))} (версия CVSS и источник в выгрузке не указаны).")
641
+ else:
642
+ lines.append("Критичность: не определена – оценки CVSS в выгрузке нет, оценка по регламенту КАПО не выполнена.")
643
+ if area:
644
+ lines.append(area)
645
+ paths = [f"- {hub_clean(one_line(r.hub_id, 40))}: {hub_clean(one_line(r.dep_path, 400))}" for r in rows
646
+ if one_line(r.dep_path)]
647
+ if paths:
648
+ lines += ["Что обнаружено (пути зависимости по выгрузке Hub):", *paths]
649
+ if outcome == "true_positive" and state == "actual":
650
+ lines.append("Требуется от разработчика – принять компенсирующие меры: 1) применить обновление безопасности – "
651
+ f"обновить {component} до безопасной версии (см. рекомендации ниже); 2) если обновить нельзя – "
652
+ "обратиться к поставщику, заменить компонент или доработать его самостоятельно; 3) если обновить "
653
+ "сейчас нельзя – описать организационно-технические меры (временные ограничения или условия "
654
+ "эксплуатации) и срок устранения. После мер статус уязвимости уточняется: нейтрализована или "
655
+ "устранена. " + DEADLINE_SCA)
656
+ elif outcome == "true_positive":
657
+ lines.append("Что не установлено: используется ли в продукте уязвимый код компонента и может ли нарушитель "
658
+ "влиять на его входные данные.")
659
+ lines.append("Требуется от разработчика – выбрать одно: 1) применить обновление безопасности – обновить "
660
+ f"{component} до безопасной версии (см. рекомендации ниже); 2) если обновить нельзя – обратиться к "
661
+ "поставщику, заменить компонент или доработать его самостоятельно; 3) представить обоснование "
662
+ "неактуальности уязвимости; 4) если уязвимость актуальна, а обновить сейчас нельзя – описать "
663
+ "организационно-технические меры (временные ограничения или условия эксплуатации) и срок "
664
+ "устранения. " + DEADLINE_SCA)
665
+ lines.append(NOT_ACTUAL_PROOF)
666
+ lines.append(GOST_KAPO_BASIS)
667
+ reference = reference_block([c for r in rows for c in r.cwe], catalog or {}, capec_names)
668
+ if reference:
669
+ lines += ["", reference]
670
+ return "\n".join(lines)