officefileapi-devexpress-dot-pdf-dot-pdfdocumentsigner-dot-addtodss-x28-string-icrlclient-iocspclient-icertificatestoreprovider-x29.md
Adds information about the specified signature to the Document Security Store (DSS).
Namespace : DevExpress.Pdf
Assembly : DevExpress.Docs.v25.2.dll
NuGet Package : DevExpress.Document.Processor
public void AddToDss(
string signatureFieldName,
ICrlClient crl,
IOcspClient ocsp,
ICertificateStoreProvider provider
)
Public Sub AddToDss(
signatureFieldName As String,
crl As ICrlClient,
ocsp As IOcspClient,
provider As ICertificateStoreProvider
)
| Name | Type | Description |
|---|---|---|
| signatureFieldName | String |
The name of the form field that contains the target signature.
| | crl | ICrlClient |
An object that contains a Certificate Revocation List (CRL) request for a certificate chain.
| | ocsp | IOcspClient |
An object that returns Online Certificate Status Protocol (OCSP) responce for a certificate chain.
| | provider | ICertificateStoreProvider |
Provides certificates used to build a certificate chain.
|
| Type | Description |
|---|---|
| ArgumentException |
Occurs if the specified form field is not signed.
|
The signatureFieldName parameter is mandatory. Other parameters can be null.
The code sample below retrieves the name of the first signature field, adds the related signature’s information to the DSS, and applies a timestamp to the document.
using (var signer = new PdfDocumentSigner(@"signed.pdf"))
{
ITsaClient tsaClient = new TsaClient(new Uri(@"https://freetsa.org/tsr"), HashAlgorithmType.SHA256);
string signatureName = signer.GetSignatureFieldNames(false)[0];
// Create a provider that retrieves certificates from a store:
using (var certificateStoreProvider =
new CertificateStoreProvider(new X509Store(StoreLocation.CurrentUser), true))
{
// Add the signature to the security store
// and specify the CrlClient and OcspClient objects
// used to check the certificates' revocation status:
signer.AddToDss(signatureName, new CrlClient(), new OcspClient(), certificateStoreProvider);
}
signer.SaveDocument(@"signedLTV.pdf", new[] { new PdfSignatureBuilder(new PdfTimeStamp(tsaClient)) });
}
Using signer = New PdfDocumentSigner("signed.pdf")
Dim tsaClient As ITsaClient = New TsaClient(New Uri("https://freetsa.org/tsr"), HashAlgorithmType.SHA256)
Dim signatureName As String = signer.GetSignatureFieldNames(False)(0)
' Create a provider that retrieves certificates from a store:
Using certificateStoreProvider =
New CertificateStoreProvider(New X509Store(StoreLocation.CurrentUser), True)
' Add the signature to the security store
' and specify the CrlClient and OcspClient objects
' used to check the certificates' revocation status:
signer.AddToDss(signatureName, New CrlClient(), New OcspClient(), certificateStoreProvider)
End Using
signer.SaveDocument("signedLTV.pdf", { New PdfSignatureBuilder(New PdfTimeStamp(tsaClient)) })
End Using
See Also