Surface Analysis System on Cloud

This repository is a PoC for surface analysis of malware on AWS.

Requirements Service

Get an account for the following services.

• AWS
• GitHub
• VirusTotal Private API Key

How to Use

Clone or Fork This Repository

$ git clone https://github.com/JPCERTCC/SurfaceAnalysis-on-Cloud.git

Setup Configuration

variables.tf

# Region to build the system
variable "region" {
  default = "us-east-1"
}

# Docker image name
variable "image_name" {
  default = "malware-analysis"
}

# Dockerfile directory
variable "docker_dir" {
  default = "docker"
}

# Analysis script directory
variable "codecommit_dir" {
  default = "analysis_script"
}

# Username to commit to Codecommit
variable "codecommit_username" {
  default = "terraformer"
}

# E-mail to commit to Codecommit
variable "codecommit_email" {
  default = "[email protected]"
}

# System name to build on AWS
variable "app_name" {
  default = "malware-analysis"
}

# IP address to access API Gateway and S3
variable "trusted_ip" {
  default = "192.168.1.1/32"
}

# Network address used by VPC
variable "cidr_block_vpc" {
  default = "172.20.0.0/16"
}

# VirusToal Private API key
variable "vt_api_key" {
  default = ""
}

# AWS access key
variable "aws_access_key_id" {
  default = ""
}

# AWS secret access key
variable "aws_secret_access_key" {
  default = ""
}

# twitter bearer token
variable "twitter_token" {
  default = ""
}

# E-mail to notify the analysis status
variable "sns_email" {
  default = ""
}

Setup GitHub Actions

Set GitHub Actions secrets.

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_ACCOUNT_NUMBER
• AWS_REGION

How to use GitHub Actions secrets. https://docs.github.com/en/actions/security-guides/encrypted-secrets

Finally, commit the repository to GitHub.