Wie eine Lambda-Funktion unter einer Webadresse antwortet, ohne etwas anderes aufzusetzen

Stellen Sie sich ein kleines Programm vor, das nur laufen soll, wenn jemand es aufruft: die Meldung entgegennehmen, dass ein Kunde bezahlt hat, ein Kontaktformular verarbeiten, ein Bild umwandeln. Dafür wollen Sie keinen Server, der 24 Stunden eingeschaltet ist. Dafür gibt es Lambda: Sie geben Amazon Ihren Code, und Amazon führt ihn nur dann aus, wenn es nötig ist, und berechnet Ihnen nur diese Zeit. Keine Maschinen, die gepflegt werden müssen.

Die Frage ist: Wie rufen Sie ihn auf? Das Universellste ist, ihm eine Webadresse zu geben, eine URL wie https://algo.on.aws/, sodass jeder Browser oder jedes Programm sie „öffnen“ kann und Ihr Code antwortet. Diese Anleitung macht genau das mit der Option, die Lambda von Haus aus mitbringt und Funktions-URL heißt. Es muss nichts weiter installiert oder gebucht werden.

Schritt für Schritt

1. Prüfen Sie, ob Ihre Funktion auf eine Webanfrage antworten kann

   Wenn die Funktion über ihre Webadresse aufgerufen wird, übergibt Lambda ihr ein Datenpaket mit der Anfrage (was angefragt wurde, mit welchen Daten) und erwartet, dass Ihr Code eine Antwort mit zwei Dingen zurückgibt: einem Statuscode (200 bedeutet „alles in Ordnung“) und einem Body (der Text oder die Daten, die Sie zurückgeben). Wenn Ihre Funktion für einen anderen Zweck geschrieben wurde, muss sie angepasst werden. Ein Minimalbeispiel in Node.js, das „hallo, Welt“ antwortet:

   export const handler = async (event) => ({
     statusCode: 200,
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ hola: "mundo" })
   });

   Wenn Sie nicht selbst programmieren, geben Sie diesen Absatz an die Person weiter, die es tut: Sie wird wissen, was gemeint ist.

2. Entscheiden Sie, wer die Funktion aufrufen darf

   Das ist die einzige wichtige Entscheidung dieser Anleitung, und man sollte sie gut verstehen. Es gibt zwei Optionen:

   • Nur mit AWS-Anmeldedaten (die Option heißt AWS_IAM): Nur ein Programm von Ihnen, das Berechtigungen in Ihrem Amazon-Konto hat, kann sie aufrufen. Das ist die sicherste, aber ein normaler Browser oder ein externer Dienst können sie nicht nutzen.
   • Offen (die Option heißt NONE): Jeder, der die Adresse kennt, kann sie aufrufen. Das brauchen Sie, wenn ein externer Dienst (ein Webhook) oder eine Webseite sie aufrufen soll. Im Gegenzug muss Ihr Code für die Sicherheit sorgen: bei jedem Aufruf ein Passwort oder eine Signatur prüfen. Das sehen wir im letzten Schritt.

   Einfache Regel: Wenn Sie nicht wissen, welche Sie wählen sollen, nehmen Sie die erste. Wenn die Funktion Aufrufe von außerhalb Ihres Kontos empfangen muss, nehmen Sie die zweite und überspringen Sie den letzten Schritt nicht.

3. Aktivieren Sie die Webadresse

   Öffnen Sie in der AWS-Konsole Lambda, öffnen Sie Ihre Funktion und klicken Sie auf den Reiter Konfiguration. Wählen Sie im Menü links Funktions-URL und klicken Sie auf Funktions-URL erstellen. Wählen Sie den Zugriffstyp aus dem vorherigen Schritt.

   Wenn eine eigene Webseite von einer anderen Domain aus sie aufrufen soll, klappen Sie CORS auf und tragen Sie die Adresse dieser Seite unter „Ursprung zulassen“ ein (zum Beispiel https://miweb.com). Wenn Sie ein Sternchen setzen, kann jede Website der Welt sie vom Browser aus aufrufen; vermeiden Sie das, außer Sie wollen genau das. Speichern. Oben erscheint die neue Adresse, die so aussieht: https://xxxxxxxx.lambda-url.eu-west-1.on.aws/. Das ist Ihre URL.

4. Probieren Sie sie aus

   Wenn Sie die offene Option gewählt haben, kopieren Sie die Adresse und fügen Sie sie in den Browser ein: Sie sollten die Antwort Ihrer Funktion sehen (im Beispiel den Text „hallo, Welt“). Sie funktioniert bereits.

   Wenn Sie sie lieber aus einem Terminal testen, geben Sie in CloudShell (das Terminalsymbol in der oberen Leiste der AWS-Konsole) ein:

   curl -i https://xxxxxxxx.lambda-url.eu-west-1.on.aws/

   Wenn Sie die Option mit Anmeldedaten gewählt haben, sagt der Browser „Forbidden“: Das ist zu erwarten, weil er keine Anmeldedaten mitschickt. Den Test muss das Programm von Ihnen machen, das sie aufrufen soll, mit den AWS-Bibliotheken, die die Anfragen bereits signieren können.

5. Sehen Sie sich das Tagebuch der Ausführungen an

   Reiter Überwachen, Schaltfläche CloudWatch-Protokolle anzeigen. Jeder Aufruf hinterlässt einen Vermerk mit der Dauer und dem, was Ihr Code geschrieben hat. Wenn ein Aufruf einen Fehler zurückgibt, sehen Sie hier den Grund. Ein Tipp, der Geld spart: Setzen Sie in dieser Protokollgruppe eine Aufbewahrung von zum Beispiel 30 Tagen; sonst werden die Protokolle für immer gespeichert und berechnet.

6. Wenn Sie sie offen gelassen haben, schützen Sie sie

   Offen heißt, dass jeder sie aufrufen kann, also muss Ihr Code bei jedem Aufruf etwas prüfen. Üblich ist: Der Dienst, der Ihnen den Webhook schickt, fügt jeder Meldung eine Signatur oder einen geheimen Schlüssel bei, und Ihre Funktion prüft, ob er korrekt ist, bevor sie etwas tut. Diesen Schlüssel speichern Sie in den Umgebungsvariablen der Funktion (Reiter Konfiguration), nicht im Code.

   Und setzen Sie eine Obergrenze, wie oft sie gleichzeitig laufen darf (reservierte Parallelität, unter Konfiguration): Wenn jemand die Adresse bombardiert, verhindert die Obergrenze, dass die Rechnung explodiert.

Was schiefgehen kann