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:
Ein evtl. im PDF vergebenes User-Passwort muss gesetzt werden, sonst findet keine Verarbeitung statt.

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:
1          Owner-Passwort
0          User-Passwort

Achtung:
Die SECURITYINFO Metadaten werden nur bei verschlüsselten Dokumenten gesetzt. Falls sie aldso nicht vohanden sind bedeutet das, dass das Dokument ungeschützt ist.

Set

EncryptOwnerPassword

String

Owner-Passwort (Eigentümer-Passwort) der Eingabedatei (bzw. der Eingabe­dateien) bzw. BackgroundFilename.
Die Passwörter sind in genau der Reihenfolge aufzulisten wie die zugehörigen Dateien innerhalb der Properties InputFilename /BackgroundFilename (durch „;“ getrennt).

Das Passwort selbst darf kein „;“ enthalten.

Set

EncryptUserPassword

String

User-Passwort (Benutzer-Passwort) der Eingabedatei (bzw. der Eingabe­dateien) bzw. BackgroundFilename.
Die Passwörter sind in genau der Reihenfolge aufzulisten wie die zugehörigen Dateien innerhalb der Properties InputFilename /BackgroundFilename (durch „;“ getrennt).

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
(ab CIB pdf toolbox 1.4.78)

String

Mögliche Werte sind:

„“ oder „0“ = es ist kein User-Password vorhanden

“1” = User-Password ist vorhanden

Get

PdfOwnerPasswordPresent
(ab CIB pdf toolbox 1.4.78)

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:
“1.7EL3“           Acrobat Familie 8
            (zum Öffnen ist ein Acrobat                 Reader ab Version 9 erforderlich!)

Hinweis:
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

Get/
Set

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.
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.

Mögliche Werte:
„0“       keine Verschlüsselung der Meta-
            daten
„1“       Metadaten werden verschlüsselt
            (default)

Hinweis:
Für die Verarbeitung dieser Property ist eine PdfVersion von mindestens 1.5 erforderlich.

Get/
Set

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?“.
Bei unverschlüsselter Eingabe werden in der Ausgabe alle Schalter auf TRUE gesetzt.

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:
“1“ oder „TRUE“            erlaubt
“0“ oder „FALSE“          nicht erlaubt  

Set

EncryptEnableClipboard

String

Kopieren von Inhalt für die Ausgabedatei genehmigen.

Mögliche Werte:
“1“ oder „TRUE“            erlaubt
“0“ oder „FALSE“          nicht erlaubt

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:
“1“ oder „TRUE“            erlaubt
“0“ oder „FALSE“          nicht erlaubt

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:
“1“ oder „TRUE“            erlaubt
“0“ oder „FALSE“          nicht erlaubt

Set

PdfEncryptionLevel
(ab CIB pdf toolbox 1.4.78)

String

Liefert die Verschlüsselungstiefe, welche größer gleich 40 und immer ein Vielfaches von 8.

Get

PdfEncryptionAlgorithm
(ab CIB pdf toolbox 1.4.78)

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


Bei den Fällen „4“ und „5“ ist benutzerdefinierte Verschlüsselung möglich. Hiermit ist das von Acrobat angebotene Feature „Metadaten unverschlüsselt“ gemeint.

Get

PdfPermissionAssemble
(ab CIB pdf toolbox 1.4.78)

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
(ab CIB pdf toolbox 1.4.78)

String

Mögliche Werte sind:

„“ = ausschneiden von Text und Grafik erlaubt

„NotAllowed” = ausschneiden von Text und Grafik nicht erlaubt

Get

PdfPermissionCopy
(ab CIB pdf toolbox 1.4.78)

String

Mögliche Werte sind:

„“ = kopieren von Text und Grafiken erlaubt

„NotAllowed“ = kopieren von Text und Grafiken nicht erlaubt

Get

PdfPermissionFillFormFields
(ab CIB pdf toolbox 1.4.78)

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
(bit 3 gesetzt oder Dokument nicht verschlüsselt)

„NotAllowed“ = nicht erlaubt
(bit 3 nicht gesetzt)

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
(bit 5 gesetzt oder Dokument nicht verschlüsselt)

„NotAllowed“ = nicht erlaubt
(bit 5 nicht gesetzt)

Get

PdfPermissionPrint
(ab CIB pdf toolbox 1.4.78)

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