Control/Configure API Gateway with Usage Plans & API Keys
Zusammenfassung
Kurz
Der Beitrag beschreibt die Einrichtung von API-Schlüsseln und Nutzungsplänen in API Gateway, um Anfragen zu begrenzen und ausgewählte Methoden zugangspflichtig zu machen. Der Autor warnt, Schlüssel nicht allein zur Autorisierung zu nutzen, und berichtet für den Test von `200 OK` mit gültigem Header beziehungsweise `403 Forbidden` ohne passenden Schlüssel.
Mittel
Der Beitrag erklärt, wie eine API-Gateway-API mit einem API-Schlüssel und einem Nutzungsplan versehen wird. Als Einsatzfälle nennt der Autor Drosselungsgrenzen, ein Anfragelimit je Schlüssel und den Zugriff eines Nutzers auf mehrere API-Stufen oder Methoden. Er warnt jedoch davor, API-Schlüssel allein zur Authentifizierung oder Autorisierung einzusetzen: Ein Schlüssel könne Zugriff auf weitere APIs ermöglichen, wenn diese im selben Nutzungsplan liegen. Für Autorisierung verweist er auf Lambda-Autorisierer, IAM-Rollen oder Amazon Cognito.
Die Anleitung sieht vor, einen Schlüssel anzulegen, bei den gewünschten Methoden die Schlüsselpflicht einzuschalten und die API bereitzustellen. Danach werden ein Nutzungsplan mit optionalen Drosselungs- und Kontingentgrenzen erstellt sowie Schlüssel und passende API-Stufe diesem Plan zugeordnet. Laut Beitrag macht die Zuordnung der Stufe nicht automatisch alle Methoden schlüsselpflichtig; entscheidend ist die Einstellung je Methode.
Beim beschriebenen Test wird der Schlüssel im Header `X-API-Key` übermittelt. Der Autor nennt `200 OK` als erwartete Antwort und `403 Forbidden`, wenn der Header fehlt oder ein falscher Schlüssel verwendet wird. Der Text ist eine Anleitung, keine systematische Prüfung; die Ergebnisse werden vom Autor berichtet.
Ausführlich lesen
Der Beitrag von Itsuki beschreibt, wie sich eine API-Gateway-API mit einem API-Schlüssel und einem Nutzungsplan konfigurieren lässt. Als mögliche Einsatzfälle nennt der Autor Grenzwerte für die Drosselung von Anfragen, ein Kontingent für die Zahl der Anfragen je Schlüssel innerhalb eines Zeitraums sowie den Zugang eines einzelnen Nutzers zu mehreren bereitgestellten API-Stufen und Methoden.
Zugleich warnt der Beitrag ausdrücklich davor, API-Schlüssel allein zur Authentifizierung oder Autorisierung zu verwenden. Nach seiner Darstellung kann ein Nutzer mit einem gültigen Schlüssel für eine API unter Umständen auf alle APIs zugreifen, die demselben Nutzungsplan zugeordnet sind. Für Autorisierung verweist der Autor stattdessen auf Lambda-Autorisierer, IAM-Rollen oder Amazon Cognito. Als andere Zugangsmodelle erwähnt er private APIs mit VPC-Endpunkten und die Steuerung über AWS WAF.
Die Anleitung führt durch die Einrichtung in der API-Gateway-Konsole. Zuerst wird ein API-Schlüssel angelegt, wahlweise automatisch erzeugt oder mit einem eigenen Wert. Der Autor betont, dass Schlüsselwerte eindeutig sein müssen: Zwei Schlüssel mit verschiedenen Namen, aber identischem Wert, würden als derselbe Schlüssel behandelt. Anschließend wird bei der gewünschten API-Methode die Option aktiviert, die einen API-Schlüssel verlangt. Damit diese Einstellung wirksam wird, soll die API bereitgestellt oder erneut bereitgestellt und der Name der betreffenden Stufe notiert werden.
Danach wird ein Nutzungsplan erstellt. Dessen Drosselungs- und Kontingentgrenzen können laut Anleitung optional festgelegt werden. Im nächsten Schritt wird der zuvor erstellte API-Schlüssel dem Plan hinzugefügt. Zusätzlich wird die passende API-Stufe dem Nutzungsplan zugeordnet. Der Beitrag hebt hervor, dass diese Zuordnung allein nicht bewirkt, dass sämtliche Methoden der Stufe einen Schlüssel verlangen: Das gilt nur für Methoden, bei denen die entsprechende Schlüsselpflicht aktiviert wurde.
Zum Abschluss beschreibt der Autor einen Funktionstest: Die Anfrage soll an die API-URL und Stufe gesendet werden, wobei der API-Schlüssel im HTTP-Header `X-API-Key` steht. Als erwartetes Ergebnis nennt der Beitrag `200 OK`. Fehlt der Header oder wird ein anderer Schlüssel verwendet, solle die API mit `403 Forbidden` und einer JSON-Nachricht mit dem Text „Forbidden“ antworten.
Der Text ist eine praktische Konsolenanleitung und berichtet keinen systematischen Test, keine Messwerte und keine Untersuchung von Sicherheitsgrenzen. Die genannten Ergebnisse sind daher als Darstellung des Autors zu verstehen; weitergehende Aussagen über die Wirksamkeit oder Eignung der Konfiguration enthält der Beitrag nicht.
Gegengeprüft von Claude Haiku 5.5: ok
Luna nennt für SF-T1 einen Anteil von 48 %, der im Bericht nicht vorkommt; die Einordnung oben beruht allein auf dem Bericht.
Im Bericht, aber nicht in der Zusammenfassung
- Hinweis, dass API-Schlüsselwerte eindeutig sein müssen, wird in keiner der beiden Zusammenfassungen erwähnt
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Tempo und Grenzen
- SF-T1 Welche messbaren Schwellen sollen eine Pause auslösen, und wer prüft sie?
- clef 100 %kein Bezug
- Luna 48 %einzelne zitierbare Belege
- JEV 100 %kein Bezug
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung einzelne zitierbare Belege