hacking-with-go

Hacking with Go

This is my attempt at filling the gap in Go security tooling. When starting to learn Go, I learned from a lot of tutorials but I could find nothing that is geared towards security professionals.

These documents are based on the Gray/Black Hat Python/C# series of books. I like their style. Join me as I learn more about Go and attempt to introduce Go to security denizens without fluff and through practical applications.

Table of Contents

• 01 - Setting up a Go development environment
• 02 - Basics
  • 02.1 - Packages, functions, variables, basic types, casting and constants
  • 02.2 - for, if, else, switch and defer
  • 02.3 - Pointers, structs, arrays, slices and range
  • 02.4 - Methods and interfaces
  • 02.5 - Printf, Scanf, bufio readers and maps
  • 02.6 - Goroutines and channels
  • 02.7 - Error handling
• 03 - Useful Go packages - WIP
  • 03.1 - flag package
  • 03.2 - log package
• 04 - Go networking
  • 04.1 - Basic TCP and UDP clients
  • 04.2 - TCP servers
  • 04.3 - TCP proxy
  • 04.4 - SSH clients
  • 04.5 - SSH Harvester
• 05 - Parsing Files
  • 05.1 - Extracting PNG Chunks
• 06 - Go-Fuzz
  • 06.1 - Go-Fuzz Quickstart
  • 06.2 - Fuzzing iprange with Go-Fuzz
  • 06.2 - Fuzzing goexif2 with Go-Fuzz

Code

• 01 - Setting up a Go development environment
• 02 - Basics
• 03 - Useful Go packages
• 04 - Go networking
• 05 - Parsing Files
• 06 - Go-Fuzz

FAQ

Why not use Python?
Python reigns supreme in security and for good reason. It's a powerful programming language. There are a lot of supporting libraries out there both in security and for general use. However, I think Go has its merits and can occupy a niche.

Why not use other tutorials?
There are a lot of tutorials for Go out there. None are geared towards security professionals. Our needs are different, we want to write quick and dirty scripts that work (hence Python is so successful). Similar guides are available in Python and other programming languages.

Why not just use Black Hat Go?
There's a book named Black Hat Go by No Starch in production. Looking at the author list, I cannot compete with them in terms of experience and knowledge. That is a proper book with editors and a publisher while I am just some rando learning as I go. It does not take a lot of CPU power to decide the book will be better.

But the book is not out yet. Today is December 6th 2017 and the book is marked for release in August 2018. The book page does not have any released chapters or material. We can assume it's going to be similar to the other gray|black hat books. This repository and that book are inevitably going to have a lot of overlap. Think of this as warm up while we wait.

Update February 2020: Black Hat Go has been released. Please see the code samples at https://github.com/blackhat-go/bhg.

Rewrite in Rust/Haskell
Honestly I will be very much interested in a similar guide for Rust/Haskell geared for security people. Please let me know if you create one.

Feedback

I am always interested in feedback. There will be errors and there are always better ways to code. Please create an issue here. If this has helped you please let me know, it helps with the grind.

Other resources

There are tons of Go resources online. I am going to try not to re-hash what has been already created. Hacking with Go is not meant to be self-contained. When in doubt, use one of these resources or just search.

The following links helped me get started:

• GoDoc: https://godoc.org/
• A Tour of Go: https://tour.golang.org/
• Go by Example: https://gobyexample.com/
• Go playground: https://play.golang.org/
• Effective Go: https://golang.org/doc/effective_go.html

Similar resources to Hacking with Go:

• Security with Go published by Packt: https://github.com/PacktPublishing/Security-with-Go
• goHackTools: https://github.com/dreddsa5dies/goHackTools
• Go programming language secure coding practices guide

License

• Code in this repository is licensed under GPLv3.
• Non-code content is licensed under Creative Commons Attribution-NonCommercial 4.0 (CC BY-NC 4.0).