comet_backup_ruby_sdk 1.3.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ffe045abb4afab383a013a5da8d35ed80d576fa82361d1579421f23722393be7
-  data.tar.gz: cb90f69c80adce36b9277042ae4581a168d9cc4d820e8eed974c9a705cf9dca4
+  metadata.gz: 5978dc4b2eb4c0001eb7a7c44b3a215450fcbdc9ad7e639c75ba4b9b023b9ac5
+  data.tar.gz: 8bfd3b9417fefa6bde04316a2fbd6917ded287594e42cc64d989f56be52a6af4
 SHA512:
-  metadata.gz: b239d4b53d1096c9acebdd9769a1f415081a7a74dcba8834bcef72ddb459b5ffda6d0a4d22ab8310661bacf0d577630dbb01ef7283f494dfabb922bfe17218fb
-  data.tar.gz: b9791ed93a89258fc608375ef5230e62dfbd35589c1bf5026aae2bd35816985cf5b2caf4ba3a5c3c39f0d61f409c92575a0a7f6f0b7f097abad08e0e48383697
+  metadata.gz: 7bf9d9f36941632b74473ab2d6aeb6d0252951bdcf9be1b6f9ef9b1e595bc2cd91ee813f689d9e84c0b08442378799c8e6fd563c43aef40fd75f23b57d33d5bc
+  data.tar.gz: 859734f1a066f09426fb736ab83e28fa1b829ed795db56ed403622825fdf701723e25465f511be44e9316876d5d5f9e2a5f3904569005b1930db78aca3773a8c

data/.rubocop.yml

@@ -23,3 +23,8 @@ Layout/EmptyLinesAroundClassBody:
 # with the times when we do need multi-line bodies
 Style/IfUnlessModifier:
   Enabled: false
+
+  # allow rocket hashes
+
+Style/HashSyntax:
+  EnforcedStyle: no_mixed_keys

data/CHANGELOG.md

@@ -1,4 +1,46 @@
 # CHANGELOG
+## 2021-09-08 v1.7.0
+- Based on Comet 21.9.1
+- Support new `device_timezone` field on the `DeviceConfig` class. 
+- Add `admin_dispatcher_ping_destination` api method
+- Add support for new retention range type constants: `RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_DAY`
+- Add support for new retention range type constants: `RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_WEEK`
+- Add support for new retention range type constants: `RETENTIONRANGE_LAST_X_BACKUPS_ONE_FOR_EACH_MONTH`
+- Add support for Microsoft Office 365 Sharepoiint constant `STOREDOBJECTTYPE_MSSITELISTDRIVEENTITY`
+- Add Microsoft Office 365 Region cloud region constants `OFFICE_365_REGION_PUBLIC`
+- Add Microsoft Office 365 Region cloud region constants `OFFICE_365_REGION_CHINA`
+- Add Microsoft Office 365 Region cloud region constants `OFFICE_365_REGION_GERMANY`
+- Add Microsoft Office 365 Region cloud region constants `OFFICE_365_REGION_US_GOVT`
+- Add Microsoft Office 365 Region cloud region constants `OFFICE_365_REGION_US_DOD`
+
+## 2021-07-01 v1.6.0
+- Based on Comet 21.6.6
+- Support new `DefaultSourceWithOSRestriction` and `LastSuccessfulBackupJob` fields
+- Support custom credentials when performing a cloud Office 365 restore job
+- Support identifying Microsoft Teams folders inside a Sharepoint backup job
+- Document the `SourceIncludePattern` structure used for `PINCLUDE`/`RINCLUDE` rules in a File-type `EngineProps` array
+- Document existing `BrandingProps` endpoint
+
+## 2021-05-25 v1.5.0
+- Based on Comet 21.6.1
+- Add new APIs to remotely browse MySQL, MongoDB, MSSQL database servers
+- Add Microsoft Office 365 properties on BackupJobDetail and on StoredObject
+- Add Microsoft Office 365 browsing APIs
+- Add Microsoft Office 365 Engine definition (`ENGINE_BUILTIN_MSOFFICE`) and associated `EngineProp` data structure definitions
+- Add `AdminDispatcherRegisterOfficeApplication` APIs
+- Add `RESTORETYPE_OFFICE365_CLOUD` constant
+- Support suspending organizations
+- Support reading the Server Self-Backup status
+- Support new `PathMenuBarIcnsFile` branding option for Comet Backup on macOS
+- Add more detailed description for `AdminDispatcherRequestStoredObjects`
+
+## 2021-03-03 v1.4.0
+- Based on Comet 21.2.1
+- Support restoring files to original paths
+- Support the new "Custom" requestable Storage Vault provider type and its `CustomRemoteBucketSettings` structure
+- Support new `SpanUseStaticSlots` attribute
+- Fix missing fields in `ExternalLDAPAuthenticationSourceSettings` structure
+- Fix broken `AdminDispatcherRequestFilesystemObjects` that was parsing into the wrong response type
 
 ## 2020-11-24 v1.3.0
 - Based on Comet 20.11.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    comet_backup_ruby_sdk (1.2.0)
+    comet_backup_ruby_sdk (1.7.0)
 
 GEM
   remote: https://rubygems.org/
