mufassall

Шпаргалка · Бизнес-процессы

Электронная цифровая подпись

14 мин · Средний · mufassall.dtwin.uz/ru/l/digital-signature/

← Открыть урок

Проблема

Продавец подписывает договор ключом, который никогда не покидает аппаратный токен, покупатель подписывает тоже, а подписи должны оставаться доказуемыми годами после того, как истекут сертификаты. Что именно хешируется, что покрывает подпись, как сервер её проверяет и зачем нужна доверенная метка времени.

Чему вы научитесь

  • Что именно подписывается: хеш файла внутри подписываемых атрибутов
  • Что лежит в подписи CMS (PKCS#7): detached и attached
  • Четыре проверки на сервере: математика, цепочка, срок, отзыв через OCSP
  • Почему доверенная метка времени сохраняет старую подпись после истечения сертификата
Итоговая сцена

Диаграмма как код

Итоговая схема урока в виде текста: вставьте её в Jira, GitLab, GitHub, Notion или документацию, там Mermaid рисуется сам. Есть варианты для D2 и PlantUML (Confluence, IntelliJ).

Mermaid: схема

flowchart LR
  n_signer(("Продавец"))
  n_app(["Приложение подписи"])
  n_api["Сервер документов"]
  n_docs[("Хранилище документов")]
  n_token[("Ключевой токен")]
  n_ca>"УЦ (OCSP)"]
  n_tsa>"Метка времени TSA"]
  n_partner(["Приложение покупателя"])
  n_signer --> n_app
  n_app --> n_api
  n_app --> n_token
  n_token -.-> n_app
  n_api --> n_docs
  n_api --> n_ca
  n_api --> n_tsa
  n_partner --> n_api

Mermaid: последовательность запросов

sequenceDiagram
  participant n_app as Приложение подписи
  participant n_api as Сервер документов
  participant n_token as Ключевой токен
  participant n_docs as Хранилище документов
  actor n_thief as Вор
  participant n_ca as УЦ (OCSP)
  participant n_tsa as Метка времени TSA
  participant n_partner as Приложение покупателя
  Note over n_app,n_api: Приложение хеширует точные байты договора
  n_app->>n_api: GET /contracts/ct_2041/file HTTP/1.1
  n_api-->>n_app: HTTP/1.1 200 OK
  Note over n_app,n_token: Закрытый ключ подписывает внутри токена и не покидает его
  n_app->>n_token: app -#62; token: C_Sign over PKCS#35;11
  n_token-->>n_app: token: signature, 64 bytes
  Note over n_app,n_api: Подпись едет в пакете CMS
  n_app->>n_api: POST /contracts/ct_2041/signatures HTTP/1.1
  n_api-->>n_app: HTTP/1.1 202 Accepted
  Note over n_api,n_docs: Сервер проверяет подпись в четыре шага
  n_api->>n_docs: verify ct_2041 signer #35;0
  Note over n_thief,n_api: Отозванный сертификат всё равно проходит
  n_thief->>n_api: verify ct_2077 signer #35;0
  Note over n_api,n_ca: Спросить УЦ: этот сертификат ещё действует?
  n_api->>n_ca: POST /ocsp HTTP/1.1
  n_ca-->>n_api: HTTP/1.1 200 OK
  Note over n_api,n_ca: Через два года подпись не доказать
  n_api->>n_ca: 2028-05-10 re-verify ct_2041 signer #35;0
  Note over n_api,n_tsa: Доверенная метка времени фиксирует момент подписи
  n_api->>n_tsa: POST /tsa HTTP/1.1
  n_tsa-->>n_api: HTTP/1.1 200 OK
  Note over n_api,n_docs: Хранить доказательства вместе с подписью
  n_api->>n_docs: 2028-05-10 re-verify ct_2041 signer #35;0
  Note over n_partner,n_api: Покупатель подписывает тот же договор
  n_partner->>n_api: POST /contracts/ct_2041/signatures HTTP/1.1
  n_api-->>n_partner: HTTP/1.1 200 OK

D2

direction: right

n_signer: "Продавец" {
  shape: person
}
n_app: "Приложение подписи" {
  shape: rectangle
}
n_api: "Сервер документов" {
  shape: rectangle
}
n_docs: "Хранилище документов" {
  shape: cylinder
}
n_token: "Ключевой токен" {
  shape: stored_data
}
n_ca: "УЦ (OCSP)" {
  shape: cloud
}
n_tsa: "Метка времени TSA" {
  shape: cloud
}
n_partner: "Приложение покупателя" {
  shape: rectangle
}

n_signer -> n_app
n_app -> n_api
n_app -> n_token
n_token -> n_app {
  style.stroke-dash: 3
}
n_api -> n_docs
n_api -> n_ca
n_api -> n_tsa
n_partner -> n_api

PlantUML: последовательность запросов

