1. IronSecureDoc
2. Anleitungen
3. Region schwärzen

Wie man Bereiche in PDF-Dateien schwärzt

von Mehr Muhammad Hamza

Das Schwärzen sensibler Informationen in PDF-Dokumenten ist entscheidend, um die Privatsphäre zu gewährleisten und die Einhaltung von Datenschutzbestimmungen sicherzustellen. Die[POST]Die Redact Region API von IronSecureDoc bietet eine effiziente Möglichkeit, sensible Texte und Informationen in bestimmten Bereichen eines PDF-Dokuments mithilfe echter Schwärzung zu verbergen. Diese API stellt sicher, dass die geschwärzten Daten vollständig entfernt werden und nicht wiederhergestellt werden können, was sie ideal für den Umgang mit vertraulichen Informationen in juristischen, finanziellen oder persönlichen Dokumenten macht.

Ziehen und Starten von IronSecureDoc

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

Die [POST]Redact Region API

Die[POST]Der Redact Region API-Endpunkt ermöglicht es Ihnen, sensible Informationen innerhalb bestimmter Bereiche eines PDF-Dokuments durch echte Schwärzung zu verbergen. Diese Funktion ist entscheidend für Anwendungen, die vertrauliche Dokumente verwalten, wie z. B. juristische Verträge, medizinische Unterlagen oder Finanzberichte. Durch die Nutzung dieser API können Sie sicherstellen, dass sensible Texte in definierten Bereichen eines PDF dauerhaft entfernt werden, was sowohl Sicherheit als auch Compliance bietet.

In Swagger ausprobieren

Swagger ist ein leistungsstarkes Werkzeug, das Entwicklern ermöglicht, über eine benutzerfreundliche Web-Oberfläche mit RESTful-APIs zu interagieren. Egal, ob Sie Sprachen wie Python, Java oder andere verwenden, Swagger bietet eine bequeme Möglichkeit, diese API zu testen und zu implementieren.

Schritte zum Schwärzen eines Bereichs 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.

   

2. Lokalisieren Sie die[POST]Redact Region API:

   Innerhalb der Swagger-UI, finden Sie die[POST]/v1/document-services/pdfs/redact-region-Endpunkt.

   

3. Redaktionskoordinaten festlegen:

   In diesem Beispiel werden wir eine Tabelle aus dem PDF auf Seitenindex 1 entfernen.(d. h., Seite #2). Verwenden Sie die folgenden Koordinaten, um den Schwärzungsbereich festzulegen:

   • Seitenindex(spezifische_Seiten): 1
   • X-Koordinate(region_to_redact_x): 60
   • Y-Koordinate(region_to_redact_y): 270
   • Breite(region_to_redact_w): 470
   • Höhe(region_to_redact_h): 200

4. Optionale Parameter festlegen:

   Optional können Sie ein Benutzer- oder Besitzerpasswort hinzufügen, bestimmte Seiten angeben oder entscheiden, ob ein schwarzer Kasten über den redigierten Bereich gezeichnet wird, und das Dokument mit PDF/A- oder PDF/UA-Konformität speichern.

   

5. Eine Beispiel-PDF hochladen:

   Laden Sie im Anfragekörper eine Beispiel-PDF-Datei hoch, auf die Sie die Schwärzung anwenden möchten. Stellen Sie sicher, dass die Datei als pdf_file hinzugefügt wird.

6. Die Anforderung ausführen:

   Klicken Sie auf "Ausführen", um die Anforderung auszuführen. Die Antwort wird das redigierte PDF enthalten, bei dem die Tabelle auf Seitenindex 1 wie angegeben entfernt wurde.

   

   Diese Swagger-UI-Interaktion ermöglicht es Ihnen, den Schwärzungsprozess einfach zu testen und bietet sofortiges Feedback darüber, wie die Koordinaten den PDF-Inhalt beeinflussen.

7. Überprüfen Sie das Ausgabepdf:

   Der geschwärzte Bereich wird sich auf Seite 2 befinden.

Verstehen der Eingabeparameter

Bevor Sie diese API verwenden, ist es wichtig, die erforderlichen und optionalen Eingabeparameter für die Schwärzung eines Bereichs in Ihrem PDF zu verstehen. Diese Parameter helfen, den spezifischen Bereich zu definieren, der geschwärzt werden soll.

Wichtige Parameter

• pdf_file: Das PDF-Dokument, das Sie schwärzen möchten.
• region_to_redact_x: X-Koordinate des zu schwärzenden Bereichs(beginnend von der unteren linken Ecke der Seite).
• region_to_redact_y: Y-Koordinate des zu redigierenden Bereichs(beginnend von der unteren linken Ecke der Seite).
• region_to_redact_w: Breite des zu schwärzenden Bereichs.
• region_to_redact_h: Höhe des zu schwärzenden Bereichs.

Optionale Parameter

• user_password: Wenn das PDF passwortgeschützt ist, geben Sie das Benutzerpasswort ein.
• owner_password: Geben Sie das Besitzerpasswort an, wenn Änderungen eingeschränkt sind.
• specific_pages: Geben Sie an, welche Seiten geschwärzt werden sollen. Falls nicht angegeben, gilt die Schwärzung für alle Seiten.
• save_as_pdfa: Speichern Sie das PDF mit PDF/A-3-Konformität.
• save_as_pdfua: Speichern Sie das PDF mit PDF/UA-Konformität.

  ---

API-Integration: Python-Beispiel

Sobald Sie mit den Parametern vertraut sind, können Sie diese API mit Ihrer bevorzugten Programmiersprache 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/redact-region'
headers = {
    'accept': '*/*',
    'author': 'IronSoftware',
    'title': 'REDACT REGION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

# Open the file
files = {
    'pdf_file': ('sample_file.pdf', open('sample_file.pdf', 'rb'), 'application/pdf')
}

# Prepare the argument
data = {
    'region_to_redact_x': '60',
    'region_to_redact_y': '270',
    'region_to_redact_w': '470',
    'region_to_redact_h': '200',
    'specific_pages':[1]
}

# Call the API
response = requests.post(url, headers=headers, files=files, data=data)

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

print('PDF redacted successfully.')

import requests

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

# Open the file
files = {
    'pdf_file': ('sample_file.pdf', open('sample_file.pdf', 'rb'), 'application/pdf')
}

# Prepare the argument
data = {
    'region_to_redact_x': '60',
    'region_to_redact_y': '270',
    'region_to_redact_w': '470',
    'region_to_redact_h': '200',
    'specific_pages':[1]
}

# Call the API
response = requests.post(url, headers=headers, files=files, data=data)

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

print('PDF redacted successfully.')

Dieser Code führt die folgenden Schritte aus:

• Laden Sie das PDF: Die zu redigierende PDF-Datei wird aus dem lokalen Dateisystem geladen.
• Festlegen von Schwärzungsparametern: Geben Sie die Koordinaten an(X, Y)Breite, Höhe und spezifische Seite zum Schwärzen.
• API aufrufen: Der[POST]Die Redact Region API wird aufgerufen, indem die erforderlichen Parameter übergeben werden.

• Speichern Sie das Ergebnis: Die bearbeitete PDF wird als neue Datei gespeichert.

  Der angegebene Bereich ist wie unten gezeigt geschwärzt.