Шпаргалка · Бизнес-процессы
Электронная цифровая подпись
Проблема
Продавец подписывает договор ключом, который никогда не покидает аппаратный токен, покупатель подписывает тоже, а подписи должны оставаться доказуемыми годами после того, как истекут сертификаты. Что именно хешируется, что покрывает подпись, как сервер её проверяет и зачем нужна доверенная метка времени.
Чему вы научитесь
- Что именно подписывается: хеш файла внутри подписываемых атрибутов
- Что лежит в подписи 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_apiMermaid: последовательность запросов
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 OKD2
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_apiPlantUML: последовательность запросов
@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
@endumlPlantUML: компоненты
@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-ответ вместе с подписью, чтобы она оставалась доказуемой после истечения сертификата.
Показатели: в начале и в конце
| Показатель | В начале | В конце |
|---|---|---|
| Приём подписи p95 | 35 мс | 260 мс |
| Принято с отозванным сертификатом | 0/день | 0/день |
| Недоказуемые старые подписи | 0 | 0 |
Шаги
- Кейс Приложение хеширует точные байты договора
Продавец открывает договор
ct_2041в приложении подписи. - Кейс Закрытый ключ подписывает внутри токена и не покидает его
Приложение не подписывает хеш файла напрямую.
- Кейс Подпись едет в пакете CMS
Приложение упаковывает подпись в CMS (он же PKCS#7)
SignedData: алгоритмы, сертификат подписанта с сертификатом издателя иsignerInfoс подписываемыми атрибутами и значением подписи. - Решение Сервер проверяет подпись в четыре шага
Сервер хеширует свою копию файла и сравнивает с
messageDigest. - Проблема Отозванный сертификат всё равно проходит
Вор берёт украденный токен, вводит PIN, записанный на стикере, и подписывает договор на крупную поставку.
- Решение Спросить УЦ: этот сертификат ещё действует?
Прежде чем принять подпись, сервер отправляет OCSP-запрос на responder, указанный в сертификате.
- Проблема Через два года подпись не доказать
Договоры должны оставаться доказуемыми годами, для аудита и суда.
- Решение Доверенная метка времени фиксирует момент подписи
Сразу после подписи сервер отправляет хеш значения подписи в службу меток времени (RFC 3161).
- Решение Хранить доказательства вместе с подписью
В момент подписи сервер сохраняет ещё и цепочку сертификатов и OCSP-ответ, полученный сразу после метки времени.
- Кейс Покупатель подписывает тот же договор
Покупатель открывает договор, приложение хеширует тот же PDF и получает тот же
messageDigest. - Итоги Итог
Пять правил для ЭЦП на деловых документах.
Термины
- Электронная цифровая подпись (ЭЦП)
- Подпись закрытым ключом над хешем документа. Любой может проверить её открытым ключом из сертификата.
- CMS (PKCS#7)
- Формат, упаковывающий подпись, сертификаты и подписываемые атрибуты: вместе с документом (attached) или отдельно (detached).
- OCSP
- Запрос к удостоверяющему центру: действует ли сертификат сейчас, отозван или неизвестен. Онлайн-альтернатива списку CRL.
- Доверенная метка времени
- Служба меток времени (TSA) подписывает хеш значения подписи своим временем. Момент подписи доказуем и после истечения сертификата.