Wie man PDF-Dateien verschlüsselt/Passwort & Berechtigungen hinzufügt
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.
Wie man PDF-Dateien verschlüsselt/Passwort & Berechtigungen hinzufügt
- Den IronSecureDoc-Docker-Image abrufen und starten
- Testen Sie die API mit Swagger.
- Geben Sie den Parameter für Passwort und Berechtigungen an.
- Führen Sie den API-Aufruf aus, um die Änderungen anzuwenden.
- Das verschlüsselte PDF-Dokument exportieren
Ziehen und Starten von IronSecureDoc
Wenn Sie IronSecureDoc noch nicht gestartet haben, folgen Sie bitte den unten stehenden Links, um es einzurichten:
Lokaler Gastgeber | Bereitstellung 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
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.
Finden Sie die API:
Finde die [POST]/v1/document-services/pdfs/encrypt API, das dem Verschlüsseln/Hinzufügen von Passwort & Berechtigungen entspricht.
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.
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.
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.
Ü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
Name | Datentyp | Beschreibung |
---|---|---|
pdf_datei | anwendung/pdf | Die PDF-Datei, die Sie verschlüsseln möchten. |
allow_extracting_content | boolean | Geben Sie an, ob die Inhaltsausgabe erlaubt ist. |
Formularausfüllung zulassen | boolean | Geben Sie an, ob das Ausfüllen des Formulars erlaubt ist. |
erlaube_Anmerkungen | boolean | Geben Sie an, ob Anmerkungen erlaubt sind. |
Drucken erlauben | boolean | Geben Sie an, ob Drucken erlaubt ist. |
Änderungen_erlauben | boolean | Geben Sie an, ob Änderungen erlaubt sind. |
new_owner_password | string | Das neue Besitzerpasswort für das PDF, das vollen Zugriff und die Möglichkeit zum Ändern der Berechtigungen gewährt. |
Optionale Parameter
Name | Datentyp | Beschreibung |
---|---|---|
Benutzer_Passwort | string | Das aktuelle Benutzerpasswort, erforderlich, wenn das PDF ein Benutzerpasswort benötigt, um den Lesezugriff zu gewähren. |
Besitzerkennwort | string | Das aktuelle Besitzerpasswort, erforderlich, wenn das PDF ein Besitzerpasswort hat, um vollen Zugriff zu gewähren. |
neues_benutzer_passwort | Das neue Benutzerpasswort für Lesezugriff. | |
Als_PDF/A_speichern | boolean | Speichern Sie das PDF als PDF/A-3-konform. |
save_as_pdfua | boolean | Speichern Sie das PDF als PDF/UA-konform. |
Autor | string | Legen Sie die Autorenmetadaten des PDFs fest. |
titel | string | Legen Sie die PDF-Metadaten-Eigenschaft "Titel" fest. |
Betreff | string | Legen 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.')
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.