RenewPadesArchiveTimestamp - TPdf - PDFium Delphi Component

Компонент: TPdf · Модуль: PDFium

Добавляет новую архивную метку времени Document Time-stamp к существующей цепочке подписей PAdES

Syntax

function RenewPadesArchiveTimestamp(const FileName: string; const Options: TPadesArchiveTimestampOptions; out Report: TPadesArchiveTimestampReport): Boolean;

function RenewPadesArchiveTimestampToStream(Stream: TStream; const Options: TPadesArchiveTimestampOptions; out Report: TPadesArchiveTimestampReport): Boolean;

Description

Читает точный исходный файл, буфер памяти, пользовательский поток или завершённый прогрессирующий источник, удерживаемый активным компонентом, и добавляет инкрементальную метку времени Document Time-stamp по RFC 3161, чей ByteRange охватывает все предыдущие ревизии

Когда UpdateDss равно True, перед меткой времени добавляется предоставленный полный материал сертификатов, OCSP, CRL и VRI, чтобы возвращённый токен защищал обновлённое состояние долгосрочной проверки

Результат записывается только после того, как добавленное поле становится обнаруживаемым, а структурная проверка сообщает PAdES B-LTA

Parameters

FileName	Путь назначения, в который записывается полностью подготовленный результат
Stream	Поток назначения, очищаемый и заполняемый только после успешного продления
Options	URL TSA, nonce, ёмкость токена и необязательный полный заменяющий материал DSS
Report	Уровни источника и результата, количества меток времени, длины в байтах, состояние обновления DSS, время генерации, OID политики и nonce

Remarks

Требует, чтобы Active было равно True, а TsaUrl указывало доступную службу RFC 3161
Результат описывает и расширяет исходную загруженную версию, а не несохранённые правки, которые компонент содержит в текущий момент
Зашифрованные и незавершённые прогрессирующие входные данные отклоняются
Существующие входные данные уже должны объявлять ESIC ExtensionLevel 2, если только UpdateDss не равно True
Обновление DSS заменяет активную ссылку каталога, поэтому DssOptions должен содержать каждый сертификат и каждый элемент проверки, которые должны оставаться доступными
ContentsSize ограничивается снизу значением 1024 байта и сверху 16 MiB
Исторические ревизии остаются неизменными байт в байт, поскольку каждое обновление добавляется в конец
Используйте ValidatePades и онлайн-политику доверия по отдельности, когда требуются актуальные решения по сертификатам, отзывам или историческому доверию

Example

var
  Options: TPadesArchiveTimestampOptions;
  Report: TPadesArchiveTimestampReport;
begin
  Options := TPadesArchiveTimestampOptions.Default;
  Options.TsaUrl := 'https://tsa.example.test';
  Options.Nonce := 42;
  if Pdf1.RenewPadesArchiveTimestamp('renewed.pdf', Options, Report) then
    ShowMessage(Format('%d archival timestamps', [Report.ResultDocTimeStampCount]));
end;

RenewPadesArchiveTimestamp Метод