c0a43ae915
Девятый проход, по итогам приёмки v1.0.0-rc1 на живом Debian 13. Общая тема:
интерфейс обещал оператору то, что продукт умел, но до чего не доходило
управление.
Секрет пира. Подпись под полем предлагала оставить его пустым, сервер умел его
сгенерировать, и генерация была недостижима: в go-playground/validator тег
omitempty НЕ пропускает правило, если поле объявлено указателем и указатель не
nil — hasValue считает указатель на пустую строку «значением». Правило min=6
применялось к пустой строке и отказывало. Ловушка закрыта общим шагом
нормализации DTO, а не тегом на одном поле: та же ловушка ломала фильтр списка
пиров, где очищенный крестиком el-input отправляет `?name=`. Граница проходит по
каждому полю отдельно — у remark пустая строка означает «убрать пометку», у
disabled ноль означает «включён».
Отказы. Любая ошибка любого поля превращалась в слово `invalid`, а слой vo
определял код ответа СРАВНЕНИЕМ текста сообщения — тот же антипаттерн, который
запрещён панели, только на сервере. Ответ несёт errors[{code, field, message,
params}]; панель выбирает фразу по коду и подставляет причины под поля.
Сессия. Ветка «войдите заново» была недостижима дважды: сервер отвечает HTTP 200
на любой отказ, поэтому обработчик ошибок axios не вызывался, а условие в нём
проверяло code === "A0230" и поле msg, которых в этом API никогда не было.
Истёкший токен вдобавок уезжал с кодом системной ошибки.
Иконки. Контракт currentColor был объявлен в двух местах и не действовал: восемь
ассетов несли литеральный fill="#000000" на <path>, а атрибут представления
перебивает унаследованное CSS-свойство. Под это попадали все семь иконок
бокового меню на фоне #181818.
Имя пира. Два правила на одном поле противоречили друг другу (min=1 против
6-32), а копия набора символов в слое контроллеров несла неэкранированный дефис
и впускала `, - . / : ; <` — через панель проходило имя peer/name, которое
импорт того же пира отклонял. Набор символов ЛОГИНА сознательно не сужен и
закреплён тестом: он приходит из HY2XS_ADMIN_USER и оркестратором не
ограничивается.
Добавлены подпись «Разработано во Flamy» с адресом, принадлежащим приложению, и
контрактные тесты панели как обязательный шаг сборки. Их исполняет Bun, а не
vitest: jsdom не вычисляет currentColor и визуальной корректности не доказал бы,
зато vitest привёл бы в граф pnpm audit сотню транзитивных зависимостей.
docs/ разложена по слоям, 11-testing-and-acceptance.md (117 КБ) разбит на пять
частей, добавлен docs/acceptance/ с отчётом о прогоне rc1 и перечнем дефектов.
Обход документации в приёмке стал рекурсивным: плоский docs/*.md после
разнесения по каталогам совпадал бы ровно с одним файлом.
212 lines
6.9 KiB
Go
212 lines
6.9 KiB
Go
package service
|
|
|
|
import (
|
|
"errors"
|
|
"strings"
|
|
"testing"
|
|
"time"
|
|
|
|
"github.com/golang-jwt/jwt/v5"
|
|
"hy2xs-admin/dao"
|
|
"hy2xs-admin/model/bo"
|
|
"hy2xs-admin/model/constant"
|
|
)
|
|
|
|
func newJwtTestDB(t *testing.T) []byte {
|
|
t.Helper()
|
|
|
|
newTestDB(t)
|
|
|
|
secret := "test-jwt-secret-not-used-anywhere-else-0123456789"
|
|
if err := dao.UpsertConfigValue(constant.JwtSecret, secret); err != nil {
|
|
t.Fatalf("не удалось записать %s: %v", constant.JwtSecret, err)
|
|
}
|
|
return []byte(secret)
|
|
}
|
|
|
|
func testAccount() bo.AccountBo {
|
|
return bo.AccountBo{Id: 1, Username: "hy2xsadmin", Roles: []string{"admin"}, TokenVersion: 1}
|
|
}
|
|
|
|
func TestGenAndParseTokenRoundTrip(t *testing.T) {
|
|
newJwtTestDB(t)
|
|
|
|
token, err := GenToken(testAccount())
|
|
if err != nil {
|
|
t.Fatalf("GenToken: %v", err)
|
|
}
|
|
|
|
claims, err := ParseToken(token)
|
|
if err != nil {
|
|
t.Fatalf("ParseToken: %v", err)
|
|
}
|
|
if claims.Admin.Id != 1 || claims.Admin.Username != "hy2xsadmin" {
|
|
t.Fatalf("claims не совпадают: %+v", claims.Admin)
|
|
}
|
|
if claims.Admin.TokenVersion != 1 {
|
|
t.Fatalf("token_version потерян: %d", claims.Admin.TokenVersion)
|
|
}
|
|
if claims.ExpiresAt == nil {
|
|
t.Fatal("токен выписан без срока жизни")
|
|
}
|
|
}
|
|
|
|
// Алгоритм подписи задаётся сервером, а не токеном.
|
|
//
|
|
// Прежний keyfunc возвращал ключ, не глядя на token.Method: набор допустимых
|
|
// алгоритмов фактически определял недоверенный вход. Здесь проверяется, что
|
|
// токен, подписанный другим HMAC-алгоритмом тем же ключом, отклоняется.
|
|
func TestParseTokenRejectsOtherSigningMethod(t *testing.T) {
|
|
secret := newJwtTestDB(t)
|
|
|
|
now := time.Now()
|
|
claims := MyClaims{
|
|
Admin: testAccount(),
|
|
RegisteredClaims: jwt.RegisteredClaims{
|
|
ExpiresAt: jwt.NewNumericDate(now.Add(time.Hour)),
|
|
IssuedAt: jwt.NewNumericDate(now),
|
|
Issuer: tokenIssuer,
|
|
},
|
|
}
|
|
signed, err := jwt.NewWithClaims(jwt.SigningMethodHS512, claims).SignedString(secret)
|
|
if err != nil {
|
|
t.Fatalf("не удалось подписать тестовый токен: %v", err)
|
|
}
|
|
|
|
if _, err := ParseToken(signed); err == nil {
|
|
t.Fatal("токен, подписанный HS512, принят при разрешённом только HS256")
|
|
}
|
|
}
|
|
|
|
// Токен без exp не должен считаться бессрочно валидным.
|
|
func TestParseTokenRejectsTokenWithoutExpiration(t *testing.T) {
|
|
secret := newJwtTestDB(t)
|
|
|
|
claims := MyClaims{
|
|
Admin: testAccount(),
|
|
RegisteredClaims: jwt.RegisteredClaims{
|
|
IssuedAt: jwt.NewNumericDate(time.Now()),
|
|
Issuer: tokenIssuer,
|
|
},
|
|
}
|
|
signed, err := jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString(secret)
|
|
if err != nil {
|
|
t.Fatalf("не удалось подписать тестовый токен: %v", err)
|
|
}
|
|
|
|
if _, err := ParseToken(signed); err == nil {
|
|
t.Fatal("токен без exp принят")
|
|
}
|
|
}
|
|
|
|
func TestParseTokenRejectsExpiredToken(t *testing.T) {
|
|
secret := newJwtTestDB(t)
|
|
|
|
past := time.Now().Add(-2 * time.Hour)
|
|
claims := MyClaims{
|
|
Admin: testAccount(),
|
|
RegisteredClaims: jwt.RegisteredClaims{
|
|
ExpiresAt: jwt.NewNumericDate(past.Add(time.Hour)),
|
|
IssuedAt: jwt.NewNumericDate(past),
|
|
Issuer: tokenIssuer,
|
|
},
|
|
}
|
|
signed, err := jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString(secret)
|
|
if err != nil {
|
|
t.Fatalf("не удалось подписать тестовый токен: %v", err)
|
|
}
|
|
|
|
_, err = ParseToken(signed)
|
|
if err == nil {
|
|
t.Fatal("истёкший токен принят")
|
|
}
|
|
// Вопрос задаётся значению, а не тексту: middleware различает истёкшую
|
|
// сессию и недействительный токен именно через errors.Is, и проверка здесь
|
|
// обязана закреплять тот же способ.
|
|
if !errors.Is(err, ErrTokenExpired) {
|
|
t.Errorf("истечение срока должно сообщаться отдельным значением, получено: %v", err)
|
|
}
|
|
if errors.Is(err, ErrTokenInvalid) {
|
|
t.Error("истёкший токен не должен выглядеть как недействительный")
|
|
}
|
|
}
|
|
|
|
// Токен, выписанный не нами, не должен разбираться как наш даже при совпадении
|
|
// ключа: issuer входит в проверку.
|
|
func TestParseTokenRejectsForeignIssuer(t *testing.T) {
|
|
secret := newJwtTestDB(t)
|
|
|
|
now := time.Now()
|
|
claims := MyClaims{
|
|
Admin: testAccount(),
|
|
RegisteredClaims: jwt.RegisteredClaims{
|
|
ExpiresAt: jwt.NewNumericDate(now.Add(time.Hour)),
|
|
IssuedAt: jwt.NewNumericDate(now),
|
|
Issuer: "some-other-service",
|
|
},
|
|
}
|
|
signed, err := jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString(secret)
|
|
if err != nil {
|
|
t.Fatalf("не удалось подписать тестовый токен: %v", err)
|
|
}
|
|
|
|
if _, err := ParseToken(signed); err == nil {
|
|
t.Fatal("токен с чужим issuer принят")
|
|
}
|
|
}
|
|
|
|
func TestParseTokenRejectsWrongSecret(t *testing.T) {
|
|
newJwtTestDB(t)
|
|
|
|
now := time.Now()
|
|
claims := MyClaims{
|
|
Admin: testAccount(),
|
|
RegisteredClaims: jwt.RegisteredClaims{
|
|
ExpiresAt: jwt.NewNumericDate(now.Add(time.Hour)),
|
|
IssuedAt: jwt.NewNumericDate(now),
|
|
Issuer: tokenIssuer,
|
|
},
|
|
}
|
|
signed, err := jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString([]byte("совершенно другой ключ подписи"))
|
|
if err != nil {
|
|
t.Fatalf("не удалось подписать тестовый токен: %v", err)
|
|
}
|
|
|
|
if _, err := ParseToken(signed); err == nil {
|
|
t.Fatal("токен, подписанный чужим ключом, принят")
|
|
}
|
|
}
|
|
|
|
func TestParseTokenRejectsGarbage(t *testing.T) {
|
|
newJwtTestDB(t)
|
|
|
|
for _, value := range []string{
|
|
"",
|
|
"not-a-token",
|
|
"a.b.c",
|
|
strings.Repeat("A", 500),
|
|
"eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJhZG1pbiI6eyJpZCI6MX19.",
|
|
} {
|
|
if _, err := ParseToken(value); err == nil {
|
|
t.Errorf("мусорный токен %q принят", value)
|
|
}
|
|
}
|
|
}
|
|
|
|
// Пустой JWT_SECRET — повреждённое состояние, а не «ключ нулевой длины».
|
|
// Раньше значение разыменовывалось без проверки, и подпись выполнялась пустым
|
|
// ключом: такой токен подделывает кто угодно.
|
|
func TestGenTokenRefusesEmptySecret(t *testing.T) {
|
|
newTestDB(t)
|
|
if err := dao.UpsertConfigValue(constant.JwtSecret, ""); err != nil {
|
|
t.Fatalf("не удалось очистить %s: %v", constant.JwtSecret, err)
|
|
}
|
|
|
|
if _, err := GenToken(testAccount()); err == nil {
|
|
t.Fatal("токен подписан пустым ключом")
|
|
}
|
|
if _, err := ParseToken("whatever"); err == nil {
|
|
t.Fatal("разбор токена с пустым ключом не отклонён")
|
|
}
|
|
}
|