@startuml
participant "Приложение подписи" as n_app
participant "Сервер документов" as n_api
database "Ключевой токен" as n_token
database "Хранилище документов" as n_docs
actor "Вор" as n_thief
boundary "УЦ (OCSP)" as n_ca
boundary "Метка времени TSA" as n_tsa
participant "Приложение покупателя" as n_partner
note over n_app, n_api : Приложение хеширует точные байты договора
n_app -> n_api : GET /contracts/ct_2041/file HTTP/1.1
n_api --> n_app : HTTP/1.1 200 OK
note over n_app, n_token : Закрытый ключ подписывает внутри токена и не покидает его
n_app -> n_token : app -> token: C_Sign over PKCS#11
n_token --> n_app : token: signature, 64 bytes
note over n_app, n_api : Подпись едет в пакете CMS
n_app -> n_api : POST /contracts/ct_2041/signatures HTTP/1.1
n_api --> n_app : HTTP/1.1 202 Accepted
note over n_api, n_docs : Сервер проверяет подпись в четыре шага
n_api -> n_docs : verify ct_2041 signer #0
note over n_thief, n_api : Отозванный сертификат всё равно проходит
n_thief -> n_api : verify ct_2077 signer #0
note over n_api, n_ca : Спросить УЦ: этот сертификат ещё действует?
n_api -> n_ca : POST /ocsp HTTP/1.1
n_ca --> n_api : HTTP/1.1 200 OK
note over n_api, n_ca : Через два года подпись не доказать
n_api -> n_ca : 2028-05-10 re-verify ct_2041 signer #0
note over n_api, n_tsa : Доверенная метка времени фиксирует момент подписи
n_api -> n_tsa : POST /tsa HTTP/1.1
n_tsa --> n_api : HTTP/1.1 200 OK
note over n_api, n_docs : Хранить доказательства вместе с подписью
n_api -> n_docs : 2028-05-10 re-verify ct_2041 signer #0
note over n_partner, n_api : Покупатель подписывает тот же договор
n_partner -> n_api : POST /contracts/ct_2041/signatures HTTP/1.1
n_api --> n_partner : HTTP/1.1 200 OK
@enduml

PlantUML: компоненты

@startuml
left to right direction
actor "Продавец" as n_signer
agent "Приложение подписи" as n_app
component "Сервер документов" as n_api
database "Хранилище документов" as n_docs
storage "Ключевой токен" as n_token
cloud "УЦ (OCSP)" as n_ca
cloud "Метка времени TSA" as n_tsa
agent "Приложение покупателя" as n_partner
n_signer --> n_app
n_app --> n_api
n_app --> n_token
n_token ..> n_app
n_api --> n_docs
n_api --> n_ca
n_api --> n_tsa
n_partner --> n_api
@enduml

Итог

Пять правил для ЭЦП на деловых документах.

1) Подписывайте хеш точных байтов, внутри подписываемых атрибутов. 2) Закрытый ключ остаётся в токене, наружу выходит только подпись. 3) Проверяйте хеш, математику, цепочку, даты и отзыв (OCSP или CRL). 4) signingTime — лишь заявление: берите метку TSA над значением подписи. 5) Храните цепочку и OCSP-ответ вместе с подписью, чтобы она оставалась доказуемой после истечения сертификата.

Показатели: в начале и в конце

ПоказательВ началеВ конце
Приём подписи p9535 мс260 мс
Принято с отозванным сертификатом0/день0/день
Недоказуемые старые подписи00

Шаги

  1. Кейс Приложение хеширует точные байты договора

    Продавец открывает договор ct_2041 в приложении подписи.

  2. Кейс Закрытый ключ подписывает внутри токена и не покидает его

    Приложение не подписывает хеш файла напрямую.

  3. Кейс Подпись едет в пакете CMS

    Приложение упаковывает подпись в CMS (он же PKCS#7) SignedData: алгоритмы, сертификат подписанта с сертификатом издателя и signerInfo с подписываемыми атрибутами и значением подписи.

  4. Решение Сервер проверяет подпись в четыре шага

    Сервер хеширует свою копию файла и сравнивает с messageDigest.

  5. Проблема Отозванный сертификат всё равно проходит

    Вор берёт украденный токен, вводит PIN, записанный на стикере, и подписывает договор на крупную поставку.

  6. Решение Спросить УЦ: этот сертификат ещё действует?

    Прежде чем принять подпись, сервер отправляет OCSP-запрос на responder, указанный в сертификате.

  7. Проблема Через два года подпись не доказать

    Договоры должны оставаться доказуемыми годами, для аудита и суда.

  8. Решение Доверенная метка времени фиксирует момент подписи

    Сразу после подписи сервер отправляет хеш значения подписи в службу меток времени (RFC 3161).

  9. Решение Хранить доказательства вместе с подписью

    В момент подписи сервер сохраняет ещё и цепочку сертификатов и OCSP-ответ, полученный сразу после метки времени.

  10. Кейс Покупатель подписывает тот же договор

    Покупатель открывает договор, приложение хеширует тот же PDF и получает тот же messageDigest.

  11. Итоги Итог

    Пять правил для ЭЦП на деловых документах.

Термины

Электронная цифровая подпись (ЭЦП)
Подпись закрытым ключом над хешем документа. Любой может проверить её открытым ключом из сертификата.
CMS (PKCS#7)
Формат, упаковывающий подпись, сертификаты и подписываемые атрибуты: вместе с документом (attached) или отдельно (detached).
OCSP
Запрос к удостоверяющему центру: действует ли сертификат сейчас, отозван или неизвестен. Онлайн-альтернатива списку CRL.
Доверенная метка времени
Служба меток времени (TSA) подписывает хеш значения подписи своим временем. Момент подписи доказуем и после истечения сертификата.