X-ERP Hilfe

03. API-Rechte und eigener Integrationsbenutzer

Trennen Sie die Integration von menschlichen Konten und vergeben Sie nur die API-Operationen, die der Datenfluss tatsächlich benötigt.

Ein gutes Integrationskonto erzählt seinen Zweck schon durch Name und Rolle – und lässt sich sperren, ohne einen Menschen aus X-ERP auszusperren.

Die Schnittstelle als Produkt

X-ERP trennt API-Rechte nach Controllern und Operationen wie Lesen, Erstellen, Ändern und Löschen. Diese Trennung begrenzt Fehlerwirkung und macht eine 403-Antwort zu einem wichtigen Sicherheitsbeweis.

So wird die Anbindung robust

  1. Legen Sie je Integration und Umgebung ein eigenes Konto an.
  2. Vergeben Sie eine eindeutige Rolle nach Controller und benötigter CRUD-Operation.
  3. Entziehen Sie UI-, Administrations- und Löschrechte, wenn sie nicht notwendig sind.
  4. Bewahren und rotieren Sie das Kennwort im Secret Store.
  5. Testen Sie erlaubte und ausdrücklich verbotene Aufrufe.
  6. Dokumentieren Sie Eigentümer, Zweck, Ablaufdatum und Notfallsperre.

Produktionsreife nachweisen

  • 403 erscheint bei einem bewusst verbotenen Test.
  • Konto ist keiner natürlichen Person zugeordnet.
  • Test- und Produktion verwenden getrennte Geheimnisse.
  • Sperren des Kontos beendet den Datenfluss kontrolliert.

Fehler, die erst im Betrieb teuer werden

  • Persönlicher Adminzugang wird in einem Dienst hinterlegt.
  • Mehrere Integrationen teilen ein Konto und sind nicht unterscheidbar.
  • Rechte wachsen über Jahre, weil alte Operationen nie entzogen werden.

Das nehmen Sie mit

Die Integration besitzt eine eng begrenzte, prüfbare Identität mit einem klaren Abschaltpunkt.

Weiterführender Link / Quelle

Weiterführende Themen

  1. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 02. Anmeldung und Sitzungscookie
  2. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 04. Endpunkte, Datenverträge und Antworten
  3. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 10. Test, Abnahme und Produktionsbetrieb

Häufige Fragen

**Was bedeutet HTTP 403?**

Die Sitzung ist bekannt, aber die konkrete Operation ist nicht erlaubt. Prüfen Sie Rolle und API-Recht – nicht das Kennwort.

**Braucht Lesen und Ändern dasselbe Recht?**

Nein. Die API-Berechtigungen können Operationen getrennt freigeben; vergeben Sie nur den tatsächlich benötigten Umfang.