Seminar Gravitee API Management – Grundlagen

Das Grundlagenseminar vermittelt den vollständigen Weg von einer Backend-Schnittstelle zu einer sicher veröffentlichten und überwachten API. Die Arbeit erfolgt in der Management Console und umfasst API-Erstellung, Policies, Pläne, Anwendungen, Subscriptions, Portal und erste Analysen.

Inhaltsübersicht

• Seminarziele
• Inhalte
• Praxisübungen
• Zielgruppe
• Voraussetzungen
• Arbeitsweise

Seminarziele

Im Seminar werden folgende Kompetenzen aufgebaut:

• Aufbau und zentrale Begriffe von Gravitee API Management sicher verwenden
• Eine V4-HTTP-Proxy-API erstellen, konfigurieren, testen und bereitstellen
• Entrypoints, Endpoints, Flows und Policies voneinander abgrenzen
• Pläne, Anwendungen und Subscriptions für kontrollierten Zugriff einsetzen
• APIs dokumentieren und im Developer Portal veröffentlichen
• Logs und Analytics für Funktionsprüfung und erste Fehlersuche nutzen

Inhalte

Plattform und Bedienmodell

• Management Console, Management API, Gateway und Developer Portal
• Organisationen, Umgebungen, APIs, Anwendungen und Benutzerrollen
• Synchrone und asynchrone API-Unterstützung im Überblick
• Typischer Lebenszyklus von Erstellung bis Veröffentlichung

Erste V4-API

• API-Details, Version, Beschreibung und Definitionstyp
• HTTP-Listener, Context Path, Entrypoint und Backend-Endpoint
• Endpoint-Gruppen, Health Checks und einfache Ausfallszenarien
• Speichern, Deployment, Start und kontrollierter Test

Policy Studio

• Flows, Phasen, Bedingungen und Reihenfolge
• Rate Limit, Header-Transformation, Inhaltszuweisung und JSON-Validierung
• Gravitee Expression Language für einfache Kontextbezüge
• Debug Mode, Fehlerbilder und Response Templates im Überblick

Zugriff und Consumer

• Planarten und Auswahl eines geeigneten Einstiegsmodells
• API-Key-Plan, Anwendungen, Subscription und Schlüsselverwaltung
• Subscription-Validierung und organisatorische Zuständigkeiten
• Aufruf einer geschützten API und Prüfung ungültiger Zugriffe

Dokumentation und Developer Portal

• API-Informationen, Dokumentationsseiten und OpenAPI-Anzeige
• Veröffentlichung, Sichtbarkeit und Kategorien
• Auffinden, Testen und Abonnieren aus Consumer-Sicht
• Grundlagen eines konsistenten API-Katalogs

Analyse und erste Administration

• Übersichts- und API-Dashboards
• Runtime-Logs, Statuscodes, Antwortzeiten und Anwendungsbezug
• Audit-Trail und Änderungshistorie
• Typische Konfigurationsfehler und kontrollierte Korrektur

Praxisübungen

1. Eine V4-HTTP-Proxy-API anlegen und einen Backend-Dienst über den Gateway erreichbar machen.
2. Rate Limit, Header-Transformation und JSON-Validierung als Flow konfigurieren.
3. Einen API-Key-Plan, eine Anwendung und eine Subscription erstellen.
4. Erfolgreiche und abgewiesene Requests testen und die Ausführung im Debug Mode prüfen.
5. Dokumentation ergänzen und die API im Developer Portal veröffentlichen.
6. Aufrufe in Analytics und Logs analysieren und einen Konfigurationsfehler beheben.

Zielgruppe

API-Entwickler, Administratoren, Platform Engineers, technische Product Owner und Architekten ohne oder mit geringer Gravitee-Erfahrung.

Voraussetzungen

Grundkenntnisse zu HTTP, REST und JSON; praktische Erfahrung mit einem API-Testwerkzeug ist hilfreich.

Arbeitsweise

Die Themen werden durch fachliche Einordnung, Demonstrationen und aufeinander aufbauende Übungen am System vermittelt. Konfigurationen werden geprüft, mit Negativtests belastet und anhand von Logs, Statusinformationen oder Metriken nachvollzogen. Die Übungen bilden einen durchgängigen technischen Anwendungsfall und vermeiden isolierte Klickfolgen ohne betrieblichen Zusammenhang.