files.com 1.0.298 → 1.0.300

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3e5ba413e3894bc38bc4fe3d8632f8eb7809368963095101fb8c4c479246dd8
-  data.tar.gz: d7179818843d71a47f74c67a74d524209646232a447b451569564456b5db0fee
+  metadata.gz: d254f2d5da5d785a5be384cc526a1697a3774a8a31df315dfba7dfc689c115b8
+  data.tar.gz: 3303a48addebc1b06e1a0a16a9019254b1dfea5733f74adeeac7c9e53aeed0de
 SHA512:
-  metadata.gz: 1c279c4636e00579259cdc6960fa7c7171f302954bd7a74dc375d45d4514c60694a111443d72394173ef19d134d6d0f2df6ac9a4569fdccd6b309b850560f838
-  data.tar.gz: 9e5437da0aa30ec3e9d3ae2b9b7f2c36d26503249cb712996e7d8aed65cd2ad92e3c65a6bee29b0ba70a138239a53e3851295b7d92bcc8a9d16f13fda60f1455
+  metadata.gz: 9e5f9056389ef70a9b40e56f167e1c02959fd182a69ce214191d0920f2a7f5df7917b75e739aafb53a1ffa8464a5956ac1de3aa34792e764493418b5478487f2
+  data.tar.gz: 0b563cf3388670d93ed033108464e2be0f4fbec633c6be0476d6fe9be48243047bb77f543e87d0a6639cbe71aaa4559c5f0aca414b4a27d37512022e4a33c571

data/_VERSION

@@ -1 +1 @@
-1.0.298
+1.0.300

data/docs/api_key.md

@@ -15,6 +15,7 @@
   "path": "shared/docs",
   "permission_set": "full",
   "platform": "win32",
+  "url": "example",
   "user_id": 1
 }
 ```
@@ -30,6 +31,7 @@
 * `path` (string): Folder path restriction for this api key. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
 * `permission_set` (string): Permissions for this API Key.  Keys with the `desktop_app` permission set only have the ability to do the functions provided in our Desktop App (File and Share Link operations).  Additional permission sets may become available in the future, such as for a Site Admin to give a key with no administrator privileges.  If you have ideas for permission sets, please let us know.
 * `platform` (string): If this API key represents a Desktop app, what platform was it created on?
+* `url` (string): URL for API host.
 * `user_id` (int64): User ID for the owner of this API Key.  May be blank for Site-wide API Keys.
 
 

data/docs/bundle.md

@@ -19,9 +19,11 @@
   "skip_company": true,
   "id": 1,
   "created_at": "2000-01-01T01:00:00Z",
+  "dont_separate_submissions_by_folder": true,
   "expires_at": "2000-01-01T01:00:00Z",
   "max_uses": 1,
   "note": "The internal note on the bundle.",
+  "path_template": "{{name}}_{{ip}}",
   "user_id": 1,
   "username": "user",
   "clickwrap_id": 1,
@@ -52,9 +54,11 @@
 * `skip_company` (boolean): BundleRegistrations can be saved without providing company?
 * `id` (int64): Bundle ID
 * `created_at` (date-time): Bundle created at date/time
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (date-time): Bundle expiration date/time
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `user_id` (int64): Bundle creator user ID
 * `username` (string): Bundle creator username
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
@@ -117,11 +121,13 @@ Files::Bundle.create(
   paths: ["file.txt"], 
   password: "Password", 
   form_field_set_id: 1, 
+  dont_separate_submissions_by_folder: true, 
   expires_at: "2000-01-01T01:00:00Z", 
   max_uses: 1, 
   description: "The public description of the bundle.", 
   note: "The internal note on the bundle.", 
   code: "abc123", 
+  path_template: "{{name}}_{{ip}}", 
   permissions: "read", 
   preview_only: true, 
   require_registration: true, 
@@ -140,11 +146,13 @@ Files::Bundle.create(
 * `paths` (array(string)): Required - A list of paths to include in this bundle.
 * `password` (string): Password for this bundle.
 * `form_field_set_id` (int64): Id of Form Field Set to use with this bundle
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (string): Bundle expiration date/time
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `description` (string): Public description
 * `note` (string): Bundle internal note
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
@@ -189,10 +197,12 @@ Files::Bundle.update(id,
   clickwrap_id: 1, 
   code: "abc123", 
   description: "The public description of the bundle.", 
+  dont_separate_submissions_by_folder: true, 
   expires_at: "2000-01-01T01:00:00Z", 
   inbox_id: 1, 
   max_uses: 1, 
   note: "The internal note on the bundle.", 
+  path_template: "{{name}}_{{ip}}", 
   permissions: "read", 
   preview_only: true, 
   require_registration: true, 
@@ -213,10 +223,12 @@ Files::Bundle.update(id,
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
 * `description` (string): Public description
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (string): Bundle expiration date/time
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?
@@ -277,10 +289,12 @@ bundle.update(
   clickwrap_id: 1,
   code: "abc123",
   description: "The public description of the bundle.",
+  dont_separate_submissions_by_folder: true,
   expires_at: "2000-01-01T01:00:00Z",
   inbox_id: 1,
   max_uses: 1,
   note: "The internal note on the bundle.",
+  path_template: "{{name}}_{{ip}}",
   permissions: "read",
   preview_only: true,
   require_registration: true,
@@ -301,10 +315,12 @@ bundle.update(
 * `clickwrap_id` (int64): ID of the clickwrap to use with this bundle.
 * `code` (string): Bundle code.  This code forms the end part of the Public URL.
 * `description` (string): Public description
+* `dont_separate_submissions_by_folder` (boolean): Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
 * `expires_at` (string): Bundle expiration date/time
 * `inbox_id` (int64): ID of the associated inbox, if available.
 * `max_uses` (int64): Maximum number of times bundle can be accessed
 * `note` (string): Bundle internal note
+* `path_template` (string): Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
 * `permissions` (string): Permissions that apply to Folders in this Share Link.
 * `preview_only` (boolean): Restrict users to previewing files only?
 * `require_registration` (boolean): Show a registration page that captures the downloader's name and email address?

data/docs/site.md

@@ -107,6 +107,8 @@
   "session": "",
   "session_pinned_by_ip": true,
   "sftp_enabled": true,
+  "sftp_host_key_type": "default",
+  "active_sftp_host_key_id": 1,
   "sftp_insecure_ciphers": true,
   "sftp_user_root_enabled": true,
   "sharing_enabled": true,
@@ -245,6 +247,8 @@
 * `session` (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_host_key_type` (string): Sftp Host Key Type
