Experiment: A light-weight agent to get a port scan perspective into a useable place/format for security operations
Перейти к файлу
Jonathan Claudius 664135f4fb
Merge pull request #10 from Jason-Cooke/patch-1
docs: fix typo
2019-10-21 09:55:51 -04:00
bin Add specs and perspective 2018-07-26 10:45:54 -04:00
lambda Add incomplete lambda example 2018-07-20 10:55:35 -04:00
lib Add Rakefile so specs run 2018-07-26 11:36:20 -04:00
s3/xml Actually provide example xml 2018-07-20 11:05:02 -04:00
spec/nmap-agent Add Rakefile so specs run 2018-07-26 11:36:20 -04:00
.rspec Add specs and perspective 2018-07-26 10:45:54 -04:00
.travis.yml Mocking up POCs for multi-scans 2018-07-19 10:35:29 -04:00
CODE_OF_CONDUCT.md Add Mozilla Code of Conduct file 2019-03-29 23:58:27 -07:00
Dockerfile tidy up repo 2018-07-17 16:27:49 -04:00
Gemfile initial commit of functional nmap-agent run 2018-07-17 15:10:19 -04:00
README.md docs: fix typo 2019-10-19 09:28:42 +13:00
Rakefile Add Rakefile so specs run 2018-07-26 11:36:20 -04:00
docker-compose.yml Add specs and perspective 2018-07-26 10:45:54 -04:00
nmap_agent.gemspec Add Rakefile so specs run 2018-07-26 11:36:20 -04:00

README.md

nmap-agent (client)

A container that performs NMAP scans and send results to S3 for post analysis

Inputs:

  • target(s)
  • scan options
  • reporting endpoint

Outputs

  • Raw NMAP XML results sent to S3

Benefits:

  • simplified format
  • deployable via docker
  • pass inputs via ENV vars
  • No running services
  • Multiple perspectives...
    • Scan from Docker => Prod Endpoint
    • Scan from Docker => Docker Network
    • Scan from Docker => VPC

S3 bucket (server)

A receiving location for scan results

Inputs:

  • Uploads scan results via write only access (limit exposure if a single node is corrupted)

Outputs:

  • S3 bucket scan results via read-only access (limit exposure if policy node is corrupted)

Benefits:

  • No web application to secure/maintain
  • Easy access to raw data for alternative uses
  • Easy programmatics access to data store
  • AWS/DevOps friendly

nmap2json post processing (Lambda function)

a simple lambda function, which is run on any file that changes in an S3 bucket ./xml folder and produces a simplified ./json equivalent. JSON is simply an easier format to work with and reduces the barrier of entry for really anything to use this data, including the policy framework.

nmap-policy (TBD)

a policy/expectations framework for describing service expectations for a given perspective