cdncheck

Funktionen • Installation • Verwendung • Discord beitreten


cdncheck ist ein Werkzeug zur Identifizierung der Technologie, die mit DNS-/IP-Netzwerkadressen verbunden ist.

Funktionen

CDN-, CLOUD- und WAF-Erkennung
Einfach als Bibliothek nutzbar
Leicht erweiterbare Anbieter
Unterstützung für IP- und DNS-Eingaben
Text- und JSONL-Ausgabe
Filter für die Ausgabe

Installation

cdncheck erfordert go1.19, um erfolgreich installiert zu werden. Führen Sie den folgenden Befehl aus, um die neueste Version zu installieren:

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

Verwendung

cdncheck -h

Dies zeigt die Hilfe für das Tool an. Hier sind alle Schalter, die es unterstützt.

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

Wie fügt man neue Anbieter hinzu?

Die Datei provider.yaml enthält eine Liste der CDN-, WAF- und Cloud-Anbieter. Die Liste enthält URLs, ASNs und CIDRs, die dann mit dem Programm generate-index zu einer finalen Datei sources_data.json kompiliert werden.

Beispiel einer provider.yaml-Datei -

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"

Neue Anbieter, die von einer URL, einer ASN oder einer Liste statischer CIDRs gescrapt werden können, können der Datei provider.yaml hinzugefügt werden, indem Sie die folgenden einfachen Schritte befolgen:

Forken Sie das GitHub-Repository, das die Datei cmd/generate-index/provider.yaml enthält.
Klonen Sie Ihr geforktes Repository auf Ihren lokalen Rechner und navigieren Sie zum Verzeichnis cmd/generate-index.
Öffnen Sie die Datei provider.yaml und suchen Sie den Abschnitt für den Anbietertyp, den Sie hinzufügen möchten (CDN, WAF oder Cloud).
Fügen Sie die Informationen des neuen Anbieters zum entsprechenden Abschnitt in der Datei provider.yaml hinzu.
Committen Sie Ihre Änderungen mit einer aussagekräftigen Commit-Nachricht.
Pushen Sie Ihre Änderungen in Ihr geforktes Repository auf GitHub.
Eröffnen Sie einen Pull-Request an das ursprüngliche Repository mit Ihren Änderungen.

Andere Anbieter

CNAME- und Wappalyzer-basierte Ergänzungen können in der Datei other.go vorgenommen werden. Fügen Sie einfach die Werte zu den Variablen hinzu und schon kann es losgehen.

// 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 als Bibliothek

Hilfsbibliothek, die prüft, ob eine bestimmte IP auf Cloud / CDN / WAF läuft.

Die Bibliothek kann durch Importieren von github.com/projectdiscovery/cdncheck verwendet werden. Hier folgt ein grundlegendes Beispiel:

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 wurde mit ❤️ vom projectdiscovery-Team entwickelt und unter der MIT-Lizenz veröffentlicht.

cdncheck v1.2.49

Kategorien