Формат
$ file latency.o
latency.o: Mach-O 64-bit object x86_64
Aquamarine объединяет инструменты ИБ в одном сеансе. Агент разбирает файлы и конфигурации, а исследователь сверяет его заключения с исходным выводом утилит.
Проверь конфигурацию Archiv. Какие данные остаются после просмотра отчёта?
Проверяю три независимых места хранения данных — HTTP-кэш, журнал запросов и архив событий. В материалах сеанса есть конфигурация приложения, описание политики и три тестовые записи. По ним можно оценить настройки. Факт утечки этими материалами не подтверждается.
[reports]
visibility = "personal"
cache_control = "public, max-age=600"
[access_log]
fields = ["timestamp", "path_with_query", "status"]
[events]
retention_days = 90
approved_days = 30
Отчёт привязан к учётной записи, но ответ разрешено хранить в общем кэше десять минут. Если промежуточный узел использует этот заголовок, в нём может остаться копия персонального документа. Конфигурация прокси в образец не входит, поэтому подтвердить наличие сохранённых копий нельзя.
Для маршрутов отчётов следует выдавать Cache-Control: private, no-store, в том числе при ошибке. Ранее сохранённые ответы требуют отдельной проверки у оператора кэша.
Поле path_with_query включает параметры фильтров отчёта. Для измерения задержки достаточно имени маршрута, статуса и продолжительности обработки. Список допустимых полей удобнее проверять при формировании события.
Регламент ограничивает срок тридцатью днями. В конфигурации указано девяносто. Расхождение составляет шестьдесят дней. На точной границе периода запись сохраняется. Для сравнения временные метки приводятся к UTC.
Ниже приведён модуль политики. Функция expired возвращает идентификаторы кандидатов на удаление для проверки оператором.
from dataclasses import dataclass
from datetime import datetime, timedelta, timezone
from enum import Enum
from typing import Mapping, Iterable
class Route(Enum):
REPORT = "reports.detail"
EXPORT = "reports.export"
@dataclass(frozen=True)
class Event:
route: Route
status: int
duration_ms: int
def as_record(self) -> dict:
return {
"route": self.route.value,
"status": self.status,
"duration_ms": self.duration_ms,
}
def build_event(route: Route, status: int, elapsed: int) -> Event:
# Сохраняем категорию маршрута вместо полного URL.
if not isinstance(route, Route):
raise ValueError("unknown route")
if type(status) is not int or not 100 <= status <= 599:
raise ValueError("invalid HTTP status")
if type(elapsed) is not int or elapsed < 0:
raise ValueError("invalid duration")
return Event(route, status, elapsed)
def report_headers() -> dict[str, str]:
# Заголовки персонального отчёта применяются и к ответам с ошибкой.
return {"Cache-Control": "private, no-store"}
@dataclass(frozen=True)
class Retention:
days: int
def __post_init__(self):
if not 1 <= self.days <= 30:
raise ValueError("retention exceeds the approved period")
def cutoff(self, now: datetime) -> datetime:
if now.utcoffset() is None:
raise ValueError("timezone is required")
return now.astimezone(timezone.utc) - timedelta(days=self.days)
def expired(records: Iterable[Mapping], now: datetime) -> list[str]:
cutoff = Retention(days=30).cutoff(now)
candidates = []
for record in records:
created = record["created_at"]
if created.utcoffset() is None:
raise ValueError("timestamp without a timezone")
if created < cutoff:
candidates.append(record["id"])
return candidates
Проверки фиксируют состав события, обработку неизвестного маршрута, заголовок ответа и поведение на границе срока хранения.
import unittest
from datetime import datetime, timedelta, timezone
from policy import Route, build_event, expired, report_headers
class ReportPolicyTests(unittest.TestCase):
def test_log_contains_only_service_fields(self):
event = build_event(Route.REPORT, 200, 34)
self.assertEqual(event.as_record(), {
"route": "reports.detail",
"status": 200,
"duration_ms": 34,
})
def test_unknown_route_is_rejected(self):
with self.assertRaises(ValueError):
build_event("raw-path", 200, 34)
def test_report_has_no_store_directive(self):
self.assertEqual(report_headers()["Cache-Control"],
"private, no-store")
def test_retention_boundary(self):
now = datetime(2026, 5, 10, tzinfo=timezone.utc)
records = [
{"id": "A", "created_at": now - timedelta(days=31)},
{"id": "B", "created_at": now - timedelta(days=30)},
{"id": "C", "created_at": now - timedelta(days=29)},
]
self.assertEqual(expired(records, now), ["A"])
if __name__ == "__main__":
unittest.main()
$ python3 -m unittest -q test_policy
Ran 4 tests
OK
В образце обнаружены два риска раскрытия данных и одно расхождение с регламентом хранения. Четыре теста подтверждают поведение предложенного модуля. Для закрытия замечаний понадобятся фактические заголовки ответов за прокси, образец журнала после обновления и отчёт о применении срока хранения.
Функция summarize_latency распределяет массив телеметрии между потоками. Каждый поток обходит свой диапазон указателями, отбрасывает ошибочные измерения и возвращает локальную сводку.
$ file latency.o
latency.o: Mach-O 64-bit object x86_64
$ nm -gU latency.o # выборка
0000000000000000 T _scan_range
00000000000000a0 T __Z17summarize_latencyNSt3__14spanIK6SampleLm18446744073709551615EEEtjsummarize_latency делит входные записи на диапазоны. scan_range читает один диапазон, получает его границы и записывает результат через указатель out.
$ otool -tv latency.o # функция scan_range
_scan_range:
0000000000000000 cmpq %rsi, %rdi
0000000000000003 je 0x67
0000000000000005 pushq %rbp
0000000000000006 movq %rsp, %rbp
0000000000000009 pushq %r14
000000000000000b pushq %rbx
000000000000000c xorl %r8d, %r8d
000000000000000f xorl %r10d, %r10d
0000000000000012 xorl %r9d, %r9d
0000000000000015 xorl %eax, %eax
0000000000000017 jmp 0x29
0000000000000019 nopl (%rax)
0000000000000020 addq $0x4, %rdi
0000000000000024 cmpq %rsi, %rdi
0000000000000027 je 0x61
0000000000000029 movzwl (%rdi), %r11d
000000000000002d testb $0x1, 0x2(%rdi)
0000000000000031 sete %bl
0000000000000034 cmpw $-0x1, %r11w
0000000000000039 sete %r14b
000000000000003d orb %bl, %r14b
0000000000000040 jne 0x20
0000000000000042 movzwl %r11w, %r11d
0000000000000046 addq %r11, %r10
0000000000000049 incq %r9
000000000000004c cmpw %r11w, %dx
0000000000000050 adcq $0x0, %rax
0000000000000054 cmpw %r11w, %r8w
0000000000000058 cmoval %r8d, %r11d
000000000000005c movl %r11d, %r8d
000000000000005f jmp 0x20
0000000000000061 popq %rbx
0000000000000062 popq %r14
0000000000000064 popq %rbp
0000000000000065 jmp 0x72
0000000000000067 xorl %eax, %eax
0000000000000069 xorl %r9d, %r9d
000000000000006c xorl %r10d, %r10d
000000000000006f xorl %r8d, %r8d
0000000000000072 movq %r10, (%rcx)
0000000000000075 movq %r9, 0x8(%rcx)
0000000000000079 movq %rax, 0x10(%rcx)
000000000000007d movw %r8w, 0x18(%rcx)
0000000000000082 retqВ цикле указатель %rdi смещается на четыре байта. Инструкции testb и cmpw проверяют флаг валидности и значение 0xffff. Команда adcq увеличивает счётчик только при превышении порога.
Параллелизм задаётся во внешней функции. До семи задач запускаются через std::async, последний диапазон обрабатывает вызывающий поток. Частичные результаты объединяются после future::get().
$ ./check_latency
accepted=3 slow=1 total_ms=136 peak_ms=72
10007 samples / 1..8 workers: OKИз пяти измерений приняты 14, 50 и 72 мс. При пороге 50 мс превышение одно. Запись с нулевым флагом и значение 0xffff исключены.
На серии из 10 007 записей результат для каждого числа потоков от одного до восьми совпал с последовательным эталоном. Отдельно проверен пустой диапазон.
#include "latency.hpp"
#include <algorithm>
#include <future>
#include <vector>
// Каждый вызов получает свой диапазон и собственный приёмник результата.
extern "C" void scan_range(const Sample* first, const Sample* last,
std::uint16_t limit_ms, Summary* out) noexcept {
Summary part{};
for (const Sample* row = first; row != last; ++row) {
const auto ms = row->elapsed_ms;
if ((row->flags & 1u) == 0 || ms == UINT16_MAX)
continue;
part.total_ms += ms;
++part.accepted;
part.slow += ms > limit_ms;
part.peak_ms = std::max(part.peak_ms, ms);
}
*out = part;
}
Summary summarize_latency(std::span<const Sample> rows,
std::uint16_t limit_ms, unsigned workers) {
if (rows.empty())
return {};
const auto count = std::min<std::size_t>(rows.size(), std::clamp(workers, 1u, 8u));
const auto block = rows.size() / count;
const auto extra = rows.size() % count;
auto reduce = [limit_ms](const Sample* begin, const Sample* end) {
Summary local{};
scan_range(begin, end, limit_ms, &local);
return local;
};
std::vector<std::future<Summary>> pending;
pending.reserve(count - 1);
const Sample* cursor = rows.data();
for (std::size_t lane = 0; lane + 1 < count; ++lane) {
const Sample* end = cursor + block + (lane < extra);
pending.emplace_back(std::async(std::launch::async, reduce, cursor, end));
cursor = end;
}
// Последний диапазон обрабатывает вызывающий поток.
Summary result = reduce(cursor, rows.data() + rows.size());
for (auto& task : pending) {
const Summary part = task.get();
result.total_ms += part.total_ms;
result.accepted += part.accepted;
result.slow += part.slow;
result.peak_ms = std::max(result.peak_ms, part.peak_ms);
}
return result;
}auth.jsonl10:42:01 svc-export key.rotate
10:42:08 worker-2 auth.denied key=v3
10:42:09 worker-1 auth.ok key=v4
После ротации ключа один обработчик продолжил использовать версию v3. Сопоставление событий по времени и имени узла сужает поиск причины до конфигурации worker-2.
bom.diffrelease 4.8.1 → 4.8.2
raster-core 2.4.0 → 2.4.1
+ image-codec 1.3.0
Сравнение двух ведомостей компонентов (SBOM) выявляет новую библиотеку image-codec. Перед выпуском команда может сверить её происхождение и лицензию с реестром согласованных зависимостей.
ingress.yaml · cert.pemingress.host reports.example
certificate.SAN DNS:api.example
DNS:admin.example
Имя reports.example отсутствует в списке имён сертификата. Проверка пары файлов перед развёртыванием выявляет расхождение, из-за которого клиент отклонит сертификат для этого узла.
roles.yaml · policy.mdrole reports.viewer
policy reports.read
granted reports.read, reports.export
Регламент разрешает просмотр отчётов, а конфигурация роли также разрешает экспорт. Владелец роли получает точное имя лишнего разрешения для пересмотра.
SHA256SUMS$ shasum -a 256 -c SHA256SUMS
bin/collector: OK
etc/defaults.toml: FAILED
По доверенному манифесту бинарный файл совпадает с релизом. Контрольная сумма конфигурации отличается. Следующий предмет проверки — изменения в defaults.toml при упаковке.
Доступ для исследователей по всему миру. Стоимость указана в долларах США за месяц.
$20/ мес.
$80/ мес.