PDF-Berechtigungen für Druck, Kopie und Bearbeitung festlegen
Die Prüfung für PDF-Berechtigungen verwandelt eine übermittelte Liste von Zugriffsoptionen in einen eindeutigen Berechtigungssatz.
Im Browser ausführen – kostenlos
Läuft direkt in Ihrem Browser – kostenlos. Ihre Datei verlässt Ihren Browser nicht und wird an keinen Server übertragen.
Geben Sie eine PDF-Referenz und eine beliebige Kombination aus print, copy, edit und annotate an. Das Ergebnis verwendet kanonische Namen in Kleinschreibung, entfernt Duplikate und folgt einer festen Reihenfolge. Enthält die Liste einen nicht unterstützten Namen, schlägt die Anfrage verständlich fehl, statt eine mehrdeutige Richtlinie an den nächsten Schritt Ihres Dokumentenablaufs weiterzugeben. So bleiben automatisierte Konfigurationen einheitlich und nachvollziehbar.
Legen Sie die Richtlinie vor der Dokumentänderung fest
Abläufe zur PDF-Sicherheit beginnen häufig mit einem kleinen Konfigurationsobjekt, lange bevor eine Verschlüsselungsbibliothek oder ein Dokumentendienst die Datei verarbeitet. Diese Konfiguration muss ebenso sorgfältig geprüft werden wie das Dokument. Eine falsch geschriebene Option wie „printing“ könnte andernfalls übergangen, von verschiedenen Bibliotheken unterschiedlich ausgelegt oder fälschlich als gültig gespeichert werden. Diese Fähigkeit schafft an dieser Schnittstelle einen klaren Vertrag. Senden Sie die PDF-Referenz zusammen mit den Namen der Berechtigungen, die Sie erteilen möchten. Die Prüfung bestätigt, dass die Referenz vorhanden ist und permissions ein Array ausschließlich aus print, copy, edit und annotate enthält. Anschließend werden die akzeptierten Namen in kanonischer Reihenfolge zurückgegeben. Die PDF wird weder heruntergeladen noch untersucht, verschlüsselt oder neu geschrieben. Durch die getrennte Prüfung lässt sich das Ergebnis sicher an einen späteren Schutzschritt, eine Richtliniendatenbank, eine Freigabeansicht oder ein Prüfprotokoll übergeben. Außerdem kann eine Anwendung eine fehlerhafte Auswahl sofort ablehnen, bevor ein langsamerer oder teurerer Dokumentvorgang startet.
Wie die Normalisierung ein stabiles Ergebnis erzeugt
Berechtigungslisten stammen oft aus Kontrollkästchen, Kommandozeilenargumenten, importierten Einstellungen oder zusammengeführten Regeln. Dabei können unterschiedliche Großschreibung, umgebende Leerzeichen, wiederholte Werte und wechselnde Reihenfolgen entstehen. Die Normalisierung entfernt Leerraum an beiden Enden und wandelt jeden Namen in Kleinschreibung um, bevor er mit dem zulässigen Wortschatz verglichen wird. Duplikate werden zu einem Eintrag zusammengeführt, da Berechtigungen eine Menge und keine Befehlsfolge darstellen. Die Ausgabe lautet stets print, copy, edit und annotate, unabhängig von der Eingabereihenfolge. Ein leeres Array ist gültig und beschreibt eine Richtlinie, die keine dieser vier Berechtigungen erteilt. Ein Wert, der keine Zeichenfolge ist, oder ein unbekannter Name führt zu einem Fehler für die gesamte Anfrage; die Anwendung verwirft niemals stillschweigend eine unbekannte Option. Dieses Alles-oder-nichts-Verhalten schützt die beabsichtigte Sicherheitsrichtlinie. Die deterministische Ausgabe lässt sich zudem leicht vergleichen, speichern, signieren, prüfen und testen.
Nutzen Sie den normalisierten Satz im vollständigen PDF-Ablauf
Das zurückgegebene Array beschreibt eine geprüfte Richtlinie und ist kein verändertes Dokument. Übergeben Sie es an die Komponente, die Verschlüsselung oder Eigentümerbeschränkungen tatsächlich anwendet, und prüfen Sie deren Dokumentation zum genauen Verhalten von Leseprogrammen und Betriebssystemen. PDF-Berechtigungen sind im Allgemeinen hinweisende Kontrollen, die konforme Software durchsetzt; sie ersetzen weder Zugriffsschutz noch eine umsichtige Verteilung oder Verschlüsselung mit einem geeigneten Kennwort. Die Trennung von Prüfung und Durchsetzung bietet dennoch praktische Vorteile. Ein Webformular kann vor dem Absenden eine klare Zusammenfassung zeigen, eine API kann eine einheitliche Darstellung statt vieler gleichwertiger Arrays speichern und ein Stapelauftrag kann beim ersten unbekannten Namen stoppen. Da diese Fähigkeit keinen Netzwerkdienst verwendet und die angegebene PDF nicht dekodiert, liefert sie im Browser dasselbe deterministische Ergebnis wie über die API. Die Browsernutzung ist kostenlos; automatisierte API-Anfragen verwenden den veröffentlichten Grundpreis von $0.002. Dokumentinhalte werden von dieser Prüfung weder zurückgegeben noch gespeichert.
Anwendungsfälle
Ein Berechtigungsformular prüfen
Normalisieren Sie Kontrollkästchenwerte vor einem PDF-Schutzauftrag und zeigen Sie den exakt akzeptierten Berechtigungssatz an.
Gespeicherte Dokumentrichtlinien vereinheitlichen
Entfernen Sie Duplikate und Reihenfolgeunterschiede, bevor Sie Berechtigungen in einer Datenbank oder einem Prüfprotokoll speichern.
Unsichere Konfigurationsfehler ablehnen
Stoppen Sie einen Stapelablauf, wenn eine Integration einen unbekannten Namen sendet, statt ihn unbemerkt zu übergehen.
Häufige Fragen
Verändert oder verschlüsselt diese Fähigkeit die PDF?
Nein. Sie prüft die PDF-Referenz und Berechtigungsnamen und gibt einen normalisierten Satz zurück, den Sie mit einem eigenen PDF-Schutzwerkzeug anwenden.
Welche Berechtigungen werden unterstützt?
Die unterstützten kanonischen Namen lauten print, copy, edit und annotate.
Was geschieht bei einem unbekannten Namen?
Die Anfrage schlägt mit einem Fehler für ungültige Eingaben fehl, der den unbekannten Wert und die zulässigen Optionen nennt.
Sind Duplikate und Großbuchstaben zulässig?
Ja. Äußerer Leerraum wird entfernt, Namen werden kleingeschrieben und wiederholte Berechtigungen zusammengeführt.
Kann ich eine leere Berechtigungsliste angeben?
Ja. Ein leeres Array bleibt leer und bedeutet, dass keine der vier unterstützten Berechtigungen erteilt wird.
Wie hoch sind die Kosten?
Die Ausführung im Browser auf dieser Seite ist kostenlos. Die Automatisierung per API kostet $0.002 je Anfrage.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/pdf/permissions-set \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdf":"kit://upl_example_pdf","permissions":["print","copy"]}'const res = await fetch("https://api.kit.forhosting.com/pdf/permissions-set", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "kit://upl_example_pdf",
"permissions": [
"print",
"copy"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/permissions-set",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "kit://upl_example_pdf",
"permissions": [
"print",
"copy"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/permissions-set", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"kit://upl_example_pdf","permissions":["print","copy"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"kit://upl_example_pdf","permissions":["print","copy"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/permissions-set", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"pdf": "kit://upl_example_pdf",
"permissions": [
"print",
"copy"
]
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.permissions_set",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_mb | 25 |
max_pages | 200 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |