Security

Security

Αυτή η σελίδα καλύπτει κωδικούς πρόσβασης, κρυπτογράφηση και ψηφιακές υπογραφές. Document.OpenFile() / Document.Open() δέχονται έναν κωδικό πρόσβασης για το άνοιγμα ενός προστατευμένου εγγράφου, Document.Save() δέχεται μια επιλογή encrypt για την προστασία ενός, και Document.Sign() / Document.Certify() / Document.VerifySignatures() προσθέτουν και ελέγχουν ψηφιακές υπογραφές.

Άνοιγμα και Αποκρυπτογράφηση Εγγράφων με Κωδικό Πρόσβασης

Περάστε { password: '...' } στο Document.OpenFile() ή Document.Open() για να ανοίξετε ένα έγγραφο προστατευμένο με κωδικό χρήστη. Εάν λείπει ο κωδικός ή είναι λανθασμένος, η κλήση πετάει InvalidPasswordError.

import { Document, InvalidPasswordError } from '@asposefoss/pdf';

try {
  const doc = Document.OpenFile('secret.pdf', { password: 'hunter2' });
  doc.WriteTo('decrypted.pdf');    // output is plaintext
} catch (e) {
  if (e instanceof InvalidPasswordError) console.error('wrong password');
  else throw e;
}

Κρυπτογράφηση κατά την Αποθήκευση

Document.Save() (και Document.WriteTo()) δέχονται μια επιλογή encrypt. Η κρυπτογράφηση με βάση τον κωδικό πρόσβασης είναι η κοινή περίπτωση· η βιβλιοθήκη υποστηρίζει επίσης κρυπτογράφηση με δημόσιο κλειδί προς ένα ή περισσότερα πιστοποιητικά παραλήπτη, που ανοίγονται ξανά με το ιδιωτικό κλειδί του παραλήπτη.

// Encrypt to one or more recipient certificates (PEM string or DER bytes):
const bytes = doc.Save({
  encrypt: {
    recipients: [{ certificate: recipientCertPem }],
    algorithm: 'aes256',                 // 'aes256' (default) | 'aes128' | 'rc4'
    permissions: { copying: false },     // shared across all recipients
  },
});

// Open with the recipient's private key + certificate, or a PKCS#12 bundle:
const opened = Document.Open(bytes, {
  recipient: { privateKey, certificate: recipientCertPem },
});
console.log(opened.Permissions);         // recovered permission flags (not enforced)

Υπογραφή και Πιστοποίηση

Document.Certify() προσθέτει μια πιστοποίηση (συγγραφέα) υπογραφή που φέρει μια μετατροπή DocMDP η οποία δηλώνει ποιες μεταγενέστερες αλλαγές επιτρέπονται· Document.Sign() προσθέτει μια περαιτέρω, κανονική υπογραφή έγκρισης που μπορεί να προσαρμοστεί σταδιακά από πάνω. Και οι δύο δέχονται έναν υπογράφοντα { certificate, privateKey } και ένα αντικείμενο επιλογών (reason, location, name, fieldName, και — για Certify() — permissions).

const certifying = Document.OpenFile('report.pdf');
await certifying.Certify(
  { certificate: author.certificate, privateKey: author.privateKey },
  { permissions: 'form-fill', reason: 'Certifying the report', fieldName: 'Certification' },
);
const certifiedBytes = certifying.Save();

const approving = Document.Open(certifiedBytes);
await approving.Sign(
  { certificate: approver.certificate, privateKey: approver.privateKey },
  { reason: 'Approved for publication', fieldName: 'Approval' },
);
approving.WriteTo('signed.pdf');

Επαλήθευση Υπογραφών

Document.VerifySignatures() ελέγχει κάθε υπογραφή στο έγγραφο: επανυπολογίζει κάθε /ByteRange digest, επαληθεύει το αποσπασμένο CMS και αναφέρει τι άλλαξε μετά από κάθε υπογραφή. Επιστρέφει ένα SignatureReport[], μία καταχώρηση ανά υπογραφή.

const reports = await Document.OpenFile('signed.pdf').VerifySignatures();
for (const r of reports) {
  console.log(r.name, 'integrity:', r.integrity, 'signature:', r.signature);
}

Συμβουλές και Καλές Πρακτικές

• Αναλάβετε το InvalidPasswordError ειδικά πριν από ένα γενικό catch-all κατά το άνοιγμα μη αξιόπιστης εισόδου, ώστε να μπορείτε να αντιδράτε διαφορετικά σε έναν εσφαλμένο κωδικό πρόσβασης από ό,τι σε ένα κατεστραμμένο αρχείο.
• Κλήστε το Certify() πριν από οποιεσδήποτε κλήσεις Sign() — μια πιστοποιητική υπογραφή καθορίζει τα DocMDP δικαιώματα που οι μεταγενέστερες υπογραφές έγκρισης επικάθονται πάνω τους.
• Document.Open() επιστρέφει τα ανακτημένα Permissions μετά την αποκρυπτογράφηση με δημόσιο κλειδί, αλλά η βιβλιοθήκη δεν τα επιβάλλει αυτή καθαυτή — αντιμετωπίστε τα ως πληροφοριακά.
• VerifySignatures() είναι async — await το (ή διαχειριστείτε το επιστρεφόμενο Promise) πριν διαβάσετε τον πίνακα αναφορών.

Κοινά προβλήματα

FAQ

Ποια είναι η διαφορά μεταξύ Υπογραφής και Πιστοποίησης;

Certify() προσθέτει την πρώτη υπογραφή πιστοποίησης και δηλώνει (μέσω μιας DocMDP μετατροπής) ποιες μετέπειτα αλλαγές επιτρέπονται. Sign() προσθέτει μια συνηθισμένη υπογραφή έγκρισης, προσαρτημένη σταδιακά πάνω σε ό,τι υπήρχε πριν.

Πώς ανοίγω ένα PDF προστατευμένο με κωδικό πρόσβασης;

Περάστε το { password: '...' } στο Document.OpenFile() ή Document.Open() και πιάστε το InvalidPasswordError αν ο κωδικός μπορεί να είναι λανθασμένος.

Επιβάλλει αυτή η βιβλιοθήκη τις σημαίες δικαιωμάτων PDF;

Όχι. Το Document.Open() ανακτά τις σημαίες Permissions από ένα κρυπτογραφημένο έγγραφο για να τις ελέγξετε, αλλά δεν περιορίζει αυτόματα τι μπορεί να κάνει ο κώδικάς σας με το ανοιχτό έγγραφο.

Πώς μπορώ να ελέγξω αν οι υπογραφές ενός υπογεγραμμένου PDF είναι ακόμη έγκυρες;

Καλέστε το Document.VerifySignatures() (μια async μέθοδο) και εξετάστε τα πεδία integrity και signature του κάθε SignatureReport που επιστρέφεται.

API Reference Περίληψη

Δείτε επίσης

• Aspose.PDF — Enterprise Documentation