Para excluir endereços IP fidedignos da aplicação do reCAPTCHA, crie uma lista de autorizações para uma chave do reCAPTCHA associada ao seu site e adicione os endereços IP e as sub-redes a essa lista de autorizações.
Também pode remover um endereço IP e uma sub-rede da lista de autorizações, e listar os endereços IP e as sub-redes que são adicionados à lista de autorizações.
Antes de começar
Reúna todos os endereços IP e sub-redes que quer adicionar à lista de autorizações.
Identifique os endereços IP e as sub-redes que quer remover da lista de autorizações.
Certifique-se de que tem a seguinte função de gestão de identidades e acessos: administrador do reCAPTCHA Enterprise (
roles/recaptchaenterprise.admin).
Adicione um endereço IP ou uma sub-rede à lista de autorizações
Quando adiciona um endereço IP ou uma sub-rede à lista de autorizações, o reCAPTCHA ignora a validação e atribui sempre uma pontuação de 0.9 aos pedidos provenientes desse endereço IP ou sub-rede.
Pode adicionar um máximo de 1000 endereços IP e sub-redes a uma lista de autorizações.
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 qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
- KEY: a chave reCAPTCHA associada ao seu site.
- IP_ADDRESS_OR_SUBNET: o endereço IP ou a sub-rede que tem de ser adicionada à lista de autorizações.
Execute o seguinte comando:
Linux, macOS ou 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: a chave reCAPTCHA associada ao seu site.
- IP_ADDRESS_OR_SUBNET: o endereço IP ou a sub-rede que tem de ser adicionada à lista de autorizações.
- PROJECT_ID: o ID do seu Google Cloud projeto
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride
Corpo JSON do pedido:
{
"ip_override_data": {
"ip": "IP_ADDRESS_OR_SUBNET",
"override_type": "ALLOW"
}
}
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Deve receber um código de estado de êxito (2xx) e uma resposta vazia.
Depois de adicionar um endereço IP ou uma sub-rede à lista de autorizações, as alterações entram em vigor dentro de alguns minutos.
Remova um endereço IP ou uma sub-rede da lista de autorizações
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 qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
- KEY: a chave reCAPTCHA associada ao seu site.
- IP_ADDRESS_OR_SUBNET: o endereço IP ou a sub-rede que tem de ser adicionada à lista de autorizações.
Execute o seguinte comando:
Linux, macOS ou 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: a chave reCAPTCHA associada ao seu site.
- IP_ADDRESS_OR_SUBNET: o endereço IP ou a sub-rede que tem de ser adicionada à lista de autorizações.
- PROJECT_ID: o ID do seu Google Cloud projeto
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
Método HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride
Corpo JSON do pedido:
{
"ip_override_data": {
"ip": "IP_ADDRESS_OR_SUBNET",
"override_type": "ALLOW"
}
}
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json,
e execute o seguinte 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
Deve receber um código de estado de êxito (2xx) e uma resposta vazia.
Depois de remover um endereço IP ou uma sub-rede da lista de autorizações, as alterações entram em vigor dentro de alguns minutos.
Liste todos os endereços IP da lista de autorizações
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 qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
- KEY: a chave reCAPTCHA associada ao seu site.
Execute o seguinte comando:
Linux, macOS ou 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: a chave reCAPTCHA associada ao seu site.
- PROJECT_ID: o ID do seu Google Cloud projeto
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
Método HTTP e URL:
GET https://recaptchaenterprise.googleapis.com/v1/projects//keys/ :listIpOverrides
Para enviar o seu pedido, escolha uma destas opções:
curl
Execute o seguinte comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recaptchaenterprise.googleapis.com/v1/projects//keys/ :listIpOverrides"
PowerShell
Execute o seguinte 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
Deve receber uma resposta JSON semelhante à seguinte:
{
"ipOverrides": [
{
"ip": "1.2.3.4",
"overrideType": "ALLOW"
}
],
"nextPageToken": ""
}