files.com 1.0.208 → 1.0.212

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 338dbd01060e2af598a844cfc78d2fd3dc08056161ac59dc5d8ac8098c678462
-  data.tar.gz: b3b1d00f73d4f0dd3b146c0df3472def4300478e377690b675da939a2bee988b
+  metadata.gz: b47255f7698ba6a1ebe5f8f8ba855d33aa546db17d89d212851219add42b5c2c
+  data.tar.gz: 92b8059a5f8a8d9bda18855fccf4e31a6109bd9a44c785c47ad5b0ab87f54bcf
 SHA512:
-  metadata.gz: 83629f10047b516c31d63d5d593299ba8c1432c0e11dd13d88bedb52058820a7eeb342f7089c2c2d88947d28e41999b723be1e8c2e5192551242d4b936055608
-  data.tar.gz: ac9673fc689b715369a25ce0d00350178b52e6d460aff78f733e37aa332d0e394eed627aa7431e1bfd534243e098201e436af7b890c9459e8e1a1ed46827f3ad
+  metadata.gz: 7f655df9c1e037f0d8e88b7f17b44584dcb2a393d4948066d4098522a9389c8d868e9366d1865d633e780acd220b6127a4b5f20d412a8e7f75b39558a3e91adc
+  data.tar.gz: b20cb722bd517b94b5b5344c883b5048d598794d66ea45b97388e44afee89786fc7b1393e21acab4b7e2ee453092f00f3b19c64c4a3c0d379a23471ca6099c89

data/_VERSION

@@ -1 +1 @@
-1.0.208
+1.0.212

data/docs/automation_run.md

@@ -0,0 +1,35 @@
+# AutomationRun
+
+## Example AutomationRun Object
+
+```
+{
+  "automation_id": 1,
+  "status": "success",
+  "status_messages_url": "https://www.example.com/log_file.txt"
+}
+```
+
+* `automation_id` (int64): ID of the associated Automation.
+* `status` (string): The success status of the AutomationRun. One of `running`, `success`, `partial_failure`, or `failure`.
+* `status_messages_url` (string): Link to status messages log file.
+
+
+---
+
+## List Automation Runs
+
+```
+Files::AutomationRun.list(
+  user_id: 1, 
+  per_page: 1, 
+  automation_id: 1
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `cursor` (string): Used for pagination.  Send a cursor value to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+* `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+* `automation_id` (int64): Required - ID of the associated Automation.

data/docs/file.md

