CertificateHolder
Contenuti
[
Nascondere
]CertificateHolder class
Rappresenta un titolare diX509Certificato2 istanza.
Per saperne di più, visita ilLavorare con le firme digitali articolo di documentazione.
public class CertificateHolder
Proprietà
Nome | Descrizione |
---|---|
Certificate { get; } | Restituisce l’istanza diX509Certificato2 che contiene chiavi private, pubbliche e catena di certificati. |
Metodi
Nome | Descrizione |
---|---|
static Create(byte[], SecureString) | CreaCertificateHolder oggetto che utilizza l’array di byte dell’archivio PKCS12 e la sua password. |
static Create(byte[], string) | CreaCertificateHolder oggetto che utilizza l’array di byte dell’archivio PKCS12 e la sua password. |
static Create(string, string) | CreaCertificateHolder oggetto che utilizza il percorso per l’archivio PKCS12 e la sua password. |
static Create(string, string, string) | CreaCertificateHolder oggetto che utilizza il percorso per l’archivio PKCS12, la sua password e l’alias utilizzando quale chiave privata e certificato verranno trovati. |
Osservazioni
CertificateHolder
può essere creato solo da metodi di fabbrica statici. Contiene un’istanza diX509Certificato2 che viene utilizzato per introdurre chiavi private, pubbliche e catene di certificati nel sistema. Questa classe è applicata inDigitalSignatureUtil
EPdfDigitalSignatureDetails
invece di metodi obsoleti con X509Certificate2 come parametri.
Esempi
Mostra come firmare un file di documento crittografato.
// Creare un certificato X.509 da un archivio PKCS#12, che dovrebbe contenere una chiave privata.
CertificateHolder certificateHolder = CertificateHolder.Create(MyDir + "morzal.pfx", "aw");
// Crea un commento, una data e una password di decrittazione che verranno applicati con la nostra nuova firma digitale.
SignOptions signOptions = new SignOptions
{
Comments = "Comment",
SignTime = DateTime.Now,
DecryptionPassword = "docPassword"
};
// Imposta un nome file di sistema locale per il documento di input non firmato e un nome file di output per la sua nuova copia firmata digitalmente.
string inputFileName = MyDir + "Encrypted.docx";
string outputFileName = ArtifactsDir + "DigitalSignatureUtil.DecryptionPassword.docx";
DigitalSignatureUtil.Sign(inputFileName, outputFileName, certificateHolder, signOptions);
Mostra come firmare digitalmente i documenti.
// Creare un certificato X.509 da un archivio PKCS#12, che dovrebbe contenere una chiave privata.
CertificateHolder certificateHolder = CertificateHolder.Create(MyDir + "morzal.pfx", "aw");
// Crea un commento e una data che verranno applicati con la nostra nuova firma digitale.
SignOptions signOptions = new SignOptions
{
Comments = "My comment",
SignTime = DateTime.Now
};
// Prendi un documento non firmato dal file system locale tramite un flusso di file,
// quindi crea una copia firmata determinata dal nome file del flusso di file di output.
using (Stream streamIn = new FileStream(MyDir + "Document.docx", FileMode.Open))
{
using (Stream streamOut = new FileStream(ArtifactsDir + "DigitalSignatureUtil.SignDocument.docx", FileMode.OpenOrCreate))
{
DigitalSignatureUtil.Sign(streamIn, streamOut, certificateHolder, signOptions);
}
}
Mostra come aggiungere una riga per la firma a un documento e poi firmarlo utilizzando un certificato digitale.
[Description("WORDSNET-16868")]
public static void Sign()
{
string signeeName = "Ron Williams";
string srcDocumentPath = MyDir + "Document.docx";
string dstDocumentPath = ArtifactsDir + "SignDocumentCustom.Sign.docx";
string certificatePath = MyDir + "morzal.pfx";
string certificatePassword = "aw";
CreateSignees();
Signee signeeInfo = mSignees.Find(c => c.Name == signeeName);
if (signeeInfo != null)
SignDocument(srcDocumentPath, dstDocumentPath, signeeInfo, certificatePath, certificatePassword);
else
Assert.Fail("Signee does not exist.");
}
/// <summary>
/// Crea una copia di un documento sorgente firmato utilizzando le informazioni fornite sul firmatario e il certificato X509.
/// </summary>
private static void SignDocument(string srcDocumentPath, string dstDocumentPath,
Signee signeeInfo, string certificatePath, string certificatePassword)
{
Document document = new Document(srcDocumentPath);
DocumentBuilder builder = new DocumentBuilder(document);
// Configura e inserisci una riga della firma, un oggetto nel documento che visualizzerà la firma con cui lo firmeremo.
SignatureLineOptions signatureLineOptions = new SignatureLineOptions
{
Signer = signeeInfo.Name,
SignerTitle = signeeInfo.Position
};
SignatureLine signatureLine = builder.InsertSignatureLine(signatureLineOptions).SignatureLine;
signatureLine.Id = signeeInfo.PersonId;
// Per prima cosa, salveremo una versione non firmata del nostro documento.
builder.Document.Save(dstDocumentPath);
CertificateHolder certificateHolder = CertificateHolder.Create(certificatePath, certificatePassword);
SignOptions signOptions = new SignOptions
{
SignatureLineId = signeeInfo.PersonId,
SignatureLineImage = signeeInfo.Image
};
// Sovrascrivi il documento non firmato salvato sopra con una versione firmata utilizzando il certificato.
DigitalSignatureUtil.Sign(dstDocumentPath, dstDocumentPath, certificateHolder, signOptions);
}
public class Signee
{
public Guid PersonId { get; set; }
public string Name { get; set; }
public string Position { get; set; }
public byte[] Image { get; set; }
public Signee(Guid guid, string name, string position, byte[] image)
{
PersonId = guid;
Name = name;
Position = position;
Image = image;
}
}
private static void CreateSignees()
{
var signImagePath = ImageDir + "Logo.jpg";
mSignees = new List<Signee>
{
new Signee(Guid.NewGuid(), "Ron Williams", "Chief Executive Officer", TestUtil.ImageToByteArray(signImagePath)),
new Signee(Guid.NewGuid(), "Stephen Morse", "Head of Compliance", TestUtil.ImageToByteArray(signImagePath))
};
}
private static List<Signee> mSignees;
Guarda anche
- spazio dei nomi Aspose.Words.DigitalSignatures
- assemblea Aspose.Words