View a markdown version of this page

So ändern Sie eine Sicherheitsrichtlinie - Amazon API Gateway

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.

So ändern Sie eine Sicherheitsrichtlinie

Sie können die Sicherheitsrichtlinie für Ihre API ändern. Wenn Sie über Ihren benutzerdefinierten Domainnamen Traffic an Ihre APIs senden, müssen die API und der benutzerdefinierte Domainname nicht dieselbe Sicherheitsrichtlinie haben. Wenn Sie diesen benutzerdefinierten Domainnamen aufrufen, verwendet API Gateway die Sicherheitsrichtlinie der benutzerdefinierten Domain, um den TLS-Handshake auszuhandeln. Aus Konsistenzgründen empfehlen wir jedoch, für Ihren benutzerdefinierten Domainnamen und Ihre API dieselbe Sicherheitsrichtlinie zu verwenden.

Wenn Sie Ihre Sicherheitsrichtlinie ändern, dauert es etwa 15 Minuten, bis das Update abgeschlossen ist. Sie können die apiStatus Ihrer API überwachen. Wenn Ihre API aktualisiert wird, apiStatus ist dies der Fall, UPDATING und wenn sie abgeschlossen ist, wird sie aktualisiertAVAILABLE. Wenn Ihre API aktualisiert wird, können Sie sie immer noch aufrufen.

AWS-Managementkonsole
Um die Sicherheitsrichtlinie einer API zu ändern

  1. Melden Sie sich bei der API Gateway-Konsole unter an https://console.aws.amazon.com/apigateway.

  2. Wählen Sie eine REST-API aus.

  3. Wählen Sie API-Einstellungen und anschließend Bearbeiten aus.

  4. Wählen Sie für Sicherheitsrichtlinie eine neue Richtlinie aus, die mit beginntSecurityPolicy_.

  5. Wählen Sie für den Endpunktzugriffsmodus die Option Strikt aus.

  6. Wählen Sie Änderungen speichern aus.

    Sie müssen Ihre API erneut bereitstellen, damit die Änderungen wirksam werden. Da Sie den Endpunkt-Zugriffsmodus auf Strikt geändert haben, dauert es etwa 15 Minuten, bis die Änderungen vollständig übernommen werden.

AWS CLI

Mit dem folgenden Befehl update-rest-api wird eine API aktualisiert, sodass sie die Sicherheitsrichtlinie verwendet: SecurityPolicy_TLS13_1_3_2025_09

aws apigateway update-rest-api \
    --rest-api-id abcd1234 \
    --patch-operations '[
        {
            "op": "replace",
            "path": "/securityPolicy",
            "value": "SecurityPolicy_TLS13_1_3_2025_09"
        }, 
        {
            "op": "replace",
            "path": "/endpointAccessMode",
            "value": "STRICT"
        }
    ]'

Die Ausgabe sieht wie folgt aus:

{
    "id": "abcd1234",
    "name": "MyAPI",
    "description": "My API with a new security policy",
    "createdDate": "2025-02-04T11:47:06-08:00",
    "apiKeySource": "HEADER",
    "endpointConfiguration": {
        "types": [
            "REGIONAL"
        ],
        "ipAddressType": "dualstack"
    },
    "tags": {},
    "disableExecuteApiEndpoint": false,
    "securityPolicy": "SecurityPolicy_TLS13_1_3_2025_09",
    "endpointAccessMode": "STRICT"
    "rootResourceId": "efg456"
}

Der folgende Befehl update-rest-api aktualisiert eine API, die eine erweiterte Sicherheitsrichtlinie verwendet hat, um die Sicherheitsrichtlinie zu verwenden. TLS_1_0

aws apigateway update-rest-api \
    --rest-api-id abcd1234 \
    --patch-operations '[
        {
            "op": "replace",
            "path": "/securityPolicy",
            "value": "TLS_1_0"
        }, 
        {
            "op": "replace",
            "path": "/endpointAccessMode",
            "value": ""
        }
    ]'

Die Ausgabe sieht wie folgt aus:

{
    "id": "abcd1234",
    "name": "MyAPI",
    "description": "My API with a new security policy",
    "createdDate": "2025-02-04T11:47:06-08:00",
    "apiKeySource": "HEADER",
    "endpointConfiguration": {
        "types": [
            "REGIONAL"
        ],
        "ipAddressType": "dualstack"
    },
    "tags": {},
    "disableExecuteApiEndpoint": false,
    "securityPolicy": "TLS_1_0",
    "rootResourceId": "efg456"
}