gRPC nmap vulners

This repository provides you simple gRPC server that scans given targets ports with nmap-vulners.

You must have nmap vulners.nse script installed (Click).

User guide

Server

1. Add environment variables or add .env file.
   Example .env content:

   NETWORK="tcp"
   ADDRESS="127.0.0.1:8080"
   

2. Run go mod download to install all dependecies
3. Run go build ./cmd/server/... to build server binary file
4. Run file that you just built (./server)

Client

1. Install Evans
2. Run evans api/vulners.proto -p 8080 from project directory
3. Type call CheckVuln and write targets & ports (To stop target or ports input - press CTRL+D)

Development

Generate Go gRPC files

make protoc-gen

Build and run server

make build
./server

Build and run CLI

test_target: 87.249.43.21 test_ports: 22,

make build-cli
./cli TARGET PORTS

Generate golangci-lint & tests & coverage

make lint
make test
make coverage