@@ -150,10 +150,10 @@ Files::File.delete(path,
 
 ---
 
-## Return metadata for file/folder
+## Find file/folder by path
 
 ```
-Files::File.metadata(path, 
+Files::File.find(path, 
   with_previews: true, 
   with_priority_color: true
 )
@@ -287,27 +287,6 @@ file.delete(
 * `recursive` (boolean): If true, will recursively delete folers.  Otherwise, will error on non-empty folders.
 
 
----
-
-## Return metadata for file/folder
-
-```
-file = Files::File.list_for(path).first
-
-file.metadata(
-  with_previews: true,
-  with_priority_color: true
-)
-```
-
-### Parameters
-
-* `path` (string): Required - Path to operate on.
-* `preview_size` (string): Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
-* `with_previews` (boolean): Include file preview information?
-* `with_priority_color` (boolean): Include file priority color information?
-
-
 ---
 
 ## Copy file/folder

data/docs/public_ip_address.md

@@ -5,9 +5,13 @@
 ```
 {
   "ip_address": "1.1.1.1",
-  "server_name": "server-1"
+  "server_name": "server-1",
+  "ftp_enabled": "",
+  "sftp_enabled": ""
 }
 ```
 
 * `ip_address` (string): The public IP address.
 * `server_name` (string): The name of the frontend server.
+* `ftp_enabled` (string): 
+* `sftp_enabled` (string): 

data/docs/session.md

@@ -12,6 +12,7 @@
   "multiple_regions": true,
   "read_only": true,
   "root_path": "",
+  "sftp_insecure_ciphers": true,
   "site_id": 1,
   "ssl_required": true,
   "tls_disabled": true,
@@ -33,9 +34,10 @@
 * `multiple_regions` (boolean): Can access multiple regions?
 * `read_only` (boolean): Is this session read only?
 * `root_path` (string): Initial root path to start the user's session in.
+* `sftp_insecure_ciphers` (boolean): Are insecure SFTP ciphers allowed for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure SSH ciphers for this user.)
 * `site_id` (int64): Site ID
 * `ssl_required` (boolean): Is SSL required for this user?  (If so, ensure all your communications with this user use SSL.)
-* `tls_disabled` (boolean): Is strong TLS disabled for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure TLS versions for this user.)
+* `tls_disabled` (boolean): Aee insecure TLS versions allowed for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure TLS versions for this user.)
 * `two_factor_setup_needed` (boolean): If true, this user needs to add a Two Factor Authentication method before performing any further actions.
 * `allowed_2fa_method_sms` (boolean): Sent only if 2FA setup is needed. Is SMS two factor authentication allowed?
 * `allowed_2fa_method_totp` (boolean): Sent only if 2FA setup is needed. Is TOTP two factor authentication allowed?

data/docs/site.md

@@ -115,6 +115,7 @@
     "multiple_regions": true,
     "read_only": true,
     "root_path": "",
+    "sftp_insecure_ciphers": false,
     "site_id": 1,
     "ssl_required": true,
     "tls_disabled": false,
@@ -128,6 +129,7 @@
   },
   "session_pinned_by_ip": true,
   "sftp_enabled": true,
+  "sftp_insecure_ciphers": true,
   "sftp_user_root_enabled": true,
   "sharing_enabled": true,
   "show_request_access_link": true,
@@ -303,6 +305,7 @@
 * `session`: Current session
 * `session_pinned_by_ip` (boolean): Are sessions locked to the same IP? (i.e. do users need to log in again if they change IPs?)
 * `sftp_enabled` (boolean): Is SFTP enabled?
+* `sftp_insecure_ciphers` (boolean): Are Insecure Ciphers allowed for SFTP?  Note:  Settting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
 * `sftp_user_root_enabled` (boolean): Use user FTP roots also for SFTP?
 * `sharing_enabled` (boolean): Allow bundle creation
 * `show_request_access_link` (boolean): Show request access link for users without access?  Currently unused.
@@ -317,7 +320,7 @@
 * `ssl_required` (boolean): Is SSL required?  Disabling this is insecure.
 * `subdomain` (string): Site subdomain
 * `switch_to_plan_date` (date-time): If switching plans, when does the new plan take effect?
-* `tls_disabled` (boolean): Is TLS disabled(site setting)?
+* `tls_disabled` (boolean): Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
 * `trial_days_left` (int64): Number of days left in trial
 * `trial_until` (date-time): When does this Site trial expire?
 * `updated_at` (date-time): Last time this Site was updated
@@ -387,6 +390,7 @@ Files::Site.update(
   session_expiry: 1.0, 
   ssl_required: true, 
   tls_disabled: true, 
+  sftp_insecure_ciphers: true, 
   user_lockout: true, 
   user_lockout_tries: 1, 
   user_lockout_within: 1, 
@@ -487,7 +491,8 @@ Files::Site.update(
 * `office_integration_available` (boolean): Allow users to use Office for the web?
 * `session_expiry` (double): Session expiry in hours
 * `ssl_required` (boolean): Is SSL required?  Disabling this is insecure.
-* `tls_disabled` (boolean): Is TLS disabled(site setting)?
+* `tls_disabled` (boolean): Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
+* `sftp_insecure_ciphers` (boolean): Are Insecure Ciphers allowed for SFTP?  Note:  Settting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
 * `user_lockout` (boolean): Will users be locked out after incorrect login attempts?
 * `user_lockout_tries` (int64): Number of login tries within `user_lockout_within` hours before users are locked out
 * `user_lockout_within` (int64): Number of hours for user lockout window

data/lib/files.com/errors.rb

@@ -191,6 +191,9 @@ module Files
   class TooManyLoginAttemptsError < RateLimitedError; end
   class TooManyRequestsError < RateLimitedError; end
 
+  class ServiceUnavailableError < APIError; end
+  class UploadsUnavailableError < ServiceUnavailableError; end
+
   class SiteConfigurationError < APIError; end
   class AccountAlreadyExistsError < SiteConfigurationError; end
   class AccountOverdueError < SiteConfigurationError; end

data/lib/files.com/models/automation_run.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Files
+  class AutomationRun
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - ID of the associated Automation.
+    def automation_id
+      @attributes[:automation_id]
+    end
+
+    # string - The success status of the AutomationRun. One of `running`, `success`, `partial_failure`, or `failure`.
+    def status
+      @attributes[:status]
+    end
+
+    # string - Link to status messages log file.
+    def status_messages_url
+      @attributes[:status_messages_url]
+    end
+
+    # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+    #   cursor - string - Used for pagination.  Send a cursor value to resume an existing list from the point at which you left off.  Get a cursor from an existing list via the X-Files-Cursor-Next header.
+    #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+    #   automation_id (required) - int64 - ID of the associated Automation.
+    def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params.dig(:user_id) and !params.dig(:user_id).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params.dig(:cursor) and !params.dig(:cursor).is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params.dig(:per_page) and !params.dig(:per_page).is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: automation_id must be an Integer") if params.dig(:automation_id) and !params.dig(:automation_id).is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: automation_id") unless params.dig(:automation_id)
+
+      List.new(AutomationRun, params) do
+        Api.send_request("/automation_runs", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+  end
+end

data/lib/files.com/models/file.rb

@@ -867,23 +867,6 @@ module Files
       delete(params)
     end
 
-    # Return metadata for file/folder
-    #
-    # Parameters:
-    #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
-    #   with_previews - boolean - Include file preview information?
-    #   with_priority_color - boolean - Include file priority color information?
-    def metadata(params = {})
-      params ||= {}
-      params[:path] = @attributes[:path]
-      raise MissingParameterError.new("Current object doesn't have a path") unless @attributes[:path]
-      raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
-      raise InvalidParameterError.new("Bad parameter: preview_size must be an String") if params.dig(:preview_size) and !params.dig(:preview_size).is_a?(String)
-      raise MissingParameterError.new("Parameter missing: path") unless params.dig(:path)
-
-      Api.send_request("/file_actions/metadata/#{@attributes[:path]}", :get, params, @options)
-    end
-
     # Copy file/folder
     #
     # Parameters:
@@ -1029,13 +1012,12 @@ module Files
       delete(path, params, options)
     end
 
-    # Return metadata for file/folder
-    #
     # Parameters:
+    #   path (required) - string - Path to operate on.
     #   preview_size - string - Request a preview size.  Can be `small` (default), `large`, `xlarge`, or `pdf`.
     #   with_previews - boolean - Include file preview information?
     #   with_priority_color - boolean - Include file priority color information?
-    def self.metadata(path, params = {}, options = {})
+    def self.find(path, params = {}, options = {})
       params ||= {}
       params[:path] = path
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params.dig(:path) and !params.dig(:path).is_a?(String)
@@ -1046,6 +1028,10 @@ module Files
       File.new(response.data, options)
     end
 
+    def self.get(path, params = {}, options = {})
+      find(path, params, options)
+    end
+
     # Copy file/folder
     #
     # Parameters:

data/lib/files.com/models/public_ip_address.rb

@@ -18,5 +18,15 @@ module Files
     def server_name
       @attributes[:server_name]
     end
+
+    # string
+    def ftp_enabled
+      @attributes[:ftp_enabled]
+    end
+
+    # string
+    def sftp_enabled
+      @attributes[:sftp_enabled]
+    end
   end
 end

data/lib/files.com/models/session.rb

@@ -85,6 +85,15 @@ module Files
       @attributes[:root_path] = value
     end
 
+    # boolean - Are insecure SFTP ciphers allowed for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure SSH ciphers for this user.)
+    def sftp_insecure_ciphers
+      @attributes[:sftp_insecure_ciphers]
+    end
+
+    def sftp_insecure_ciphers=(value)
+      @attributes[:sftp_insecure_ciphers] = value
+    end
+
     # int64 - Site ID
     def site_id
       @attributes[:site_id]
@@ -103,7 +112,7 @@ module Files
       @attributes[:ssl_required] = value
     end
 
-    # boolean - Is strong TLS disabled for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure TLS versions for this user.)
+    # boolean - Aee insecure TLS versions allowed for this user? (If this is set to true, the site administrator has signaled that it is ok to use less secure TLS versions for this user.)
     def tls_disabled
       @attributes[:tls_disabled]
     end

data/lib/files.com/models/site.rb

@@ -459,6 +459,11 @@ module Files
       @attributes[:sftp_enabled]
     end
 
+    # boolean - Are Insecure Ciphers allowed for SFTP?  Note:  Settting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
+    def sftp_insecure_ciphers
+      @attributes[:sftp_insecure_ciphers]
+    end
+
     # boolean - Use user FTP roots also for SFTP?
     def sftp_user_root_enabled
       @attributes[:sftp_user_root_enabled]
@@ -529,7 +534,7 @@ module Files
       @attributes[:switch_to_plan_date]
     end
 
-    # boolean - Is TLS disabled(site setting)?
+    # boolean - Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
     def tls_disabled
       @attributes[:tls_disabled]
     end
@@ -652,7 +657,8 @@ module Files
     #   office_integration_available - boolean - Allow users to use Office for the web?
     #   session_expiry - double - Session expiry in hours
     #   ssl_required - boolean - Is SSL required?  Disabling this is insecure.
-    #   tls_disabled - boolean - Is TLS disabled(site setting)?
+    #   tls_disabled - boolean - Are Insecure TLS and SFTP Ciphers allowed?  Enabling this is insecure.
+    #   sftp_insecure_ciphers - boolean - Are Insecure Ciphers allowed for SFTP?  Note:  Settting TLS Disabled -> True will always allow insecure ciphers for SFTP as well.  Enabling this is insecure.
     #   user_lockout - boolean - Will users be locked out after incorrect login attempts?
     #   user_lockout_tries - int64 - Number of login tries within `user_lockout_within` hours before users are locked out
     #   user_lockout_within - int64 - Number of hours for user lockout window

data/lib/files.com.rb

@@ -37,6 +37,7 @@ require "files.com/models/app"
 require "files.com/models/as2_key"
 require "files.com/models/auto"
 require "files.com/models/automation"
+require "files.com/models/automation_run"
 require "files.com/models/bandwidth_snapshot"
 require "files.com/models/behavior"
 require "files.com/models/bundle"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.208
+  version: 1.0.212
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-14 00:00:00.000000000 Z
+date: 2021-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -96,6 +96,7 @@ files:
 - docs/as2_key.md
 - docs/auto.md
 - docs/automation.md
+- docs/automation_run.md
 - docs/bandwidth_snapshot.md
 - docs/behavior.md
 - docs/bundle.md
@@ -173,6 +174,7 @@ files:
 - lib/files.com/models/as2_key.rb
 - lib/files.com/models/auto.rb
 - lib/files.com/models/automation.rb
+- lib/files.com/models/automation_run.rb
 - lib/files.com/models/bandwidth_snapshot.rb
 - lib/files.com/models/behavior.rb
 - lib/files.com/models/bundle.rb