sophos_central_api 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed2be4896987431b40e0fc3b01f61addc9b58485aa3f1157493dadb070a792e2
-  data.tar.gz: 848756dcc5fd520b1f5584acad7a9a318caf569cfd4bbef377b9e646fbc6c5f6
+  metadata.gz: de42982e7073acef13887732efb277b3f24e31fcf34552f7857100edc20b99a2
+  data.tar.gz: 40425c2083e372ea6434f86723209ddd1673a1055ca8fc26e9bac997fb961305
 SHA512:
-  metadata.gz: b0e6aff68a24b83ae099fbb6d4273dc3cfa918b36223fefca96951b51f352081c50bfeef5f246205daf0ec98281a837f32390d151704340e2f048193479a2bf8
-  data.tar.gz: 5aec805aaf3ab8988af7dc8adc50fb4e41564e94bf1cfdfa1fd05b6251bd7ac6a0af0a87fc94b1e619e408b5e1e8266d8ddfa3d86fd2a92bb4dd39c2112731d1
+  metadata.gz: 4c3655439d962b32baef1e85a1ec31e4442c103472a82d0a2388d271fccde35c2fadb43088fd07db5ef3676d99331cea568f4019f61705b54a88577a7f97e073
+  data.tar.gz: 47cc68a252b5ad954f6bb6b48aae862b27e48ab35e0bacdb8c1fb605dd4d322d2af1325ec5457bef5ad6c970d20ac5f01c23e30705bd41f50c58a0c0e55c208b

data/CHANGELOG.md

@@ -8,3 +8,6 @@
 
 ## [0.1.2] - 2024-02-15
 - Fix initialization issue
+
+## [0.2.0] - 2024-02-20
+- Configuration and authentication exceptions changed

data/Gemfile

@@ -7,4 +7,5 @@ gemspec
 
 gem 'rake', '~> 13.0'
 gem 'rubocop', '~> 1.7'
+gem 'simplecov', require: false, group: :test
 gem 'wrapi'

data/README.md

@@ -1,4 +1,7 @@
 # Sophos Central Partner API
