cdncheck

Funcionalidades • Instalação • Uso • Entrar no Discord


cdncheck é uma ferramenta para identificar a tecnologia associada a endereços de rede dns / ip.

Funcionalidades

Detecção de CDN, CLOUD e WAF
Fácil de usar como biblioteca
Provedores facilmente extensíveis
Suporte a entrada de IP, DNS
Saída em texto, JSONL
Filtros na saída

Instalação

cdncheck requer go1.19 para instalar com sucesso. Execute o seguinte comando para instalar a versão mais recente:

go install -v github.com/projectdiscovery/cdncheck/cmd/cdncheck@latest

Uso

cdncheck -h

Isso exibirá a ajuda da ferramenta. Aqui estão todas as opções que ela suporta.

Usage:
  ./cdncheck [flags]

Flags:
INPUT:
   -i, -input string[]  list of ip / dns to process

DETECTION:
   -cdn    display only cdn in cli output
   -cloud  display only cloud in cli output
   -waf    display only waf in cli output

MATCHER:
   -mcdn, -match-cdn string[]      match host with specified cdn provider (cloudfront, fastly, google, leaseweb)
   -mcloud, -match-cloud string[]  match host with specified cloud provider (aws, google, oracle)
   -mwaf, -match-waf string[]      match host with specified waf provider (cloudflare, incapsula, sucuri, akamai)

FILTER:
   -fcdn, -filter-cdn string[]      filter host with specified cdn provider (cloudfront, fastly, google, leaseweb)
   -fcloud, -filter-cloud string[]  filter host with specified cloud provider (aws, google, oracle)
   -fwaf, -filter-waf string[]      filter host with specified waf provider (cloudflare, incapsula, sucuri, akamai)

OUTPUT:
   -resp               display technology name in cli output
   -o, -output string  write output in plain format to file
   -v, -verbose        display verbose output
   -j, -jsonl          write output in json(line) format
   -nc, -no-color      disable colors in cli output
   -version            display version of the project
   -silent             only display results in output

CONFIG:
   -r, -resolver string[]  list of resolvers to use (file or comma separated)
   -e, -exclude            exclude detected ip from output
   -retry int              maximum number of retries for dns resolution (must be at least 1) (default 2)

UPDATE:
   -up, -update                 update cdncheck to latest version
   -duc, -disable-update-check  disable automatic cdncheck update check

Como adicionar novos provedores?

O arquivo provider.yaml contém uma lista de provedores CDN, WAF e Cloud. A lista contém URLs, ASNs e CIDRs que são então compilados em um arquivo final sources_data.json usando o programa generate-index.

Exemplo do arquivo provider.yaml:

cdn:
  # asn contains the ASN numbers for providers
  asn:
    leaseweb:
      - AS60626

  # urls contains a list of URLs for CDN providers
  urls:
    cloudfront:
      - https://d7uri8nf7uskq.cloudfront.net/tools/list-cloudfront-ips
    fastly:
      - https://api.fastly.com/public-ip-list

  # cidr contains the CIDR ranges for providers
  cidr:
    akamai:
      - "23.235.32.0/20"
      - "43.249.72.0/22"
      - "103.244.50.0/24"
      - "103.245.222.0/23"
      - "103.245.224.0/24"
      - "104.156.80.0/20"

Novos provedores que podem ser obtidos a partir de uma URL, ASN ou uma lista de CIDR estáticos podem ser adicionados ao arquivo provider.yaml seguindo os passos simples abaixo:

Faça um fork do repositório GitHub que contém o arquivo cmd/generate-index/provider.yaml.
Clone seu repositório forkado para sua máquina local e navegue até o diretório cmd/generate-index.
Abra o arquivo provider.yaml e localize a seção para o tipo de provedor que deseja adicionar (CDN, WAF ou Cloud).
Adicione as informações do novo provedor à seção apropriada no arquivo provider.yaml.
Faça commit das suas alterações com uma mensagem descritiva.
Envie suas alterações para o repositório forkado no GitHub.
Abra um pull request para o repositório original com suas alterações.

Outros provedores

Adições baseadas em CNAME e Wappalyzer podem ser feitas no arquivo other.go. Basta adicionar os valores às variáveis e pronto.

// cdnCnameDomains contains a map of CNAME to domains to cdns
var cdnCnameDomains = map[string]string{
	"cloudfront.net":         "amazon",
	"amazonaws.com":          "amazon",
    ...
}

// cdnWappalyzerTechnologies contains a map of wappalyzer technologies to cdns
var cdnWappalyzerTechnologies = map[string]string{
	"imperva":    "imperva",
	"incapsula":  "incapsula",
	...
}

cdncheck como biblioteca

Biblioteca auxiliar que verifica se um determinado IP está em Cloud / CDN / WAF.

A biblioteca pode ser usada importando github.com/projectdiscovery/cdncheck. Aqui está um exemplo básico:

package main

import (
	"fmt"
	"net"
	"github.com/projectdiscovery/cdncheck"
)

func main() {
	client := cdncheck.New()
	ip := net.ParseIP("173.245.48.12")

	// checks if an IP is contained in the cdn denylist
	matched, val, err := client.CheckCDN(ip)
	if err != nil {
		panic(err)
	}

	if matched {
		fmt.Printf("%v is a %v\n", ip, val)
	} else {
		fmt.Printf("%v is not a CDN\n", ip)
	}

	// checks if an IP is contained in the cloud denylist
	matched, val, err = client.CheckCloud(ip)
	if err != nil {
		panic(err)
	}

	if matched {
		fmt.Printf("%v is a %v\n", ip, val)
	} else {
		fmt.Printf("%v is not a Cloud\n", ip)
	}

	// checks if an IP is contained in the waf denylist
	matched, val, err = client.CheckWAF(ip)
	if err != nil {
		panic(err)
	}

	if matched {
		fmt.Printf("%v WAF is %v\n", ip, val)
	} else {
		fmt.Printf("%v is not a WAF\n", ip)
	}
}

cdncheck é feito com ❤️ pela equipe do projectdiscovery e distribuído sob Licença MIT.

Ler mais

cdncheck v1.2.49

Categorias