Enterprise-Richtlinie

Pia liest beim Start %ProgramData%\Pia\policy.json. IT-Administratoren können damit Standardwerte setzen oder einzelne Einstellungen auf verwalteten Geräten sperren.

Dateispeicherort

C:\ProgramData\Pia\policy.json

Standardbenutzer können diesen Ordner lesen; nur Administratoren dürfen schreiben. Benutzer können die Datei nicht aus Pia heraus überschreiben.

Achtung

Pia lädt die Richtlinie nur einmal beim Start. Änderungen an policy.json greifen erst, nachdem der Benutzer Pia neu startet.

Dateiformat

policy.json hat zwei Abschnitte auf oberster Ebene, beide mit derselben Struktur wie Pias Benutzereinstellungen:

• defaults — wird angewendet, solange der Wert des Benutzers noch dem Pia-Standard entspricht. Hat der Benutzer eine Einstellung bereits geändert, überschreibt der Richtlinien-Default diese nicht.
• enforce — fest gesetzte Werte. Die zugehörigen Bedienelemente in Pias Einstellungs-UI werden deaktiviert, sodass der Benutzer sie nicht ändern kann. Erscheint eine Eigenschaft in beiden Abschnitten, gewinnt enforce.

Hinweis

Eine skalare Eigenschaft wirkt nur, wenn ihr Wert vom Pia-Standard abweicht. Beispiel: "theme": "System" in enforce ist wirkungslos, da System ohnehin der Standard ist. Um einen abweichenden Wert (etwa "Dark") festzuschreiben, setze ihn ausdrücklich.

Unterstützte Einstellungen

Alle Eigenschaftsnamen verwenden camelCase. Unbekannte Eigenschaften werden ignoriert. Ungültiges JSON wird als Warnung protokolliert und die Richtlinie wird nicht angewendet — schau ins Anwendungs-Log, falls eine Richtlinie nicht zu greifen scheint.

Eigenschaft	Typ	Standard	Beschreibung
theme	"System" | "Dark" | "Light"	"System"	UI-Design
uiLanguage	"EN" | "DE" | "FR"	"EN"	Sprache der Oberfläche
targetLanguage	"EN" | "DE" | "FR"	nicht gesetzt	Standard-Ausgabesprache für Optimize
targetSpeechLanguage	"Auto" | "EN" | "DE" | "FR"	"Auto"	Spracherkennungs-Sprache
defaultOutputAction	"CopyToClipboard" | "AutoType" | "PasteToPreviousWindow"	"CopyToClipboard"	Was nach Optimize passiert
autoTypeDelayMs	integer	10	AutoType-Verzögerung in Millisekunden
defaultTemplateId	GUID	nicht gesetzt	Standard-Optimierungsvorlage
whisperModel	"Tiny" | "Base" | "Small" | "Medium" | "Large"	"Base"	Whisper-Modellgröße
ttsEnabled	bool	false	Sprachsynthese aktivieren
ttsVoiceModelKey	string	"en_US-lessac-medium"	TTS-Stimmen-ID
startMinimized	bool	false	Minimiert in der Taskleiste starten
launchAtStartup	bool	true	Pia mit Windows starten
showTodoPanelButton	bool	true	Todo-Panel-Schaltfläche im Hauptfenster anzeigen
autoUpdateEnabled	bool	true	Automatische Aktualisierung beim Start zulassen
syncEnabled	bool	false	Pia Cloud Sync aktivieren
serverUrl	string	nicht gesetzt	Pia-Cloud-Server-URL (für Self-Hosting)
trustSelfSignedCertificates	bool	false	Selbstsignierte TLS-Zertifikate akzeptieren
useSameProviderForAllModes	bool	true	Einen AI-Provider für Optimize/Assistant/Research verwenden
modeProviderDefaults	object	{}	Zuordnung von Konversationsmodus zu AI-Provider-GUID
privacy	object	siehe unten	Datenschutzeinstellungen (verschachtelt)

privacy ist ein verschachteltes Objekt:

Eigenschaft	Typ	Standard	Beschreibung
tokenizationEnabled	bool	true	PII durch Tokens ersetzen, bevor Text an die KI gesendet wird

Beispiel

{
  "defaults": {
    "uiLanguage": "DE",
    "targetLanguage": "DE",
    "whisperModel": "Small"
  },
  "enforce": {
    "theme": "Dark",
    "serverUrl": "https://pia.corp.example.com",
    "syncEnabled": true
  }
}

In diesem Beispiel ist Deutsch die Startsprache, Benutzer können aber auf Englisch oder Französisch wechseln. Das Design ist auf Dark fixiert, Sync ist verpflichtend, und die Pia-Cloud-URL ist auf den selbst gehosteten Firmen-Server festgelegt.

Rollout

1. Lege oder bearbeite C:\ProgramData\Pia\policy.json auf jedem verwalteten Gerät an (z. B. über dein Endpoint-Management-System).
2. Validiere das JSON.
3. Lass die Benutzer Pia schließen und erneut öffnen.

Einstellungen unter enforce erscheinen in Pias Einstellungs-UI ausgegraut; Defaults erscheinen normal.