@@ -14,7 +14,7 @@ GEM
     rainbow (3.0.0)
     rake (13.0.1)
     regexp_parser (1.7.1)
-    rexml (3.2.4)
+    rexml (3.2.5)
     rubocop (0.88.0)
       parallel (~> 1.10)
       parser (>= 2.7.1.1)

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2020 Comet Licensing Ltd.
+Copyright (c) 2021 Comet Licensing Ltd.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

data/RELEASING.md

@@ -2,9 +2,11 @@
 
 1. All tests passing
 2. Update changelog in `CHANGELOG.md`
-3. Update version number in `gemspec`
-4. `gem build comet_backup_ruby_sdk`
+3. Update version number in `comet_backup_ruby_sdk.gemspec`
+4. `bundle install`
+	- Should update our internal version in Gemfile.lock
+5. `gem build comet_backup_ruby_sdk.gemspec`
 	- Should be warning-free
-5. Git tag
+6. Git tag
 	- Respect semver
-6. `gem push comet_backup_ruby_sdk-0.x.x.gem`
+7. `gem push comet_backup_ruby_sdk-1.x.x.gem`

data/comet_backup_ruby_sdk.gemspec

@@ -12,7 +12,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'comet_backup_ruby_sdk'
-  spec.version       = '1.3.0'
+  spec.version       = '1.7.0'
   spec.authors       = ['Comet Licensing Ltd.']
   spec.email         = ['hello@cometbackup.com']
 

data/lib/comet/api_response_error.rb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby --enable-frozen-string-literal
 #
-# Copyright (c) 2020-2020 Comet Licensing Ltd.
+# Copyright (c) 2020-2021 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT

data/lib/comet/comet_server.rb

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby --enable-frozen-string-literal
 #
-# Copyright (c) 2020-2020 Comet Licensing Ltd.
+# Copyright (c) 2020-2021 Comet Licensing Ltd.
 # Please see the LICENSE file for usage information.
 #
 # SPDX-License-Identifier: MIT
@@ -808,6 +808,7 @@ module Comet
     # This does not remove any storage buckets. Unused storage buckets will be cleaned up by the Constellation Role.
     # Any stored data can not be decrypted without the user profile. Misuse can cause data loss!
     # This also allows to uninstall software from active devices under the user account
+    # This also removes all job history for the user account.
     #
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
@@ -1076,6 +1077,33 @@ module Comet
       ret
     end
 
+    # AdminDispatcherPingDestination
+    #
+    # Test the connection to the storage bucket.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::DestinationLocation] extra_data The destination location settings
+    # @return [Comet::CometAPIResponseMessage]
+    def admin_dispatcher_ping_destination(target_id, extra_data)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'extra_data' expected Comet::DestinationLocation, got #{extra_data.class}" unless extra_data.is_a? Comet::DestinationLocation
+
+      submit_params['ExtraData'] = extra_data.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/ping-destination', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::CometAPIResponseMessage.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherRefetchProfile
     #
     # Instruct a live connected device to refresh their profile.
@@ -1100,6 +1128,62 @@ module Comet
       ret
     end
 
