IronSecureDoc unter Windows mit C# hosten

Curtis Chau
Curtis Chau
Aktualisiert: 2. August 2026
IronSecureDoc on Docker

IronSecureDoc ist ein Docker-Container, der Ihnen leistungsstarke PDF-Manipulationsmöglichkeiten über eine einfache REST-API bietet, ohne den Aufwand und die Kosten von Online-SaaS-Diensten. Dieser Leitfaden führt Sie durch die Schritte zum Hosten von IronSecureDoc auf Ihrem Rechner, einschließlich der Einrichtung von Umgebungsvariablen und eines einfachen Beispiels für die Verwendung der REST-API. Für die vollständige API, sehen Sie sich unsere REST-API-Referenz an.

docker pull ironsoftwareofficial/ironsecuredoc:latest
SHELL

Voraussetzungen

Schritt-für-Schritt-Anleitung

1. Docker Desktop installieren

Falls Sie Docker Desktop noch nicht installiert haben, befolgen Sie diese Schritte:

  1. Gehen Sie zur Docker Desktop-Downloadseite.
  2. Laden Sie den Docker Desktop-Installer für Windows herunter.
  3. Starten Sie das Installationsprogramm und folgen Sie den Anweisungen auf dem Bildschirm.
  4. Starten Sie nach der Installation Docker Desktop und vergewissern Sie sich, dass es ausgeführt wird.

2. Laden Sie das Docker-Image „IronSecureDoc“ herunter.

Öffnen Sie eine Eingabeaufforderung und laden Sie das neueste IronSecureDoc-Image von Docker Hub herunter:

docker pull ironsoftwareofficial/ironsecuredoc:latest
SHELL

3. Container ohne Zertifikat ausführen

Starten Sie den Docker-Container mit den erforderlichen Umgebungsvariablen:

Swagger UI in Browser
docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest
SHELL

Testversion oder Lizenzschlüssel anwenden, um Wasserzeichen zu entfernen

Tipps: Ersetzen Sie <IRONSECUREDOC_LICENSE_KEY> durch Ihren tatsächlichen IronSecureDoc-Lizenzschlüssel. Andernfalls wird ein Wasserzeichen auf Enterprise Features angewendet.
Swagger UI in Browser

4. Zugriff auf den Container

Sobald der Container läuft, können Sie auf IronSecureDoc zugreifen, indem Sie einen Webbrowser öffnen und zu folgender Adresse navigieren:

http://localhost:8080/swagger/index.html
Text
Swagger UI in Browser

Sie sollten die IronSecureDoc-Oberfläche sehen, was darauf hinweist, dass Ihr Container erfolgreich ausgeführt wird.

5. Führen Sie den IronSecureDoc-Container mit Zertifikat aus.

Falls Sie den Container mit einem Zertifikat ausführen müssen, befolgen Sie diese Schritte, um das Zertifikat zu generieren und den lokalen Rechner zu konfigurieren:

  1. Zertifikat erzeugen:

    dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
    dotnet dev-certs https --trust
    SHELL

    Ersetzen Sie <CREDENTIAL_PLACEHOLDER> durch ein Passwort.

  2. Führen Sie den Docker-Container aus:

    docker container run -d -p 8081:8081 -p 8080:8080 -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Production -v %USERPROFILE%\.aspnet\https:/https:ro -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> ironsoftwareofficial/ironsecuredoc:latest
    SHELL

    Ersetzen Sie <IRONSECUREDOC_LICENSE_KEY> und <CERTIFICATE_PASSWORD> durch Ihren tatsächlichen IronSecureDoc-Lizenzschlüssel bzw. das Zertifikatspasswort.

6. Verwaltung des Containers

Sie können Ihren laufenden Container mithilfe von Docker-Befehlen verwalten. Hier sind einige nützliche Befehle:

  • Container stoppen:

    docker stop <container-id>
    SHELL
  • Container starten:

    docker start <container-id>
    SHELL
  • Container entfernen:

    docker rm -f <container-id>
    SHELL

Ersetzen Sie <container-id> durch die tatsächliche Container-ID oder den Namen.

Umgebungsvariablen

Der Container kann mithilfe der folgenden Umgebungsvariablen konfiguriert werden:

  • PDF_MAX_SIZE_MB (Standard: 30): Legt die maximale Dateigröße für PDF-Uploads in Megabyte fest.
  • REQUEST_TIMEOUT_SECONDS (Standard: 5): Legt die Zeitüberschreitungsdauer in Sekunden für API-Anfragen fest. Ein Wert von -1 erlaubt Anfragen, unbegrenzt zu laufen.
  • ALLOWED_ORIGINS: Konfiguriert Cross-Origin Resource Sharing (CORS), indem erlaubte Herkunfts-URLs angegeben werden. Mehrere URLs müssen durch Kommas getrennt werden. Verwenden Sie * oder all, um Anfragen von jeder Herkunft zuzulassen.
  • HTTP_PORTS: Definiert die HTTP-Ports, die der Container freigibt. Dies sollte mit der Port-Zuordnung unter Verwendung des -p-Flags übereinstimmen (z.B. 8080). Trennen Sie mehrere Ports mit einem Semikolon (;).
  • HTTPS_PORTS: Definiert die HTTPS-Ports, die der Container freigibt. Dies sollte mit der Port-Zuordnung unter Verwendung des -p-Flags übereinstimmen (z.B. 8081). Trennen Sie mehrere Ports mit einem Semikolon (;).
  • IronSecureDoc_LicenseKey (Erforderlich): Setzt den IronSecureDoc-Lizenzschlüssel. Wichtig: Geben Sie diesen Wert nicht öffentlich weiter.

