kinetic_sdk 0.1.1

data/lib/kinetic_sdk/request_ce/lib/webhook_jobs.rb

@@ -0,0 +1,142 @@
+module KineticSdk
+  class RequestCe
+
+    # Find space webhook jobs
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +status+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_space_webhook_jobs(params={}, headers=default_headers)
+      info("Finding webhook jobs in the Space")
+      get("#{@api_url}/webhookJobs", params, headers)
+    end
+
+    # Find all Webhook Jobs for a space.
+    #
+    # This method will process pages of jobs and internally
+    # concatenate the results into a single array.
+    #
+    # Warning - using this method can cause out of memory errors on large
+    #           result sets.
+    #
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +status+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_all_space_webhook_jobs(params={}, headers=default_headers)
+      # Make the initial request of pages jobs
+      response = find_space_webhook_jobs(params, headers)
+      # Build Submissions Array
+      jobs = response.content["webhookJobs"]
+      # if a next page token exists, keep retrieving jobs and add them to the results
+      while (!response.content["nextPageToken"].nil?)
+        params['pageToken'] = response.content["nextPageToken"]
+        response = find_space_webhook_jobs(params, headers)
+        # concat the jobs
+        jobs.concat(response.content["webhookJobs"] || [])
+      end
+      final_content = {"webhookJobs" => jobs, "nextPageToken" => nil }
+      # Return the results
+      response.content=final_content
+      response.content_string=final_content.to_json
+      response
+    end
+
+    # Find kapp webhook jobs
+    #
+    # @param kapp_slug [String] the Kapp slug
+    # @param params [Hash] Query parameters that are added to the URL, such as +status+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_kapp_webhook_jobs(kapp_slug, params={}, headers=default_headers)
+      info("Finding webhook jobs in the \"#{kapp_slug}\" Kapp")
+      get("#{@api_url}/kapps/#{kapp_slug}/webhookJobs", params, headers)
+    end
+
+    # Find all Webhook Jobs for a kapp.
+    #
+    # This method will process pages of jobs and internally
+    # concatenate the results into a single array.
+    #
+    # Warning - using this method can cause out of memory errors on large
+    #           result sets.
+    #
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +status+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_all_kapp_webhook_jobs(kapp_slug, params={}, headers=default_headers)
+      # Make the initial request of pages jobs
+      response = find_kapp_webhook_jobs(kapp_slug, params, headers)
+      # Build Submissions Array
+      jobs = response.content["webhookJobs"]
+      # if a next page token exists, keep retrieving jobs and add them to the results
+      while (!response.content["nextPageToken"].nil?)
+        params['pageToken'] = response.content["nextPageToken"]
+        response = find_kapp_webhook_jobs(kapp_slug, params, headers)
+        # concat the jobs
+        jobs.concat(response.content["webhookJobs"] || [])
+      end
+      final_content = {"webhookJobs" => jobs, "nextPageToken" => nil }
+      # Return the results
+      response.content=final_content
+      response.content_string=final_content.to_json
+      response
+    end
+
+    # Update space webhook job
+    #
+    # @param job_id [String] id of the Job
+    # @param job_properties [Hash] Query parameters that are added to the URL, such as +status+
+    #   - +event+ -  "Complete",
+    #   - +id+ -  "00000000-0000-1000-8000-000000000000",
+    #   - +name+ -  "Foo",
+    #   - +parentId+ -  "00000000-0000-1000-8000-000000000000",
+    #   - +requestContent+ -  null,
+    #   - +responseContent+ -  null,
+    #   - +retryCount+ -  0,
+    #   - +scheduledAt+ -  "2016-04-20T12:00:00Z",
+    #   - +scopeId+ -  "00000000-0000-1000-8000-000000000000",
+    #   - +scopeType+ -  "Kapp",
+    #   - +status+ -  "Queued",
+    #   - +summary+ -  null,
+    #   - +type+ -  "Submission",
+    #   - +url+ -  "http://my.server.com/api",
+    #   - +webhookId+ -  "00000000-0000-1000-8000-000000000000"
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_space_webhook_job(job_id, job_properties={}, headers=default_headers)
+      info("Updating the webhook job #{job_id} in Space")
+      put("#{@api_url}/webhookJobs/#{job_id}", job_properties, headers)
+    end
+
+
+    # Update kapp webhook job
+    #
+    # @param kapp_slug [String] the Kapp slug
+    # @param job_id [String] id of the Job
+    # @param job_properties [Hash] Query parameters that are added to the URL, such as +status+
+    #   - +event+ -  "Complete",
+    #   - +id+ -  "00000000-0000-1000-8000-000000000000",
+    #   - +name+ -  "Foo",
+    #   - +parentId+ -  "00000000-0000-1000-8000-000000000000",
+    #   - +requestContent+ -  null,
+    #   - +responseContent+ -  null,
+    #   - +retryCount+ -  0,
+    #   - +scheduledAt+ -  "2016-04-20T12:00:00Z",
+    #   - +scopeId+ -  "00000000-0000-1000-8000-000000000000",
+    #   - +scopeType+ -  "Kapp",
+    #   - +status+ -  "Queued",
+    #   - +summary+ -  null,
+    #   - +type+ -  "Submission",
+    #   - +url+ -  "http://my.server.com/api",
+    #   - +webhookId+ -  "00000000-0000-1000-8000-000000000000"
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_kapp_webhook_job(kapp_slug, job_id, job_properties={}, headers=default_headers)
+      info("Updating the webhook job #{job_id} in the \"#{kapp_slug}\" Kapp")
+      put("#{@api_url}/kapps/#{kapp_slug}/webhookJobs/#{job_id}", job_properties, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/request_ce/lib/webhooks.rb

@@ -0,0 +1,192 @@
+module KineticSdk
+  class RequestCe
+
+    # Add form webhook
+    #
+    # @param kapp_slug [String] slug of the Kapp the form webhook belongs to
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - Created | Deleted | Updated
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_form_webhook(kapp_slug, webhook_properties, headers=default_headers)
+      raise StandardError.new "Webhook properties is not valid, must be a Hash." unless webhook_properties.is_a? Hash
+      payload = { "type" => "Form" }.merge(webhook_properties)
+      add_webhook_on_kapp(kapp_slug, payload, headers)
+    end
+
+    # Add space webhook
+    #
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - Login Failure
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_space_webhook(webhook_properties, headers=default_headers)
+      raise StandardError.new "Webhook properties is not valid, must be a Hash." unless webhook_properties.is_a? Hash
+      payload = { "type" => "Space" }.merge(webhook_properties)
+      add_webhook_on_space(payload, headers)
+    end
+
+    # Add submission webhook
+    #
+    # @param kapp_slug [String] slug of the Kapp the submission webhook belongs to
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - Closed | Created | Deleted | Saved | Submitted | Updated
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_submission_webhook(kapp_slug, webhook_properties, headers=default_headers)
+      raise StandardError.new "Webhook properties is not valid, must be a Hash." unless webhook_properties.is_a? Hash
+      payload = { "type" => "Submission" }.merge(webhook_properties)
+      add_webhook_on_kapp(kapp_slug, payload, headers)
+    end
+
+    # Add user webhook
+    #
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - Login | Logout
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_user_webhook(webhook_properties, headers=default_headers)
+      raise StandardError.new "Webhook properties is not valid, must be a Hash." unless webhook_properties.is_a? Hash
+      payload = { "type" => "User" }.merge(webhook_properties)
+      add_webhook_on_space(payload, headers)
+    end
+
+    # Add a webhook on a Kapp (either a Form or Submission webhook)
+    #
+    # Ideally the shortcut methods (add_form_webhook,
+    # add_submission_webhook) would be used instead of this one.
+    #
+    # @param kapp_slug [String] slug of the Kapp the webhook belongs to
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - depends on +type+
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    #   - +type+ - The type of model the webhook is bound to: Form | Submission
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_webhook_on_kapp(kapp_slug, webhook_properties, headers=default_headers)
+      raise StandardError.new "Webhook properties is not valid, must be a Hash." unless webhook_properties.is_a? Hash
+      info("Adding a \"#{webhook_properties['event']}\" \"#{webhook_properties['type']}\" webhook for #{kapp_slug}")
+      post("#{@api_url}/kapps/#{kapp_slug}/webhooks", webhook_properties, headers)
+    end
+
+    # Add a webhook on a Space (either a Space or User webhook)
+    #
+    # Ideally the shortcut methods (add_space_webhook, add_user_webhook)
+    # would be used instead of this one.
+    #
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - depends on +type+
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    #   - +type+ - The type of model the webhook is bound to: Space | User
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def add_webhook_on_space(webhook_properties, headers=default_headers)
+      raise StandardError.new "Webhook properties is not valid, must be a Hash." unless webhook_properties.is_a? Hash
+      info("Adding a \"#{webhook_properties['event']}\" \"#{webhook_properties['type']}\" webhook")
+      post("#{@api_url}/webhooks", webhook_properties, headers)
+    end
+
+    # Find all webhooks for a Kapp
+    #
+    # @param kapp_slug [String] the Kapp slug
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_webhooks_on_kapp(kapp_slug, params={}, headers=default_headers)
+      info("Finding all webhooks on the \"#{kapp_slug}\" Kapp")
+      get("#{@api_url}/kapps/#{kapp_slug}/webhooks", params, headers)
+    end
+
+    # Find all webhooks for a Space
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_webhooks_on_space(params={}, headers=default_headers)
+      info("Finding all webhooks on the Space")
+      get("#{@api_url}/webhooks", params, headers)
+    end
+
+    # Find a webhook defined in a Kapp
+    #
+    # @param kapp_slug [String] the Kapp slug
+    # @param name [String] the webhook name
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_webhook_on_kapp(kapp_slug, name, params={}, headers=default_headers)
+      info("Finding the \"#{name}\" webhook on the \"#{kapp_slug}\" Kapp")
+      get("#{@api_url}/kapps/#{kapp_slug}/webhooks/#{encode(name)}", params, headers)
+    end
+
+    # Find a webhook defined in a Space
+    #
+    # @param name [String] the webhook name
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def finding_webhook_on_space(name, params={}, headers=default_headers)
+      info("Finding the \"#{name}\" webhook on the Space")
+      get("#{@api_url}/webhooks/#{encode(name)}", params, headers)
+    end
+
+    # Update a webhook on a Kapp (either a Form or Submission webhook)
+    #
+    # All of the webhook properties are optional.  Only the properties provided
+    # in the Hash will be updated, the other properties will retain their
+    # current values.
+    #
+    # @param kapp_slug [String] the Kapp slug
+    # @param name [String] the webhook name
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - depends on +type+
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    #   - +type+ - The type of model the webhook is bound to: Form | Submission
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_webhook_on_kapp(kapp_slug, name, webhook_properties, headers=default_headers)
+      info("Updating the \"#{name}\" webhook on the \"#{kapp_slug}\" Kapp")
+      put("#{@api_url}/kapps/#{kapp_slug}/webhooks/#{encode(name)}", webhook_properties, headers)
+    end
+
+
+    # Update a webhook on a Space (either a Space or User webhook)
+    #
+    # All of the webhook properties are optional.  Only the properties provided
+    # in the Hash will be updated, the other properties will retain their
+    # current values.
+    #
+    # @param name [String] the webhook name
+    # @param webhook_properties [Hash] hash of webhook properties
+    #   - +event+ - depends on +type+
+    #   - +name+ - A descriptive name for the webhook
+    #   - +filter+ - A javascript expression to determine when the webhook should fire
+    #   - +url+ - URL to post the bindings when the event is triggered
+    #   - +type+ - The type of model the webhook is bound to: Space | User
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def update_webhook_on_space(name, webhook_properties, headers=default_headers)
+      info("Updating the \"#{name}\" webhook on the Space")
+      put("#{@api_url}/webhooks/#{encode(name)}", webhook_properties, headers)
+    end
+
+  end
+end

data/lib/kinetic_sdk/request_ce/request-ce-sdk.rb

@@ -0,0 +1,153 @@
+Dir[File.join(File.dirname(File.expand_path(__FILE__)), "lib", "**", "*.rb")].each {|file| require file }
+
+module KineticSdk
+
+  # RequestCe is a Ruby class that acts as a wrapper for the Kinetic Request CE REST API
+  # without having to make explicit HTTP requests.
+  #
+  class RequestCe
+
+    # Include the KineticHttpUtils module
+    include KineticSdk::Utils::KineticHttpUtils
+
+    attr_reader :api_url, :username, :options, :password, :space_slug, :server, :version
+
+    # Initalize the Request CE SDK with the web server URL, the space user
+    # username and password, along with any custom option values.
+    #
+    # @param [Hash<Symbol, Object>] opts Kinetic Request CE properties
+    # @option opts [String] :config_file optional - path to the YAML configuration file
+    #
+    #   * Ex: /opt/config/request-ce-configuration1.yaml
+    #
+    # @option opts [String] :app_server_url the URL to the Kinetic Request CE web application
+    #
+    #   * Must not be used when `:space_server_url` is also used.
+    #   * If space_slug is provided, it will be appended to the URL as a path parameter
+    #   * Ex: <http://192.168.0.1:8080/kinetic>
+    #
+    # @option opts [String] :space_server_url the URL to the Kinetic Request CE space
+    #
+    #   * Must not be used when `app_server_url` is used
+    #   * Typically used when using a proxy server that supports space slugs as subdomains
+    #   * Ex: <http://acme.server.io/kinetic> - space slug (`acme`) as subdomain
+    #   * Ex: <http://localhost:8080/kinetic/acme> - same result as using `:app_server_url` and `:space_slug`
+    #
+    # @option opts [String] :space_slug the slug that identifies the Space
+    #
+    #   * Optional when `:app_server_url` is used
+    #   * Required when `:space_server_url` is used
+    #   * Required to log in to a Space
+    #   * Must be nil to log in to the System
+    #
+    # @option opts [String] :username the username for the user
+    # @option opts [String] :password the password for the user
+    # @option opts [Hash<Symbol, Object>] :options ({}) optional settings
+    #
+    #   * :log_level (String) (_defaults to: off_) level of logging - off | info | debug | trace
+    #   * :max_redirects (Fixnum) (_defaults to: 10_) maximum number of redirects to follow
+    #   * :ssl_ca_file (String) full path to PEM certificate used to verify the server
+    #   * :ssl_verify_mode (String) (_defaults to: none_) - none | peer
+    #
+    # Example: using a configuration file
+    #
+    #     KineticSdk::RequestCe.new({
+    #       config_file: "/opt/config1.yaml"
+    #     })
+    #
+    # Example: space user properties hash
+    #
+    #     KineticSdk::RequestCe.new({
+    #       app_server_url: "http://localhost:8080/kinetic",
+    #       space_slug: "foo",
+    #       username: "space-user-1",
+    #       password: "password",
+    #       options: {
+    #           log_level: "debug",
+    #           ssl_verify_mode: "peer",
+    #           ssl_ca_file: "/usr/local/self_signing_ca.pem"
+    #       }
+    #     })
+    #
+    # Example: system user properties hash
+    #
+    #     KineticSdk::RequestCe.new({
+    #       app_server_url: "http://localhost:8080/kinetic",
+    #       username: "admin",
+    #       password: "password",
+    #       options: {
+    #           log_level: "debug",
+    #           ssl_verify_mode: "peer",
+    #           ssl_ca_file: "/usr/local/self_signing_ca.pem"
+    #       }
+    #     })
+    #
+    # Example: space user properties hash with the space url
+    #
+    #     # Note: This example results in the same API endpoint as using:
+    #     #
+    #     #   app_server_url: https://myapp.io
+    #
+    #     KineticSdk::RequestCe.new({
+    #       space_server_url: "https://myapp.io/foo",
+    #       space_slug: "foo",
+    #       username: "space-user-1",
+    #       password: "password",
+    #       options: {
+    #         log_level: "info",
+    #         max_redirects: 3
+    #       }
+    #     })
+    #
+    # Example: space user properties hash with the space url as a subdomain
+    #
+    #     # Note: This example requires a proxy server to rewrite the space slug
+    #     #       as a request path parameter rather than a subdomain.
+    #     #
+    #     #   Ex: https://myapp.io/foo
+    #
+    #     KineticSdk::RequestCe.new({
+    #       space_server_url: "https://foo.myapp.io",
+    #       space_slug: "foo",
+    #       username: "space-user-1",
+    #       password: "password",
+    #       options: {
+    #         log_level: "info",
+    #         max_redirects: 3
+    #       }
+    #     })
+    #
+    def initialize(opts={})
+      options = {}
+
+      # process the configuration file if it was provided
+      unless opts[:config_file].nil?
+        options.merge!(YAML::load_file opts[:config_file])
+      end
+
+      # process the configuration hash if it was provided
+      options.merge!(opts)
+
+      # allow either :app_server_url or :space_server_url, but not both
+      if options[:app_server_url] && options[:space_server_url]
+        raise StandardError.new "Expecting one of :app_server_url or :space_server_url, but not both."
+      end
+
+      # process any individual options
+      @options = options.delete(:options) || {}
+      @username = options[:username]
+      @password = options[:password]
+      @space_slug = options[:space_slug]
+      if options[:app_server_url]
+        @server = options[:app_server_url].chomp('/')
+        @api_url = @server + (@space_slug.nil? ? "/app/api/v1" : "/#{@space_slug}/app/api/v1")
+      else
+        raise StandardError.new "The :space_slug option is required when using the :space_server_url option" if @space_slug.nil?
+        @server = options[:space_server_url].chomp('/')
+        @api_url = "#{@server}/app/api/v1"
+      end
+      @version = 1
+    end
+
+  end
+end

data/lib/kinetic_sdk/task/lib/access_keys.rb

@@ -0,0 +1,94 @@
+module KineticSdk
+  class Task
+
+    # Add an access key
+    #
+    # @param access_key [Hash] properties for the access key
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Example
+    #
+    #     add_access_key({
+    #       "description" => "Description",
+    #       "identifier" => "X54DLNU",
+    #       "secret" => "xyz"
+    #     })
+    #
+    # Example
+    #
+    #     add_access_key({
+    #       "description" => "Description"
+    #     })
+    #
+    # Example
+    #
+    #     add_access_key()
+    #
+    def add_access_key(access_key={}, headers=default_headers)
+      info("Adding access key " + (access_key.has_key?('identifier') ? access_key['identifier'] : ""))
+      post("#{@api_url}/access-keys", access_key, headers)
+    end
+
+    # Delete an access key
+    #
+    # @param identifier [String] access key identifier
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def delete_access_key(identifier, headers=header_basic_auth)
+      info("Deleting access key \"#{identifier}\"")
+      delete("#{@api_url}/access-keys/#{encode(identifier)}", headers)
+    end
+
+    # Delete all access keys
+    #
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def delete_access_keys(headers=header_basic_auth)
+      info("Deleting all access keys")
+      (find_access_keys(headers).content["accessKeys"] || []).each do |access_key|
+        delete("#{@api_url}/access_keys/#{encode(access_key['identifier'])}", headers)
+      end
+    end
+
+    # Find all access keys
+    #
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_access_keys(params={}, headers=header_basic_auth)
+      info("Finding all access keys")
+      get("#{@api_url}/access-keys", params, headers)
+    end
+
+    # Find an access key
+    #
+    # @param identifier [String] access key identifier
+    # @param params [Hash] Query parameters that are added to the URL, such as +include+
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    def find_access_key(identifier, params={}, headers=default_headers)
+      info("Finding access key \"#{identifier}\"")
+      get("#{@api_url}/access-keys/#{encode(identifier)}", params, headers)
+    end
+
+    # Update an access key
+    #
+    # @param identifier [String] access key identifier
+    # @param body [Hash] properties to update, all optional
+    # @param headers [Hash] hash of headers to send, default is basic authentication and accept JSON content type
+    # @return [KineticSdk::Utils::KineticHttpResponse] object, with +code+, +message+, +content_string+, and +content+ properties
+    #
+    # Exammple
+    #
+    #     update_identifier("X54DLNU", {
+    #       "description": "Updated access key"
+    #     })
+    #
+    def update_access_key(identifier, body={}, headers=default_headers)
+      info("Updating the \"#{identifier}\" access key")
+      put("#{@api_url}/access-keys/#{encode(identifier)}", body, headers)
+    end
+
+  end
+end