Уровни доказательств и качества документации по ГОСТ

Редакционная система достоверности: источник, реализация, стенд, межвендорная проверка и юридический статус.

Документация ПО — НАЙС.ОС CLOUD. Это самостоятельная учебно-справочная статья. Команды приведены для изучения и диагностики; операции с ключами, дисками и действующими сервисами выполняют только после резервного копирования и проверки назначения.

Классификация утверждений

Уровень	Значение	Как формулируем
STANDARD	Документ определяет профиль	«RFC определяет…»
IMPLEMENTED	Код присутствует и включён в сборку	«В компоненте реализована операция…»
TESTED_LOCAL	На одном стенде проведён воспроизводимый тест	«Проверено при таких-то версиях и параметрах…»
TESTED_INTEROP	Две независимые реализации обменялись данными	«Подтверждена совместимость в профиле и версиях…»
REGULATORY	Есть проверенное основание для статуса/области применения	«В соответствии с документом/сертификатом…»

Эти уровни не образуют автоматической лестницы. Можно реализовать и испытать криптографию без сертификации, а можно иметь опубликованный профиль без программной реализации в НАЙС.ОС.

Типичные некорректные выводы

• «Поставлен gost Provider — значит Nginx поддерживает ГОСТ TLS». Нет: TLS должен согласовать действительный cipher suite.
• «LUKS2 шифруется Кузнечиком — значит используется только ГОСТ». Нет: заголовок, функции вывода ключей и механизмы целостности могут быть другими.
• «Кривая и OID присутствуют в OpenSSL — значит совместимо с КриптоПро». Нет: контейнер, сериализация и парольная защита требуют отдельных тестов.
• «Два VPN поддерживают ГОСТ — значит они подключатся». Нет: необходимо совпадение конкретного протокола и трансформов.
• «Код встроен в ядро — зашифрованный корень загрузится при любых условиях». Нет: нужны initramfs, dm-crypt, загрузчик и процедура восстановления.

Как вести источник

Для каждого первоисточника поддерживайте: устойчивый URL, идентификатор, публикационную дату, статус, раздел, дату проверки, связь со статьями. Исправления (errata) RFC нужно отслеживать отдельно; со временем рекомендации могут заменять старые, не делая автоматически недействительными все архивные данные.

Как работать с противоречиями

Приоритет у текста применимого стандарта или официального каталога, затем у документации производителя конкретной версии и у воспроизводимого теста. Результат вашей лаборатории не переписывает стандарт: если тест расходится с документом, фиксируйте это как дефект или ограничение реализации.

Автоматический контроль

В поставке R17 есть tools/check_gost_handbook.py: проверка всех новых ссылок внутри раздела, идентификаторов источников и корректности машинного реестра OID. Её можно запускать отдельно после редактирования. Установщик добавляет только новые файлы и пункт меню — без замены вашего docsctl и без внедрения новых обязательных правил в рабочую сборку.

Первоисточники и дополнительное чтение

• Каталог ТК26 — официальные публикации технического комитета.
• RFC 9215 — ГОСТ-2012 в сертификатах и списках отзыва.
• RFC 5652 — базовая структура CMS и типы содержимого.
• RFC 9058 — режим MGM, приложение A с тестовыми векторами.