Einfaches Beispiel: Text in einem Dokument schwärzen

Für die vollständige Liste der API-Endpunkte konsultieren Sie die vollständige REST API Referenz.

Text schwärzen

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'words_to_redact="sensitiveWord"' -F 'draw_black_box=true' -F 'match_whole_word=true' -F 'match_case=true'
SHELL

Ersetzen Sie /path/to/your/document.pdf durch den tatsächlichen Pfad zu dem Dokument, das Sie schwärzen möchten, und sensitiveWord durch das Wort, das Sie schwärzen möchten.

Regulären Ausdruck schwärzen

curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'regular_expression="[0-9]"' -F 'draw_black_box=true'
SHELL

Ersetzen Sie /path/to/your/document.pdf durch den tatsächlichen Pfad zu dem Dokument, das Sie schwärzen möchten, und [0-9] durch den regulären Ausdruck, den Sie finden und schwärzen möchten.

Abschluss

Sie haben IronSecureDoc erfolgreich auf Ihrem Rechner gehostet und mit den erforderlichen Umgebungsvariablen konfiguriert. Sie haben auch gelernt, wie Sie mit der IronSecureDoc REST API unter Verwendung von cURL sowohl einfache als auch fortgeschrittene Operationen durchführen. Für weitere Konfigurations- und Gebrauchshinweise konsultieren Sie die vollständige REST API Referenz.

Häufig gestellte Fragen

Was ist IronSecureDoc und warum sollte ich es verwenden?

IronSecureDoc ist ein Docker-Container, der für leistungsstarke PDF-Bearbeitung entwickelt wurde. Er bietet eine einfache REST-API und arbeitet offline, um die Dokumentensicherheit zu gewährleisten, ohne auf externe SaaS-Dienste zu vertrauen.

Wie installiere ich Docker Desktop auf Windows?

Um Docker Desktop auf Windows zu installieren, besuchen Sie die Docker Desktop-Downloadseite, laden Sie das Installationsprogramm herunter und folgen Sie den Bildschirmanweisungen, um die Installation abzuschließen.

Wie kann ich das neueste IronSecureDoc-Image von Docker Hub laden?

Sie können das neueste IronSecureDoc-Image laden, indem Sie ein Befehlszeilenfenster öffnen und den Befehl docker pull ironsoftwareofficial/IronSecureDoc:latest ausführen.

Wie führe ich den IronSecureDoc-Container auf meinem lokalen Computer aus?

Führen Sie den Container mit folgendem Befehl aus: docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> ironsoftwareofficial/ironsecuredoc:latest, wobei Sie <IRONSECUREDOC_LICENSE_KEY> durch Ihren tatsächlichen Lizenzschlüssel ersetzen.

Wie greife ich nach dem Start des Containers auf die Oberfläche von IronSecureDoc zu?

Sobald der Container läuft, greifen Sie auf IronSecureDoc zu, indem Sie im Webbrowser zu http://localhost:8080/swagger/index.html` navigieren.

Wie kann ich den IronSecureDoc-Container mit HTTPS ausführen?

Um den Container mit HTTPS auszuführen, erstellen Sie zunächst ein Zertifikat mit dem Befehl dotnet dev-certs https und führen Sie dann den Container mit Umgebungsvariablen für HTTP- und HTTPS-Ports, Zertifikatpfad und Passwort aus.

Was sind die wichtigsten Umgebungsvariablen zur Konfiguration von IronSecureDoc?

Wichtige Umgebungsvariablen umfassen PDF_MAX_SIZE_MB, REQUEST_TIMEOUT_SECONDS, HTTP_PORTS, HTTPS_PORTS und IronSecureDoc_LicenseKey. Diese steuern Einstellungen wie Dateigrößenlimits und Serverport-Konfigurationen.

Wie kann ich mit IronSecureDoc Text in einem PDF-Dokument schwärzen?

Verwenden Sie den cURL-Befehl: curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' mit passenden Formulardaten und Konfiguration, um bestimmte Wörter oder Muster in einem Dokument zu schwärzen.

Was sind die Docker-Befehle zur Verwaltung des IronSecureDoc-Containers?

Nützliche Docker-Befehle umfassen docker stop <container-id> zum Stoppen, docker start <container-id> zum Starten und docker rm -f <container-id> zum Entfernen des Containers.

Wo finde ich die vollständige API-Referenz für IronSecureDoc?

Die vollständige API-Referenz für IronSecureDoc ist auf der Website von Iron Software unter /enterprise/securedoc/tutorials/use-rest-api/ verfügbar.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

Version:2024.10gerade veröffentlicht