+* `active_sftp_host_key_id` (int64): Id of the currently selected custom SFTP Host Key
 * `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
@@ -377,6 +381,8 @@ Files::Site.update(
   user_requests_notify_admins: true, 
   ftp_enabled: true, 
   sftp_enabled: true, 
+  sftp_host_key_type: "default", 
+  active_sftp_host_key_id: 1, 
   bundle_watermark_value: {"key":"example value"}, 
   allowed_2fa_method_sms: true, 
   allowed_2fa_method_u2f: true, 
@@ -499,6 +505,8 @@ Files::Site.update(
 * `user_requests_notify_admins` (boolean): Send email to site admins when a user request is received?
 * `ftp_enabled` (boolean): Is FTP enabled?
 * `sftp_enabled` (boolean): Is SFTP enabled?
+* `sftp_host_key_type` (string): Sftp Host Key Type
+* `active_sftp_host_key_id` (int64): Id of the currently selected custom SFTP Host Key
 * `bundle_watermark_value` (object): Preview watermark settings applied to all bundle items. Uses the same keys as Behavior.value
 * `allowed_2fa_method_sms` (boolean): Is SMS two factor authentication allowed?
 * `allowed_2fa_method_u2f` (boolean): Is U2F two factor authentication allowed?

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

@@ -104,6 +104,15 @@ module Files
       @attributes[:platform] = value
     end
 
+    # string - URL for API host.
+    def url
+      @attributes[:url]
+    end
+
+    def url=(value)
+      @attributes[:url] = value
+    end
+
     # int64 - User ID for the owner of this API Key.  May be blank for Site-wide API Keys.
     def user_id
       @attributes[:user_id]

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

@@ -140,6 +140,15 @@ module Files
       @attributes[:created_at]
     end
 
+    # boolean - Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
+    def dont_separate_submissions_by_folder
+      @attributes[:dont_separate_submissions_by_folder]
+    end
+
+    def dont_separate_submissions_by_folder=(value)
+      @attributes[:dont_separate_submissions_by_folder] = value
+    end
+
     # date-time - Bundle expiration date/time
     def expires_at
       @attributes[:expires_at]
@@ -167,6 +176,15 @@ module Files
       @attributes[:note] = value
     end
 
+    # string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
+    def path_template
+      @attributes[:path_template]
+    end
+
+    def path_template=(value)
+      @attributes[:path_template] = value
+    end
+
     # int64 - Bundle creator user ID
     def user_id
       @attributes[:user_id]
@@ -301,10 +319,12 @@ module Files
     #   clickwrap_id - int64 - ID of the clickwrap to use with this bundle.
     #   code - string - Bundle code.  This code forms the end part of the Public URL.
     #   description - string - Public description
+    #   dont_separate_submissions_by_folder - boolean - Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
     #   expires_at - string - Bundle expiration date/time
     #   inbox_id - int64 - ID of the associated inbox, if available.
     #   max_uses - int64 - Maximum number of times bundle can be accessed
     #   note - string - Bundle internal note
+    #   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
     #   permissions - string - Permissions that apply to Folders in this Share Link.
     #   preview_only - boolean - Restrict users to previewing files only?
     #   require_registration - boolean - Show a registration page that captures the downloader's name and email address?
@@ -329,6 +349,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permissions must be an String") if params[:permissions] and !params[:permissions].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 
@@ -411,11 +432,13 @@ module Files
     #   paths (required) - array(string) - A list of paths to include in this bundle.
     #   password - string - Password for this bundle.
     #   form_field_set_id - int64 - Id of Form Field Set to use with this bundle
+    #   dont_separate_submissions_by_folder - boolean - Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
     #   expires_at - string - Bundle expiration date/time
     #   max_uses - int64 - Maximum number of times bundle can be accessed
     #   description - string - Public description
     #   note - string - Bundle internal note
     #   code - string - Bundle code.  This code forms the end part of the Public URL.
+    #   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
     #   permissions - string - Permissions that apply to Folders in this Share Link.
     #   preview_only - boolean - Restrict users to previewing files only?
     #   require_registration - boolean - Show a registration page that captures the downloader's name and email address?
@@ -436,6 +459,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: description must be an String") if params[:description] and !params[:description].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: code must be an String") if params[:code] and !params[:code].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permissions must be an String") if params[:permissions] and !params[:permissions].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: clickwrap_id must be an Integer") if params[:clickwrap_id] and !params[:clickwrap_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
@@ -471,10 +495,12 @@ module Files
     #   clickwrap_id - int64 - ID of the clickwrap to use with this bundle.
     #   code - string - Bundle code.  This code forms the end part of the Public URL.
     #   description - string - Public description
+    #   dont_separate_submissions_by_folder - boolean - Do not create subfolders for files uploaded to this share. Note: there are subtle security pitfalls with allowing anonymous uploads from multiple users to live in the same folder. We strongly discourage use of this option unless absolutely required.
     #   expires_at - string - Bundle expiration date/time
     #   inbox_id - int64 - ID of the associated inbox, if available.
     #   max_uses - int64 - Maximum number of times bundle can be accessed
     #   note - string - Bundle internal note
+    #   path_template - string - Template for creating submission subfolders. Can use the uploader's name, email address, ip, company, and any custom form data.
     #   permissions - string - Permissions that apply to Folders in this Share Link.
     #   preview_only - boolean - Restrict users to previewing files only?
     #   require_registration - boolean - Show a registration page that captures the downloader's name and email address?
@@ -498,6 +524,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: inbox_id must be an Integer") if params[:inbox_id] and !params[:inbox_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: max_uses must be an Integer") if params[:max_uses] and !params[:max_uses].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: note must be an String") if params[:note] and !params[:note].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: path_template must be an String") if params[:path_template] and !params[:path_template].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: permissions must be an String") if params[:permissions] and !params[:permissions].is_a?(String)
       raise MissingParameterError.new("Parameter missing: id") unless params[:id]
 

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

@@ -514,6 +514,16 @@ module Files
       @attributes[:sftp_enabled]
     end
 
+    # string - Sftp Host Key Type
+    def sftp_host_key_type
+      @attributes[:sftp_host_key_type]
+    end
+
+    # int64 - Id of the currently selected custom SFTP Host Key
+    def active_sftp_host_key_id
+      @attributes[:active_sftp_host_key_id]
+    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]
@@ -767,6 +777,8 @@ module Files
     #   user_requests_notify_admins - boolean - Send email to site admins when a user request is received?
     #   ftp_enabled - boolean - Is FTP enabled?
     #   sftp_enabled - boolean - Is SFTP enabled?
+    #   sftp_host_key_type - string - Sftp Host Key Type
+    #   active_sftp_host_key_id - int64 - Id of the currently selected custom SFTP Host Key
     #   bundle_watermark_value - object - Preview watermark settings applied to all bundle items. Uses the same keys as Behavior.value
     #   allowed_2fa_method_sms - boolean - Is SMS two factor authentication allowed?
     #   allowed_2fa_method_u2f - boolean - Is U2F two factor authentication allowed?
@@ -850,6 +862,8 @@ module Files
       raise InvalidParameterError.new("Bad parameter: password_validity_days must be an Integer") if params[:password_validity_days] and !params[:password_validity_days].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: password_min_length must be an Integer") if params[:password_min_length] and !params[:password_min_length].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: disable_users_from_inactivity_period_days must be an Integer") if params[:disable_users_from_inactivity_period_days] and !params[:disable_users_from_inactivity_period_days].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: sftp_host_key_type must be an String") if params[:sftp_host_key_type] and !params[:sftp_host_key_type].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: active_sftp_host_key_id must be an Integer") if params[:active_sftp_host_key_id] and !params[:active_sftp_host_key_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: bundle_watermark_value must be an Hash") if params[:bundle_watermark_value] and !params[:bundle_watermark_value].is_a?(Hash)
       raise InvalidParameterError.new("Bad parameter: require_2fa_user_type must be an String") if params[:require_2fa_user_type] and !params[:require_2fa_user_type].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: color2_top must be an String") if params[:color2_top] and !params[:color2_top].is_a?(String)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.298
+  version: 1.0.300
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-03 00:00:00.000000000 Z
+date: 2022-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable