Imperva (Incapsula)

Atenção!

Para executar esta tarefa, utilize os seus próprios proxies.
Se o proxy usar autenticação por IP, é necessário adicionar o endereço 65.21.190.34 à lista de permissões (whitelist).
Após a resolução, você receberá cookies especiais, que devem ser adicionados ao navegador.

Parâmetros da solicitação

IMPORTANTE: alguns valores de parâmetros são dinâmicos — eles mudam a cada renderização da página que contém Imperva.
Extraia-os imediatamente antes de criar a tarefa para evitar erros durante a resolução.
Veja exemplos de extração automática de parâmetros na seção Como encontrar todos os parâmetros necessários para criar uma tarefa.

type<string>required

CustomTask

class<string>required

Imperva

websiteURL<string>required

O endereço da página principal onde o Incapsula está localizado.

incapsulaScriptUrl (dentro da metadata)<string>required

"incapsulaScriptUrl": "_Incapsula_Resource?SWJIYLWA=719d34d31c8e3a6e6fffd425f7e032f3" - Nome do arquivo JS do Incapsula.

incapsulaCookies (dentro da metadata)<string>required

Seus cookies do Incapsula. Eles podem ser obtidos na página usando document.cookie ou no cabeçalho da requisição Set-Cookie: "incap_sess_*=...; visid_incap_*=..." (veja o exemplo de requisição /createTask).

proxyType<string>required

http - proxy http/https comum;
https - tente esta opção apenas se "http" não funcionar (necessário para alguns proxies personalizados);
socks4 - proxy socks4;
socks5 - proxy socks5.

proxyAddress<string>required

Endereço IP do proxy IPv4/IPv6. Não é permitido:

uso de proxies transparentes (que revelem o IP do cliente);
uso de proxies em máquinas locais.

proxyPort<integer>required

Porta do proxy.

proxyLogin<string>required

proxyPassword<string>required

Senha do servidor proxy.

reese84UrlEndpoint (dentro da metadata)<string>optional

O nome do endpoint para onde a impressão digital reese84 é enviada pode ser encontrado entre as solicitações e termina com ?d=site.com.

userAgent<string>optional

User-Agent do navegador. Use o valor atual compatível com o CapMonster Cloud: userAgentPlaceholder

Você pode obter o valor mais recente em: https://capmonster.cloud/api/useragent/actual.

Criar método de tarefa

POST

https://api.capmonster.cloud/createTask

Exemplo de requisição

{
  "clientKey": "API_KEY",
  "task": {
    "type": "CustomTask",
    "class": "Imperva",
    "websiteURL": "https://yourwebsite.com/page-with-imperva",
    "userAgent": "userAgentPlaceholder",
    "metadata": {
      "incapsulaScriptUrl": "_Incapsula_Resource?example-parameter=example-value",
      "incapsulaCookies": "example-session-cookie=your-session-cookie; example-visitor-cookie=your-visitor-cookie;",
      "reese84UrlEndpoint": "your-reese84-url-endpoint"
    },
    "proxyType": "your-proxy-type",
    "proxyAddress": "your-proxy-address",
    "proxyPort": 1234,
    "proxyLogin": "your-proxy-login",
    "proxyPassword": "your-proxy-password"
  }
}

Exemplo de resposta

{
  "errorId": 0,
  "taskId": 407533072
}

Obter resultado da tarefa

Use o método getTaskResult para obter a solução Imperva.

POST

https://api.capmonster.cloud/getTaskResult

Exemplo de requisição

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

Exemplo de resposta

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "domains": {
      "https://example.com": {
        "cookies": {
          "___utmvc": "NMB+nRa4inxXNeXuhPl9w4opzdo...E4OTU2OGEwNzI2ODlkODc4MWIwNmU3MQ==; Max-Age=31536000; Domain=.site.com; Path=/; Secure; SameSite=Lax"
        }
      }
    }
  }
}

Access denied

Error 16 - este erro está relacionado ao uso de servidores proxy que não correspondem à geolocalização exigida.

Como encontrar todos os parâmetros necessários para criar uma tarefa

Automaticamente

Para automatizar a extração dos parâmetros, eles podem ser obtidos via navegador (normal ou headless, por exemplo, usando Playwright) ou diretamente a partir de requisições HTTP. Como os valores dos parâmetros dinâmicos têm curta duração, recomenda-se utilizá-los imediatamente após a extração.

Importante!

Os trechos de código fornecidos são exemplos básicos para aprendizado sobre como extrair os parâmetros necessários. A implementação exata dependerá do seu site com captcha, sua estrutura e os elementos HTML e seletores utilizados.

