Seminar ATXServer2 – REST API und Automatisierung

Das Seminar behandelt die ATXServer2-REST-API als Grundlage reproduzierbarer Geräte- und Testabläufe. Bearer-Authentisierung, Benutzer- und Geräteabfragen, Filter, Reservierung, Aktivitätsverwaltung, Source-Daten, Freigabe, Provider-Installationsendpunkte, Fehlerbehandlung und robuste Clientarchitektur werden praktisch umgesetzt.

Inhaltsübersicht

• Lernziele und fachliche Einordnung
• Schrittweise Seminarinhalte
• Praxisübungen und Laborszenarien
• Zielgruppe und Voraussetzungen
• Didaktik und Arbeitsweise

Lernziele

• API-Authentisierung, Ressourcen und Statuscodes sicher anwenden.
• Geräte nach Plattform, Verfügbarkeit und Eigenschaften auswählen.
• Reservierung, Aktivität und Freigabe zuverlässig automatisieren.
• Source-Informationen und Provider-Endpunkte kontrolliert verwenden.
• Robuste Clients mit Timeouts, Retry, Logging und sicherem Cleanup entwickeln.

Schrittweise Seminarinhalte

1. API-Grundmodell und Bearer-Authentisierung

Schwerpunkt: Server-URL, API-Version, Benutzer-Token, Authorization-Header, 403, JSON, Content-Type, Transportverschlüsselung und Secret-Schutz.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „API-Grundmodell und Bearer-Authentisierung“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von Server-URL, API-Version, Benutzer-Token, Authorization-Header, 403, JSON, Content-Type, Transportverschlüsselung und Secret-Schutz modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine sichere und getestete API-Basis dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

2. Benutzer- und Geräteabfragen

Schwerpunkt: Benutzerinfo, Geräteliste, Einzelgerät, Plattformfilter, usable, Eigenschaften, count, present, using, colding, userId und Fehlerfälle.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „Benutzer- und Geräteabfragen“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von Benutzerinfo, Geräteliste, Einzelgerät, Plattformfilter, usable, Eigenschaften, count, present, using, colding, userId und Fehlerfälle modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis einen verlässlichen Discovery- und Auswahlprozess dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

3. Reservierung und Idle-Timeout

Schwerpunkt: POST auf Benutzergeräte, UDID, optionales Idle-Timeout, Administratorbelegung für andere Nutzer, Konflikte, Eingabevalidierung und Antwortprüfung.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „Reservierung und Idle-Timeout“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von POST auf Benutzergeräte, UDID, optionales Idle-Timeout, Administratorbelegung für andere Nutzer, Konflikte, Eingabevalidierung und Antwortprüfung modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine robuste Reservierungsfunktion dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

4. Aktivität und Sitzungssteuerung

Schwerpunkt: Aktivitätsendpunkt, Zeitintervalle, Heartbeat des Clients, verlorene Jobs, Timeout-Verhalten, Parallelzugriffe und Sitzungsnachweis.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „Aktivität und Sitzungssteuerung“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von Aktivitätsendpunkt, Zeitintervalle, Heartbeat des Clients, verlorene Jobs, Timeout-Verhalten, Parallelzugriffe und Sitzungsnachweis modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis eine zuverlässige Aktivitäts- und Lease-Logik dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

5. Source-Daten und Plattformendpunkte

Schwerpunkt: Provider-URL, atxAgentAddress, remoteConnectAddress, whatsInputAddress, WDA-URL, Secret, Zugriffsrechte, Datenminimierung und Lebensdauer.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „Source-Daten und Plattformendpunkte“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von Provider-URL, atxAgentAddress, remoteConnectAddress, whatsInputAddress, WDA-URL, Secret, Zugriffsrechte, Datenminimierung und Lebensdauer modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis einen sicheren Source-Datenverwendungsprozess dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

6. Freigabe und Provider-Installationen

Schwerpunkt: DELETE-Freigabe, APK- und IPA-Installation, UDID, URL, Startoption, Provider-Secret, Rückgabecodes, Teilfehler und Cleanup.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „Freigabe und Provider-Installationen“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von DELETE-Freigabe, APK- und IPA-Installation, UDID, URL, Startoption, Provider-Secret, Rückgabecodes, Teilfehler und Cleanup modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis einen vollständigen Geräte- und App-Lifecycle dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

7. Robuste Clientarchitektur

Schwerpunkt: Timeouts, Retry mit Grenzen, Idempotenz, Korrelation, strukturierte Logs, Fehlerklassen, Secret-Maskierung, Tests, parallele Jobs und finally-Cleanup.

1. Ausgangslage, Systemzustand, Schutzbedarf und Zielkriterien für den Themenblock „Robuste Clientarchitektur“ erfassen.
2. Relevante Komponenten, Konfigurationswerte, Rollen und Abhängigkeiten anhand von Timeouts, Retry mit Grenzen, Idempotenz, Korrelation, strukturierte Logs, Fehlerklassen, Secret-Maskierung, Tests, parallele Jobs und finally-Cleanup modellieren.
3. Die erforderliche Konfiguration oder Prozessfolge in einer kontrollierten Laborumgebung schrittweise umsetzen und jeden Zwischenschritt dokumentieren.
4. Funktion, Berechtigungen, Protokollierung, Fehlerverhalten und Wiederanlauf mit definierten Positiv- und Negativfällen prüfen.
5. Als Arbeitsergebnis einen produktionsreifen API-Cliententwurf dokumentieren, fachlich abnehmen und in einen wiederholbaren Standard überführen.

Praxisübungen und Laborszenarien

• Implementierung eines Clients für Benutzer- und Geräteabfragen mit Filtern.
• Automatisierung von Reservierung, Aktivitätsupdate und garantierter Freigabe.
• Abruf und sichere Nutzung plattformspezifischer Source-Daten.
• Durchführung einer App-Installation mit Fehler- und Retry-Szenarien.

Zielgruppe und Voraussetzungen

Zielgruppe: Testautomatisierung, Python- und Skriptentwicklung, DevOps, CI/CD Engineering, Plattformintegration und technische Qualitätssicherung

Voraussetzungen: Grundkenntnisse in HTTP, JSON, REST und Skripting; Python-Praxis ist hilfreich, aber nicht zwingend

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, strukturierte Konfigurationsschritte, Praxisübungen und kontrollierte Fehlerfälle vertieft. Jede Übung verwendet definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen, damit die erarbeiteten Abläufe als Betriebsstandard wiederholbar bleiben.