Configura una lista de entidades permitidas de direcciones IP

Para excluir direcciones IP de confianza de la aplicación forzosa de reCAPTCHA, debes crear una lista de entidades permitidas para una clave de reCAPTCHA asociada con tu sitio y agregar las direcciones IP y las subredes a esa lista.

También puedes quitar una dirección IP y una subred de la lista de entidades permitidas, y enumerar las direcciones IP y las subredes que se agregaron a la lista.

Antes de comenzar

• Recopila todas las direcciones IP y subredes que quieras agregar a la lista de entidades permitidas.

• Identifica las direcciones IP y las subredes que deseas quitar de la lista de entidades permitidas.

• Asegúrate de tener el siguiente rol de administración de identidades y accesos: Administrador de reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).

Agrega una dirección IP o subred a la lista de entidades permitidas

Cuando agregas una dirección IP o una subred a la lista de entidades permitidas, reCAPTCHA omite la verificación y siempre otorga una puntuación de 0.9 a las solicitudes que provienen de esa dirección IP o subred. Puedes agregar un máximo de 100 direcciones IP y subredes a una lista de entidades permitidas.

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. Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

   • KEY: Es la clave de reCAPTCHA asociada con tu sitio.
   • IP_ADDRESS_OR_SUBNET: Es la dirección IP o subred que se debe agregar a la lista de entidades permitidas.

   Ejecuta el siguiente comando:

   Linux, macOS o Cloud Shell

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

   Windows (PowerShell)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

   Windows (cmd.exe)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• KEY: Es la clave de reCAPTCHA asociada con tu sitio.
• IP_ADDRESS_OR_SUBNET: Es la dirección IP o subred que se debe agregar a la lista de entidades permitidas.
• PROJECT_ID: El Google Cloud ID de tu proyecto

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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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 exitoso (2xx) y una respuesta vacía.

Después de agregar una dirección IP o una subred a la lista de entidades permitidas, los cambios se aplican en unos minutos.

Quita una dirección IP o subred de la lista de entidades permitidas

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. Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

   • KEY: Es la clave de reCAPTCHA asociada con tu sitio.
   • IP_ADDRESS_OR_SUBNET: Es la dirección IP o subred que se debe agregar a la lista de entidades permitidas.

   Ejecuta el siguiente comando:

   Linux, macOS o Cloud Shell

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

   Windows (PowerShell)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

   Windows (cmd.exe)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• KEY: Es la clave de reCAPTCHA asociada con tu sitio.
• IP_ADDRESS_OR_SUBNET: Es la dirección IP o subred que se debe agregar a la lista de entidades permitidas.
• PROJECT_ID: El Google Cloud ID de tu proyecto

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

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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 exitoso (2xx) y una respuesta vacía.

Después de quitar una dirección IP o una subred de la lista de entidades permitidas, los cambios se aplican en unos minutos.

Cómo ver todas las direcciones IP de la lista de entidades permitidas

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. Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

   • KEY: Es la clave de reCAPTCHA asociada con tu sitio.

   Ejecuta el siguiente comando:

   Linux, macOS o Cloud Shell

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

   Windows (PowerShell)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

   Windows (cmd.exe)

   Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

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

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• KEY: Es la clave de reCAPTCHA asociada con tu sitio.
• PROJECT_ID: El Google Cloud ID de tu proyecto

Método HTTP y URL:

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$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 que se muestra a continuación:

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

¿Qué sigue?

• Cómo crear evaluaciones para sitios web