Aquamarine
Aquamarine / Security Research

Агентская среда
для исследований
безопасности

Aquamarine объединяет инструменты ИБ в одном сеансе. Агент разбирает файлы и конфигурации, а исследователь сверяет его заключения с исходным выводом утилит.

Анализ веб-сервиса

Aquamarine / Archivreview / policy

Проверь конфигурацию Archiv. Какие данные остаются после просмотра отчёта?

karat k1

Объём проверки

Проверяю три независимых места хранения данных — 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 распределяет массив телеметрии между потоками. Каждый поток обходит свой диапазон указателями, отбрасывает ошибочные измерения и возвращает локальную сводку.

latency.o13 616 байт · macOS

Формат

$ file latency.o
latency.o: Mach-O 64-bit object x86_64
Поля заголовка Mach-O
+0x00 MH_MAGIC_64 · 64-битный заголовок, младший байт идёт первым. +0x04 CPU_TYPE_X86_64 · инструкции семейства x86 в 64-битном режиме. +0x08 CPU_SUBTYPE_X86_64_ALL · общий подтип для архитектуры x86-64. +0x0c MH_OBJECT · перемещаемый объектный файл для линковки. +0x10 Вслед за заголовком идут четыре команды загрузки. +0x14 Команды загрузки занимают 760 байт. +0x18 MH_SUBSECTIONS_VIA_SYMBOLS · символы задают границы подразделов для линкера. +0x1c Зарезервированное поле заголовка содержит ноль.

Символы

$ nm -gU latency.o  # выборка
0000000000000000 T _scan_range
00000000000000a0 T __Z17summarize_latencyNSt3__14spanIK6SampleLm18446744073709551615EEEtj

summarize_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 записей результат для каждого числа потоков от одного до восьми совпал с последовательным эталоном. Отдельно проверен пустой диапазон.

Исходный код latency.cpp
#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.jsonl
10: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.diff
release      4.8.1 → 4.8.2
  raster-core   2.4.0 → 2.4.1
+ image-codec   1.3.0

Сравнение двух ведомостей компонентов (SBOM) выявляет новую библиотеку image-codec. Перед выпуском команда может сверить её происхождение и лицензию с реестром согласованных зависимостей.

Проверка конфигурации TLSingress.yaml · cert.pem
ingress.host       reports.example
certificate.SAN    DNS:api.example
                   DNS:admin.example

Имя reports.example отсутствует в списке имён сертификата. Проверка пары файлов перед развёртыванием выявляет расхождение, из-за которого клиент отклонит сертификат для этого узла.

Ревизия прав доступаroles.yaml · policy.md
role        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/ мес.

  • Всё из начальной подписки
  • Расширенные инструменты анализа
  • Более мощная модель
  • Облако для чатов