TekH
232b341894
Refactored `Pkcs11Options` by removing `DefaultCertificationLevel` and improving property documentation. Replaced `VisualSignature` in `PdfSignOptionsDto` with `Appearance` using the new `PdfSignatureAppearanceDto` class, which encapsulates signature appearance details, including font and color settings. Enhanced `PdfSignatureCertificationLevel` enum with more descriptive values and added XML documentation. Updated `IPdfDigitalSignatureService` to support optional signature images and removed redundant methods. Refactored `PdfDigitalSignatureService` to streamline appearance handling, validate inputs, and improve maintainability. Removed unused methods and added support for `PdfSignatureAppearanceDto`. Simplified `PdfSignatureController` by consolidating form properties into `PdfSignOptionsDto`. Improved code readability and flexibility while removing redundant logic.
30 lines
1.5 KiB
C#
30 lines
1.5 KiB
C#
using EnvelopeGenerator.Application.Common.Dto;
|
|
|
|
namespace EnvelopeGenerator.Application.Common.Interfaces.Services;
|
|
|
|
/// <summary>
|
|
/// Defines PDF digital-signing operations for the application boundary.
|
|
/// </summary>
|
|
public interface IPdfDigitalSignatureService
|
|
{
|
|
/// <summary>
|
|
/// Creates a digital signature for the provided PDF bytes and returns
|
|
/// a new signed PDF document.
|
|
/// </summary>
|
|
/// <param name="inputPdf">Source PDF content stream.</param>
|
|
/// <param name="outputPdf">Destination stream for signed PDF output.</param>
|
|
/// <param name="options">Optional signing options that map to PDF signature metadata fields.</param>
|
|
/// <param name="image">Optional image stream for signature appearance.</param>
|
|
/// <param name="cancellationToken">Cancellation token for cooperative cancellation.</param>
|
|
Task SignPdfAsync(Stream inputPdf, Stream outputPdf, PdfSignOptionsDto? options = null, Stream? image = null, CancellationToken cancellationToken = default);
|
|
|
|
/// <summary>
|
|
/// Checks whether the provided PDF contains signature field(s) and whether
|
|
/// those signatures are cryptographically valid.
|
|
/// </summary>
|
|
/// <param name="inputPdf">PDF content stream to inspect.</param>
|
|
/// <param name="cancellationToken">Cancellation token for cooperative cancellation.</param>
|
|
/// <returns>A structured result containing signature presence and per-signature details.</returns>
|
|
Task<PdfSignatureCheckResultDto> CheckPdfSignatureAsync(Stream inputPdf, CancellationToken cancellationToken = default);
|
|
}
|