+[![Version](https://img.shields.io/gem/v/sophos_central_api.svg)](https://rubygems.org/gems/sophos_central_api)
+[![Maintainability](https://api.codeclimate.com/v1/badges/0e0c212559aad49a915c/maintainability)](https://codeclimate.com/github/jancotanis/sophos/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/0e0c212559aad49a915c/test_coverage)](https://codeclimate.com/github/jancotanis/sophos/test_coverage)
 
 This is a wrapper for the Sophos Central Partner API. You can see the API endpoints here https://developer.sophos.com/getting-started
 
@@ -9,7 +12,7 @@ Currently only the GET requests to customers, endpoints and alerts are implement
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'sophos_partner_api'
+gem 'sophos_central_api'
 ```
 
 And then execute:
@@ -18,14 +21,14 @@ And then execute:
 
 Or install it yourself as:
 
-    $ gem install sophos_partner_api
+    $ gem install sophos_central_api
 
 ## Usage
 
 Before you start making the requests to API provide the client id and client secret and email/password using the configuration wrapping.
 
 ```
-require 'sophos_partner_api'
+require 'sophos_central_api'
 
 Sophos.configure do |config|
   config.client_id = ENV["SOPHOS_CLIENT_ID"]

data/Rakefile

@@ -1,12 +1,20 @@
 # frozen_string_literal: true
 
 require 'bundler/gem_tasks'
+require 'dotenv'
 require 'rake/testtask'
 
+Dotenv.load
+
+system './bin/cc-test-reporter before-build'
+
 Rake::TestTask.new(:test) do |t|
   t.libs << 'test'
   t.libs << 'lib'
   t.test_files = FileList['test/**/*_test.rb']
+  at_exit do
+    system './bin/cc-test-reporter after-build'
+  end
 end
 
 require 'rubocop/rake_task'

data/lib/sophos/authentication.rb

@@ -1,5 +1,7 @@
+require 'faraday'
 require 'json'
 require 'uri'
+require File.expand_path('error', __dir__)
 
 module Sophos
   # Deals with authentication flow and stores it within global configuration
@@ -8,6 +10,7 @@ module Sophos
     # Authorize to the Sophos portal and return access_token
     # @see https://developer.sophos.com/getting-started
     def auth_token(options = {})
+      raise ConfigurationError.new 'Client id and/or secret not configured' unless client_id && client_secret
       # use id endpoint instead of global api
       response = connection.post(id_endpoint+'/api/v2/oauth2/token') do |request|
         request.headers['Content-Type'] = 'application/x-www-form-urlencoded'
@@ -22,8 +25,10 @@ module Sophos
         self.endpoint = partner.apiHosts.global
         self.connection_options = { headers: { 'X-partner-id': self.partner_id } }
       else
-        raise raise StandardError.new 'Partner id not returned; response ' + response.to_s
+        raise AuthenticationError.new 'Partner id not returned; response ' + response.to_s
       end
+    rescue Faraday::UnauthorizedError => e
+        raise AuthenticationError.new 'Unauthorized; response ' + e.to_s
     end
     alias login auth_token
 
@@ -43,7 +48,7 @@ module Sophos
       self.token_type        = response['token_type']
       self.refresh_token     = response['refresh_token']
       self.token_expires     = response['expires_in']
-      raise StandardError.new 'Could not find valid access_token; response ' + response.to_s if at.nil? || at.empty?
+      raise AuthenticationError.new 'Could not find valid access_token; response ' + response.to_s if at.nil? || at.empty?
 
       at
     end

data/lib/sophos/client/endpoint.rb

@@ -11,23 +11,23 @@ module Sophos
       Helper::def_api_call :downloads, Helper::endpoint_url(:downloads)
 
       # @see https://developer.sophos.com/docs/endpoint-v1/1/routes/endpoint-groups/get
-      Helper::def_api_call :endpoint_groups, Helper::endpoint_url(:endpoint_groups), true
+      Helper::def_api_call :endpoint_groups, Helper::endpoint_url(:endpoint_groups), :endpoint_group
       def endpoint_group_endpoints(group_id)
         get_paged Helper::endpoint_url("endpoint-groups/#{group_id}/endpoints")
       end
 
       # @see https://developer.sophos.com/docs/endpoint-v1/1/routes/migrations/get
-      Helper::def_api_call :migrations, Helper::endpoint_url(:migrations), true
+      Helper::def_api_call :migrations, Helper::endpoint_url(:migrations), :migration
       def migration_endpoints(migration_id)
         get_paged Helper::endpoint_url("migrations/#{migration_id}/endpoints")
       end
 
       # @see https://developer.sophos.com/docs/endpoint-v1/1/routes/policies/get
-      Helper::def_api_call :policies, Helper::endpoint_url(:policies), true
+      Helper::def_api_call :policies, Helper::endpoint_url(:policies), :policy
 
       # Get all the endpoints for the specified tenant. No endpoint method defined as this clashes with api endpoint method
       # @see https://developer.sophos.com/docs/endpoint-v1/1/routes/endpoints/get
-      Helper::def_api_call :endpoints, Helper::endpoint_url(:endpoints), false
+      Helper::def_api_call :endpoints, Helper::endpoint_url(:endpoints)
       def endpoint_isolation(endpoint_id)
         get Helper::endpoint_url("endpoints/#{endpoint_id}/isolation")
       end

data/lib/sophos/client/helper.rb

@@ -8,26 +8,17 @@ module Sophos
         method_name.to_s.gsub('_', '-')
       end
 
-      def self.singular method_name
-        method_name = method_name.to_s.gsub(/s$/, '') 
-        method_name.gsub(/ie$/, 'y').to_sym
-      end
-
-      def self.common_url(method)
-        "/common/v1/#{sanitize(method)}"
-      end
-
-      def self.endpoint_url(method)
-        "/endpoint/v1/#{sanitize(method)}"
-      end
-
-      def self.partner_url(method)
-        "/partner/v1/#{sanitize(method)}"
+      def self.common_url(method) self.url('common', method); end
+      def self.endpoint_url(method) self.url('endpoint', method); end
+      def self.partner_url(method) self.url('partner', method); end
+      
+      def self.url(api,method)
+        "/#{api}/v1/#{sanitize(method)}"
       end
 
       # generate end point for 'endpoint' and 'endpoints'
-      def self.def_api_call(method, url, id_field = false, paged = true)
-        if id_field
+      def self.def_api_call(method, url, singular_method = nil, paged = true)
+        if singular_method
           self.send(:define_method, method) do |id = nil, params = {}|
             if id
               get("#{url}/#{id}", params)
@@ -36,8 +27,7 @@ module Sophos
             end
           end
           # strip trailing 's'
-          singlr = self.singular(method) #method.to_s.chop.to_sym
-          self.send(:define_method, singlr) do |id, params = {}|
+          self.send(:define_method, singular_method) do |id, params = {}|
             get("#{url}/#{id}", params)
           end
         else

data/lib/sophos/client/partner.rb

@@ -8,13 +8,13 @@ module Sophos
     module Partner
 
       # @see https://developer.sophos.com/docs/partner-v1/1/routes/tenants/get
-      Helper::def_api_call :tenants, Helper::partner_url(:tenants), true
+      Helper::def_api_call :tenants, Helper::partner_url(:tenants), :tenant
 
       # @see https://developer.sophos.com/docs/partner-v1/1/routes/roles/get
-      Helper::def_api_call :roles, Helper::partner_url(:roles), true
+      Helper::def_api_call :roles, Helper::partner_url(:roles), :role
 
       # @see https://developer.sophos.com/docs/partner-v1/1/routes/admins/get
-      Helper::def_api_call :admins, Helper::partner_url(:admins), true
+      Helper::def_api_call :admins, Helper::partner_url(:admins), :admin
 
       # Get the list of role assignments for given admin.
       # @see https://developer.sophos.com/docs/partner-v1/1/routes/admins/%7BadminId%7D/role-assignments/get

data/lib/sophos/configuration.rb

@@ -7,7 +7,7 @@ module Sophos
   module Configuration
     include WrAPI::Configuration
 
-    # An array of additional valid keys in the options hash when configuring a {Sophos::API}
+    # An array of additional valid keys in the options hash when configuring a [Sophos::API]
     VALID_OPTIONS_KEYS = (WrAPI::Configuration::VALID_OPTIONS_KEYS + [:partner_id, :tenant_id, :id_endpoint]).freeze
 
     # @private

data/lib/sophos/error.rb

@@ -0,0 +1,11 @@
+module Sophos
+	
+  # Generic error to be able to rescue all Zabbix errors
+  class SophosError < StandardError; end
+
+  # Raised when Zabbix not configured correctly
+  class ConfigurationError < SophosError; end
+
+  # Error when authentication fails
+  class AuthenticationError < SophosError; end
+end

data/lib/sophos/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sophos
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

data/lib/sophos_central_api.rb

@@ -9,6 +9,6 @@ module Sophos
   #
   # @return [Sophos::Client]
   def self.client(options = {})
-    Sophos::Client.new
+    Sophos::Client.new(options)
   end
 end

data/sophos_central_api.gemspec

@@ -32,5 +32,6 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'wrapi', ">= 0.3.0"
   s.add_development_dependency 'dotenv'
   s.add_development_dependency 'minitest'
+  s.add_development_dependency 'simplecov'
   s.add_development_dependency 'rubocop'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sophos_central_api
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Janco Tanis
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-15 00:00:00.000000000 Z
+date: 2024-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -92,6 +106,7 @@ files:
 - Gemfile
 - README.md
 - Rakefile
+- bin/cc-test-reporter.exe
 - lib/sophos/api.rb
 - lib/sophos/authentication.rb
 - lib/sophos/client.rb
@@ -100,6 +115,7 @@ files:
 - lib/sophos/client/helper.rb
 - lib/sophos/client/partner.rb
 - lib/sophos/configuration.rb
+- lib/sophos/error.rb
 - lib/sophos/pagination.rb
 - lib/sophos/version.rb
 - lib/sophos_central_api.rb