JavaScript
Python
C#

Mostrar código (Node.js)

import { chromium } from "playwright";

(async () => {
  const browser = await chromium.launch({ headless: false });
  const page = await browser.newPage();

  await page.goto("https://www.example.com/");

  // Extraia o atributo src do iframe com id main-iframe
  const iframeSrc = await page.$eval("#main-iframe", (iframe) =>
    iframe.getAttribute("src")
  );
  console.log("src do iframe:", iframeSrc);

  // Obtenha todos os cookies
  const cookies = await page.context().cookies();

  // Filtre cookies que começam com visid_incap_ ou incap_ses_
  const filteredCookies = cookies.filter(
    (cookie) =>
      cookie.name.startsWith("visid_incap_") ||
      cookie.name.startsWith("incap_ses_")
  );

  filteredCookies.forEach((cookie) => {
    console.log(`${cookie.name}=${cookie.value}`);
  });

  await browser.close();
})();

Mostrar código

import asyncio
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False)
        page = await browser.new_page()

        await page.goto("https://www.example.com/")

        # Extraia o atributo src do iframe com id main-iframe
        iframe_src = await page.locator("#main-iframe").get_attribute("src")
        print("src do iframe:", iframe_src)  # Exibe o valor do src

        # Obtenha todos os cookies
        cookies = await page.context.cookies()

        # Filtre cookies que começam com visid_incap_ ou incap_ses_
        filtered_cookies = [
            cookie for cookie in cookies
            if cookie["name"].startswith("visid_incap_") or cookie["name"].startswith("incap_ses_")
        ]

        for cookie in filtered_cookies:
            print(f"{cookie['name']}={cookie['value']}")

        await browser.close()

asyncio.run(main())

Mostrar código

using System;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.Playwright;

class Program
{
    public static async Task Main(string[] args)
    {
        var playwright = await Playwright.CreateAsync();
        var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions { Headless = false });
        var page = await browser.NewPageAsync();

        await page.GotoAsync("https://www.example.com/");

        // Extraia o atributo src do iframe com id main-iframe
        var iframeSrc = await page.GetAttributeAsync("#main-iframe", "src");
        Console.WriteLine("src do iframe: " + iframeSrc); // Exibe o valor do src

        // Obtenha todos os cookies
        var cookies = await page.Context.CookiesAsync();

        // Filtre cookies que começam com visid_incap_ ou incap_ses_
        var filteredCookies = cookies.Where(cookie =>
            cookie.Name.StartsWith("visid_incap_") || cookie.Name.StartsWith("incap_ses_"));

        foreach (var cookie in filteredCookies)
        {
            Console.WriteLine($"{cookie.Name}={cookie.Value}");
        }

        await browser.CloseAsync();
    }
}

Usar biblioteca SDK

JavaScript / TypeScript
Python
C#

Mostrar código (para navegador)

// https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver

import {
  CapMonsterCloudClientFactory,
  ClientOptions,
  ImpervaRequest
} from "@zennolab_com/capmonstercloud-client";

document.addEventListener("DOMContentLoaded", async () => {

  const API_KEY = "YOUR_API_KEY"; // Informe sua chave de API do CapMonster Cloud

  const client = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: API_KEY })
  );

  // O Imperva (Incapsula) só pode ser resolvido usando seu próprio proxy
  const proxy = {
    proxyType: "http",
    proxyAddress: "123.45.67.89",
    proxyPort: 8080,
    proxyLogin: "username",
    proxyPassword: "password",
  };

  const impervaRequest = new ImpervaRequest({
    websiteURL: "https://yourwebsite.com/page-with-imperva",
    metadata: {
      incapsulaScriptUrl:
        "_Incapsula_Resource?SWJIYLWA=1234567890abcdef1234567890abcdef",
      incapsulaCookies:
        "incap_ses_1234_5678901=testSessionValue1234567890abcdef==; " +
        "visid_incap_5678901=testVisitorValue1234567890abcdef==;",
    },
    proxy,
  });

  // Se necessário, você pode verificar o saldo
  const balance = await client.getBalance();
  console.log("Balance:", balance);

  const result = await client.Solve(impervaRequest);
  console.log("Solution:", result.solution);
});

Mostrar código (Node.js)

// https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver

const {
  CapMonsterCloudClientFactory,
  ClientOptions,
  ImpervaRequest,
} = require("@zennolab_com/capmonstercloud-client");

const API_KEY = "YOUR_API_KEY"; // Informe sua chave de API do CapMonster Cloud

