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.

Hinweis

  • 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. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  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, 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

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, 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. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  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, 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

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, 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. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  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

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