2.14 Fehlersuche und Dokumentation von Schnittstellen

BeimAPIs Onboardingund erhältautomatisierte Workflows verbinden mehrere Systeme miteinander.

Tritt ein neuerFehler Mitarbeiterauf, diemuss benötigtengeprüft Benutzerkonten,werden:

Geräte,

Rollen
• welches System betroffen ist
• welcher Schritt fehlgeschlagen ist
• welche Daten übertragen wurden
• welcher Statuscode zurückgegeben wurde
• ob Authentifizierung und Zugriffsrechte.
  Berechtigungen korrekt sind
• welche Änderungen zuletzt durchgeführt wurden

BeimEine Offboardingstrukturierte werdenFehlersuche diesegrenzt Zugängedas kontrolliertProblem entzogen, Daten gesichert und Lizenzen freigegeben.

Beide Prozesse eignen sich gutSchritt für eineSchritt teilweiseein, Automatisierung.

anstatt

mehrere

OnboardingEinstellungen richtetgleichzeitig Zugängezu ein. Offboarding entfernt oder überträgt sie kontrolliert.verändern.

---

Lernziele

Nach dieser Seite solltest du erklären können:

• wie einAPI- automatisiertesund OnboardingWorkflow-Fehler aufgebautsystematisch ist
• welche Schritte beim Offboarding notwendig sind
• welche Systeme beteiligt sein können
• welche Daten benötigtuntersucht werden
• welche SchritteInformationen automatisiertfür werdendie dürfen
Fehlersuche
• wo Freigaben notwendigwichtig sind
• wie FehlerLogs und TeilerfolgeStatuscodes behandeltausgewertet werden
• welchewie SicherheitsregelnFehler geltenreproduziert werden
• was eine Schnittstellendokumentation enthalten sollte
• warum Änderungen dokumentiert werden müssen
• wie Störungen nachvollziehbar übergeben werden

---

BeteiligteFehler Systemezuerst eingrenzen

EinVor Onboarding-der technischen Analyse sollte geklärt werden:

• Was funktioniert nicht?
• Seit wann besteht der Fehler?
• Wer oder Offboarding-Prozesswas kannist mehrerebetroffen?
Systeme
• Tritt verbinden.der Fehler immer oder nur gelegentlich auf?
• Wurde vorher etwas verändert?
• Funktionieren andere Workflows oder Benutzer?
• Welche Fehlermeldung wird angezeigt?

Beispiel:

Beispiele:Der Workflow startet, aber der Benutzer wird nicht im Zielsystem angelegt.

Diese Beschreibung ist genauer als:

Die API funktioniert nicht.

---

Fehlerkategorien

SystemFehlerbereich	AufgabeBeispiel
PersonalsystemTrigger	liefertWebhook Mitarbeiterdatenstartet den Workflow nicht
n8nNetzwerk	steuertZielsystem dennicht Workflowerreichbar
Google WorkspaceDNS	E-Mail,Hostname Kalenderkann undnicht Benutzerkontoaufgelöst werden
SlackTLS	interneZertifikat Kommunikationwird nicht akzeptiert
Projektmanagement-SystemAuthentifizierung	AufgabenToken undfehlt Projekteoder ist abgelaufen
TicketsystemAutorisierung	Hardware-Berechtigung undoder SupportaufgabenScope fehlt
GeräteverwaltungRequest	LaptopMethode, undEndpoint Smartphoneoder Body ist falsch
CRM-SystemDaten	Zugriff für VertriebPflichtfeld oder KundenbetreuungDatentyp ist falsch
DokumentationZielsystem	ProtokollAPI undantwortet Anleitungenmit Serverfehler
Workflow-Logik	Bedingung oder Mapping ist falsch
Rate Limit	zu viele Anfragen
Timeout	Antwort dauert zu lange

---

BenötigteGrundregel Eingangsdatender Fehlersuche

TypischeEmpfohlene Onboarding-Daten:Reihenfolge:

