aws_account_utils 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 79a564cff80b5c7490a6c9f586818af44291a017
-  data.tar.gz: c790580762a7dca94ab5d59bce32d18484bc1851
+  metadata.gz: 2cdc1bfeb1376e9bffa076150d73b0962bd9bb69
+  data.tar.gz: 5901819531b21ed4a3d5f5bbaa6f9deafbd1c44a
 SHA512:
-  metadata.gz: 4e8678b02ed10dd429002d841ca3a3676cb55f24a09543c2786ec11f1eff7363dbbceb931188e4ea7afe6c735449588a05b34abc064086d27af49dc736d93901
-  data.tar.gz: 8561de0dd6419b28957d01ef5589b1beeece3ca8246bb381fd40175ba450d64e554fd3863da99f1cae4a554067019b9da5ef2442945fc5b5a0d56c52f925a1e0
+  metadata.gz: 5bb6b0094d7e5b269c3f541a4c425989bbe695f6908f4fe1d11611f2ae9e72ccd04d7f6ff298f61ecdad80471e68b9f96e458c5a5df8f3b5caa58caf277e63c0
+  data.tar.gz: 6939a40b12e209fa685c09accb8bf36ddf87e498616f10852d7842b3b194d3d2d1a974e53a8eb4d2fff173917fc90b47c6a8655365c11461aa4b6964cd6539b9

data/.codeclimate.yml

@@ -18,13 +18,13 @@ engines:
   rubocop:
     enabled: true
   golint:
-    enabled: true
+    enabled: false
   gofmt:
-    enabled: true
+    enabled: false
   eslint:
-    enabled: true
+    enabled: false
   csslint:
-    enabled: true
+    enabled: false
 
 # Engines can analyze files and report issues on them, but you can separately
 # decide which files will receive ratings based on those issues. This is
@@ -35,11 +35,11 @@ engines:
 
 # Note: If the ratings key is not specified, this will result in a 0.0 GPA on your dashboard.
 
-# ratings:
-#   paths:
+ ratings:
+  paths:
 #   - app/**
-#   - lib/**
-#   - "**.rb"
+   - lib/**
+   - "**.rb"
 #   - "**.go"
 
 # You can globally exclude files from being analyzed by any engine using the
@@ -47,4 +47,4 @@ engines:
 
 #exclude_paths:
 #- spec/**/*
-#- vendor/**/*
+#- vendor/**/*

data/README.md

@@ -2,6 +2,8 @@
 
 A collection of helpers for creating and modifying AWS account details that can not be done using any existing AWS API
 
+Special Note: the `create_account` operation requires that your IP be white-listed by AWS in order to bypass the CAPTCHA
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -20,6 +22,24 @@ Or install it yourself as:
 
 ## Usage
 
