Downloads e SDK

Tudo que você precisa para usar o CatSuite e escrever extensões, reunido em um só lugar. O aplicativo é gratuito, sem assinatura e sem paywall, e as ferramentas para desenvolvedores ficam em endereços oficiais: o GitHub para os downloads e o código e o Marketplace do Visual Studio Code para a extensão CatSuite Studio.

Aplicativo CatSuite #

O CatSuite é um aplicativo Android. Baixe pela loja oficial:

• Google Play — CatSuite

Todos os módulos — interceptador, navegador, proxy de rede, Repetir, Intruso, Descobridor, Decodificar, Analisador SSL/TLS, extensões e fluxos — já vêm no aplicativo. Os dados ficam no aparelho. Comece por Primeiros passos.

Repositório oficial no GitHub #

O repositório github.com/netcattest/catsuite reúne o código-fonte e os downloads das ferramentas para desenvolvedores:

Os arquivos prontos ficam nas versões publicadas do repositório, cada uma com o seu arquivo de somas SHA-256:

Confira a integridade #

Compare o SHA-256 de cada arquivo baixado com o valor publicado no SHA256SUMS.txt da mesma versão.

Get-FileHash .\catsuite-sdk-1.4.0.zip -Algorithm SHA256

sha256sum -c --ignore-missing SHA256SUMS.txt

SDK de extensões 1.4.0 #

O SDK reúne tudo para criar plugins do CatSuite: os tipos da API, o runtime de referência, os esquemas, quinze exemplos editáveis e seis modelos de fluxo.

• Baixar o SDK 1.4.0 (ZIP)
• Explorar a pasta sdk no GitHub
• Guia completo do SDK

O ZIP extrai a pasta catsuite-sdk. Não é preciso instalar nada no aparelho para executar extensões: o motor QuickJS roda dentro do aplicativo e o objeto global cat já está disponível para o seu código. Para escrever, escolha onde prefere trabalhar:

• No VS Code, com o CatSuite Studio: sugestões do SDK, validação, prévia local e pacotes .catplug assinados.
• No navegador, com a IDE de extensões: editor com realce, autocompletar, validação, simulador e exportação de .catplug, sem instalar nada.
• Consulte o contrato na Referência da API JavaScript e no Manifesto e pacote .catplug.

declare const cat: {
  readonly apiVersion: 1;
  readonly sdkVersion: "1.4.0";
  events: { on(name: "http.request" | "http.response" | "http.complete", handler: (message: CatMessage) => void | Promise<void>): void };
  proxy: { onRequest(handler: (m: CatMessage) => CatMessage | void): void; onResponse(handler: (m: CatMessage) => CatMessage | void): void };
  http: { send(request: CatRequest): Promise<CatMessage> };
  ui: { tab: { register(options: { id: string; title: CatText; components: CatComponent[] }): void } };
  findings: { add(finding: CatFinding): Promise<string> };
};

CatSuite Studio para VS Code #

O CatSuite Studio é a extensão oficial do CatSuite para o Visual Studio Code: sugestões do SDK ao digitar cat., modelos prontos, validação contínua, prévia local com fixtures e geração de pacotes .catplug assinados.

• Instalar pelo Visual Studio Marketplace
• Baixar o VSIX 1.2.0
• Código-fonte no GitHub

Pelo Marketplace, use a visão Extensões do VS Code e busque por CatSuite Studio, ou a linha de comando:

code --install-extension NetCatTest.catsuite-studio

Com o VSIX baixado, abra Extensões → ⋯ → Instalar do VSIX no VS Code e selecione o arquivo, ou use a linha de comando:

code --install-extension catsuite-studio-1.2.0.vsix

O CatSuite Studio exige o Visual Studio Code 1.100.0 ou superior. Veja o guia completo do CatSuite Studio.

IDE de extensões #

A IDE web roda inteiramente no navegador: nada é enviado para servidores e o simulador não faz conexões de rede. Você cria do zero ou a partir de um exemplo, valida, executa em um simulador fiel ao aplicativo e exporta um .catplug pronto para importar no CatSuite. Veja o guia completo da IDE.

Conector CatBridge #

O CatBridge é opcional e roda no seu computador. A distribuição pronta não exige Go: baixe o pacote do seu sistema, extraia e inicie o serviço. O pareamento usa um código numérico de 24 dígitos, sem QR Code. O passo a passo está em Instalar e parear o CatBridge, e o catálogo de ferramentas em Capacidades e ferramentas.

Documentação para leitura automática #

Toda página desta documentação tem uma versão em Markdown: acrescente .md ao endereço. Há também um índice em texto para modelos de linguagem:

• llms.txt do CatSuite — índice bilíngue do aplicativo e da documentação.
• llms-full.txt — documentação completa em português e inglês em um único arquivo.

Próximo passo #

• SDK de extensões 1.4.0
• CatSuite Studio para VS Code
• Instalar e parear o CatBridge