Как добавить штамп для электронной подписи PAdES в консольном режиме

Начиная с версии КриптоАРМ 6.2, в консольном режиме (CLI) появилась расширенная возможность подписывать PDF-документы со встроенной подписью стандарта PAdES, включая настройку графического штампа. Это позволяет автоматизировать процесс подписания и единообразно оформлять типовые или шаблонные документы, задавая точное расположение, размер и внешний вид штампа.

Базовый синтаксис команды

Базовая команда для подписания PDF с использованием стандарта PAdES и графического штампа выглядит следующим образом:

"C:\Program Files\CryptoARM 6\cryptoarm6.exe" sign --source-file "Путь_к_исходному_файлу.pdf"
--cert "Серийный_номер_сертификата" 
--pin "Ваш_PIN_код"  
--pades 

Пример:

"C:\Program Files\CryptoARM 6\cryptoarm6.exe" sign --source-file "C:\Doc\Пример.pdf" \
--cert 5883d78e000300093ab6 \
--pin 12345678 \
--pades

Команду следует писать целиком в одну строку:

"C:\Program Files\CryptoARM 6\cryptoarm6.exe" sign --source-file "C:\Doc\Пример.pdf" --cert 5883d78e000300093ab6 --pin 12345678 --pades

Настройка графического штампа

Для гибкой настройки штампа к базовой команде добавляются следующие аргументы:

--pades – обязательный ключ для активации подписи стандарта PAdES c графическим штампом.
--stamp-width – ширина штампа в пикселях.
--stamp-height – высота штампа в пикселях.
--stamp-padding-left – отступ штампа от левого края страницы.
--stamp-padding-bottom – отступ штампа от нижнего края страницы.
--stamp-color – цвет текста штампа (по умолчанию #000000 (черный)).
--stamp-page – номер страницы (по умолчанию последняя).
--stamp-on-all-pages – флаг для добавления штампа на всех страницах.
--stamp-mchd – включает номер МЧД в штамп.
--stamp-pixel-ratio – коэффициент плотности пикселей (pixel ratio) для генерации штампа (по умолчанию 1).
--overwrite-original-pdf – если этот флаг указан, исходный pdf-файл будет перезаписан подписанным документом.

Практические примеры

Пример 1: Стандартный штамп на последней странице

Создает подпись со штампом размером 100x30 мм, расположенным в 20 мм от левого и нижнего края последней страницы.

"C:\Program Files\CryptoARM 6\cryptoarm6.exe" sign --source-file "C:\Doc\Пример.pdf" \
--cert "5883d78e000300093ab6" \ 
--pin "12345678" \
--pades \
--stamp-width 100 \
--stamp-height 30 \
--stamp-padding-left 20 \
--stamp-padding-bottom 20

Пример 2: Красный штамп на всех страницах

Добавляет штамп красного цвета на все страницы документа в правом нижнем углу.

"C:\Program Files\CryptoARM 6\cryptoarm6.exe" sign --source-file "C:\Doc\Пример.pdf" 
--cert "5883d78e000300093ab6"  
--pin "12345678"  
--pades  
--stamp-width 80  
--stamp-height 30  
--stamp-padding-left 110  
--stamp-padding-bottom 10  
--stamp-color #FF0000  
--stamp-on-all-pages

Важные примечания

• Обязательные параметры: Для работы с графическим штампом всегда используйте ключ --pades.
• Безопасность: Ключ --overwrite-original-pdf необратимо изменяет исходный файл. Используйте его с осторожностью, желательно в скриптах, где путь к файлу контролируется.
• Содержимое штампа: Информация в штампе (ФИО, дата, сертификат и т.д.) генерируется автоматически на основе данных вашего сертификата. Настраивается только его внешнее представление, исключение: номер МЧД.

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

Скачать КриптоАРМ: ссылка.