Zulassungsliste für IP-Adressen konfigurieren

Wenn Sie vertrauenswürdige IP-Adressen von der reCAPTCHA-Durchsetzung ausschließen möchten, erstellen Sie eine Zulassungsliste für einen reCAPTCHA-Schlüssel, der mit Ihrer Website verknüpft ist, und fügen Sie dieser Zulassungsliste die IP-Adressen und die Subnetze hinzu.

Sie können auch eine IP-Adresse und ein Subnetz aus der Zulassungsliste entfernen und die IP-Adressen und Subnetze auflisten, die der Zulassungsliste hinzugefügt wurden.

Hinweise

  • Sammeln Sie alle IP-Adressen und Subnetze, die Sie der Zulassungsliste hinzufügen möchten.

  • Identifizieren Sie die IP-Adressen und Subnetze, die Sie aus der Zulassungsliste entfernen möchten.

  • Sie benötigen Identity and Access Management-Rolle „reCAPTCHA Enterprise Admin“ (roles/recaptchaenterprise.admin).

IP-Adresse oder Subnetz auf die Zulassungsliste setzen

Wenn Sie eine IP-Adresse oder ein Subnetz der Zulassungsliste hinzufügen, wird die reCAPTCHA-Überprüfung übersprungen und Anfragen, die von dieser IP-Adresse oder diesem Subnetz stammen, erhalten immer die Punktzahl 0.9. Sie können einer Zulassungsliste maximal 1.000 IP-Adressen und ‑Subnetze hinzufügen.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • KEY: Der reCAPTCHA-Schlüssel, der Ihrer Website zugeordnet ist.
    • IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, die bzw. das der Zulassungsliste hinzugefügt werden muss.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud recaptcha keys add-ip-override
    KEY \
    --ip=IP_ADDRESS_OR_SUBNET \
    --override=ALLOW

    Windows (PowerShell)

    gcloud recaptcha keys add-ip-override
    KEY `
    --ip=IP_ADDRESS_OR_SUBNET `
    --override=ALLOW

    Windows (cmd.exe)

    gcloud recaptcha keys add-ip-override
    KEY ^
    --ip=IP_ADDRESS_OR_SUBNET ^
    --override=ALLOW

  3. REST

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • KEY: Der reCAPTCHA-Schlüssel, der Ihrer Website zugeordnet ist.
    • IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, die bzw. das der Zulassungsliste hinzugefügt werden muss.
    • PROJECT_ID: Ihre Google Cloud -Projekt-ID

    HTTP-Methode und URL:

    POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride

    JSON-Text der Anfrage:

    
    {
      "ip_override_data": {
        "ip": "IP_ADDRESS_OR_SUBNET",
        "override_type": "ALLOW"
      }
    }
    
    

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride"

    PowerShell

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride" | Select-Object -Expand Content

    Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Nachdem Sie eine IP-Adresse oder ein Subnetz zur Zulassungsliste hinzugefügt haben, werden die Änderungen innerhalb weniger Minuten wirksam.

IP-Adresse oder ‑Subnetz aus der Zulassungsliste entfernen

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • KEY: Der reCAPTCHA-Schlüssel, der Ihrer Website zugeordnet ist.
    • IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, die bzw. das der Zulassungsliste hinzugefügt werden muss.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud recaptcha keys remove-ip-override
    KEY \
    --ip=IP_ADDRESS_OR_SUBNET \
    --override=ALLOW

    Windows (PowerShell)

    gcloud recaptcha keys remove-ip-override
    KEY `
    --ip=IP_ADDRESS_OR_SUBNET `
    --override=ALLOW

    Windows (cmd.exe)

    gcloud recaptcha keys remove-ip-override
    KEY ^
    --ip=IP_ADDRESS_OR_SUBNET ^
    --override=ALLOW

  3. REST

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • KEY: Der reCAPTCHA-Schlüssel, der Ihrer Website zugeordnet ist.
    • IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, die bzw. das der Zulassungsliste hinzugefügt werden muss.
    • PROJECT_ID: Ihre Google Cloud -Projekt-ID

    HTTP-Methode und URL:

    POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride

    JSON-Text der Anfrage:

    
    {
      "ip_override_data": {
        "ip": "IP_ADDRESS_OR_SUBNET",
        "override_type": "ALLOW"
      }
    }
    
    

    Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

    curl

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride"

    PowerShell

    Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride" | Select-Object -Expand Content

    Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Nachdem Sie eine IP-Adresse oder ein Subnetz aus der Zulassungsliste entfernt haben, werden die Änderungen innerhalb weniger Minuten wirksam.

Alle IP-Adressen aus der Zulassungsliste auflisten

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

    • KEY: Der reCAPTCHA-Schlüssel, der Ihrer Website zugeordnet ist.

    Führen Sie folgenden Befehl aus:

    Linux, macOS oder Cloud Shell

    gcloud recaptcha keys list-ip-overrides KEY --format=json

    Windows (PowerShell)

    gcloud recaptcha keys list-ip-overrides KEY --format=json

    Windows (cmd.exe)

    gcloud recaptcha keys list-ip-overrides KEY --format=json

  3. REST

    Ersetzen Sie diese Werte in den folgenden Anfragedaten:

    • KEY: Der reCAPTCHA-Schlüssel, der Ihrer Website zugeordnet ist.
    • PROJECT_ID: Ihre Google Cloud -Projekt-ID

    HTTP-Methode und URL:

    GET https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides

    Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

    curl

    Führen Sie folgenden Befehl aus:

    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides"

    PowerShell

    Führen Sie folgenden Befehl aus:

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides" | Select-Object -Expand Content

    Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

    
    {
      "ipOverrides": [
        {
          "ip": "1.2.3.4",
          "overrideType": "ALLOW"
        }
      ],
      "nextPageToken": ""
    }
    
    
    

Nächste Schritte