CIB pdf toolbox technischer Leitfaden (DE)
7. Passwörter und Verschlüsselung bei PDFs
7.2. Properties für Passwort-Schutz und Verschlüsselung
Propertybezeichnung
Propertybezeichnung Typ Funktionalität Art AllowPdfPermissions (ab CIB
pdf toolbox 1.8.3) String Über
die Property kann gesteuert werden, ob bei der Verarbeitung die im PDF über
das Owner-Passwort gesetzten Bearbeitungsrechte berücksichtigt werden. Achtung: Das
erzeugte Ausgabe-PDF ist nicht verschlüsselt. 1 Rechte werden ignoriert 0 Rechte werden beachtet (default) Bei der
PDF/A Konvertierung eines mit Ownerpasswort geschützten PDF muss diese
Property auf den Wert „1“ gesetzt werden. Andernfalls wird ein Fehler
ausgegeben. Set EncryptDocumentPassword (ab CIB pdf toolbox 1.18.0) String Über
diese Property kann das Passwort für ein Passwort-geschütztes Dokument übergeben
werden ohne die Detailangabe, ob es sich um ein EncryptUserPassword oder EncryptOwnerPassword
handelt. Die
Syntax ist identisch zu der von diesen beiden Properties. Wenn
das EncryptDocumentPassword gesetzt wird, stellt die CIB pdf toolbox bei der
Verarbeitung fest um welches Passwort es sich dabei handelt (User oder Owner). Für die
Rückmeldung dieser Information wurden die Metadaten PDFPERMISSION (= SECURITYINFO)
um das Flag IsOwnerAccess erweitert: Achtung: Set EncryptOwnerPassword String Owner-Passwort
(Eigentümer-Passwort) der Eingabedatei (bzw. der Eingabedateien) bzw.
BackgroundFilename. Das
Passwort selbst darf kein „;“ enthalten. Set EncryptUserPassword String User-Passwort
(Benutzer-Passwort) der Eingabedatei (bzw. der Eingabedateien) bzw.
BackgroundFilename. Das
Passwort selbst darf kein „;“ enthalten. Set OutputOwnerPassword String Vergibt
neues Owner-Passwort (Eigentümer-Passwort) für die Ausgabedatei. Das
Passwort selbst darf kein „;“ enthalten. Set OutputUserPassword String Vergibt
neues User-Passwort (Benutzer-Passwort) für die Ausgabedatei. Das
Passwort selbst darf kein „;“ enthalten. Set PdfUserPasswordPresent String Mögliche Werte sind: „“ oder „0“ = es ist kein User-Password
vorhanden “1” = User-Password ist
vorhanden Get PdfOwnerPasswordPresent String Mögliche Werte sind: „“ oder „0“ = es ist kein Owner-Password
vorhanden “1” = Owner-Password ist
vorhanden Get PdfVersion String Setzen
der zu erzeugenden PdfVersion. Gültige Werte: “1.3” Acrobat-Familie
4 “1.4” Acrobat-Familie
5 (default) “1.5” Acrobat-Familie
6 “1.6” Acrobat-Familie
7 „1.7“ Acrobat-Familie
8 Ab CIB pdf toolbox Version 1.4.109: Hinweis:
Get/ EncryptMetadata (Ab CIB pdf toolbox Version 1.4.109) String Durch Setzen dieser Property
kann der Benutzer steuern, ob die Metadaten im PDF verschlüsselt werden. Mögliche Werte: Hinweis: Get/ Die Einstellungen der folgenden
Encryptxxx-Properties (Berechtigungen) werden generell mit dem Passwort aus
der Eingabe in das Ausgabedokument übernommen. Siehe hierzu Kapitel „Wie
verhält sich die CIB pdf toolbox bei Passwortschutz?“. Wird für das Ausgabedokument ein
neues Passwort (OutputOwnerPassword, OutputUserPassword) vergeben, können die
Berechtigungen durch Setzen der folgenden Encryptxxx-Properties neu vergeben
werden. EncryptEnableAssembling String Dokumentzusammenstellung
für die Ausgabedatei genehmigen. Mögliche
Werte: Set EncryptEnableClipboard String Kopieren
von Inhalt für die Ausgabedatei genehmigen. Mögliche
Werte: Set EncryptEnableExtract String ScreenReader-Programme
(z.B. für Sehbehinderte) können auf den Inhalt zugreifen. Der Benutzer darf
Text und Grafiken nicht aus der PDF-Datei kopieren, wenn dieser Wert gesetzt
ist. Mögliche
Werte: „0“ keine Erlaubnis (default) „1“ Aktion erlaubt Set EncryptEnableForms String Ausfüllen
von Formularfeldern für die Ausgabedatei genehmigen. Mögliche
Werte: Set EncryptEnableModifying String Der
Benutzer darf die PDF-Datei verändern (Text hinzufügen etc.), wenn dieser
Wert gesetzt ist. Mögliche Werte: „0“ keine Erlaubnis (default) „1“ Aktion erlaubt Set EncryptEnableNotes String Der
Benutzer darf der PDF-Datei Text Notes und AcroForm Felder hinzufügen und
vorhandene ändern, wenn dieser Wert gesetzt ist. Mögliche Werte: „0“ keine Erlaubnis (default) „1“ Aktion erlaubt Set EncryptEnablePrinting String Drucken
für die Ausgabedatei genehmigen. Mögliche
Werte: Set PdfEncryptionLevel String Liefert die
Verschlüsselungstiefe, welche größer gleich 40 und immer ein Vielfaches von
8. Get PdfEncryptionAlgorithm String Liefert den Wert des
Verschlüsselungsalgorithmus. „0“ = undokumentierter Algorithmus „1“ = PDF-Verschlüsselung 40 bit (RC4-40) „2“ = PDF-Verschlüsselung, 40 bit oder höher (RC4-128) „3“ = undokumentierter Algorithmus Ab CIB pdf toolbox 1.4.107: „4“ = AES-128 Ab CIB pdf toolbox 1.4.109: „5“ = AES-256 Get PdfPermissionAssemble String Mögliche Werte sind: „“ = Tauschen von Seiten,
erzeugen von Lesezeichen und Thumbnails erlaubt „NotAllowed” = Tauschen von
Seiten, erzeugen von Lesezeichen und Thumbnails nicht erlaubt Get PdfPermissionContentAccess String Mögliche Werte sind: „“ = ausschneiden von Text und
Grafik erlaubt „NotAllowed” = ausschneiden von
Text und Grafik nicht erlaubt Get PdfPermissionCopy String Mögliche Werte sind: „“ = kopieren von Text und
Grafiken erlaubt „NotAllowed“ = kopieren von Text
und Grafiken nicht erlaubt Get PdfPermissionFillFormFields String Mögliche Werte sind: „“ = ausfüllen von
Formularfeldern, einschließlich Signaturfeldern, erlaubt „NotAllowed“ = ausfüllen von
Formularfeldern, einschließlich Signaturfeldern, nicht erlaubt Get PdfPermissionModify (ab CIB pdf toolbox 1.4.78) String Mögliche Werte sind: „“ = Änderung ist erlaubt „NotAllowed“ = nicht erlaubt Get PdfPermissionModifyAnnotations (ab CIB pdf toolbox 1.4.78) String add or modify text annotations and (if modify permission is true) form
fields) Mögliche Werte sind: „“ = Änderung von Annotations ist erlaubt „NotAllowed“ = nicht erlaubt Get PdfPermissionPrint String Mögliche Werte sind: „“ = Drucken erlaubt „NotAllowed“ = Druck nicht
erlaubt „Low Resolution“ = Druck nur in
geringer Auflösung Get PdfPermissions String Bitfeld
als Dezimalzahl, erlaubte Zugriffsarten ohne Hauptkennwort Get
Ein evtl. im PDF vergebenes User-Passwort muss gesetzt werden, sonst findet
keine Verarbeitung statt.
1 Owner-Passwort
0 User-Passwort
Die SECURITYINFO
Metadaten werden nur bei verschlüsselten Dokumenten gesetzt. Falls sie aldso
nicht vohanden sind bedeutet das, dass das Dokument ungeschützt ist.
Die Passwörter sind in genau der Reihenfolge aufzulisten wie die zugehörigen
Dateien innerhalb der Properties InputFilename /BackgroundFilename (durch „;“
getrennt).
Die Passwörter sind in genau der Reihenfolge aufzulisten wie die zugehörigen
Dateien innerhalb der Properties InputFilename /BackgroundFilename (durch „;“
getrennt).
(ab
CIB pdf toolbox 1.4.78)
(ab CIB pdf toolbox 1.4.78)
“1.7EL3“ Acrobat Familie 8
(zum Öffnen ist ein Acrobat Reader
ab Version 9 erforderlich!)
Bei aktivierter Verschlüsselung werden folgende Verschlüsselungs-Algorithmen
angewendet:
”1.3” RC4-40, Revision 2
”1.4” RC4-128, Revision 3
”1.5” RC4-128, Revision 4
ab “1.6” AES-128, Revision 4
ab „1.7EL3“ AES-256, Revision 5
Set
Bei den Metadaten handelt es sich um allgemeine Informationen zum PDF wie
Autor, Erstellungsdatum etc. Format und Inhalt der Metadaten sind nicht
festgelegt und hängen von dem Tool ab, das das PDF erstellt hat.
„0“ keine Verschlüsselung der Meta-
daten
„1“ Metadaten werden verschlüsselt
(default)
Für die Verarbeitung dieser Property ist eine PdfVersion von mindestens 1.5
erforderlich.
Set
Bei unverschlüsselter Eingabe werden in der Ausgabe alle Schalter auf TRUE
gesetzt.
“1“ oder „TRUE“ erlaubt
“0“ oder „FALSE“ nicht erlaubt
“1“ oder „TRUE“ erlaubt
“0“ oder „FALSE“ nicht erlaubt
“1“ oder „TRUE“ erlaubt
“0“ oder „FALSE“ nicht erlaubt
“1“ oder „TRUE“ erlaubt
“0“ oder „FALSE“ nicht erlaubt
(ab
CIB pdf toolbox 1.4.78)
(ab
CIB pdf toolbox 1.4.78)
Bei den Fällen „4“ und „5“ ist benutzerdefinierte Verschlüsselung möglich.
Hiermit ist das von Acrobat angebotene Feature „Metadaten unverschlüsselt“
gemeint.
(ab
CIB pdf toolbox 1.4.78)
(ab
CIB pdf toolbox 1.4.78)
(ab
CIB pdf toolbox 1.4.78)
(ab CIB pdf toolbox 1.4.78)
(bit 3 gesetzt oder Dokument nicht verschlüsselt)
(bit 3 nicht gesetzt)
(bit 5 gesetzt oder Dokument nicht verschlüsselt)
(bit 5 nicht gesetzt)
(ab
CIB pdf toolbox 1.4.78)