Google Sheets SOCKS (GSS) is a post exploitation tool that implements SOCKS5 proxy channel using Google Sheets as the middle-man.
It enables SOCKS5-like proxying over spreadsheets, making it a powerful alternative when it’s too risky or impractical to deploy a classic C2 infrastructure.
✅ No need for VPS, DNS tunneling, or custom domains; just Google Sheets and a service account.
GSSocks creates a covert communication channel between a client (running on the attaccker system) and a server (deployed on target system).
All traffic is tunneled through Google Sheets in base64-encoded chunks, simulating SOCKS5 behavior internally.
- The client writes data to the sheet using a connection ID and a role tag (
client). - The server reads and processes this data, opens the target connection, and sends the response back via the same sheet (
serverrole). - This allows arbitrary TCP connections from inside hardened environments with only Google services whitelisted.
- Client opens a local TCP listener (default:
:9191) and encodes all data in base64. - Each chunk is written to Google Sheets using a unique
connID. - Server polls Google Sheets:
- Waits for SOCKS5 handshake data
- Parses the target address from the payload
- Connects to the real destination
- Server response is encoded, uploaded, and later read by the client.
- Communication continues asynchronously, chunk by chunk.
Coming soon...
- Create a Google Sheet and share it with the Service Account email.
- Place the Google Sheet ID inside the client and server files
- Place the service account JSON inside the
rawCredentialsarray. - Build the tools:
go build -o client ./client.go
go build -o server ./server.go
go build -o goproxy ./goproxy.go- Deploy the server and the goproxy binaries on the target machine and run it
- Run the client on the attacker machine
- configure proxychains to connect by using Socks5 protocol on port 9191
- Use your favourite tool via proxychains
Originally showcased live at DEF CON 33, demonstrating covert C2 and SOCKS proxying over Google Services.
Disclaimer and notes GSSocks has been made in Italy with ❤️
Please do not use it for illegal purpose. I take no responsibility for the use that will be made of it.