+Overview
+=================
+
+If you are required to go through a proxy, the following should be set prior to execution.
+```
+export no_proxy=127.0.0.1
+export http_proxy=myproxyhots.com
+```
+
+```ruby
+aws_utils = AwsAccountUtils::AwsAccountUtils.new(
+  browser: (Watir::Browser) - default: Watir Browser object - You can pass in your own Browser object or use the built-in which uses firefox.
+  logger: (Logger) - default: Logger object. - You can pass in your own logger or use the built in.
+  log_level: (Symbol) - default: :info - Sets the logger level. Only :info and :debug are useful
+  screenshots: (String) - default: nil - Enables screenshots by passing the directory to put the screenshots which are taken throughout the different operations. 
+ )
+```
+
  Operations
 =================
   * [create_account](#create_account)
@@ -39,14 +59,15 @@ Or install it yourself as:
 create_account
 ------------
 
-> Creates a new AWS Account and with the miminal amount of information and 
+> Creates a new AWS Account and with the minimal amount of information and 
 > returns the account number of the new account.
+> Requires that your IP be white-listed by AWS in order to bypass the CAPTCHA
 
 `#create_account(account_name:, account_email, account_password:, account_details:)`
 
 **Examples:**
 ```Ruby
-details = { 'fullName'     => 'Hermen Munster',
+details = { 'fullName'     => 'Herman Munster',
             'company'      => 'The Munsters',
             'addressLine1' => '1313 Mockingbird Lane',
             'city'         => 'Mockingbird Heights',
@@ -62,7 +83,7 @@ resp = aws_utils.create_account(account_name: 'My Test Account 01',
 resp #=> String
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_name: (required, String) - The account name to associate with this new account
 account_email: (required, String) - The email to associate with this new account
@@ -77,18 +98,19 @@ account_details: (required, Hash) - Hash of account deatails
 change_root_password
 ------------
 
-
 > Changes the account password
 
 `change_root_password(account_email:, account_password:, new_password:)`
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.change_root_password(account_email: 'adfefef@gmail.com',
+                                      account_password: 'foobar1212121',
+                                      new_password: 'mynewpassword')
+resp #=> true/false
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The old password to use with this new account
@@ -110,11 +132,12 @@ check_enterprise_support
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.check_enterprise_support(account_email: 'adfefef@gmail.com',
+                                          account_password: 'foobar1212121'')
+resp #=> true/false
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -129,25 +152,29 @@ account_password: (required, String) - The password to use with this new account
 confirm_consolidated_billing
 ------------
 
-> Confirms consolidated billing
+> Confirms consolidated billing by taking the link that was emailed to you when you enabled consolidated billing.
 
 `confirm_consolidated_billing(account_email:, account_password:, confirmation_link:)`
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.confirm_consolidated_billing(account_email: 'adfefef@gmail.com',
+                                              account_password: 'foobar1212121',
+                                              confirmation_link: 'amazonaws.com/confirmationlink')
+resp #=> nil
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
+confirmation_link: (required, String) - The unique url that will confirm billing
+
 ```
 
 **Returns:**
 
-`#return => Boolean`
+`#return => nil`
 
 ---
 
@@ -157,13 +184,15 @@ create_root_access_keys
 > Creates access and secret key for root account
 
 `create_root_access_keys(account_email:, account_password:)`
+
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.create_root_access_keys(account_email: 'adfefef@gmail.com',
+                                         account_password: 'foobar1212121)
+resp #=> Hash
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -171,7 +200,7 @@ account_password: (required, String) - The password to use with this new account
 
 **Returns:**
 
-`#return => Boolean`
+`#return => Hash {:access_key=>"my_access_key", :secret_key=>"my_secret_key"}`
 
 ---
 
@@ -184,11 +213,12 @@ delete_root_access_keys
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.delete_root_access_keys(account_email: 'adfefef@gmail.com',
+                                         account_password: 'foobar1212121)
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -196,7 +226,7 @@ account_password: (required, String) - The password to use with this new account
 
 **Returns:**
 
-`#return => Boolean`
+`#return => true/false`
 
 ---
 
@@ -209,11 +239,12 @@ email_opt_out
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.email_opt_out(account_email: 'adfefef@gmail.com',
+                               account_password: 'foobar1212121)
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -228,17 +259,18 @@ account_password: (required, String) - The password to use with this new account
 enable_enterprise_support
 ------------
 
-> Enables enterprise support
+> Enables enterprise support, this should be done after consolidated billing has been setup
 
 `enable_enterprise_support(account_email:, account_password:)`
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.enable_enterprise_support(account_email: 'adfefef@gmail.com',
+                                           account_password: 'foobar1212121)
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -258,11 +290,12 @@ enable_iam_billing
 `enable_iam_billing(account_email:, account_password:)`
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.enable_iam_billing(account_email: 'adfefef@gmail.com',
+                                    account_password: 'foobar1212121)
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -283,11 +316,12 @@ existing_consolidated_billing
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.existing_consolidated_billing?(account_email: 'adfefef@gmail.com',
+                                                account_password: 'foobar1212121)
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
@@ -308,14 +342,12 @@ logout_from_console
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.logout_from_console
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
-account_email: (required, String) - The email to associate with this new account
-account_password: (required, String) - The password to use with this new account
 ```
 
 **Returns:**
@@ -334,14 +366,17 @@ request_consolidated_billing
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+resp = aws_utils.request_consolidated_billing(master_account_email: 'my_master_acccount@gmail.com',
+                                              master_account_password: 'master_acct_password,
+                                              account_email: 'my_new_account_email@gmail.com')
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
-account_email: (required, String) - The email to associate with this new account
-account_password: (required, String) - The password to use with this new account
+master_account_email: (required, String) - The email for your master billing aws account
+master_account_password: (required, String) - The password for your master billing aws account
+account_email: (required, String) - The email for the account you want to add to consolidated billing under the master account
 ```
 
 **Returns:**
@@ -360,13 +395,27 @@ set_alternate_contacts
 **Examples:**
 ```Ruby
 
-resp #=> String
+contacts = {'operations' => {'name' => 'Operations Name',
+                             'title' => 'Operations Title',
+                             'email' => 'operations@test.com',
+                             'phoneNumber' => '888-888-1212'},
+            'security' => {'name' => 'Security Name',
+                           'title' => 'Security Title',
+                           'email' => 'Security@test.com',
+                           'phoneNumber' => '888-888-1212'}}
+                                     
+resp = aws_utils.set_alternate_contacts(account_email: 'adfefef@gmail.com',
+                                        account_password: 'foobar1212121,
+                                        contact_info: contacts)
+resp #=> True/False
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
+contact_info: (required, Hash) - A Hash of Hash of contacts, operations, security, etc.
+
 ```
 
 **Returns:**
@@ -384,19 +433,28 @@ set_challenge_questions
 
 **Examples:**
 ```Ruby
-
-resp #=> String
+my_answers = {1 => 'answer1',
+              2 => 'answer2',
+              3 => 'answer3'}
+              
+resp = aws_utils.set_challenge_questions(account_email: 'adfefef@gmail.com',
+                                         account_password: 'foobar1212121,
+                                         answers: my_answers)
+                                        
+resp #=> {1 => 'answer1', 2 => 'answer2', 3 => 'answer3'}
 ```
 
-**Paramaters:**
+**Parameters:**
 ```
 account_email: (required, String) - The email to associate with this new account
 account_password: (required, String) - The password to use with this new account
+answers: (optional, Hash) - A hash of answers to fill in for the security questions. If you dont pass your own, Random word will generate for you.
+
 ```
 
 **Returns:**
 
-`#return => Boolean`
+`#return => Hash`
 
 ---
 

data/lib/aws_account_utils.rb

@@ -16,11 +16,12 @@ require 'aws_account_utils/logout'
 
 module AwsAccountUtils
   class AwsAccountUtils
-    attr_reader :options, :logger, :browser, :screenshots
+    attr_reader :log_level, :logger, :browser, :screenshots
 
-    def initialize(logger: nil, browser: nil, screenshots: nil)
-      @browser = browser
+    def initialize(log_level: :info, logger: nil, browser: nil, screenshots: nil)
+      @log_level = log_level
       @logger = logger
+      @browser = browser
       @screenshots = screenshots
 
       Settings.set_screenshot_dir screenshots if screenshots
@@ -182,7 +183,7 @@ module AwsAccountUtils
     end
 
     def logger
-      @logger ||= AccountLogger.new(options[:log_level])
+      @logger ||= AccountLogger.new(log_level)
     end
 
     def password

data/lib/aws_account_utils/account_logger.rb

@@ -6,7 +6,7 @@ module AwsAccountUtils
     extend Forwardable
     def_delegators :@logger, :fatal, :debug, :error, :info, :warn, :debug?
 
-    def initialize(log_level = 'info')
+    def initialize(log_level)
       @log_level = log_level
       @logger = new_logger
     end
@@ -19,7 +19,7 @@ module AwsAccountUtils
         l.formatter = proc do |severity, datetime, progname, msg|
           "#{datetime} #{severity} : #{msg}\n"
         end
-        l.level = Logger.const_get @log_level.upcase
+        l.level = Logger.const_get @log_level.to_s.upcase
       end
     end
   end

data/lib/aws_account_utils/account_registration.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class AccountRegistration < Base

data/lib/aws_account_utils/alternate_contacts.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class AlternateContacts < Base

data/lib/aws_account_utils/challenge_questions.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 require 'random-word'
 
 module AwsAccountUtils
@@ -11,7 +12,7 @@ module AwsAccountUtils
     end
 
     def create(account_email, account_password, challenge_words = {})
-      logger.debug "Entering customer details."
+      logger.debug "Setting security challenge answers."
       Login.new(logger, browser).execute url,
                                          account_email,
                                          account_password

data/lib/aws_account_utils/consolidated_billing.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class ConsolidatedBilling < Base

data/lib/aws_account_utils/customer_information.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class CustomerInformation < Base
@@ -14,8 +15,9 @@ module AwsAccountUtils
       Login.new(logger, browser).execute url,
                                          account_email,
                                          account_password
-      browser.link(:text => /AWS Customer Agreement/).wait_until_present
-      browser.select_list(:class =>'control-select ng-pristine ng-valid').when_present.select 'United States'
+
+      browser.wait_until{ browser.text.include? 'AWS Customer Agreement'}
+      browser.select_list(:ng_model =>'address.countryCode').when_present.select 'United States'
       customer_details.each do |k,v|
         browser.text_field(:name => k).when_present.set v
       end
@@ -30,10 +32,15 @@ module AwsAccountUtils
       browser.input(:id => "accountId").value
     rescue StandardError
       screenshot(browser, 'error')
-      raise StandardError, 'Steps: AwsCustomerInformation Aws returned error on page.'
+      raise StandardError, 'Aws returned error on the page when submitting customer information.'
     rescue Watir::Wait::TimeoutError, Net::ReadTimeout => e
       screenshot(browser, "error")
       raise StandardError, "#{self.class.name} - #{e}"
     end
+
+    private
+    def url
+      'https://portal.aws.amazon.com/billing/signup#/account'
+    end
   end
 end

data/lib/aws_account_utils/customize_url.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class CustomizeUrl < Base
@@ -14,7 +15,7 @@ module AwsAccountUtils
       Login.new(logger, browser).execute url,
                                          account_email,
                                          account_password
-      browser.goto url
+
       browser.h2(:text => /Welcome to Identity and Access Management/).wait_until_present
       browser.button(:text => /Customize/).when_present.click
       browser.input(:id => 'alias_input').when_present.to_subtype.set url_alias

data/lib/aws_account_utils/email_preferences.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class EmailPreferences < Base
@@ -10,6 +11,8 @@ module AwsAccountUtils
     end
 
     def opt_out(account_email, account_password)
+      logger.debug "Setting email preferences."
+
       Login.new(logger, browser).execute url,
                                          account_email,
                                          account_password

data/lib/aws_account_utils/enterprise_support.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class EnterpriseSupport < Base
@@ -9,7 +10,7 @@ module AwsAccountUtils
       @browser = browser
     end
 
-    def enable(account_email,account_password)
+    def enable(account_email, account_password)
       logger.debug 'Enabling enterprise support.'
       Login.new(logger, browser).execute support_registration_url,
                                          account_email,

data/lib/aws_account_utils/iam_billing.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class IamBilling < Base

data/lib/aws_account_utils/login.rb

@@ -23,6 +23,7 @@ module AwsAccountUtils
       raise StandardError, "#{self.class.name} - #{e}"
     end
 
+    private
     def login_page?
       browser.url.include? 'ap/signin?'
     end

data/lib/aws_account_utils/logout.rb

@@ -13,7 +13,6 @@ module AwsAccountUtils
       logger.debug "Logging out of AWS."
       browser.goto url
       screenshot(browser, "1")
-      #Watir::Wait.until{browser.url == 'https://aws.amazon.com/'}
       browser.wait_until{ browser.url.include? 'https://aws.amazon.com/'}
       browser.text.include?('Sign In to the Console') || browser.text.include?('Create a Free Account')
     rescue Watir::Wait::TimeoutError, Net::ReadTimeout => e

data/lib/aws_account_utils/password.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class Password < Base
@@ -27,11 +28,10 @@ module AwsAccountUtils
       browser.h6(:text => /Success/).exist?
     rescue StandardError => e
       screenshot(browser, "error")
-      logger.debug "Standard error in #{self.class.name} - #{e}"
       error_header = browser.div(:id => /message_(error|warning)/).h6.text
       error_body = browser.div(:id => /message_(error|warning)/).p.text
-      logger.debug "AWS Password Change Error: \"#{error_header}: #{error_body}\""
-      false
+      raise StandardError, "AWS Password Change Error: \"#{error_header}: #{error_body}\""
+
     rescue Watir::Wait::TimeoutError, Net::ReadTimeout => e
       screenshot(browser, "error")
       raise StandardError, "#{self.class.name} - #{e}"

data/lib/aws_account_utils/root_access_keys.rb

@@ -1,4 +1,5 @@
 require 'aws_account_utils/base'
+require 'aws_account_utils/login'
 
 module AwsAccountUtils
   class RootAccessKeys < Base
@@ -65,8 +66,7 @@ module AwsAccountUtils
     end
 
     def keys_to_delete?
-     a = browser.a(:class => 'Delete').exist?
-      a
+     browser.a(:class => 'Delete').exist?
     end
 
     def clear_warning
@@ -83,4 +83,4 @@ module AwsAccountUtils
         secret_key: text.split("\n")[-2] }
     end
   end
-end
+end

data/lib/aws_account_utils/version.rb

@@ -1,3 +1,3 @@
 module AwsAccountUtils
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/aws_account_utils/watir_browser.rb

@@ -1,5 +1,6 @@
 require 'aws_account_utils/base'
 require 'watir-webdriver'
+Watir::HTMLElement.attributes << :ng_model
 
 module AwsAccountUtils
   class WatirBrowser

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws_account_utils
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - keviny22
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-30 00:00:00.000000000 Z
+date: 2015-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler