PDF-salauksen ja oikeuksien tarkistus Delphissä

Tässä artikkelissa käydään läpi toteutuksen tärkeimmät päätökset, rajatapaukset ja varmennukset

Käytännön toteutusvalinnat

Aloita tiedostotyypistä, odotetusta tuloksesta ja virhetilasta, jonka käyttäjän pitää nähdä. Sido sen jälkeen jokainen API-kutsu tarkistettavaan tulokseen, jotta validointi, lokitus ja tuki voivat toistaa asiakkaan tilanteen

Käytä ensin pieniä toistettavia syötetiedostoja
Pidä tuotenimet, API-nimet, tiedostonimet ja literal-arvot muuttumattomina
Tallenna validatorin tuloste ja versiotiedot luodun esimerkkitiedoston kanssa

Koodi ja API-kohdat

Koodiesimerkit säilytetään muuttumattomina, jotta kehittäjä voi verrata niitä suoraan Delphi-, C++Builder- ja Lazarus/FPC-projekteihin

var
  PDF: TPDFlib;
begin
  PDF := TPDFlib.Create;
  try
    if PDF.LoadFromFile('contract.pdf', UserPassword) <> 1 then
      raise Exception.Create('Open failed: wrong password or damaged file');
    Writeln('status    : ', PDF.EncryptionStatus);     // decrypted / encrypted / unknown
    Writeln('algorithm : ', PDF.EncryptionAlgorithm);  // RC4 vs AES family
    Writeln('strength  : ', PDF.EncryptionStrength);   // key length class
    Writeln('owner pw? : ', PDF.CheckPassword(CandidatePassword));
  finally
    PDF.Free;
  end;
end;

var
  PDF: TPDFlib;
  R: Integer;
begin
  PDF := TPDFlib.Create;
  try
    R := PDF.EncryptFile('in.pdf', 'out.pdf', 'owner-secret', 'user-secret', 4,
      PDF.EncodePermissions(1, 0, 0, 0,    // print allowed; copy/change/notes denied
                            0, 0, 0, 1));  // extended set: full-quality print only
    if (R = 1) and (PDF.LoadFromFile('out.pdf', 'user-secret') = 1) then
    begin
      Writeln('algorithm = ', PDF.EncryptionAlgorithm);
      Writeln('strength  = ', PDF.EncryptionStrength);
      Writeln('owner pw accepted: ', PDF.CheckPassword('owner-secret'));
    end;
  finally
    PDF.Free;
  end;
end;

if not Doc.Encrypt('owner-secret', 'user-secret', esAES256BitAcroX,
  [ppCanPrint], [ppCanPrintFull]) then
  raise Exception.Create('Encryption failed');

Tarkistus ennen julkaisua

Tarkista tulostiedosto samoilla työkaluilla, joita asiakas tai arkisto käyttää. Kirjaa komponenttiversio, testidata, validatorin versio ja havaittu tulos, jotta myöhempi regressio voidaan jäljittää täsmällisesti

`/Encrypt`-sanakirjan sisältö

Salaussanakirja määrittää algoritmin, avainten johdannan, käyttöoikeusbitit ja dokumentin tunnisteen. Auditoinnissa tarkista rakenteen lisäksi se, että lukija soveltaa asetuksia samalla tavalla kuin tuotantoympäristö

Lyhyt suojauskoe tasaisella API:lla

Testaa sekä salasanalla avaaminen että väärän salasanan hylkäys. Käytä Unicode-salasanaa, koska merkkijonon koodausvirhe voi näyttää salausongelmalta

Strength-taso ja AES-256

Termi AES-256 voi tarkoittaa eri PDF-suojausprofiileja. Tallenna käytetty Strength-arvo ja varmista riippumattomalla lukijalla, että tiedosto avautuu vain sovitulla tavalla

Oikeusbitit ja avainpituus

Oikeusbitit ovat PDF:n allekirjoittama kokonaisluku, eivätkä ne yksin takaa sovelluksen noudattamaa käyttöpolitiikkaa. Dokumentoi sekä bittimaski että tulkinta ennen julkaisua

PDF-salauksen ja oikeuksien tarkistus Delphissä PDFlibPas-kirjastolla