AWS: Private API with API Gateway
Zusammenfassung
Kurz
Der Bericht zeigt, wie eine private API Gateway REST-API über einen `execute-api`-VPC-Endpunkt, eine Ressourcenrichtlinie und ein Deployment eingerichtet wird, sowohl in der AWS-Konsole als auch mit CDK. Der Autor berichtet von einem erfolgreichen Test innerhalb und einem DNS-Fehler außerhalb seiner VPC; der Beitrag bietet eine Anleitung, aber keine unabhängige Sicherheitsbewertung.
Mittel
Der Beitrag erläutert anhand einer Konsolenanleitung und eines Python-CDK-Beispiels, wie eine private REST-API in Amazon API Gateway eingerichtet und auf eine VPC beziehungsweise einen VPC-Endpunkt begrenzt werden kann. Zuerst wird ein Interface-Endpunkt für `execute-api` angelegt; seine Sicherheitsgruppe muss HTTPS über TCP-Port 443 zulassen. Danach erstellt man eine private REST-API, verknüpft sie mit dem Endpunkt und hinterlegt eine Ressourcenrichtlinie. Diese kann den Zugriff etwa über `aws:SourceVpce` auf einen Endpunkt oder über `aws:SourceVpc` auf eine VPC beschränken. Nach dem Deployment wird der Aufruf aus der VPC getestet. Der Autor berichtet, dass sein Aufruf von außerhalb mit einem Fehler bei der DNS-Auflösung scheiterte.
Das CDK-Beispiel verwendet einen bereits bestehenden Endpunkt, weil dieser laut Autor von mehreren APIs geteilt werden kann. Die Richtlinie wird beim Erstellen der API gesetzt; für den Ressourcen-ARN zeigt der Beitrag eine CloudFormation-Verknüpfung. Private DNS beeinflusst laut Text die verwendbaren DNS-Adressen, nicht die Berechtigung, kann aber den Aufruf öffentlicher APIs aus der VPC beeinträchtigen. Die Sicherheitsvorteile und Testergebnisse sind Aussagen des Autors; eine allgemeine oder unabhängige Überprüfung enthält der Bericht nicht.
Ausführlich lesen
Der Bericht von Itsuki beschreibt, wie sich eine private REST-API mit Amazon API Gateway einrichten und auf Anfragen aus einer VPC beschränken lässt. Dazu zeigt er einen Weg über die AWS-Konsole und ein Beispiel mit AWS CDK. Der Beitrag behauptet, dass private APIs den Zugriff besser kontrollierbar machen: Der Netzwerkverkehr laufe über sichere Verbindungen innerhalb des Amazon-Netzwerks. Das ist die Einordnung des Autors; der Text liefert dazu keine unabhängige Sicherheitsbewertung.
Für die Konsolenvariante wird zuerst in der gewünschten VPC ein Interface-VPC-Endpunkt für den API-Gateway-Dienst `execute-api` erstellt. Der Bericht empfiehlt, Private DNS aktiviert zu lassen. Diese Option beeinflusse laut Autor die verwendbaren DNS-Adressen, nicht die Zugriffsberechtigung. Er weist zugleich darauf hin, dass sich öffentliche APIs aus der VPC möglicherweise nicht über einen API-Gateway-VPC-Endpunkt aufrufen lassen, wenn Private DNS eingeschaltet ist. Die dem Endpunkt zugeordneten Sicherheitsgruppen müssen eingehenden HTTPS-Verkehr auf TCP-Port 443 zulassen.
Anschließend wird in API Gateway eine REST-API vom Typ „Private“ angelegt und mit der VPC-Endpunkt-ID verknüpft. Als Testressource dient eine Mock-Integration. Der Autor betont, dass API-Aufrufe fehlschlagen, solange keine passende Ressourcenrichtlinie den Zugriff erlaubt; die Testfunktion in der Konsole könne die Ressourcenantwort trotzdem prüfen. Die Richtlinie lässt im gezeigten Beispiel Aufrufe über einen bestimmten VPC-Endpunkt zu. Alternativ könne sie mit `aws:SourceVpc` den Zugriff an eine VPC binden. Nach dem Speichern der Richtlinie wird die API in einer Stage bereitgestellt.
Zum Test soll die API innerhalb der VPC aufgerufen werden, etwa von einer dort laufenden EC2-Instanz. Der Autor berichtet, dass der Aufruf außerhalb der VPC in seinem Beispiel mit einem Fehler beim Auflösen des Hostnamens scheiterte. Das ist ein berichtetes Versuchsergebnis, kein Nachweis für alle Konfigurationen oder Fehlerfälle. Die DNS-Namen und die Möglichkeit, die Invoke-URL zu verwenden, hängen laut Beitrag davon ab, ob Private DNS aktiviert ist.
Für CDK zeigt der Beitrag einen Python-Stack, der einen bereits vorhandenen VPC-Endpunkt referenziert, eine Ressourcenrichtlinie erstellt und eine private REST-API mit Mock-GET-Methode sowie Zugriffsprotokollierung definiert. Der Endpunkt wird bewusst nicht im Stack angelegt, weil er laut Autor von mehreren privaten APIs genutzt werden könne. Der Code setzt eine Platzhalter-Endpunkt-ID voraus. Außerdem erläutert der Autor, dass bei `RestApi` entweder `endpoint_types` oder `endpoint_configuration`, nicht beides, verwendet werden dürfe. Die Richtlinie müsse bereits beim Erstellen der API definiert werden; für ihren Ressourcen-ARN empfiehlt er die CloudFormation-Verknüpfung `execute-api:/` mit `*`, da die API-Ressource nicht auf ihre eigene ID verweisen könne. Der gezeigte Stack enthält Löschrichtlinien, die API und Loggruppe bei Entfernung zerstören. Der Bericht dokumentiert eine Anleitung und ein Beispiel, aber keine systematische Prüfung der Konfiguration oder ihrer Eignung für andere Umgebungen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Sammel- oder Teilfragen angegeben, daher ist die Einordnung leer. Geprüft wurde die mittlere Zusammenfassung, die den Bericht im Wesentlichen treu wiedergibt. Die kurze Zusammenfassung ist ebenfalls treu, lässt aber die CDK-Details und die Option aws:SourceVpc aus.
Im Bericht, aber nicht in der Zusammenfassung
- Ohne Ressourcenrichtlinie schlagen laut Autor alle API-Aufrufe fehl, auch wenn der Testaufruf in der Konsole funktioniert
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.