+    # AdminDispatcherRegisterOfficeApplicationBegin
+    #
+    # Begin the process of registering a new Azure AD application that can access Office 365 for backup.
+    # After calling this API, you should supply the login details to the end-user, and then begin polling the AdminDispatcherRegisterOfficeApplicationCheck with the supplied "Continuation" parameter to check on the registration process.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [String] email_address The email address of the Azure AD administrator
+    # @return [Comet::RegisterOfficeApplicationBeginResponse]
+    def admin_dispatcher_register_office_application_begin(target_id, email_address)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'email_address' expected String, got #{email_address.class}" unless email_address.is_a? String
+
+      submit_params['EmailAddress'] = email_address
+
+      body = perform_request('api/v1/admin/dispatcher/register-office-application/begin', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::RegisterOfficeApplicationBeginResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRegisterOfficeApplicationCheck
+    #
+    # Check the process of registering a new Azure AD application that can access Office 365 for backup.
+    # You should begin the process by calling AdminDispatcherRegisterOfficeApplicationBegin and asking the end-user to complete the Azure authentication steps.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [String] continuation The ID returned from the AdminDispatcherRegisterOfficeApplicationBegin endpoint
+    # @return [Comet::RegisterOfficeApplicationCheckResponse]
+    def admin_dispatcher_register_office_application_check(target_id, continuation)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'continuation' expected String, got #{continuation.class}" unless continuation.is_a? String
+
+      submit_params['Continuation'] = continuation
+
+      body = perform_request('api/v1/admin/dispatcher/register-office-application/check', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::RegisterOfficeApplicationCheckResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherReindexStorageVault
     #
     # Instruct a live connected device to rebuild Storage Vault indexes now.
@@ -1197,6 +1281,90 @@ module Comet
       ret
     end
 
+    # AdminDispatcherRequestBrowseMongodb
+    #
+    # Request a list of tables in MongoDB database.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::MongoDBConnection] credentials The Mongo database authentication settings
+    # @return [Comet::BrowseSQLServerResponse]
+    def admin_dispatcher_request_browse_mongodb(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::MongoDBConnection, got #{credentials.class}" unless credentials.is_a? Comet::MongoDBConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-mongodb', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseSQLServerResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseMssql
+    #
+    # Request a list of tables in MSSQL database.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::MSSQLConnection] credentials The MSSQL database authentication settings
+    # @return [Comet::BrowseSQLServerResponse]
+    def admin_dispatcher_request_browse_mssql(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::MSSQLConnection, got #{credentials.class}" unless credentials.is_a? Comet::MSSQLConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-mssql', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseSQLServerResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestBrowseMysql
+    #
+    # Request a list of tables in MySQL database.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::MySQLConnection] credentials The MySQL database authentication settings
+    # @return [Comet::BrowseSQLServerResponse]
+    def admin_dispatcher_request_browse_mysql(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::MySQLConnection, got #{credentials.class}" unless credentials.is_a? Comet::MySQLConnection
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-browse-mysql', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseSQLServerResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherRequestBrowseVssAaw
     #
     # Request a list of installed VSS Writers (Application-Aware Writers) from a live connected device.
@@ -1230,7 +1398,7 @@ module Comet
     #
     # @param [String] target_id The live connection GUID
     # @param [String] path (Optional) Browse objects inside this path. If empty or not present, returns the top-level device paths
-    # @return [Array<Comet::StoredObject>]
+    # @return [Comet::DispatcherStoredObjectsResponse]
     def admin_dispatcher_request_filesystem_objects(target_id, path = nil)
       submit_params = {}
       raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
@@ -1245,15 +1413,8 @@ module Comet
       body = perform_request('api/v1/admin/dispatcher/request-filesystem-objects', submit_params)
       json_body = JSON.parse body
       check_status json_body
-      if json_body.nil?
-        ret = []
-      else
-        ret = Array.new(json_body.length)
-        json_body.each_with_index do |v, i|
-          ret[i] = Comet::StoredObject.new
-          ret[i].from_hash(v)
-        end
-      end
+      ret = Comet::DispatcherStoredObjectsResponse.new
+      ret.from_hash(json_body)
       ret
     end
 
@@ -1280,10 +1441,67 @@ module Comet
       ret
     end
 
+    # AdminDispatcherRequestOffice365Accounts
+    #
+    # Request a list of Office365 mailbox accounts.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::Office365Credential] credentials The Office365 account credential
+    # @return [Comet::BrowseOffice365ObjectsResponse]
+    def admin_dispatcher_request_office_365accounts(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::Office365Credential, got #{credentials.class}" unless credentials.is_a? Comet::Office365Credential
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-office365-accounts', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseOffice365ObjectsResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
+    # AdminDispatcherRequestOffice365Sites
+    #
+    # Request a list of Office365 sites.
+    # The remote device must have given consent for an MSP to browse their files.
+    #
+    # You must supply administrator authentication credentials to use this API.
+    # This API requires the Auth Role to be enabled.
+    #
+    # @param [String] target_id The live connection GUID
+    # @param [Comet::Office365Credential] credentials The Office365 account credential
+    # @return [Comet::BrowseOffice365ObjectsResponse]
+    def admin_dispatcher_request_office_365sites(target_id, credentials)
+      submit_params = {}
+      raise TypeError, "'target_id' expected String, got #{target_id.class}" unless target_id.is_a? String
+
+      submit_params['TargetID'] = target_id
+      raise TypeError, "'credentials' expected Comet::Office365Credential, got #{credentials.class}" unless credentials.is_a? Comet::Office365Credential
+
+      submit_params['Credentials'] = credentials.to_json
+
+      body = perform_request('api/v1/admin/dispatcher/request-office365-sites', submit_params)
+      json_body = JSON.parse body
+      check_status json_body
+      ret = Comet::BrowseOffice365ObjectsResponse.new
+      ret.from_hash(json_body)
+      ret
+    end
+
     # AdminDispatcherRequestStoredObjects
     #
     # Request a list of stored objects inside an existing backup job.
     # The remote device must have given consent for an MSP to browse their files.
+    # To service this request, the remote device must connect to the Storage Vault and load index data. There may be a small delay. If the remote device is running Comet 20.12.0 or later, the necessary index data is cached when this API is first called, for 15 minutes after the last repeated call. This can improve performance for interactively browsing an entire tree of stored objects.
     #
     # You must supply administrator authentication credentials to use this API.
     # This API requires the Auth Role to be enabled.
@@ -3265,7 +3483,7 @@ module Comet
 
       ret_error = Comet::CometAPIResponseMessage.new
       ret_error.from_hash(obj)
-      raise Comet::APIResponseError.new(ret_error)
+      raise Comet::APIResponseError.new(ret_error), 'Comet API response status was not OK'
     end
 
     # Perform a synchronous HTTP request.
@@ -3302,7 +3520,7 @@ module Comet
 
       form_params = []
       params.each do |k, v|
-        form_params.append [k, v, {:filename => k}]
+        form_params.append [k, v, { :filename => k }]
       end
       req.set_form(form_params, 'multipart/form-data')