Filter pro Formular — Datensatz-Zugriff beschränken

Bei Formularen, die Adress- oder Immobilien-Datensätze laden oder bearbeiten (z.B. „Adresse bearbeiten", „Immobilie bearbeiten", „Daten ergänzen"), kann ein User theoretisch über Manipulation des UUID-Parameters in der URL beliebige Datensätze ansprechen, die der API-User in onOffice sehen darf. Der Filter pro Formular beschränkt das.

Wann wichtig?

Kritisch für öffentlich zugängliche Formulare, die Datensätze ändern:

Mieter-Selbstauskunft, die einen Adressdatensatz aktualisiert
Objekt-Übergabe-Formular, das in eine Immobilie schreibt
Rückmeldungs-Formulare an Eigentümer/Käufer
Daten-Korrektur-Formulare per E-Mail-Link

Ohne Filter könnte jemand mit der korrekten URL-Struktur (?address[ID]=<UUID>) jeden Datensatz im Account-Sichtbereich des API-Users laden — auch wenn er nichts damit zu tun hat.

Setup

1. In onOffice einen Filter anlegen

Filter sind ein onOffice-Standard-Feature: Modul Adressen / Immobilien → Filter-Verwaltung → neuer Filter.

Beispiel-Filter:

„Nur aktive Immobilien" (Status = aktiv)
„Nur Suchprofile aus Region X"
„Nur Adressen mit Kontaktart = Mieter"
„Nur Status > 5" (für Vermarktungs-Reife)

2. Filter im propform-Formular aktivieren

Im Form-Editor → Adress- oder Immobilien-Felder → Filtereinstellungen → den onOffice-Filter aus dem Dropdown auswählen.

3. Effekt

Das Formular kann jetzt nur Datensätze laden/bearbeiten, die im Filter sind. Versucht jemand, eine UUID außerhalb des Filters anzusprechen → Formular weist die Anfrage ab.

Best Practices

Filter so eng wie möglich: Nur Datensätze, die das spezifische Formular wirklich bearbeiten soll
Pro Formular eigener Filter: Verschiedene Formulare brauchen oft verschiedene Beschränkungen
Filter regelmäßig prüfen: Wenn neue Datensätze automatisch in den Filter rutschen sollen, müssen die Filter-Bedingungen entsprechend dynamisch sein
Testen: Mit einer UUID außerhalb des Filters versuchen, das Formular aufzurufen — sollte abgelehnt werden

Kombination mit anderen Schutz-Mechanismen

Filter pro Formular ist eine Daten-Schutz-Schicht, kein Zugriffs-Schutz für das Formular selbst. Ergänzend:

IP-Whitelist — wer darf das Formular überhaupt aufrufen
Formular-Passwort — Aufruf nur mit Passwort
Formularschlüssel via URL-Parameter — dynamischer Token-Schutz

Mehr dazu in der Formular-Schutz-Doku.

Verwandt

📖 Formular-Schutz — Übersicht aller Schutz-Mechanismen
📖 Mein Formular schreibt keine Daten — wenn der API-User Datensätze gar nicht erst sieht (Rechte-Probleme)