Подпись не заменяет 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Защищённый канал до peerReplay валидного 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 следует одному строгому порядку

  1. Разобрать Signature-Input и отклонить неизвестный обязательный profile.
  2. Найти активный public key или shared secret по keyid.
  3. Проверить alg against key policy, не доверяя значению из request отдельно.
  4. Проверить created, expires и допустимое clock skew.
  5. Проверить уникальность nonce в replay cache для keyid.
  6. Пересчитать Content-Digest по полученным bytes.
  7. Построить signature base и проверить signature постоянным временем.
  8. Только затем выполнить 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 на обеих границах
ExpiredClock 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.

Проверенные источники