Wenn Sie vertrauenswürdige IP-Adressen von der reCAPTCHA-Erzwigung 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 die IP-Adressen und Subnetze dieser Zulassungsliste hinzu.
Sie können auch eine IP-Adresse und ein Subnetz von der Zulassungsliste entfernen und die IP-Adressen und Subnetze auflisten, die der Zulassungsliste hinzugefügt werden.
Hinweis
Erfassen Sie alle IP-Adressen und Subnetze, die Sie der Zulassungsliste hinzufügen möchten.
Geben Sie die IP-Adressen und Subnetze an, die Sie aus der Zulassungsliste entfernen möchten.
Sie benötigen die folgende Rolle für die Identitäts- und Zugriffsverwaltung: reCAPTCHA Enterprise Admin (
roles/recaptchaenterprise.admin).
IP-Adresse oder Subnetz zur Zulassungsliste hinzufügen
Wenn Sie eine IP-Adresse oder ein Subnetz zur Zulassungsliste hinzufügen, überspringt reCAPTCHA die Überprüfung und gibt den Anfragen von dieser IP-Adresse oder diesem Subnetz immer die Punktzahl 0.9.
Sie können einer Zulassungsliste maximal 100 IP-Adressen und Subnetze hinzufügen.
gcloud
In the Google Cloud console, 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.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- KEY: Der reCAPTCHA-Schlüssel, der mit Ihrer Website verknüpft ist.
- IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, das der Zulassungsliste hinzugefügt werden soll.
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 mit Ihrer Website verknüpft ist.
- IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, das der Zulassungsliste hinzugefügt werden soll.
- 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 von der Zulassungsliste entfernen
gcloud
In the Google Cloud console, 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.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- KEY: Der reCAPTCHA-Schlüssel, der mit Ihrer Website verknüpft ist.
- IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, das der Zulassungsliste hinzugefügt werden soll.
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 mit Ihrer Website verknüpft ist.
- IP_ADDRESS_OR_SUBNET: Die IP-Adresse oder das Subnetz, das der Zulassungsliste hinzugefügt werden soll.
- 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
In the Google Cloud console, 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.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- KEY: Der reCAPTCHA-Schlüssel, der mit Ihrer Website verknüpft 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 mit Ihrer Website verknüpft 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": ""
}