Seminar Lansweeper – API, Webhooks und Integrationsentwicklung

Robuste Integrationen benötigen stabile Abfragen, sichere technische Identitäten, belastbares Datenmapping, kontrollierte Wiederholungen und aussagekräftiges Monitoring.

Inhaltsübersicht

1. Integrationsarchitektur und Anwendungsfälle
2. Authentisierung und Geheimnisverwaltung
3. Datenmodell und GraphQL
4. Filter, Pagination und Batching
5. Mapping und Identitätsauflösung
6. Webhooks und Ereignisverarbeitung
7. Bulk Export und analytische Datenflüsse
8. Fehlerbehandlung und Wiederholung
9. Tests und Vertragssicherheit
10. Monitoring und Betriebsübergabe

Zielsetzung

Nach Abschluss können lesende Integrationen und ereignisgesteuerte Datenflüsse entworfen, implementiert, getestet, abgesichert und produktionsreif dokumentiert werden.

Zielgruppe

Softwareentwicklung, Integration Engineering, DevOps, Datenplattformteams, CMDB-Verantwortliche und technische Beratung.

Voraussetzungen

Grundkenntnisse zu HTTP, JSON, Authentisierung und einer Skript- oder Programmiersprache. Kenntnisse von GraphQL sind hilfreich, aber nicht erforderlich.

Seminarinhalte

Die Inhalte werden kapitelweise aufgebaut. Jede Einheit enthält eine eigene Inhaltsübersicht, eine klar definierte Umsetzungskette, Prüfungen und eine dokumentierte Praxisaufgabe.

Kapitel 1: Integrationsarchitektur und Anwendungsfälle

Inhaltsverzeichnis des Kapitels:

1. Quell- und Zielsysteme
2. Datenhoheit
3. Vollabzug, Delta und Ereignis
4. nichtfunktionale Ziele

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Integrationsarchitektur und Anwendungsfälle“ werden erfasst. Dabei werden insbesondere Quell- und Zielsysteme und Datenhoheit eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Vollabzug, Delta und Ereignis, nichtfunktionale Ziele sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Datenhoheit, Vollabzug, Delta und Ereignis, nichtfunktionale Ziele, Integrationsarchitektur und Anwendungsfälle, Integrationsarchitektur und Anwendungsfälle. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen nichtfunktionale Ziele, Integrationsarchitektur und Anwendungsfälle, Integrationsarchitektur und Anwendungsfälle; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein Integrationssteckbrief mit Datenfluss, Eigentümer und Qualitätszielen. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 2: Authentisierung und Geheimnisverwaltung

Inhaltsverzeichnis des Kapitels:

1. technische Identitäten
2. Minimalrechte
3. Asset Scope
4. Rotation und Widerruf

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Authentisierung und Geheimnisverwaltung“ werden erfasst. Dabei werden insbesondere technische Identitäten und Minimalrechte eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Asset Scope, Rotation und Widerruf sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Minimalrechte, Asset Scope, Rotation und Widerruf, Authentisierung und Geheimnisverwaltung, Authentisierung und Geheimnisverwaltung. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Rotation und Widerruf, Authentisierung und Geheimnisverwaltung, Authentisierung und Geheimnisverwaltung; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein produktionsfähiges Geheimnis- und Zugriffsmodell. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 3: Datenmodell und GraphQL

Inhaltsverzeichnis des Kapitels:

1. Schema
2. Objekte und Relationen
3. selektierte Felder
4. Variablen und Teilfehler

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Datenmodell und GraphQL“ werden erfasst. Dabei werden insbesondere Schema und Objekte und Relationen eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören selektierte Felder, Variablen und Teilfehler sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Objekte und Relationen, selektierte Felder, Variablen und Teilfehler, Datenmodell und GraphQL, Datenmodell und GraphQL. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Variablen und Teilfehler, Datenmodell und GraphQL, Datenmodell und GraphQL; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Eine kleine parametrische Abfrage mit nachvollziehbarer Antwortverarbeitung. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 4: Filter, Pagination und Batching

Inhaltsverzeichnis des Kapitels:

1. fachliche Filter
2. Cursor oder Seiten
3. Batchgrößen
4. Checkpoints

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Filter, Pagination und Batching“ werden erfasst. Dabei werden insbesondere fachliche Filter und Cursor oder Seiten eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Batchgrößen, Checkpoints sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Cursor oder Seiten, Batchgrößen, Checkpoints, Filter, Pagination und Batching, Filter, Pagination und Batching. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Checkpoints, Filter, Pagination und Batching, Filter, Pagination und Batching; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein vollständiger, duplikatfreier und wiederanlauffähiger Bestandsabruf. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 5: Mapping und Identitätsauflösung

Inhaltsverzeichnis des Kapitels:

1. Zielschlüssel
2. Datentypen
3. Wertetransformation
4. Konfliktregeln

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Mapping und Identitätsauflösung“ werden erfasst. Dabei werden insbesondere Zielschlüssel und Datentypen eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Wertetransformation, Konfliktregeln sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Datentypen, Wertetransformation, Konfliktregeln, Mapping und Identitätsauflösung, Mapping und Identitätsauflösung. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Konfliktregeln, Mapping und Identitätsauflösung, Mapping und Identitätsauflösung; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Eine versionierte Mappingtabelle für mehrere Asset-Typen. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 6: Webhooks und Ereignisverarbeitung