{

"employeeId":
Trigger "EMP-105",prüfen
"firstName":
Eingangsdaten "Max",prüfen
"lastName":
Netzwerk "Mustermann",und "email":Erreichbarkeit "[email protected]",prüfen
"department":
Endpoint "IT",und "role":HTTP-Methode "ITprüfen
Support",
Authentifizierung "startDate":prüfen
"2026-08-03",
Berechtigungen "manager":prüfen
"Teamleitung
Request-Body IT"und }Header 

prüfen

Statuscode und Response auswerten

Workflow-Logik prüfen

letzte Änderungen kontrollieren

WichtigeVon Pflichtfelder:außen nach innen prüfen: Auslösung, Verbindung, Zugang, Daten und Verarbeitung.

---

Schritt 1: Trigger prüfen

Zu prüfen sind:

• eindeutigeIst Mitarbeiter-IDder Workflow aktiv?
• VornameWurde das Ereignis ausgelöst?
• NachnameIst die Webhook-URL korrekt?
• dienstlicheWird E-Mail-Adressedie richtige HTTP-Methode verwendet?
• AbteilungIst der Zeitplan korrekt?
• RolleIst die richtige Zeitzone eingestellt?
• Startdatum
Wurde
• zuständigedas FührungskraftEreignis als Duplikat abgelehnt?

---

Onboarding-Ablauf

Ein möglicher automatisierter Ablauf:Beispiel:

MitarbeiterWebhook freigegebenwurde nicht empfangen
          |
          v
WebhookQuellsystem anhat n8n
         |
         v
Daten validieren
         |
         v
doppelte Verarbeitung prüfen
         |
         v
Freigabe vorhanden?gesendet?
     /           \
   nein           ja
   |               |
   v               v
stoppenQuelle Kontoprüfen   anlegenEndpoint |
                 v
          Gruppen zuweisen
                 |
                 v
          Lizenzen vergeben
                 |
                 v
          IT-Aufgabe erstellen
                 |
                 v
          Slack informieren
                 |
                 v
          Ergebnis protokollierenprüfen

---

Schritt 1:2: TriggerEingangsdaten prüfen

DerZu Workflowprüfen startet beispielsweise durch:sind:

• WebhookSind ausalle demPflichtfelder Personalsystemvorhanden?
• neueSind ZeileFelder inleer eineroder Datenquellenull?
• freigegebenesStimmen Formulardie Datentypen?
• manuelleIst Ausführungdie JSON-Struktur korrekt?
• festgelegtenStimmen ZeitplanFeldnamen und Großschreibung?
• Enthalten Werte unerwartete Leerzeichen?
• Entsprechen die Daten der Dokumentation?

Beispielereignis:Beispiel:

Erwartet:

{
  "eventId"active": "evt-20015",
  "event": "employee.approved"true
}

Die Event-ID verhindert eine doppelte Verarbeitung.Empfangen:

---

{
  "active": "true"
}

SchrittDer 2:erste DatenWert validieren

ist

Vorein Boolean, der Verarbeitungzweite werdenein geprüft:

• Pflichtfelder vorhanden
• E-Mail-Adresse gültig
• Startdatum plausibel
• Abteilung bekannt
• Rolle erlaubt
• Mitarbeiter-ID eindeutig
• keine unerlaubten Sonderzeichen
• keine unnötigen Daten enthalten

Fehlerhafte Daten dürfen nicht automatisch weiterverarbeitet werden.String.

---

Schritt 3: Vorhandene KontenErreichbarkeit prüfen

VorMögliche demProbleme:

Anlegen

sollte
• DNS-Auflösung geprüftfehlerhaft
werden,
• Port obgeschlossen
bereits
• Firewall blockiert
• Proxy falsch konfiguriert
• Container oder Dienst gestoppt
• Zielsystem in Wartung
• TLS-Zertifikat ungültig

Wichtig:

Wird keine HTTP-Response empfangen, existiert auch kein HTTP-Statuscode.

Dann liegt möglicherweise ein KontoNetzwerk-, existiert.DNS-, TLS- oder Verbindungsfehler vor.

---

Schritt 4: Endpoint und HTTP-Methode prüfen

Beispiel:

GET /[email protected]users/15

Möglicheruft Ergebnisse:

einen

Ergebnis	Reaktion
kein Konto vorhanden	Benutzer anlegen
Konto vorhanden	Workflow stoppen oder prüfen
mehrere Treffer	manuelle Bearbeitung
API-Fehler	Fehlerpfad starten

Dadurch werden doppelte Benutzerkonten vermieden.

---

Schritt 4: Benutzerkonto anlegen

Beispiel:ab.

POST /users

legt einen neuen Benutzer an.

Typische Fehler:

• falsche API-Version
• falscher Ressourcenname
• Schreibfehler in der URL
• falsche Benutzer-ID
• GET statt POST
• PUT statt PATCH
• nicht unterstützte HTTP-Methode

Beispiel:

DELETE /users

Die API erlaubt möglicherweise nur:

DELETE /users/15

---

Schritt 5: Authentifizierung prüfen

Zu prüfen sind:

• Ist das Credential vorhanden?
• Ist das richtige Credential ausgewählt?
• Ist das Token gültig?
• Ist das Token abgelaufen?
• Wurde es widerrufen?
• Ist der Authorization-Header korrekt?
• Stimmen Client ID und Client Secret?

Beispiel:

Falsch:

Authorization: abc123

Möglicherweise erforderlich:

Authorization: Bearer abc123

Typischer Statuscode:

401 Unauthorized

---

Schritt 6: Autorisierung prüfen

Die Identität kann gültig sein, obwohl eine Aktion nicht erlaubt ist.

Zu prüfen sind:

• Rolle
• Gruppenmitgliedschaft
• API-Scopes
• Administratorfreigabe
• Zugriff auf die konkrete Ressource
• Least-Privilege-Konfiguration

Typischer Statuscode:

403 Forbidden

Merksatz:

401 bedeutet: Identität nicht bestätigt.
403 bedeutet: Identität bestätigt, aber Zugriff nicht erlaubt.

---

Schritt 7: Header und Request-Body prüfen

Typische Header:

Authorization: Bearer abc123
Content-Type: application/json
Accept: application/json

Typische Fehler:

• Content-Type fehlt
• falsches Datenformat
• JSON syntaktisch ungültig
• Pflichtfeld fehlt
• Feldname falsch
• falscher Datentyp
• Body besitzt falsche Verschachtelung

Beispiel:

{
  "name": "Max Mustermann",
  "department": "IT"
}

Die API erwartet möglicherweise:

{
  "user": {
    "name": "Max Mustermann",
    "email": "[email protected]",
  "department": "IT",
  "active": true}
}

Mögliche Response:

Status: 201 Created

{
  "id": 105,
  "email": "[email protected]"
}

Die neue Benutzer-ID sollte gespeichert werden.

---

Schritt 5:8: GruppenStatuscode und Rollen zuweisenauswerten

Die Abteilung kann bestimmen, welche Gruppen benötigt werden.

Beispiel:

AbteilungCode	GruppenTypische Prüfung
IT200	Mitarbeitende,erwartete IT-SupportDaten vorhanden?
Vertrieb201	Mitarbeitende,Ressource CRMtatsächlich erstellt?
Buchhaltung400	Mitarbeitende,Request Financeund Pflichtfelder prüfen
Projektmanagement401	Mitarbeitende,Token Projekteund Authentifizierung prüfen
403	Rolle und Scopes prüfen
404	Endpoint und ID prüfen
409	vorhandene Ressource prüfen
415	Content-Type prüfen
422	fachliche Daten prüfen
429	Rate Limit und Wartezeit prüfen
500	Zielsystem und Logs prüfen
502	Proxy oder nachgelagerten Dienst prüfen
503	Verfügbarkeit des Dienstes prüfen
504	Timeout und Antwortzeit prüfen

Beispielablauf:

Der

AbteilungStatuscode prüfensollte /immer |gemeinsam \
  IT   Vertrieb  Buchhaltung
  |       |          |
  v       v          v
IT-Gruppe CRM     Finance

Berechtigungen müssen nachmit dem Least-Privilege-PrinzipResponse-Body vergebenausgewertet werden.

---

SchrittResponse-Body 6: Lizenzen vergebenprüfen

MöglicheBeispiel:

Lizenzen:

Status: 400 Bad Request

{
  "error": "Missing required field",
  "field": "email"
}

Der Statuscode zeigt die allgemeine Fehlerklasse.

Der Response-Body nennt häufig:

• Googlegenaue WorkspaceUrsache
• Slackbetroffenes Feld
• Projektmanagement-Systeminterne Fehlerkennung
• CRM-SystemRequest-ID
• Office-Anwendungen
empfohlene
• VPN
• weitere Fachsoftware

Vor der Vergabe sollte geprüft werden:

• Wird die Lizenz wirklich benötigt?
• Welche Lizenzstufe ist erforderlich?
• Sind noch freie Lizenzen vorhanden?
• Ist die Lizenz kostenpflichtig?
• Muss eine Freigabe erfolgen?Maßnahme

---

SchrittLogs 7: Hardware-Aufgabe erstellenverwenden

EineLogs Aufgabekönnen kann automatisch im Ticketsystem angelegt werden.

Beispiel:

{
  "title": "Laptop für Max Mustermann vorbereiten",
  "department": "IT",
  "startDate": "2026-08-03",
  "priority": "normal"
}

Mögliche Teilaufgaben:zeigen:

• Laptop auswählen
• Betriebssystem aktualisieren
• Software installieren
• Festplattenverschlüsselung prüfen
• Geräteeigentümer eintragen
• MFA vorbereiten
• Übergabe dokumentieren

---

Schritt 8: Benachrichtigung senden

Nach erfolgreicher Vorbereitung kann eine Nachricht gesendet werden.

Beispiel:

Onboarding für Max Mustermann wurde vorbereitet.

Konto: erstellt
Gruppen: zugewiesen
Hardware-Aufgabe: erstellt
Startdatum: 03.08.2026

Die Nachricht darf keine Passwörter, Tokens oder vertraulichen Personaldaten enthalten.

---

Schritt 9: Ergebnis protokollieren

Protokolliert werden sollten:

• Mitarbeiter-ID
• Zeitpunkt
• ausgeführte Schritte
• erstellte Konten
• zugewiesene Gruppen
• vergebene Lizenzen
• fehlgeschlagene Schritte
• zuständige Person
• Workflow-Ausführung
• betroffene Node
• Eingangsdaten
• Ausgangsdaten
• Statuscode
• Fehlermeldung
• Anzahl der Versuche
• Ausführungsdauer

Beispiel:

Schritt	Ergebnis
Benutzerkonto	erfolgreich
IT-Gruppe	erfolgreich
Slack-Zugang	erfolgreich
Hardware-Ticket	erfolgreich
MFA	noch offen

---

Manuelle Freigaben

Nicht jeder Schritt sollte vollständig automatisch erfolgen.

Freigaben können sinnvoll sein bei:protokollieren:

• AdministratorrechtenPasswörter
• Zugriff auf Finanzsysteme
• Zugriff auf sensible Kundendaten
• teuren Softwarelizenzen
• besonderen Sicherheitsrollen
• externen Benutzerkonten
• privilegierten VPN-Zugängen

Beispiel:

Rolle "Administrator" angefordert
             |
             v
      Freigabe notwendig
        /          \
      nein          ja
       |             |
       v             v
    ablehnen      zuweisen

---

Offboarding

Ein Offboarding beginnt, wenn ein Mitarbeiter das Unternehmen verlässt oder keinen Zugriff mehr benötigt.

Typische Eingangsdaten:

{
  "employeeId": "EMP-105",
  "email": "[email protected]",
  "endDate": "2027-01-22",
  "manager": "Teamleitung IT"
}

---

Offboarding-Ablauf

Austritt freigegeben
        |
        v
Identität prüfen
        |
        v
Zeitpunkt festlegen
        |
        v
aktive Sitzungen beenden
        |
        v
Benutzerkonto sperren
        |
        v
Tokens widerrufen
        |
        v
Gruppen entfernen
        |
        v
Daten übertragen
        |
        v
Lizenzen freigeben
        |
        v
Geräte zurückfordern
        |
        v
Vorgang dokumentieren

---

Konto deaktivieren statt sofort löschen

Benutzerkonten sollten häufig zuerst deaktiviert werden.

Vorteile:

• Daten bleiben erhalten
• E-Mails können übertragen werden
• Audit-Logs bleiben nachvollziehbar
• Konto kann bei Fehlern wieder aktiviert werden
• Abhängigkeiten können geprüft werden

Beispiel:

PATCH /users/105

{
  "active": false
}

Eine endgültige Löschung kann später nach internen Regeln erfolgen.

---

Aktive Sitzungen beenden

Beim Offboarding sollten aktive Sitzungen beendet werden.

Dazu gehören:

• Browser-Sitzungen
• mobile Apps
• Desktop-Anwendungen
• VPN-Verbindungen
• gespeicherte Anmeldungen
• OAuth-Verbindungen

Nur das Passwort zu ändern reicht möglicherweise nicht aus.

---

Tokens und API-Zugänge widerrufen

Zu prüfen sind:

• API-Keys
• Bearer-Tokens
• Refresh Tokens
• persönlicheClient ZugriffstokensSecrets
• SSH-Schlüssel
vertrauliche
• VPN-Zertifikate
• App-PasswörterPersonaldaten

Persönliche Tokens dürfen nach dem Austritt nicht aktiv bleiben.

---

Datenübertragung

Fehler

Vor der Sperrung oder Löschung können Daten übertragen werden.

Beispiele:

• E-Mails an Führungskraft übertragen
• Dateien einem Team zuweisen
• Kalendertermine übergeben
• Projekte neu zuordnen
• offene Aufgaben übertragen
• persönliche Freigaben entfernen

Der Verantwortliche für die Datenübernahme muss festgelegt sein.

---

Lizenzen freigeben

Nach dem Offboarding können Lizenzen entfernt und erneut vergeben werden.

Beispiele:

• Google Workspace
• CRM
• Projektmanagement
• Office
• VPN
• Fachsoftware

Dadurch werden unnötige Kosten vermieden.

---

Geräte und Hardware

Zu prüfen sind:

• Laptop zurückgegeben
• Smartphone zurückgegeben
• Sicherheitsschlüssel zurückgegeben
• Zugangskarte deaktiviert
• lokale Daten gesichert
• Gerät zurückgesetzt
• Inventarsystem aktualisiert

Der Workflow kann dafür automatisch Aufgaben erstellen, die eigentliche Übergabe erfolgt jedoch manuell.

---

Zeitgesteuertes Offboardingreproduzieren

Ein Offboardingreproduzierbarer Fehler kann fürgezielt einenuntersucht bestimmtenwerden.

Dazu sollten festgehalten werden:

• genaue Eingabedaten
• verwendeter Endpoint
• HTTP-Methode
• Header
• Zeitpunkt
vorbereitet
• Statuscode
• Response
• betroffene API-Version
• vorherige Änderungen

Ein Test sollte möglichst erfolgen mit:

• Testkonto
• Testdaten
• Test-Endpoint
• ungefährlicher Ressource
• deaktivierten Löschaktionen

---

Einzelnen Schritt testen

Ein komplexer Workflow sollte in einzelne Schritte zerlegt werden.

Beispiel:

1. Webhook allein testen
2. JSON-Daten prüfen
3. API-Abfrage mit GET testen
4. Authentifizierung prüfen
5. POST mit Testdaten ausführen
6. Response auswerten
7. weitere Nodes einzeln hinzufügen

KontoErst amden letztenkleinsten Arbeitstagfehlerhaften umSchritt 18:00finden, Uhrdanach deaktivieren.den Gesamtworkflow prüfen.

---

DabeiLetzte müssenÄnderungen Zeitzone und Austrittszeitpunkt eindeutig sein.prüfen

KritischeViele ZugängeFehler könnenentstehen auchnach soforteiner gesperrtÄnderung.

werden,

Mögliche wenn:Änderungen:

• einneues Sicherheitsvorfall bestehtToken
• derneue Austritt kurzfristig erfolgtAPI-Version
• Missbrauchgeänderter vermutet wirdEndpoint
• eineneue ausdrücklicheRolle
Anweisung
• verändertes vorliegtDatenmapping
• aktualisierte Node
• geänderte Firewall-Regel
• neuer Proxy
• geänderte Umgebungsvariable
• Softwareupdate

Zu dokumentieren sind:

• Was wurde geändert?
• Wann wurde es geändert?
• Wer hat es geändert?
• Warum wurde es geändert?
• Wie wurde es getestet?
• Wie kann die Änderung zurückgenommen werden?

---

Teilerfolge behandelnSchnittstellendokumentation

Beispiel:Eine Schnittstellendokumentation beschreibt, wie zwei Systeme miteinander kommunizieren.

Sie sollte enthalten:

• Zweck der Schnittstelle
• beteiligte Systeme
• verantwortliche Personen
• Trigger
• Endpoints
• HTTP-Methoden
• Authentifizierungsverfahren
• benötigte Scopes
• Datenfelder
• Datenmapping
• Statuscodes
• Fehlerbehandlung
• Rate Limits
• Zeitpläne
• Logging
• Datenschutz
• Testverfahren
• Wiederherstellungsverfahren

---

Beispiel einer Kurzdokumentation

SchrittBereich	Inhalt
Name	Mitarbeiter-Onboarding
Zweck	Benutzerkonto automatisiert vorbereiten
Quellsystem	Personalsystem
Zielsystem	Google Workspace
Automatisierung	n8n
Trigger	Webhook
Methode	POST
Ressource	/users
Datenformat	JSON
Authentifizierung	OAuth 2.0
Berechtigung	Benutzer erstellen
Fehleralarm	Slack-Kanal #it-support
Verantwortlich	interne IT
Testsystem	separates Testkonto

---

Datenmapping dokumentieren

Quellfeld	Zielfeld	Pflicht	Beispiel
firstName	givenName	ja	Max
lastName	familyName	ja	Mustermann
mail	primaryEmail	ja	[email protected]
department	organization.department	ja	IT
startDate	custom.startDate	nein	2026-08-03

Dadurch ist nachvollziehbar:

• welches Feld woher stammt
• wie es im Zielsystem heißt
• ob es verpflichtend ist
• welches Format erwartet wird

---

Workflow dokumentieren

Ein Workflow sollte folgende Angaben besitzen:

• eindeutiger Name
• kurze Beschreibung
• verantwortliche Person
• verwendete Credentials
• Trigger
• Eingaben
• Verarbeitung
• Ausgaben
• Fehlerpfad
• Abhängigkeiten
• letzte Änderung

Guter Name:

Mitarbeiter-Onboarding – Google Workspace

Ungünstiger Name:

Workflow Kopie Neu Final 3

---

Node-Namen

Nodes sollten nach ihrer Funktion benannt werden.

Gut:

• Webhook – Mitarbeiter empfangen
• Pflichtfelder prüfen
• Benutzer nach E-Mail suchen
• Google-Benutzer anlegen
• Fehler an IT melden

Ungünstig:

• HTTP Request 4
• If 2
• Node Neu
• Test Final

---

Änderungsprotokoll

deaktiviert Fehlerpfad

Datum	Änderung	Verantwortlich	Ergebnis
Konto18.07.2026	API-Endpoint aktualisiert	interne IT	erfolgreich getestet
Sitzungen beendet19.07.2026	erfolgreichneues Scope ergänzt	Administration	Freigabe dokumentiert
Slack-Zugang entfernt20.07.2026	fehlgeschlagen
Datenübertragungerweitert	nochinterne offen
Lizenz entferntIT	nichtTest ausgeführterfolgreich

DerEin VorgangÄnderungsprotokoll isterleichtert nichtdie vollständigFehlersuche abgeschlossen.nach Updates.

---

Störungsdokumentation

DerEine Workflowgute sollte:Störungsmeldung enthält:

• fehlgeschlagenekurze Schritte markierenFehlerbeschreibung
• abhängigebetroffene Aktionen prüfenSysteme
• ITBeginn benachrichtigender Störung
• manuelle Aufgabe erstellenAuswirkung
• TeilerfolgStatuscode dokumentierenoder Fehlermeldung
• bereits geprüfte Schritte
• vorläufige Ursache
• aktuelle Gegenmaßnahme
• zuständige Person
• nächster Schritt

Beispiel:

Fehler:
Benutzer-Onboarding schlägt bei der Gruppenzuweisung fehl.

Auswirkung:
Benutzerkonto wird erstellt, Gruppe jedoch nicht zugewiesen.

Statuscode:
403 Forbidden

Bereits geprüft:
Token gültig, Endpoint erreichbar, Benutzer vorhanden.

Vermutete Ursache:
benötigter Scope für Gruppenverwaltung fehlt.

---

Priorisierung von Störungen

Priorität	Beispiel
niedrig	einzelner unkritischer Datensatz
mittel	mehrere Benutzer betroffen
hoch	wichtiger Geschäftsprozess ausgefallen
kritisch	Sicherheitsvorfall oder Datenverlust

Zu berücksichtigen sind:

• Anzahl betroffener Benutzer
• betriebliche Auswirkung
• Sicherheitsrisiko
• Datenverlust
• vorhandener Workaround
• zeitliche Dringlichkeit

---

FehlerbehandlungÜbergabe an andere Mitarbeiter

Eine Übergabe sollte enthalten:

• aktueller Stand
• Fehlerursache, falls bekannt
• getestete Maßnahmen
• offene Fragen
• betroffene Zugangsdaten oder Rollen
• relevante Logs
• sichere Wiederholungsmöglichkeit
• nächster empfohlener Schritt

Schlechte Übergabe:

Funktioniert nicht. Bitte prüfen.

Bessere Übergabe:

Der POST-Request an /users ist erfolgreich. Die anschließende Gruppenzuweisung antwortet mit 403. Token und Endpoint wurden geprüft. Vermutlich fehlt der Scope für Gruppenänderungen.

---

Wiederherstellung

Vor größeren Änderungen sollte bekannt sein:

• Gibt es ein Backup?
• Kann der Workflow exportiert werden?
• Kann eine alte Version wiederhergestellt werden?
• Können Credentials zurückgesetzt werden?
• Können bereits ausgeführte Änderungen rückgängig gemacht werden?
• Welche manuellen Schritte sind notwendig?

Mögliche Fehler:Maßnahmen:

• BenutzerWorkflow-Version nicht gefundensichern
• mehrereKonfiguration Benutzer mit gleicher E-Mailexportieren
• fehlendeTestlauf Berechtigungdurchführen
• APIRollback nicht erreichbardokumentieren
• Konto bereits deaktiviert
• Datenübertragung nicht möglich
• zuständige Führungskraft fehlt
• Lizenzsystem antwortet nicht

Behandlung:

Fehler erkannt
      |
      v
sicherheitskritisch?
   /         \
 ja           nein
 |             |
 v             v
sofort       Retry oder
eskalieren   Aufgabe erstellen

---

Rollback

Beim Onboarding kann ein Rollback sinnvoll sein.

Beispiel:

1. Konto wurde angelegt.
2. erforderliche Sicherheitsgruppe konnte nicht zugewiesen werden.
3. Konto wird vorsorglich deaktiviert.
4. IT erhält eine Fehlermeldung.

Beim Offboarding ist ein vollständiger Rollback häufig schwieriger.

Deshalb sollten kritische Schritte gut dokumentiert und möglichst reversibel sein.

---

Sicherheitsregeln

• Service Account verwenden
• nur notwendige Scopes vergeben
• keine Passwörter in Logs speichern
• Webhook authentifizieren
• Event-ID prüfen
• Eingabedaten validieren
• Administratorrechte nur nach Freigabe
• Test- und Produktivsysteme trennen
• sensible Daten minimieren
• alle wichtigen Änderungen protokollierenschrittweise veröffentlichen

---

PraxisablaufPraxisbeispiel: OnboardingFehlerhafte Benutzeranlage

Fehler:

POST /users

Status: 409 Conflict

{
  "error": "Email already exists"
}

Systematische Prüfung:

1. PersonalsystemResponse sendetwurde Webhook.empfangen.
2. SignaturEndpoint und Event-IDMethode werdensind geprüft.korrekt.
3. PflichtfelderAuthentifizierung werdenist validiert.gültig.
4. VorhandenesE-Mail-Adresse existiert bereits.
5. vorhandenes Konto wird mit GET gesucht.
6. BenutzerkontoDatensatz wird nicht erneut angelegt.
7. GruppenWorkflow werdenerstellt anhandeine dermanuelle Abteilung zugewiesen.
8. notwendige Lizenzen werden vergeben.
9. Hardware-Ticket wird erstellt.
10. IT wird benachrichtigt.Prüfaufgabe.
11. Ergebnis wird protokolliert.
12. offene Schritte werden markiert.

---

PraxisablaufPraxisbeispiel: OffboardingWorkflow startet nicht

Prüfung:

1. AustrittWorkflow wird freigegeben.aktiv?
2. BenutzerkontoWebhook-URL wird eindeutig identifiziert.korrekt?
3. ZeitpunktTest- deroder SperrungProduktiv-URL wird geprüft.verwendet?
4. SitzungenQuellsystem sendet tatsächlich?
5. Firewall oder Proxy blockiert?
6. richtige HTTP-Methode?
7. Authentifizierung gültig?
8. Trigger-Log vorhanden?

Mögliche Ursache:

Im Quellsystem wurde noch die Test-Webhook-URL verwendet.

---

Praxisbeispiel: 403 Forbidden

Prüfung:

1. Token vorhanden
2. Token gültig
3. Benutzer authentifiziert
4. benötigte Rolle prüfen
5. API-Scope prüfen
6. Ressourcenzugriff prüfen
7. Administratorfreigabe prüfen

Mögliche Lösung:

Fehlenden Scope ergänzen und Tokensnur werdendie widerrufen.notwendige

KontoBerechtigung wirdfreigeben.

deaktiviert.

Gruppen und Rollen werden entfernt.

Daten und Aufgaben werden übertragen.

Lizenzen werden freigegeben.

Geräteaufgabe wird erstellt.

Abschluss wird dokumentiert.

offene Punkte werden eskaliert.

---

Systematische Fehlersuche

WennBei eineiner Onboardinggestörten oder Offboarding fehlschlägt:Schnittstelle:

1. WurdeProblem dergenau richtige Trigger ausgelöst?beschreiben
2. Istbetroffene dieSysteme Event-ID eindeutig?bestimmen
3. SindTrigger alle Pflichtfelder vorhanden?prüfen
4. IstEingangsdaten der Benutzer eindeutig identifizierbar?prüfen
5. ExistiertErreichbarkeit bereits ein Konto?prüfen
6. SindEndpoint dieund CredentialsMethode gültig?kontrollieren
7. BesitztAuthentifizierung der Service Account ausreichende Rechte?prüfen
8. WelcheAutorisierung Node ist fehlgeschlagen?prüfen
9. WelcherHeader Statuscodeund wurdeBody zurückgegeben?prüfen
10. WelcheStatuscode Schritte waren bereits erfolgreich?auswerten
11. BestehtResponse-Body ein Sicherheitsrisiko?lesen
12. IstLogs ein Retry gefahrlos möglich?kontrollieren
13. Mussletzte dasÄnderungen Konto vorsorglich deaktiviert werden?prüfen
14. WelcheFehler manuellemit AufgabeTestdaten mussreproduzieren
erstellt
15. Lösung werden?testen und dokumentieren

---

Wichtige Begriffe

seiner

Begriff	Bedeutung
OnboardingFehlereingrenzung	technischeProblem EinrichtungSchritt einesfür MitarbeitersSchritt lokalisieren
OffboardingReproduktion	kontrollierterFehler Entzugunter vongleichen ZugängenBedingungen erneut auslösen
Event-IDSchnittstellendokumentation	eindeutigeBeschreibung Kennungder einesKommunikation Ereignisseszwischen Systemen
Service AccountDatenmapping	technischerZuordnung Benutzervon fürQuell- Automatisierungenund Zielfeldern
FreigabeÄnderungsprotokoll	bestätigteDokumentation Erlaubnistechnischer für eine AktionÄnderungen
DeaktivierungStörungsdokumentation	ZugangBeschreibung sperren,eines DatenFehlers zunächstund erhalten
Datenübertragung	Übergabe von Dateien, E-Mails oder Aufgaben
Teilerfolg	nur ein Teil des Prozesses war erfolgreichBearbeitung
Rollback	bereitsÄnderung ausgeführteauf Änderungenvorherigen Stand zurücknehmencksetzen
InventarsystemWorkaround	verwaltetvorläufige GeräteUmgehung eines Fehlers
Priorität	Dringlichkeit und EigentümerAuswirkung einer Störung
Übergabe	strukturierte Weitergabe an eine andere Person

---

Gesamtmerksatz

EinBei automatisiertesder OnboardingFehlersuche legtwerden Benutzerkonten,Trigger, Gruppen,Daten, LizenzenVerbindung, Endpoint, Authentifizierung, Berechtigungen und AufgabenResponse nachnacheinander festgelegtengeprüft. RegelnEine an.vollständige BeimDokumentation Offboardingbeschreibt Systeme, Datenmapping, Rechte, Fehlerbehandlung und Änderungen, damit Schnittstellen dauerhaft nachvollziehbar betrieben werden Sitzungen, Tokens, Rollen und Zugänge kontrolliert entfernt, Daten übertragen und Lizenzen freigegeben. Kritische Rechte benötigen Freigaben und jeder Schritt muss nachvollziehbar protokolliert werden.können.

---

Kontrollfragen

Was istsollte Onboarding?zuerst geprüft werden, wenn ein Workflow nicht startet?

DieTrigger, technische Einrichtung eines neuen Mitarbeiters.

Was ist Offboarding?

Der kontrollierte Entzug von Konten, RechtenAktivierungsstatus und ZugängenEingang beimdes Austritt.

auslösenden

Warum sollte vor dem Anlegen eines Kontos gesucht werden?

Damit kein doppeltes Benutzerkonto entsteht.

Warum wird ein Konto häufig zunächst deaktiviert statt gelöscht?

Damit Daten, Protokolle und Abhängigkeiten erhalten bleiben.

Welche Schritte benötigen häufig eine manuelle Freigabe?

Administratorrechte, sensible Datenzugriffe und kostenintensive Lizenzen.Ereignisses.

Warum müssen aktiveStatuscode Sitzungenund beendetResponse-Body gemeinsam geprüft werden?

WeilDer einStatuscode Benutzerzeigt trotzdie Passwortänderungallgemeine nochFehlerklasse, angemeldetwährend seinder könnte.Response-Body häufig die genaue Ursache nennt.

Was mussbedeutet mitFehler persönlichen API-Tokens geschehen?reproduzieren?

SieDer müssenFehler widerrufenwird werden.unter bekannten Bedingungen gezielt erneut ausgelöst.

Was gehört in eine Schnittstellendokumentation?

Beteiligte Systeme, Endpoints, Methoden, Authentifizierung, Datenmapping, Fehlerbehandlung und Verantwortlichkeiten.

Warum ist ein Änderungsprotokoll wichtig?

Damit Fehler mit vorherigen technischen Änderungen in Verbindung gebracht werden können.

Was ist ein Teilerfolg?Workaround?

EinigeEine Schrittevorläufige wurdenLösung, erfolgreichdie ausgeführt,das andereProblem sindumgeht, fehlgeschlagen.ohne die eigentliche Ursache vollständig zu beheben.

Warum istsollten dieNodes Event-IDverständliche wichtig?Namen besitzen?

SieDamit verhindertAufbau, Fehlerstelle und Aufgabe des Workflows schneller erkannt werden.

Was sollte eine doppeltegute VerarbeitungStörungsübergabe desselbenenthalten?

Vorgangs.

Fehlerbeschreibung, Auswirkung, geprüfte Schritte, Logs, vermutete Ursache und nächsten Schritt.

Warum dürfensollte Passwörtereine nichtAPI immit Workflow-LogTestdaten stehen?geprüft werden?

WeilDamit Logsdie sonstFehlersuche selbstkeine zuunbeabsichtigten einemÄnderungen Sicherheitsrisikoan werden.Produktivdaten verursacht.

Was ist die wichtigste Grundregel der Fehlersuche?

Nur eine Ursache beziehungsweise Änderung nach der anderen prüfen und die Ergebnisse dokumentieren.

---

Quellen

• NISTIETF – LeastHTTP PrivilegeSemantics
• OWASPMDN Web Docs – Authorization Cheat Sheet
• OWASP – Secrets Management Cheat SheetHTTP-Statuscodes
• n8n-Dokumentation – WorkflowsExecutions
• n8n-Dokumentation – Error Handling
• OWASP – Logging Cheat Sheet
• BSI – IT-Grundschutz