Подпись не заменяет HTTPS. TLS защищает соединение и конфиденциальность на участке, а HTTP Message Signature позволяет получателю проверить, что выбранные method, authority, path, headers и digest были подписаны известным ключом. После проверки подписи сервис всё равно выполняет authorization: доверенный отправитель не получает автоматически право на любой endpoint.
Самодельная строка POST plus URL plus JSON часто ломается на query normalization, proxy host rewrite, whitespace JSON и повторной передаче заголовков. RFC 9421 задаёт канонизацию и поля Signature-Input и Signature. Для содержимого используется Content-Digest из RFC 9530, потому что подпись одного header без проверки body оставляет payload вне защиты.
Каждый механизм закрывает свой риск
| Механизм | Подтверждает | Не решает |
|---|---|---|
| TLS | Защищённый канал до peer | Replay валидного request позднее |
| Content-Digest | Целостность body bytes | Кто создал digest |
| Message Signature | Ключ подписал выбранные components | Разрешено ли business action |
| Nonce и time window | Свежесть в заданной политике | Идемпотентность side effect |
| Idempotency key | Повтор не создаёт второй результат | Подлинность отправителя |
Контракт подписывает минимум, который меняет смысл
covered components:
"@method"
"@authority"
"@path"
"content-type"
"content-digest"
"x-request-id"
signature parameters:
created, expires, nonce, keyid, algЭто профиль приложения, а не готовый header. Если query влияет на действие, подпишите соответствующий derived component по RFC, а не только path. Content-Digest вычисляется над фактическими content bytes; serializer должен завершить body до вычисления digest. Proxy не должен сжимать или переписывать подписанный content незаметно для verifier.
Не подписывайте случайный набор hop-by-hop headers, которые законно меняются посредником. Сначала нарисуйте путь request и решите, кто является подписантом и конечным verifier. Если gateway завершает подпись и создаёт новую для backend, audit должен различать исходного caller и gateway identity.
Verifier следует одному строгому порядку
- Разобрать Signature-Input и отклонить неизвестный обязательный profile.
- Найти активный public key или shared secret по keyid.
- Проверить alg against key policy, не доверяя значению из request отдельно.
- Проверить created, expires и допустимое clock skew.
- Проверить уникальность nonce в replay cache для keyid.
- Пересчитать Content-Digest по полученным bytes.
- Построить signature base и проверить signature постоянным временем.
- Только затем выполнить endpoint authorization и idempotency policy.
Replay cache хранит пару keyid plus nonce не меньше максимального окна допустимой подписи. Слишком широкое окно облегчает повтор, слишком узкое ломает запросы при clock drift и очередях. Синхронизируйте часы и измеряйте фактическую задержку, а не компенсируйте проблему сутками допуска.
Ротация допускает два ключа, но не вечный старый
- Key ID идентифицирует материал, но сам не является секретом.
- Signer начинает новым ключом после публикации verifier metadata.
- Verifier временно принимает old и new в ограниченном overlap.
- У каждого ключа есть owner, algorithm, not-before, expiry и revoke state.
- Секрет или private key не пишется в logs, traces и error body.
- После overlap старый key отклоняется и удаляется из active set.
Shared HMAC проще, но verifier, знающий secret, также способен создавать подписи; asymmetric key отделяет signing от verification. Выбор зависит от topology и threat model. Не храните один общий secret у десятков сервисов: компрометация одного сделает identities неразличимыми.
Mismatch диагностируем по одному изменению
| Ошибка | Частая причина | Контроль |
|---|---|---|
| Digest mismatch | Другие body bytes или content encoding | Сравнить byte length и digest до proxy |
| Signature mismatch только через gateway | Изменились authority, path или header | Снять covered components на обеих границах |
| Expired | Clock drift или очередь дольше окна | Сравнить trusted server time и created |
| Nonce replay | Повтор transport или атака | Проверить idempotency и request lineage |
| Unknown keyid | Ротация рассинхронизирована | Проверить key distribution revision |
Негативные тесты важнее одного curl
change method after signing -> reject
change one body byte -> digest/signature reject
reuse nonce inside window -> replay reject
send after expires -> reject
use revoked keyid -> reject
valid signature, wrong resource -> authorization reject
repeat idempotent operation -> one business resultДля внедрения подготовьте raw message samples без credentials, карту proxies, canonicalization library и version, clock metrics, key lifecycle и список authorization decisions. Успех — подпись проверяется одинаково во всех разрешённых путях, изменения смысла запроса отвергаются, а повтор не создаёт второй side effect.