founder
b99be7d514
Сборка не собиралась: два контракта приёмки роняли её на корректном коде.
verify_api_namespace_contract искал возвращение legacy-пространства имён
через grep по '/hui' и находил router_test.go, который ПЕРЕЧИСЛЯЕТ этот
префикс, чтобы доказать отсутствие маршрута, и сам versions.sh, где строка
стоит в тексте проверки. Падение приходило шестым шагом из четырнадцати, до
резолва Hysteria. За ним прятался второй такой же: проверка транзакционности
импорта пиров брала файл от начала applyPeerImportEntry и до конца, захватывая
объявленные ниже ExistPeerName и UpdatePeerLastConnectionAt.
Обе проверки теперь смотрят на код, а не на упоминания: добавлены помощники
code_without_comments и code_mentions_in, а отсутствие legacy-маршрута
доказывает тест на таблице маршрутов собранного роутера.
Планировщик стал собственностью процесса. InitCron вызывался из runServer и
на каждом вызове создавал новый cron.New(), не сохраняя ссылку; cron.Stop()
не вызывался нигде. Смена RESET_TRAFFIC_CRON выполняла StopServer(), точка
входа крутила for { runServer() } — и каждая правка добавляла целый
дублирующий набор джоб, а старое расписание сброса продолжало работать.
Фиксированные джобы регистрируются один раз, расписание переносится на месте
по EntryID, HTTP-сервер не трогается. Добавлено штатное завершение по SIGTERM.
Выражение проверяется до записи в базу тем же парсером (cron.ParseStandard),
которым его разбирает планировщик: раньше невалидная строка сохранялась, API
отвечал успехом, а сброс трафика молча исчезал.
updateConfigs стал атомарным: полная проверка партии, одна транзакция,
применение к рантайму. Прежний тест ставил запрещённый ключ первым и не
смотрел в базу — поймать частичное применение он был неспособен.
Удалены четыре ключа таблицы config без единого потребителя: HYSTERIA2_ENABLE,
HYSTERIA2_CONFIG (второй источник истины, читался первым), HYSTERIA2_TRAFFIC_TIME
и HYSTERIA2_CONFIG_REMARK. Имя профиля в share URI выводится из имени пира.
Безопасность:
- bootstrap-пароль администратора больше не генерируется и не пишется в журнал,
который отдаётся кнопкой выгрузки; отсутствие env — отказ старта;
- собственный журнал админки санитизируется наравне с чужим;
- golang-jwt/jwt v3 -> v5: GO-2025-3553 не имеет исправленной версии в v3 и
достижима с неаутентифицированного запроса; набор алгоритмов подписи
зафиксирован через WithValidMethods;
- удалён вход по несолёному SHA-224 из предыдущего поколения;
- убран modulo bias в util.RandomString — единственном генераторе секретов;
- пир установщика защищён во всех путях записи, а не только в импорте;
- удалена латентная паника в service.GetToken и недостижимая ветка GetAdminInfo,
проверявшая меньше, чем middleware.
Toolchain: Go 1.21.13 -> 1.26.7, Node 20.19.0 (EOL) -> 24.20.0. На прежнем
графе govulncheck находил 21 вызываемую уязвимость, 17 из них в stdlib,
попадающей в production-бинарь. Сейчас — ноль. Добавлен обязательный шаг
проверки зависимостей (govulncheck + pnpm audit) с записью результата в
metadata пакета.
56 lines
2.4 KiB
Go
56 lines
2.4 KiB
Go
package util
|
||
|
||
import (
|
||
"crypto/rand"
|
||
"errors"
|
||
)
|
||
|
||
const charset = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
|
||
|
||
// rejectionThreshold — граница равномерности при отображении байта в алфавит.
|
||
//
|
||
// В алфавите 62 символа, а байт принимает 256 значений. 256 = 4×62 + 8,
|
||
// поэтому при прямом `charset[b % 62]` первые ВОСЕМЬ символов алфавита
|
||
// («a»…«h») выпадают пятью значениями байта, а остальные 54 — четырьмя. То
|
||
// есть распределение смещено примерно на четверть в пользу начала алфавита.
|
||
//
|
||
// Байты со значением 248 и выше отбрасываются: оставшиеся 248 = 4×62 делятся
|
||
// на длину алфавита нацело, и остаток становится равномерным. Цена — около 3%
|
||
// отброшенных байтов, то есть один лишний вызов rand.Read на несколько сотен
|
||
// символов.
|
||
//
|
||
// Практическая потеря энтропии у прежнего варианта была невелика, но это
|
||
// ЕДИНСТВЕННЫЙ генератор секретов продукта: через него проходят JWT_SECRET,
|
||
// PEER_SECRET_KEY, PEER_SECRET_ENCRYPTION_KEY, секрет trafficStats API,
|
||
// секреты и auth_id пиров. Смещённое распределение в такой позиции чинится
|
||
// пятью строками и не обсуждается на каждом аудите заново.
|
||
const rejectionThreshold = 256 - (256 % len(charset))
|
||
|
||
// RandomString возвращает строку заданной длины из букв и цифр, равномерно
|
||
// распределённых по алфавиту.
|
||
func RandomString(length int) (string, error) {
|
||
if length <= 0 {
|
||
return "", errors.New("random string length must be positive")
|
||
}
|
||
|
||
out := make([]byte, 0, length)
|
||
buf := make([]byte, length)
|
||
|
||
for len(out) < length {
|
||
if _, err := rand.Read(buf); err != nil {
|
||
return "", err
|
||
}
|
||
for _, b := range buf {
|
||
if int(b) >= rejectionThreshold {
|
||
continue
|
||
}
|
||
out = append(out, charset[int(b)%len(charset)])
|
||
if len(out) == length {
|
||
break
|
||
}
|
||
}
|
||
}
|
||
|
||
return string(out), nil
|
||
}
|