Inhaltsverzeichnis des Kapitels:

1. relevante Ereignisse
2. Empfangsschutz
3. Entkopplung
4. Idempotenz

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Webhooks und Ereignisverarbeitung“ werden erfasst. Dabei werden insbesondere relevante Ereignisse und Empfangsschutz eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Entkopplung, Idempotenz sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Empfangsschutz, Entkopplung, Idempotenz, Webhooks und Ereignisverarbeitung, Webhooks und Ereignisverarbeitung. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Idempotenz, Webhooks und Ereignisverarbeitung, Webhooks und Ereignisverarbeitung; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein verifizierter Ereignisfluss ohne Doppelverarbeitung. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 7: Bulk Export und analytische Datenflüsse

Inhaltsverzeichnis des Kapitels:

1. Voll- und Deltaexport
2. Schema und Prüfsumme
3. Data Lake oder BI
4. Aufbewahrung

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Bulk Export und analytische Datenflüsse“ werden erfasst. Dabei werden insbesondere Voll- und Deltaexport und Schema und Prüfsumme eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Data Lake oder BI, Aufbewahrung sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Schema und Prüfsumme, Data Lake oder BI, Aufbewahrung, Bulk Export und analytische Datenflüsse, Bulk Export und analytische Datenflüsse. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Aufbewahrung, Bulk Export und analytische Datenflüsse, Bulk Export und analytische Datenflüsse; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein kontrollierter periodischer Export mit Qualitätsprüfung. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 8: Fehlerbehandlung und Wiederholung

Inhaltsverzeichnis des Kapitels:

1. Fehlerklassen
2. Backoff
3. Dead-Letter-Verarbeitung
4. Teilresultate

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Fehlerbehandlung und Wiederholung“ werden erfasst. Dabei werden insbesondere Fehlerklassen und Backoff eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Dead-Letter-Verarbeitung, Teilresultate sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Backoff, Dead-Letter-Verarbeitung, Teilresultate, Fehlerbehandlung und Wiederholung, Fehlerbehandlung und Wiederholung. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Teilresultate, Fehlerbehandlung und Wiederholung, Fehlerbehandlung und Wiederholung; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein Störungslauf mit begrenzten Wiederholungen und sicherem Wiederanlauf. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 9: Tests und Vertragssicherheit

Inhaltsverzeichnis des Kapitels:

1. Normal- und Grenzfälle
2. Rechtefehler
3. Schema- und Vertragstests
4. Regression

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Tests und Vertragssicherheit“ werden erfasst. Dabei werden insbesondere Normal- und Grenzfälle und Rechtefehler eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Schema- und Vertragstests, Regression sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Rechtefehler, Schema- und Vertragstests, Regression, Tests und Vertragssicherheit, Tests und Vertragssicherheit. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Regression, Tests und Vertragssicherheit, Tests und Vertragssicherheit; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Ein automatisierbarer Abnahmekatalog für die Integration. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Kapitel 10: Monitoring und Betriebsübergabe

Inhaltsverzeichnis des Kapitels:

1. Laufzeit und Mengen
2. Fehler und Rückstand
3. Alarmierung
4. Runbook und Rückfall

1. Schritt 1: Ausgangslage, fachlicher Zweck und Abnahmekriterien für „Monitoring und Betriebsübergabe“ werden erfasst. Dabei werden insbesondere Laufzeit und Mengen und Fehler und Rückstand eindeutig abgegrenzt.
2. Schritt 2: Technische und organisatorische Voraussetzungen werden geprüft. Dazu gehören Alarmierung, Runbook und Rückfall sowie die erforderlichen Rollen, Zugriffe, Daten und Sicherheitsfreigaben.
3. Schritt 3: Die Umsetzung erfolgt in einer dokumentierten Reihenfolge: Fehler und Rückstand, Alarmierung, Runbook und Rückfall, Monitoring und Betriebsübergabe, Monitoring und Betriebsübergabe. Jede Änderung wird zunächst in einem kontrollierten Bereich ausgeführt.
4. Schritt 4: Das Ergebnis wird mit Positiv-, Negativ- und Grenzfällen validiert. Als konkrete Prüfpunkte dienen Runbook und Rückfall, Monitoring und Betriebsübergabe, Monitoring und Betriebsübergabe; Abweichungen werden reproduzierbar dokumentiert.
5. Schritt 5: Für den Regelbetrieb werden Verantwortlichkeit, Sollwerte, Kontrollintervall, Änderungsverfahren, Rückfallmöglichkeit und Eskalationsweg festgelegt.

Praxisübung: Eine produktionsnahe Übergabe mit Betriebskennzahlen. Die Umsetzung wird anhand festgelegter Sollwerte geprüft und in einer wiederverwendbaren Betriebsnotiz festgehalten.

Durchgängiger Praxisfall

Eine Asset-Synchronisation über GraphQL und Webhooks versorgt eine zentrale CMDB. Der Praxisfall umfasst Initialabzug, Delta-Verarbeitung, Mapping, Fehlerwarteschlange, Monitoring und Abnahme.

Arbeitsweise im Seminar

Fachliche Einordnung, Demonstration, angeleitete Konfiguration, selbstständige Übung, Fehleranalyse und dokumentierte Abnahme wechseln sich ab. Sämtliche Konfigurationsschritte werden zuerst geplant, danach kontrolliert umgesetzt und abschließend mit messbaren Kriterien geprüft.