Zum Inhalt springen

PDF/A-Konvertierung mit Prüfnachweis

AnmeldenPilot anfragen

Schnellstart

Doconform in zehn Minuten testen.

Eine Testinstanz auf einem Linux-Host mit Docker Compose: ohne Datenbank, ohne TLS, nur für den ersten Eindruck. Für den Dauerbetrieb gilt das Betriebshandbuch.

Nach dem Betriebshandbuch 1.8.0

Was Sie brauchen

  • Linux-Host (amd64) mit mindestens 4 CPU und 12 GB RAM, Docker Engine ab 25 und Docker Compose ab 2.20.
  • Die Compose-Dateien aus dem Offline-Bundle. Das Betriebshandbuch steht nach der Anmeldung im Kundenportal unter Software.
  • Den Zugang zu unserer Registry oder das Offline-Bundle. Beides bekommen Sie zusammen mit der Testlizenz.
  • Optional eine Lizenzdatei. Die Testlizenz für 60 Tage holen Sie im Kundenportal; ohne Lizenz läuft Doconform im Evaluationsmodus.

Images bereitstellen

docker version --format '{{.Server.Version}}'   # mindestens 25
docker compose version                          # mindestens 2.20

# aus der Registry (Passwort aus dem Kundenportal in passwort.txt, nie auf der Kommandozeile)
docker login <registry-host> --username <benutzername> --password-stdin < passwort.txt
docker compose pull

# oder offline aus dem Bundle
for image in ../images/*.tar; do docker load -i "$image"; done
Im Verzeichnis compose/

Einstellungen und Secrets

Der API-Key bleibt beim aufrufenden Client; Doconform speichert nur seinen Hash.

cp .env.example .env
# Test ohne TLS: sonst scheitert die Anmeldung an der Konsole
echo 'PDFA_CONSOLE_SECURECOOKIE=false' >> .env

mkdir -p secrets/config && chmod 0700 secrets && chmod 0755 secrets/config
# API-Key: den Klartext bekommt nur der aufrufende Client, der Dienst kennt nur den Hash
KEY=$(openssl rand -base64 32); echo "Key fuer den Client: $KEY"
printf 'archiv=sha256:%s\n' "$(printf %s "$KEY" | sha256sum | cut -d' ' -f1)" > secrets/api-keys
# Passwort des Konsolen-Administrators "admin"
openssl rand -base64 18 | tee secrets/config/pdfa.console.admin.password
# Lizenz (optional)
cp /pfad/zur/lizenz.json secrets/config/pdfa.license.text
chmod 0644 secrets/api-keys secrets/config/*
Einstellungen, API-Key, Passwort der Konsole

Starten

Der Befehl kehrt zurück, wenn alle Dienste bereit sind. Der erste Start dauert etwa eine Minute.

docker compose up -d --wait
docker compose ps
Starten und Zustand ansehen

Erste Konvertierung

Das Ergebnis ist ein validiertes PDF/A. Die erreichte Stufe steht im Antwort-Header X-Pdfa-Level. Die Konsole unter http://127.0.0.1:8080/ zeigt den Lizenzstatus und konvertiert Dateien zur Probe.

curl -H @<(printf 'Authorization: Bearer %s\n' "$KEY") -F file=@brief.docx -o brief.pdf \
  http://127.0.0.1:8080/api/v1/convert
Eine Datei über die Schnittstelle konvertieren

Nächste Schritte

Für den Betrieb gehören ein TLS-Terminator, eine Datenbank, Virenscan, Sicherung und Updates dazu. Das Betriebshandbuch steht nach der Anmeldung im Kundenportal; Betrieb und Sicherheit im Überblick stehen unter Betrieb & Sicherheit.

60 Tage kostenlos testen

Jedes PDF/A geprüft. Jede Prüfung belegt.

Doconform

Doconform – PDF/A-Konvertierung mit Prüfnachweis. Ein Produkt der falbers IT Solutions.