mirror of
https://github.com/maride/pancap.git
synced 2024-11-24 09:44:25 +00:00
Compare commits
4 Commits
21c956c545
...
0430a1b214
Author | SHA1 | Date | |
---|---|---|---|
0430a1b214 | |||
112c027950 | |||
2f44d92262 | |||
800b4805f8 |
@ -2,11 +2,10 @@ package analyze
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"log"
|
|
||||||
|
|
||||||
"github.com/google/gopacket"
|
|
||||||
"github.com/maride/pancap/output"
|
"github.com/maride/pancap/output"
|
||||||
"github.com/maride/pancap/protocol"
|
"github.com/maride/pancap/protocol"
|
||||||
|
"github.com/google/gopacket"
|
||||||
|
"log"
|
||||||
)
|
)
|
||||||
|
|
||||||
var (
|
var (
|
||||||
@ -40,9 +39,6 @@ func Analyze(source *gopacket.PacketSource) error {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Register communication for graph
|
|
||||||
output.AddPkgToGraph(packet)
|
|
||||||
|
|
||||||
// Raise statistics
|
// Raise statistics
|
||||||
totalPackets += 1
|
totalPackets += 1
|
||||||
if processed {
|
if processed {
|
||||||
@ -72,3 +68,4 @@ func handleErr(err error) {
|
|||||||
log.Printf("Encountered error while examining packets, continuing anyway. Error: %s", err.Error())
|
log.Printf("Encountered error while examining packets, continuing anyway. Error: %s", err.Error())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
9
file.go
9
file.go
@ -3,30 +3,29 @@ package main
|
|||||||
import (
|
import (
|
||||||
"flag"
|
"flag"
|
||||||
"fmt"
|
"fmt"
|
||||||
|
|
||||||
"github.com/google/gopacket"
|
"github.com/google/gopacket"
|
||||||
"github.com/google/gopacket/layers"
|
"github.com/google/gopacket/layers"
|
||||||
"github.com/google/gopacket/pcap"
|
"github.com/google/gopacket/pcap"
|
||||||
)
|
)
|
||||||
|
|
||||||
var (
|
var (
|
||||||
filenameFlag string
|
filenameFlag *string
|
||||||
)
|
)
|
||||||
|
|
||||||
// Registers the flag --file
|
// Registers the flag --file
|
||||||
func registerFileFlags() {
|
func registerFileFlags() {
|
||||||
flag.StringVar(&filenameFlag, "file", "", "PCAP file to base analysis on")
|
filenameFlag = flag.String("file", "", "PCAP file to base analysis on")
|
||||||
}
|
}
|
||||||
|
|
||||||
// Opens the PCAP, returns its packets and the link type or an error
|
// Opens the PCAP, returns its packets and the link type or an error
|
||||||
func openPCAP() (*gopacket.PacketSource, layers.LinkType, error) {
|
func openPCAP() (*gopacket.PacketSource, layers.LinkType, error) {
|
||||||
// Check if we even got a file.
|
// Check if we even got a file.
|
||||||
if filenameFlag == "" {
|
if *filenameFlag == "" {
|
||||||
return nil, 0, fmt.Errorf("missing file to analyze. Please specifiy it with --file")
|
return nil, 0, fmt.Errorf("missing file to analyze. Please specifiy it with --file")
|
||||||
}
|
}
|
||||||
|
|
||||||
// Open specified file
|
// Open specified file
|
||||||
handle, openErr := pcap.OpenOffline(filenameFlag)
|
handle, openErr := pcap.OpenOffline(*filenameFlag)
|
||||||
if openErr != nil {
|
if openErr != nil {
|
||||||
// There were some problems opening the file
|
// There were some problems opening the file
|
||||||
return nil, 0, openErr
|
return nil, 0, openErr
|
||||||
|
8
main.go
8
main.go
@ -3,12 +3,11 @@ package main
|
|||||||
import (
|
import (
|
||||||
"flag"
|
"flag"
|
||||||
"fmt"
|
"fmt"
|
||||||
|
"github.com/maride/pancap/analyze"
|
||||||
|
"github.com/maride/pancap/output"
|
||||||
"log"
|
"log"
|
||||||
"math/rand"
|
"math/rand"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
"github.com/maride/pancap/analyze"
|
|
||||||
"github.com/maride/pancap/output"
|
|
||||||
)
|
)
|
||||||
|
|
||||||
func main() {
|
func main() {
|
||||||
@ -37,9 +36,6 @@ func main() {
|
|||||||
// Extract found and requested files
|
// Extract found and requested files
|
||||||
output.StoreFiles()
|
output.StoreFiles()
|
||||||
|
|
||||||
// Create communication graph
|
|
||||||
output.CreateGraph()
|
|
||||||
|
|
||||||
// Show user analysis
|
// Show user analysis
|
||||||
analyze.PrintSummary()
|
analyze.PrintSummary()
|
||||||
|
|
||||||
|
@ -46,12 +46,12 @@ func StoreFiles() {
|
|||||||
var filesToExtract []File
|
var filesToExtract []File
|
||||||
|
|
||||||
// Check different flag scenarios
|
// Check different flag scenarios
|
||||||
if targetAllFiles {
|
if *targetAllFiles {
|
||||||
// We should extract all files.
|
// We should extract all files.
|
||||||
filesToExtract = registeredFiles
|
filesToExtract = registeredFiles
|
||||||
} else {
|
} else {
|
||||||
// We should extract only a given set of files
|
// We should extract only a given set of files
|
||||||
fileList := strings.Split(targetFiles, ",")
|
fileList := strings.Split(*targetFiles, ",")
|
||||||
for _, f := range fileList {
|
for _, f := range fileList {
|
||||||
// Iterate over desired files
|
// Iterate over desired files
|
||||||
found := false
|
found := false
|
||||||
@ -80,7 +80,7 @@ func StoreFiles() {
|
|||||||
|
|
||||||
// Writes the given file object to disk, along with a stats file placed next to it.
|
// Writes the given file object to disk, along with a stats file placed next to it.
|
||||||
func writeOut(f File) {
|
func writeOut(f File) {
|
||||||
targetName := fmt.Sprintf("%s%c%s", targetOutput, os.PathSeparator, f.hash)
|
targetName := fmt.Sprintf("%s%c%s", *targetOutput, os.PathSeparator, f.hash)
|
||||||
targetDescName := fmt.Sprintf("%s.info", targetName)
|
targetDescName := fmt.Sprintf("%s.info", targetName)
|
||||||
targetDescription := fmt.Sprintf("Filename: %s\nHash: %s\nOrigin: %s\nSize: %d", f.name, f.hash, f.origin, len(f.content))
|
targetDescription := fmt.Sprintf("Filename: %s\nHash: %s\nOrigin: %s\nSize: %d", f.name, f.hash, f.origin, len(f.content))
|
||||||
|
|
||||||
|
@ -3,19 +3,19 @@ package output
|
|||||||
import "flag"
|
import "flag"
|
||||||
|
|
||||||
var (
|
var (
|
||||||
fullOutput bool
|
fullOutput *bool
|
||||||
printEmptyBlocks bool
|
printEmptyBlocks *bool
|
||||||
targetFiles string
|
targetFiles *string
|
||||||
targetAllFiles bool
|
targetAllFiles *bool
|
||||||
targetOutput string
|
targetOutput *string
|
||||||
graphOutput string
|
|
||||||
)
|
)
|
||||||
|
|
||||||
func RegisterFlags() {
|
func RegisterFlags() {
|
||||||
flag.BoolVar(&fullOutput, "full-output", false, "Show full output instead of limiting submodule output")
|
fullOutput = flag.Bool("full-output", false, "Show full output instead of limiting submodule output")
|
||||||
flag.BoolVar(&printEmptyBlocks, "print-empty-blocks", false, "Prints blocks (submodule output) even if the submodule doesn't have any content to print.")
|
printEmptyBlocks = flag.Bool("print-empty-blocks", false, "Prints blocks (submodule output) even if the submodule doesn't have any content to print.")
|
||||||
flag.StringVar(&targetFiles, "extract-these", "", "Comma-separated list of files to extract.")
|
targetFiles = flag.String("extract-these", "", "Comma-separated list of files to extract.")
|
||||||
flag.BoolVar(&targetAllFiles, "extract-all", false, "Extract all files found.")
|
targetAllFiles = flag.Bool("extract-all", false, "Extract all files found.")
|
||||||
flag.StringVar(&targetOutput, "extract-to", "./extracted", "Directory to store extracted files in.")
|
targetOutput = flag.String("extract-to", "./extracted", "Directory to store extracted files in.")
|
||||||
flag.StringVar(&graphOutput, "create-graph", "", "Create a Graphviz graph out of collected communication")
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
103
output/graph.go
103
output/graph.go
@ -1,103 +0,0 @@
|
|||||||
package output
|
|
||||||
|
|
||||||
import (
|
|
||||||
"crypto/sha256"
|
|
||||||
"fmt"
|
|
||||||
"io/ioutil"
|
|
||||||
|
|
||||||
"github.com/google/gopacket"
|
|
||||||
)
|
|
||||||
|
|
||||||
var graphPkgs []GraphPkg
|
|
||||||
|
|
||||||
// AddPkgToGraph adds the given packet as communication to the graph
|
|
||||||
func AddPkgToGraph(pkg gopacket.Packet) {
|
|
||||||
// Only proceed if pkg contains a network layer
|
|
||||||
if pkg.NetworkLayer() == nil {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
src := pkg.NetworkLayer().NetworkFlow().Src().String()
|
|
||||||
dst := pkg.NetworkLayer().NetworkFlow().Dst().String()
|
|
||||||
|
|
||||||
// Search for the given communication pair
|
|
||||||
for _, p := range graphPkgs {
|
|
||||||
if p.from == src && p.to == dst {
|
|
||||||
// Communication pair found, add protocol and finish
|
|
||||||
p.AddProtocol("nil")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Communcation pair was not in graphPkgs, add to it
|
|
||||||
graphPkgs = append(graphPkgs, GraphPkg{
|
|
||||||
from: src,
|
|
||||||
to: dst,
|
|
||||||
protocol: []string{""},
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
// CreateGraph writes out a Graphviz digraph
|
|
||||||
func CreateGraph() {
|
|
||||||
if graphOutput == "" {
|
|
||||||
// No graph requested
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Start with the Graphviz-specific header
|
|
||||||
dot := fmt.Sprintf("# Compile with `neato -Tpng %s > %s.png`\n", graphOutput, graphOutput)
|
|
||||||
dot += "digraph pancap {\n\toverlap = false;\n"
|
|
||||||
|
|
||||||
// First, gather all nodes as-is and write them out
|
|
||||||
dot += nodedef(graphPkgs)
|
|
||||||
|
|
||||||
// Iterate over communication
|
|
||||||
for _, p := range graphPkgs {
|
|
||||||
dot += fmt.Sprintf("\tn%s->n%s\n", hash(p.from), hash(p.to))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Close
|
|
||||||
dot += "}\n"
|
|
||||||
|
|
||||||
// Write out
|
|
||||||
ioutil.WriteFile(graphOutput, []byte(dot), 0644)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Creates a list of distinct nodes, Graphviz-compatible
|
|
||||||
func nodedef(pkgs []GraphPkg) string {
|
|
||||||
output := ""
|
|
||||||
nodes := []string{}
|
|
||||||
for _, p := range graphPkgs {
|
|
||||||
// Check if src and dst are already present in nodes array
|
|
||||||
srcFound := false
|
|
||||||
dstFound := false
|
|
||||||
for _, n := range nodes {
|
|
||||||
if p.from == n {
|
|
||||||
srcFound = true
|
|
||||||
}
|
|
||||||
if p.to == n {
|
|
||||||
dstFound = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if !srcFound {
|
|
||||||
// src not yet present, add to node list
|
|
||||||
nodes = append(nodes, p.from)
|
|
||||||
}
|
|
||||||
if !dstFound {
|
|
||||||
// dst not yet present, add to node list
|
|
||||||
nodes = append(nodes, p.to)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Output Graphviz-compatible node definition
|
|
||||||
for _, n := range nodes {
|
|
||||||
// As the Graphviz charset for nodes is rather small, rely on hashes
|
|
||||||
output += fmt.Sprintf("\tn%s[label=\"%s\"]\n", hash(n), n)
|
|
||||||
}
|
|
||||||
|
|
||||||
return output
|
|
||||||
}
|
|
||||||
|
|
||||||
func hash(s string) string {
|
|
||||||
return fmt.Sprintf("%x", sha256.Sum256([]byte(s)))[:6]
|
|
||||||
}
|
|
@ -1,19 +0,0 @@
|
|||||||
package output
|
|
||||||
|
|
||||||
// GraphPkg resembles a directed communication from one address to another
|
|
||||||
// It wraps up required information to draw a graph of the communication, including spoken protocols.
|
|
||||||
type GraphPkg struct {
|
|
||||||
from string
|
|
||||||
to string
|
|
||||||
protocol []string
|
|
||||||
}
|
|
||||||
|
|
||||||
// AddProtocol adds the given protocol to the list of protocols if not already present
|
|
||||||
func (p *GraphPkg) AddProtocol(protocol string) {
|
|
||||||
for _, p := range p.protocol {
|
|
||||||
if p == protocol {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
p.protocol = append(p.protocol, protocol)
|
|
||||||
}
|
|
@ -23,10 +23,4 @@ func Finalize() {
|
|||||||
// User avoided the files
|
// User avoided the files
|
||||||
printer.Println("Files found in stream. Add --extract-all or --extract-these <list> to extract them.")
|
printer.Println("Files found in stream. Add --extract-all or --extract-these <list> to extract them.")
|
||||||
}
|
}
|
||||||
|
|
||||||
// Check if something graph-worthy was collected
|
|
||||||
if graphOutput == "" && len(graphPkgs) > 0 {
|
|
||||||
// User didn't want a graph
|
|
||||||
printer.Println("To summarize the communcation flow with a Graphviz graph, specify --create-graph <out.dot>.")
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
@ -2,9 +2,8 @@ package output
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"strings"
|
|
||||||
|
|
||||||
"github.com/fatih/color"
|
"github.com/fatih/color"
|
||||||
|
"strings"
|
||||||
)
|
)
|
||||||
|
|
||||||
const (
|
const (
|
||||||
@ -22,7 +21,7 @@ var (
|
|||||||
// If the content is longer than MaxContentLines, content is cut.
|
// If the content is longer than MaxContentLines, content is cut.
|
||||||
func PrintBlock(headline string, content string) {
|
func PrintBlock(headline string, content string) {
|
||||||
// Avoid printing empty blocks - at least if user didn't specify it otherwise
|
// Avoid printing empty blocks - at least if user didn't specify it otherwise
|
||||||
if len(content) == 0 && !printEmptyBlocks {
|
if len(content) == 0 && !*printEmptyBlocks {
|
||||||
// No content and we are not forced to print empty blocks, return
|
// No content and we are not forced to print empty blocks, return
|
||||||
DidAvoidEmptyBlock = true
|
DidAvoidEmptyBlock = true
|
||||||
return
|
return
|
||||||
@ -39,7 +38,7 @@ func PrintBlock(headline string, content string) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Cut to MaxContentLines if required
|
// Cut to MaxContentLines if required
|
||||||
if !(fullOutput) {
|
if !(*fullOutput) {
|
||||||
// User states that they don't want to see the whole output - cut content.
|
// User states that they don't want to see the whole output - cut content.
|
||||||
content = cutContent(content)
|
content = cutContent(content)
|
||||||
}
|
}
|
||||||
|
BIN
pancap.png
BIN
pancap.png
Binary file not shown.
Before Width: | Height: | Size: 464 KiB After Width: | Height: | Size: 434 KiB |
@ -2,10 +2,10 @@ package arp
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/google/gopacket"
|
|
||||||
"github.com/google/gopacket/layers"
|
|
||||||
"github.com/maride/pancap/common"
|
"github.com/maride/pancap/common"
|
||||||
"github.com/maride/pancap/output"
|
"github.com/maride/pancap/output"
|
||||||
|
"github.com/google/gopacket"
|
||||||
|
"github.com/google/gopacket/layers"
|
||||||
"log"
|
"log"
|
||||||
"net"
|
"net"
|
||||||
)
|
)
|
||||||
|
@ -1,9 +1,9 @@
|
|||||||
package dhcpv4
|
package dhcpv4
|
||||||
|
|
||||||
import (
|
import (
|
||||||
|
"github.com/maride/pancap/output"
|
||||||
"github.com/google/gopacket"
|
"github.com/google/gopacket"
|
||||||
"github.com/google/gopacket/layers"
|
"github.com/google/gopacket/layers"
|
||||||
"github.com/maride/pancap/output"
|
|
||||||
)
|
)
|
||||||
|
|
||||||
type Protocol struct {
|
type Protocol struct {
|
||||||
|
@ -6,3 +6,4 @@ type dhcpResponse struct {
|
|||||||
serverMACAddr string
|
serverMACAddr string
|
||||||
askedFor bool
|
askedFor bool
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -2,8 +2,8 @@ package dhcpv4
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/google/gopacket/layers"
|
|
||||||
"github.com/maride/pancap/common"
|
"github.com/maride/pancap/common"
|
||||||
|
"github.com/google/gopacket/layers"
|
||||||
"log"
|
"log"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -2,8 +2,8 @@ package dhcpv4
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/google/gopacket/layers"
|
|
||||||
"github.com/maride/pancap/common"
|
"github.com/maride/pancap/common"
|
||||||
|
"github.com/google/gopacket/layers"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Processes the DHCP request packet handed over
|
// Processes the DHCP request packet handed over
|
||||||
|
@ -2,8 +2,8 @@ package dhcpv4
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/google/gopacket/layers"
|
|
||||||
"github.com/maride/pancap/common"
|
"github.com/maride/pancap/common"
|
||||||
|
"github.com/google/gopacket/layers"
|
||||||
"log"
|
"log"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -2,8 +2,8 @@ package dns
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/google/gopacket/layers"
|
|
||||||
"github.com/maride/pancap/common"
|
"github.com/maride/pancap/common"
|
||||||
|
"github.com/google/gopacket/layers"
|
||||||
"golang.org/x/net/publicsuffix"
|
"golang.org/x/net/publicsuffix"
|
||||||
"log"
|
"log"
|
||||||
)
|
)
|
||||||
|
@ -1,9 +1,9 @@
|
|||||||
package dns
|
package dns
|
||||||
|
|
||||||
import (
|
import (
|
||||||
|
"github.com/maride/pancap/output"
|
||||||
"github.com/google/gopacket"
|
"github.com/google/gopacket"
|
||||||
"github.com/google/gopacket/layers"
|
"github.com/google/gopacket/layers"
|
||||||
"github.com/maride/pancap/output"
|
|
||||||
)
|
)
|
||||||
|
|
||||||
type Protocol struct {}
|
type Protocol struct {}
|
||||||
|
@ -2,8 +2,8 @@ package dns
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/google/gopacket/layers"
|
|
||||||
"github.com/maride/pancap/common"
|
"github.com/maride/pancap/common"
|
||||||
|
"github.com/google/gopacket/layers"
|
||||||
"golang.org/x/net/publicsuffix"
|
"golang.org/x/net/publicsuffix"
|
||||||
"log"
|
"log"
|
||||||
)
|
)
|
||||||
|
@ -1,11 +1,11 @@
|
|||||||
package http
|
package http
|
||||||
|
|
||||||
import (
|
import (
|
||||||
|
"github.com/maride/pancap/common"
|
||||||
|
"github.com/maride/pancap/output"
|
||||||
"github.com/google/gopacket"
|
"github.com/google/gopacket"
|
||||||
"github.com/google/gopacket/layers"
|
"github.com/google/gopacket/layers"
|
||||||
"github.com/google/gopacket/tcpassembly"
|
"github.com/google/gopacket/tcpassembly"
|
||||||
"github.com/maride/pancap/common"
|
|
||||||
"github.com/maride/pancap/output"
|
|
||||||
)
|
)
|
||||||
|
|
||||||
type Protocol struct {
|
type Protocol struct {
|
||||||
|
@ -3,10 +3,10 @@ package http
|
|||||||
import (
|
import (
|
||||||
"bufio"
|
"bufio"
|
||||||
"fmt"
|
"fmt"
|
||||||
|
"github.com/maride/pancap/output"
|
||||||
"github.com/google/gopacket"
|
"github.com/google/gopacket"
|
||||||
"github.com/google/gopacket/tcpassembly"
|
"github.com/google/gopacket/tcpassembly"
|
||||||
"github.com/google/gopacket/tcpassembly/tcpreader"
|
"github.com/google/gopacket/tcpassembly/tcpreader"
|
||||||
"github.com/maride/pancap/output"
|
|
||||||
"io"
|
"io"
|
||||||
"io/ioutil"
|
"io/ioutil"
|
||||||
"net/http"
|
"net/http"
|
||||||
|
Loading…
Reference in New Issue
Block a user