Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Nachdem Sie eine Lambda-Funktion erstellt haben, konfigurieren Sie die Lambda-Funktion als Autorisierer für Ihre. API Anschließend konfigurieren Sie Ihre Methode so, dass sie Ihren Lambda-Authorizer aufruft, um festzustellen, ob ein Aufrufer Ihre Methode aufrufen kann. Sie können eine Lambda-Funktion in demselben Konto oder in einem anderen Konto erstellen, von dem aus Sie Ihre API erstellt haben.
Sie können Ihren Lambda-Autorisierer mit integrierten Tools in der API Gateway-Konsole oder mit Postman testen. Anweisungen zur Verwendung von Postman zum Testen Ihrer Lambda-Autorisierungsfunktion finden Sie unter. Rufen Sie eine API mit einem API Gateway Lambda-Autorisierer an
Das folgende Verfahren zeigt, wie Sie einen Lambda-Autorisierer in der API REST API Gateway-Konsole erstellen. Weitere Informationen zu den verschiedenen Typen von Lambda-Autorisierern finden Sie unter. Auswahl eines Lambda-Autorisierungstyps
- REQUEST authorizer
-
So konfigurieren Sie einen REQUEST
Lambda-Autorisierer
-
Melden Sie sich unter https://console.aws.amazon.com/apigateway bei der API Gateway-Konsole an.
-
Wählen Sie einen API und anschließend Authorizers aus.
-
Wählen Sie Genehmiger erstellen aus.
-
Geben Sie unter Name des Genehmigers einen Namen für den Genehmiger ein.
-
Wählen Sie als Genehmiger-Typ Lambda aus.
-
Wählen Sie für Lambda-Funktion den Ort aus, AWS-Region an dem Sie Ihre Lambda-Autorisierungsfunktion erstellt haben, und geben Sie dann den Funktionsnamen ein.
-
Lassen Sie das Feld Lambda-Aufrufrolle leer, damit die API REST API Gateway-Konsole eine ressourcenbasierte Richtlinie festlegen kann. Die Richtlinie gewährt API Gateway Berechtigungen zum Aufrufen der Lambda-Autorisierungsfunktion. Sie können auch den Namen einer IAM Rolle eingeben, damit API Gateway die Lambda-Autorisierungsfunktion aufrufen kann. Ein Beispiel für eine Rolle finden Sie unter. Erstellen einer annehmbaren IAM-Rolle
-
Wählen Sie für Lambda-Ereignisnutzlast die Option Anfrage.
-
Wählen Sie für Identitätsquellen-Typ einen Parametertyp aus. Die unterstützten Parametertypen sind Header
, Query string
, Stage
variable
und Context
. Um weitere Identitätsquellen hinzuzufügen, wählen Sie Parameter hinzufügen.
-
Um die vom Genehmiger generierte Genehmigungsrichtlinie zwischenzuspeichern, lassen Sie Genehmigungs-Caching aktiviert. Wenn das Policy-Caching aktiviert ist, können Sie den TTLWert ändern. Wenn Sie den Wert TTLauf Null setzen, wird das Policy-Caching deaktiviert.
Wenn Sie das Caching aktivieren, muss Ihr Autorisierer eine Richtlinie zurückgeben, die für alle Methoden in einem gilt. API Um eine methodenspezifische Richtlinie durchzusetzen, verwenden Sie die Kontextvariablen und. $context.path
$context.httpMethod
-
Wählen Sie Autorisierer erstellen.
- TOKEN authorizer
So konfigurieren Sie einen TOKEN
Lambda-Autorisierer
-
Melden Sie sich unter https://console.aws.amazon.com/apigateway bei der API Gateway-Konsole an.
-
Wählen Sie einen API und anschließend Authorizers aus.
-
Wählen Sie Genehmiger erstellen aus.
-
Geben Sie unter Name des Genehmigers einen Namen für den Genehmiger ein.
-
Wählen Sie als Genehmiger-Typ Lambda aus.
-
Wählen Sie für Lambda-Funktion den Ort aus, AWS-Region an dem Sie Ihre Lambda-Autorisierungsfunktion erstellt haben, und geben Sie dann den Funktionsnamen ein.
-
Lassen Sie das Feld Lambda-Aufrufrolle leer, damit die API REST API Gateway-Konsole eine ressourcenbasierte Richtlinie festlegen kann. Die Richtlinie gewährt API Gateway Berechtigungen zum Aufrufen der Lambda-Autorisierungsfunktion. Sie können auch den Namen einer IAM Rolle eingeben, damit API Gateway die Lambda-Autorisierungsfunktion aufrufen kann. Ein Beispiel für eine Rolle finden Sie unter. Erstellen einer annehmbaren IAM-Rolle
-
Wählen Sie für Lambda-Ereignisnutzlast die Option Token aus.
-
Geben Sie unter Token-Quelle den Header-Namen ein, der das Genehmigungstoken enthält. Der Aufrufer muss einen Header mit diesem Namen angeben, um das Autorisierungstoken an den Lambda-Autorisierer zu senden.
-
(Optional) Geben Sie für die Token-Validierung eine Anweisung ein. RegEx APIGateway führt eine erste Validierung des Eingabe-Tokens anhand dieses Ausdrucks durch und ruft bei erfolgreicher Überprüfung den Authorizer auf.
-
Um die vom Genehmiger generierte Genehmigungsrichtlinie zwischenzuspeichern, lassen Sie Genehmigungs-Caching aktiviert. Wenn das Richtlinien-Caching aktiviert ist, wird der unter Token-Quelle angegebene Header-Name zum Cache-Schlüssel. Wenn das Policy-Caching aktiviert ist, können Sie den Wert ändern. TTL Wenn Sie den Wert TTLauf Null setzen, wird das Policy-Caching deaktiviert.
Wenn Sie das Caching aktivieren, muss Ihr Autorisierer eine Richtlinie zurückgeben, die für alle Methoden in einem gilt. API Um eine methodenspezifische Richtlinie durchzusetzen, können Sie das Autorisierungs-Caching deaktivieren.
-
Wählen Sie Autorisierer erstellen.
Nachdem Sie Ihren Lambda-Authorizer erstellt haben, können Sie ihn testen. Das folgende Verfahren zeigt, wie Sie Ihren Lambda-Authorizer testen.
- REQUEST authorizer
-
Um einen REQUEST
Lambda-Autorisierer zu testen
-
Melden Sie sich unter https://console.aws.amazon.com/apigateway bei der API Gateway-Konsole an.
-
Wählen Sie den Namen Ihres Autorisierers aus.
-
Geben Sie unter Autorisierer testen einen Wert für Ihre Identitätsquelle ein.
Wenn Sie den verwendenBeispiel für eine REQUEST Autorisierungs-Lambda-Funktion, gehen Sie wie folgt vor:
-
Wählen Sie Header, geben Sie headerValue1
ein und wählen Sie dann Parameter hinzufügen aus.
-
Wählen Sie unter Identitätsquellen-Typ die Option Abfragezeichenfolge, geben Sie queryValue1
ein und wählen Sie dann Parameter hinzufügen aus.
-
Wählen Sie unter Identitätsquellen-Typ die Option Stufenvariable aus und geben Sie stageValue1
ein.
Sie können die Kontextvariablen für den Testaufruf nicht ändern, aber Sie können die APIGateway Authorizer-Testereignisvorlage für Ihre Lambda-Funktion ändern. Anschließend können Sie Ihre Lambda-Authorizer-Funktion mit geänderten Kontextvariablen testen. Weitere Informationen finden Sie im AWS Lambda Entwicklerhandbuch unter Testen von Lambda-Funktionen in der Konsole.
-
Wählen Sie Genehmiger testen aus.
- TOKEN authorizer
-
Der folgende create-authorizer-Befehl zeigt, wie Sie einen Lambda-Authorizer mit dem erstellen. AWS CLI
- REQUEST authorizer
-
Das folgende Beispiel erstellt einen REQUEST
Authorizer und verwendet den Authorizer
Header und accountId
die Kontextvariable als Identitätsquellen:
aws apigateway create-authorizer \
--rest-api-id 1234123412 \
--name 'First_Request_Custom_Authorizer' \
--type REQUEST \
--authorizer-uri 'arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthFunction/invocations' \
--identity-source 'method.request.header.Authorization,context.accountId' \
--authorizer-result-ttl-in-seconds 300
- TOKEN authorizer
-
Das folgende Beispiel erstellt einen TOKEN
Authorizer und verwendet den Authorization
Header als Identitätsquelle:
aws apigateway create-authorizer \
--rest-api-id 1234123412 \
--name 'First_Token_Custom_Authorizer' \
--type TOKEN \
--authorizer-uri 'arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123412341234:function:customAuthFunction/invocations' \
--identity-source 'method.request.header.Authorization' \
--authorizer-result-ttl-in-seconds 300
Nachdem Sie Ihren Lambda-Authorizer erstellt haben, können Sie ihn testen. Der folgende test-invoke-authorizerBefehl zeigt, wie Sie Ihren Lambda-Authorizer testen:
aws apigateway test-invoke-authorizer --rest-api-id 1234123412 \
--authorizer-id efg1234 \
--headers Authorization='Value'
Nachdem Sie Ihren Lambda-Authorizer konfiguriert haben, müssen Sie ihn an eine Methode für Sie anhängen. API
So konfigurieren Sie eine API Methode zur Verwendung eines Lambda-Autorisierers
-
Melden Sie sich unter https://console.aws.amazon.com/apigateway bei der API Gateway-Konsole an.
-
Wählen Sie einAPI.
-
Wählen Sie Ressourcen und wählen Sie dann eine neue Methode oder wählen Sie eine vorhandene Methode.
-
Wählen Sie auf der Registerkarte Methodenanfrage unter Methodenanfrage-Einstellungen die Option Bearbeiten aus.
-
Wählen Sie für Genehmiger aus dem Drop-down-Menü den Lambda-Genehmiger aus, den Sie gerade erstellt haben.
-
(Optional) Wenn Sie das Autorisierungstoken an das Backend übergeben möchten, wählen Sie HTTPAnforderungsheader. Wählen Sie Header hinzufügen und fügen Sie dann den Namen des Genehmigungsheaders hinzu. Geben Sie für Name den Header-Namen ein, der dem Token-Quellnamen entspricht, den Sie bei der Erstellung des Lambda-Autorisierers für angegeben haben. API Dieser Schritt gilt nicht für REQUEST
-Genehmiger.
-
Wählen Sie Speichern.
-
Wählen Sie Deploy ausAPI, API um das in einer Phase bereitzustellen. Für einen REQUEST
-Genehmiger mit Stufenvariablen müssen Sie auch die erforderlichen Stufenvariablen definieren und ihre Werte auf der Seite Stufen angeben.
Nachdem Sie Ihren Lambda-Authorizer konfiguriert haben, müssen Sie ihn an eine Methode für Sie anhängen. API Sie können eine neue Methode erstellen oder einen Patch-Vorgang verwenden, um einen Autorisierer an eine bestehende Methode anzuhängen.
Der folgende Befehl put-method zeigt, wie eine neue Methode erstellt wird, die einen Lambda-Authorizer verwendet:
aws apigateway put-method --rest-api-id 1234123412 \
--resource-id a1b2c3 \
--http-method PUT \
--authorization-type CUSTOM \
--authorizer-id efg1234
Der folgende Befehl update-method zeigt, wie eine vorhandene Methode aktualisiert wird, um einen Lambda-Authorizer zu verwenden:
aws apigateway update-method \
--rest-api-id 1234123412 \
--resource-id a1b2c3 \
--http-method PUT \
--patch-operations op="replace",path="/authorizationType",value="CUSTOM" op="replace",path="/authorizerId",value="efg1234"