triglav-agent 1.0.0.pre1 → 1.0.0.pre2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0e93319a7488bc71909e48a806ab59d236ee5533
-  data.tar.gz: d303d5b611c786c306eeabad855a1f98430abcfb
+  metadata.gz: b9c8497478c30bab836963959fcf1421dd29636f
+  data.tar.gz: bdeb425a24166e46ab9a5d3d3dc32f6bbc9f64b0
 SHA512:
-  metadata.gz: 041f573acea82bfb4a26dd4e019ea3a8a7e9282a5d45a4f2e31cf23516412ab44053f21fbcb4e1b375dcbe5d35d4d7eb1b86e22c1b99534fb55c883212133b6a
-  data.tar.gz: 642e9f6ba9f7315ca8f11278c119e81720d73fc1c41845ac1bd1c6e230d8b33fd9dc9918f18cf3a187a8b78cb68c48832f717fbb16cf9a5201b0201a86d4b3b7
+  metadata.gz: 44dde53afed7799a462955cb40447049eda0c729b9b667466f9cc9f80e7abee92e7db2920a43561a1e2fa24c021ca3c64d4a4d7b45143f730541067393c7b90a
+  data.tar.gz: 77ac7e13d7325623f1f5c81761fd8f2a96cb67c0c4470f54418ced18c21f1f3b9e35580eb851f6ed61ef0f6b2fac64d79f7836b3e0e1326e0dd9a4c3ef24f311

data/lib/triglav/agent/api_client.rb

@@ -34,8 +34,13 @@ module Triglav::Agent
         uri = URI.parse(triglav_url)
         config.scheme = uri.scheme
         config.host = "#{uri.host}:#{uri.port}"
-        config.timeout = timeout if timeout
-        config.debugging = debugging if debugging
+        config.timeout = timeout unless timeout.nil?
+        config.debugging = debugging unless debugging.nil?
+        config.verify_ssl = verify_ssl unless verify_ssl.nil?
+        config.verify_ssl_host = verify_ssl_host unless verify_ssl_host.nil?
+        config.ssl_ca_cert = ssl_ca_cert unless ssl_ca_cert.nil?
+        config.cert_file = cert_file unless cert_file.nil?
+        config.key_file = key_file unless key_file.nil?
       end
       @api_client = TriglavClient::ApiClient.new(config)
       initialize_current_token
@@ -176,12 +181,64 @@ module Triglav::Agent
       @opts.dig(:credential, :authenticator) || $setting.dig(:triglav, :credential, :authenticator)
     end
 
+    # Set this to enable/disable debugging. When enabled (set to true), HTTP request/response
+    # details will be logged with `logger.debug` (see the `logger` attribute).
+    # Default to false.
+    #
+    # @return [true, false]
+    def debugging
+      @opts.has_key?(:debugging) ? @opts[:debugging] : $setting.dig(:triglav, :debugging)
+    end
+
+    # The time limit for HTTP request in seconds.
+    # Default to 0 (never times out).
     def timeout
       @opts[:timeout] || $setting.dig(:triglav, :timeout)
     end
 
-    def debugging
-      @opts[:debugging] || $setting.dig(:triglav, :debugging)
+    ### TLS/SSL setting
+    # Set this to false to skip verifying SSL certificate when calling API from https server.
+    # Default to true.
+    #
+    # @note Do NOT set it to false in production code, otherwise you would face multiple types of cryptographic attacks.
+    #
+    # @return [true, false]
+    def verify_ssl
+      @opts.has_key?(:verify_ssl) ? @opts[:verify_ssl] : $setting.dig(:triglav, :verify_ssl)
+    end
+
+    ### TLS/SSL setting
+    # Set this to false to skip verifying SSL host name
+    # Default to true.
+    #
+    # @note Do NOT set it to false in production code, otherwise you would face multiple types of cryptographic attacks.
+    #
+    # @return [true, false]
+    def verify_ssl_host
+      @opts.has_key?(:verify_ssl_host) ? @opts[:verify_ssl_host] : $setting.dig(:triglav, :verify_ssl_host)
+    end
+
+    ### TLS/SSL setting
+    # Set this to customize the certificate file to verify the peer.
+    #
+    # @return [String] the path to the certificate file
+    #
+    # @see The `cainfo` option of Typhoeus, `--cert` option of libcurl. Related source code:
+    # https://github.com/typhoeus/typhoeus/blob/master/lib/typhoeus/easy_factory.rb#L145
+    def ssl_ca_cert
+      @opts[:ssl_ca_cert] || $setting.dig(:triglav, :ssl_ca_cert)
+    end
+
+    ### TLS/SSL setting
+    # Client certificate file (for client certificate)
+    def cert_file
+      @opts[:cert_file] || $setting.dig(:triglav, :cert_file)
+    end
+
+    ### TLS/SSL setting
+    # Client private key file (for client certificate)
+    def key_file
+      @opts[:key_file] || $setting.dig(:triglav, :key_file)
     end
 
     def max_retries

data/lib/triglav/agent/version.rb

@@ -1,5 +1,5 @@
 module Triglav
   module Agent
-    VERSION = "1.0.0.pre1"
+    VERSION = "1.0.0.pre2"
   end
 end

data/triglav-agent.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Triglav Team"]
   spec.email         = ["triglav_admin_my@dena.jp"]
 
-  spec.summary       = %q{Framework of Triglav Agent in Ruby.}
-  spec.description   = %q{Framework of Triglav Agent in Ruby.}
+  spec.summary       = %q{Agent framework of triglav, data-driven workflow tool.}
+  spec.description   = %q{Agent framework of triglav, data-driven workflow tool.}
   spec.homepage      = "https://github.com/triglav-dataflow/triglav-agent-framework-ruby"
   spec.license       = "MIT"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: triglav-agent
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre1
+  version: 1.0.0.pre2
 platform: ruby
 authors:
 - Triglav Team
@@ -150,7 +150,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Framework of Triglav Agent in Ruby.
+description: Agent framework of triglav, data-driven workflow tool.
 email:
 - triglav_admin_my@dena.jp
 executables: []
@@ -246,5 +246,5 @@ rubyforge_project:
 rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: Framework of Triglav Agent in Ruby.
+summary: Agent framework of triglav, data-driven workflow tool.
 test_files: []