async function solveImperva() {
  const client = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: API_KEY }),
  );

  // O Imperva (Incapsula) só pode ser resolvido usando seu próprio proxy
  const proxy = {
    proxyType: "http",
    proxyAddress: "123.45.67.89",
    proxyPort: 8080,
    proxyLogin: "username",
    proxyPassword: "password",
  };

  const impervaRequest = new ImpervaRequest({
    websiteURL: "https://yourwebsite.com/page-with-imperva",
    metadata: {
      incapsulaScriptUrl:
        "_Incapsula_Resource?SWJIYLWA=1234567890abcdef1234567890abcdef",
      incapsulaCookies:
        "incap_ses_1234_5678901=testSessionValue1234567890abcdef==; " +
        "visid_incap_5678901=testVisitorValue1234567890abcdef==;",
    },
    proxy,
  });

  // Se necessário, você pode verificar o saldo
  const balance = await client.getBalance();
  console.log("Balance:", balance);

  const result = await client.Solve(impervaRequest);
  console.log("Solution:", result.solution);
}

solveImperva().catch(console.error);

Mostrar código

# https://github.com/CapMonsterCloud/capmonster-python-captcha-solver

import asyncio

from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import ImpervaCustomTaskRequest
from capmonstercloudclient.requests.proxy_info import ProxyInfo

API_KEY = "YOUR_API_KEY"  # Informe sua chave de API do CapMonster Cloud


async def main():
    client = CapMonsterClient(
        options=ClientOptions(api_key=API_KEY)
    )

    # O Imperva (Incapsula) só pode ser resolvido usando seu próprio proxy
    proxy = ProxyInfo(
        proxyType="http",
        proxyAddress="123.45.67.89",
        proxyPort=8080,
        proxyLogin="username",
        proxyPassword="password",
    )

    imperva_request = ImpervaCustomTaskRequest(
        websiteUrl="https://yourwebsite.com/page-with-imperva",
        metadata={
            "incapsulaScriptUrl": (
                "_Incapsula_Resource?SWJIYLWA=1234567890abcdef1234567890abcdef"
            ),
            "incapsulaCookies": (
                "incap_ses_1234_5678901=testSessionValue1234567890abcdef==; "
                "visid_incap_5678901=testVisitorValue1234567890abcdef==;"
            ),
        },
        proxy=proxy,
    )

    # Se necessário, você pode verificar o saldo
    balance = await client.get_balance()
    print("Balance:", balance)

    result = await client.solve_captcha(imperva_request)
    print("Solution:", result)


asyncio.run(main())

Mostrar código

// https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver

using System;
using System.Threading.Tasks;
using Newtonsoft.Json;
using Zennolab.CapMonsterCloud;
using Zennolab.CapMonsterCloud.Requests;

class Program
{
    static async Task Main(string[] args)
    {
        // Informe sua chave de API do CapMonster Cloud
        var clientOptions = new ClientOptions
        {
            ClientKey = "YOUR_API_KEY"
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        // O Imperva (Incapsula) só pode ser resolvido usando seu próprio proxy
        var impervaRequest = new ImpervaCustomTaskRequest(
            "_Incapsula_Resource?SWJIYLWA=1234567890abcdef1234567890abcdef",
            "incap_ses_1234_5678901=testSessionValue1234567890abcdef==; " +
            "visid_incap_5678901=testVisitorValue1234567890abcdef==;",
            "Built-with-the-Example-Test-Value-"
        )
        {
            WebsiteUrl = "https://yourwebsite.com/page-with-imperva",

            Proxy = new ProxyContainer(
                "123.45.67.89",
                8080,
                ProxyType.Http,
                "username",
                "password"
            )
        };

        // Se necessário, você pode verificar o saldo
        var balance = await cmCloudClient.GetBalanceAsync();
        Console.WriteLine("Balance: " + balance);

        var impervaResult =
            await cmCloudClient.SolveAsync(impervaRequest);

        Console.WriteLine("Solution:");
        Console.WriteLine(
            JsonConvert.SerializeObject(
                impervaResult.Solution,
                Formatting.Indented
            )
        );
    }
}

Parâmetros da solicitação​

Criar método de tarefa​

Obter resultado da tarefa​

Access denied​

Como encontrar todos os parâmetros necessários para criar uma tarefa​

Automaticamente​

Usar biblioteca SDK​

Parâmetros da solicitação

Criar método de tarefa

Obter resultado da tarefa

Access denied

Como encontrar todos os parâmetros necessários para criar uma tarefa

Automaticamente

Usar biblioteca SDK