Wie man PDF-Dateien verschlüsselt/Passwort & Berechtigungen hinzufügt

This article was translated from English: Does it need improvement?
Translated
View the article in English

von Mehr Muhammad Hamza

Das Sichern von PDF-Dateien mit Passwörtern und bestimmten Berechtigungen ist entscheidend, um sensible Dokumente vor unbefugtem Zugriff und Manipulation zu schützen. Die[POST]Die Encrypt/Add Password & Permissions API von IronSecure Doc bietet eine effiziente Möglichkeit, PDF-Dateien mit Benutzer- und Besitzerkennwörtern zu verschlüsseln und Berechtigungen für das Drucken, Formularausfüllung, Anmerkungen und mehr zu konfigurieren. Diese API stellt sicher, dass das PDF vollständig geschützt ist und der Zugriff kontrolliert wird, wodurch es sich ideal für rechtliche, finanzielle oder persönliche Dokumente eignet.

Ziehen und Starten von IronSecureDoc

Wenn Sie IronSecureDoc noch nicht gestartet haben, folgen Sie bitte den unten stehenden Links, um es einzurichten:

Lokaler GastgeberBereitstellung in der Cloud

Die [POST]-API zum Verschlüsseln/Hinzufügen von Passwort und Berechtigungen

Die[POST]Die API zum Verschlüsseln/Hinzufügen von Passwörtern und Berechtigungen ermöglicht es Ihnen, Sicherheitsebenen zu PDF-Dokumenten hinzuzufügen, indem Sie diese mit Passwörtern verschlüsseln und spezifische Berechtigungen für verschiedene Operationen festlegen. Egal, ob es darum geht, Lesezugriff zu gewähren, das Ausfüllen von Formularen zu ermöglichen oder das Drucken zu deaktivieren, diese API gibt Ihnen die Kontrolle darüber, wie Ihre PDF-Dateien aufgerufen und geändert werden.

Swagger

Swagger bietet eine benutzerfreundliche Schnittstelle, um diese API interaktiv zu testen. Sie können es verwenden, um Testanforderungen zu senden und Antworten zu erhalten, ohne Code zu schreiben, was es zu einem großartigen Werkzeug für Entwickler macht.

Schritte zum Schwärzen von Text mit Swagger

  1. Zugriff auf die Swagger UI:

    Wenn Ihr API-Server lokal läuft, können Sie Swagger aufrufen, indem Sie in Ihrem Webbrowser zu http://localhost:8080/swagger/index.html navigieren.

    Swagger-Dokumentation

  2. Finden Sie die API:

    Finde die [POST]/v1/document-services/pdfs/encrypt API, das dem Verschlüsseln/Hinzufügen von Passwort & Berechtigungen entspricht.

    Text schwärzen

  3. Eingabeparameter:

    Stellen Sie die erforderlichen Parameter für die API bereit. Sie können eine Beispiel-PDF-Datei hochladen und die gewünschten Berechtigungen angeben.

  4. PDF-Datei hochladen:

    Im Anfragekörper laden Sie eine PDF-Datei als pdf_file hoch und definieren Sie die erforderlichen Berechtigungen, wie z.B. das Erlauben oder Einschränken von Drucken, Ausfüllen von Formularen und Extrahieren von Inhalten.

  5. Die Anforderung ausführen:

    Sobald alle Parameter festgelegt sind, klicken Sie auf "Ausführen", um die Anfrage zu senden. Die Antwort liefert das verschlüsselte PDF mit den angegebenen Sicherheitseinstellungen.

  6. Überprüfen Sie das Ausgabepdf:

    Geben Sie 'Passwort' ein, um den PDF-Inhalt anzuzeigen.


Verstehen der Eingabeparameter

Die API erfordert spezifische Parameter, um das PDF zu verschlüsseln und Berechtigungen zuzuweisen. Nachfolgend finden Sie eine Aufschlüsselung der erforderlichen und optionalen Parameter:

Erforderliche Parameter

NameDatentypBeschreibung
pdf_dateianwendung/pdfDie PDF-Datei, die Sie verschlüsseln möchten.
allow_extracting_contentbooleanGeben Sie an, ob die Inhaltsausgabe erlaubt ist.
Formularausfüllung zulassenbooleanGeben Sie an, ob das Ausfüllen des Formulars erlaubt ist.
erlaube_AnmerkungenbooleanGeben Sie an, ob Anmerkungen erlaubt sind.
Drucken erlaubenbooleanGeben Sie an, ob Drucken erlaubt ist.
Änderungen_erlaubenbooleanGeben Sie an, ob Änderungen erlaubt sind.
new_owner_passwordstringDas neue Besitzerpasswort für das PDF, das vollen Zugriff und die Möglichkeit zum Ändern der Berechtigungen gewährt.

Optionale Parameter

NameDatentypBeschreibung
Benutzer_PasswortstringDas aktuelle Benutzerpasswort, erforderlich, wenn das PDF ein Benutzerpasswort benötigt, um den Lesezugriff zu gewähren.
BesitzerkennwortstringDas aktuelle Besitzerpasswort, erforderlich, wenn das PDF ein Besitzerpasswort hat, um vollen Zugriff zu gewähren.
neues_benutzer_passwortDas neue Benutzerpasswort für Lesezugriff.
Als_PDF/A_speichernbooleanSpeichern Sie das PDF als PDF/A-3-konform.
save_as_pdfuabooleanSpeichern Sie das PDF als PDF/UA-konform.
AutorstringLegen Sie die Autorenmetadaten des PDFs fest.
titelstringLegen Sie die PDF-Metadaten-Eigenschaft "Titel" fest.
BetreffstringLegen Sie die PDF-Metadaten-Eigenschaft „Subject“ fest.

API-Integration: Python-Beispiel

Sobald Sie mit den Eingabeparametern vertraut sind, können Sie die API mit Python oder einer anderen bevorzugten Sprache aufrufen. Nachfolgend finden Sie ein Beispiel, wie Sie diese API mit Python integrieren können.

import requests

url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'
headers = {
    'accept': '*/*',
    'author': 'IronSoftware',
    'title': 'ENCRYPTION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

files = {
    'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}

data = {
    'allow_extracting_content': 'true',
    'allow_form_filling': 'true',
    'allow_annotations': 'false',
    'allow_printing': 'false',
    'allow_modifications': 'true',
    'new_owner_password': 'password',
    'new_user_password': 'password',
    'save_as_pdfa': 'false',
    'save_as_pdfua': 'false'
}

response = requests.post(url, headers=headers, files=files, data=data)

# Save the encrypted PDF
with open('sample.pdf', 'wb') as f:
    f.write(response.content)

print('PDF encrypted successfully.')
PYTHON

Schritte erklärt:

  • PDF laden: Die zu verschlüsselnde PDF-Datei wird aus dem lokalen Dateisystem geladen.
  • Verschlüsselungsparameter festlegen: Definieren Sie Berechtigungen wie das Erlauben von Drucken, Formularausfüllung und Inhaltsextraktion sowie das Festlegen neuer Passwörter.
  • API aufrufen: Der[POST]Die Verschlüsselungs-/Passwort- und Berechtigungen-API wird aufgerufen, wobei die notwendigen Parameter übergeben werden.
  • Speichern Sie das Ergebnis: Die verschlüsselte PDF-Datei wird als neue Datei gespeichert.

    Die PDF-Datei ist wie unten gezeigt verschlüsselt. Geben Sie 'Passwort' ein, um den PDF-Inhalt anzuzeigen.