Para excluir direcciones IP de confianza de la aplicación de reCAPTCHA, crea una lista de permitidas para una clave de reCAPTCHA asociada a tu sitio y añade las direcciones IP y las subredes a esa lista.
También puedes quitar una dirección IP y una subred de la lista de permitidas, así como consultar las direcciones IP y las subredes que se han añadido a la lista de permitidas.
Antes de empezar
Recopila todas las direcciones IP y subredes que quieras añadir a la lista de permitidos.
Identifica las direcciones IP y las subredes que quieras quitar de la lista de entidades permitidas.
Asegúrate de que tienes el siguiente rol de gestión de identidades y accesos: administrador de reCAPTCHA Enterprise (
roles/recaptchaenterprise.admin).
Añadir una dirección IP o una subred a la lista de permitidos
Cuando añades una dirección IP o una subred a la lista de permitidas, reCAPTCHA omite la verificación y siempre asigna una puntuación de 0.9 a las solicitudes procedentes de esa dirección IP o subred.
Puedes añadir un máximo de 1000 direcciones IP y subredes a una lista de permitidas.
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.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- KEY: la clave de reCAPTCHA asociada a tu sitio.
- IP_ADDRESS_OR_SUBNET: la dirección IP o la subred que se debe añadir a la lista de permitidas.
Ejecuta el siguiente comando:
Linux, macOS o 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
- KEY: la clave de reCAPTCHA asociada a tu sitio.
- IP_ADDRESS_OR_SUBNET: la dirección IP o la subred que se debe añadir a la lista de permitidas.
- PROJECT_ID: tu ID de proyecto Google Cloud
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
Método HTTP y URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride
Cuerpo JSON de la solicitud:
{
"ip_override_data": {
"ip": "IP_ADDRESS_OR_SUBNET",
"override_type": "ALLOW"
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$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
Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.
Después de añadir una dirección IP o una subred a la lista de permitidas, los cambios se aplicarán en unos minutos.
Quitar una dirección IP o una subred de la lista de permitidas
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.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- KEY: la clave de reCAPTCHA asociada a tu sitio.
- IP_ADDRESS_OR_SUBNET: la dirección IP o la subred que se debe añadir a la lista de permitidas.
Ejecuta el siguiente comando:
Linux, macOS o 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
- KEY: la clave de reCAPTCHA asociada a tu sitio.
- IP_ADDRESS_OR_SUBNET: la dirección IP o la subred que se debe añadir a la lista de permitidas.
- PROJECT_ID: tu ID de proyecto Google Cloud
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
Método HTTP y URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride
Cuerpo JSON de la solicitud:
{
"ip_override_data": {
"ip": "IP_ADDRESS_OR_SUBNET",
"override_type": "ALLOW"
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json
y ejecuta el siguiente comando:
$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
Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.
Después de quitar una dirección IP o una subred de la lista de permitidas, los cambios se aplicarán en unos minutos.
Lista todas las direcciones IP de la lista de permitidas
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.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- KEY: la clave de reCAPTCHA asociada a tu sitio.
Ejecuta el siguiente comando:
Linux, macOS o 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
- KEY: la clave de reCAPTCHA asociada a tu sitio.
- PROJECT_ID: tu ID de proyecto Google Cloud
REST
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
Método HTTP y URL:
GET https://recaptchaenterprise.googleapis.com/v1/projects//keys/ :listIpOverrides
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recaptchaenterprise.googleapis.com/v1/projects//keys/ :listIpOverrides"
PowerShell
Ejecuta el comando siguiente:
$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
Deberías recibir una respuesta JSON similar a la siguiente:
{
"ipOverrides": [
{
"ip": "1.2.3.4",
"overrideType": "ALLOW"
}
],
"nextPageToken": ""
}