zm-ruby-client 0.10.4 → 0.17.1

data/lib/zm/client/cluster/cluster.rb

@@ -4,31 +4,48 @@ require 'zm/client/connector/soap_admin'
 require 'zm/client/connector/soap_account'
 require 'zm/client/common'
 # require 'zm/client/data_source'
-require 'zm/client/domain'
 require 'zm/client/account'
+require 'zm/client/domain'
 require 'zm/client/resource'
 require 'zm/client/distributionlist'
 require 'zm/client/server'
 require 'zm/client/cos'
 require 'zm/client/license'
-# require 'zm/client/distributionlist'
 
 module Zm
   module Client
     # class admin connection
     class Cluster
-      attr_reader :soap_admin_connector, :config
+
+      attr_reader :soap_admin_connector, :config, :zimbra_attributes
+
+      attr_reader :type, :version, :release, :buildDate, :host, :majorversion, :minorversion, :microversion
 
       def initialize(config)
+        extend(ZmLogger)
+
         @config = config
+        @version = config.zimbra_version
+
+        @zimbra_attributes = Base::ZimbraAttributesCollection.new(self)
+        @zimbra_attributes.set_methods
+
         @soap_admin_connector = SoapAdminConnector.new(
           @config.zimbra_admin_scheme,
           @config.zimbra_admin_host,
           @config.zimbra_admin_port
         )
+        @soap_admin_connector.logger = logger
+      end
+
+      def has_admin_credentials?
+        @config.has_admin_credentials?
       end
 
       def login
+        raise ClusterConfigError, 'admin credentials are missing' unless @config.has_admin_credentials?
+
+        logger.info "Get Admin session token"
         @soap_admin_connector.auth(
           @config.zimbra_admin_login,
           @config.zimbra_admin_password
@@ -42,22 +59,31 @@ module Zm
       def alive?
         @soap_admin_connector.noop
         true
-      rescue Zm::Client::SoapError => _
+      rescue Zm::Client::SoapError => e
+        logger.error "Admin session token alive ? #{e.message}"
         false
       end
 
       def soap_account_connector
-        @soap_account_connector ||= SoapAccountConnector.new(
+        return @soap_account_connector unless @soap_account_connector.nil?
+
+        @soap_account_connector = SoapAccountConnector.new(
           @config.zimbra_public_scheme,
           @config.zimbra_public_host,
           @config.zimbra_public_port
         )
+        @soap_account_connector.logger = logger
+        @soap_account_connector
+      end
+
+      def token_metadata
+        @token_metadata ||= TokenMetaData.new(@soap_admin_connector.token)
       end
 
       def license
         @license ||= LicensesCollection.new(self).find
       rescue Zm::Client::SoapError => e
-        puts e.message
+        logger.error "Get License info #{e.message}"
         nil
       end
 
@@ -107,10 +133,24 @@ module Zm
         !num.zero?
       end
 
+      def infos!
+        rep = soap_admin_connector.get_version_info
+        json = rep[:Body][:GetVersionInfoResponse][:info].first
+
+        instance_variable_set(:@type, json[:type])
+        instance_variable_set(:@version, json[:version])
+        instance_variable_set(:@release, json[:release])
+        instance_variable_set(:@buildDate, json[:buildDate])
+        instance_variable_set(:@host, json[:host])
+        instance_variable_set(:@majorversion, json[:majorversion])
+        instance_variable_set(:@minorversion, json[:minorversion])
+        instance_variable_set(:@microversion, json[:microversion])
+      end
+
       private
 
       def find_domain_key(domain_name)
-        domains.find_by({ name: domain_name }, 'zimbraPreAuthKey').zimbraPreAuthKey
+        domains.attrs('zimbraPreAuthKey').find_by(name: domain_name).zimbraPreAuthKey
       end
     end
   end

data/lib/zm/client/cluster/cluster_config.rb

@@ -11,18 +11,16 @@ module Zm
                     :zimbra_admin_port, :zimbra_admin_login,
                     :zimbra_admin_password, :zimbra_public_host,
                     :zimbra_public_scheme, :zimbra_public_port,
-                    :domains
+                    :domains, :zimbra_version
 
       def initialize(parameters = nil)
-        @zimbra_admin_scheme = 'https'
-        @zimbra_admin_port = 7071
-        @zimbra_public_scheme = 'https'
-        @zimbra_public_port = 443
         @domains = []
+        @zimbra_version = '8.8.15'
 
-        if parameters.is_a?(String)
+        case parameters
+        when String
           init_from_file(parameters)
-        elsif parameters.is_a?(Hash)
+        when Hash
           @to_h = parameters
         end
 
@@ -45,14 +43,15 @@ module Zm
       end
 
       def init_from_h
-        @zimbra_admin_host = @to_h[:zimbra_admin_host] unless @to_h[:zimbra_admin_host].nil?
-        @zimbra_admin_scheme = @to_h[:zimbra_admin_scheme] unless @to_h[:zimbra_admin_scheme].nil?
-        @zimbra_admin_port = @to_h[:zimbra_admin_port] unless @to_h[:zimbra_admin_port].nil?
-        @zimbra_admin_login = @to_h[:zimbra_admin_login] unless @to_h[:zimbra_admin_login].nil?
-        @zimbra_admin_password = @to_h[:zimbra_admin_password] unless @to_h[:zimbra_admin_password].nil?
-        @zimbra_public_host = @to_h[:zimbra_public_host] unless @to_h[:zimbra_public_host].nil?
-        @zimbra_public_scheme = @to_h[:zimbra_public_scheme] unless @to_h[:zimbra_public_scheme].nil?
-        @zimbra_public_port = @to_h[:zimbra_public_port] unless @to_h[:zimbra_public_port].nil?
+        @zimbra_admin_host = @to_h.fetch(:zimbra_admin_host, nil)
+        @zimbra_admin_scheme = @to_h.fetch(:zimbra_admin_scheme, 'https')
+        @zimbra_admin_port = @to_h.fetch(:zimbra_admin_port, 7071)
+        @zimbra_admin_login = @to_h.fetch(:zimbra_admin_login, nil)
+        @zimbra_admin_password = @to_h.fetch(:zimbra_admin_password, nil)
+        @zimbra_public_host = @to_h.fetch(:zimbra_public_host, nil)
+        @zimbra_public_scheme = @to_h.fetch(:zimbra_public_scheme, 'https')
+        @zimbra_public_port = @to_h.fetch(:zimbra_public_port, 443)
+        @zimbra_version = @to_h.fetch(:zimbra_version, '8.8.15')
       end
 
       def init_from_yml(file_config_path)
@@ -81,6 +80,10 @@ module Zm
 
         domain.key
       end
+
+      def has_admin_credentials?
+        !@zimbra_admin_host.nil? && !@zimbra_admin_login.nil? && !@zimbra_admin_password.nil?
+      end
     end
 
     # class config for connection
@@ -94,7 +97,6 @@ module Zm
     end
 
     # class error for config
-    class ClusterConfigError < StandardError
-    end
+    class ClusterConfigError < StandardError; end
   end
 end

data/lib/zm/client/common/token_metadata.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    class TokenMetaDataError < StandardError; end
+
+    class TokenMetaData
+      def initialize(token)
+        raise TokenMetaDataError, 'no such token' unless token.is_a?(String)
+
+        parts = token.split('_')
+        raise TokenMetaDataError, 'invalid token' unless parts.length == 3
+
+        @key_id = parts[0]
+        @hmac = parts[1]
+        @encoded = parts[2]
+      end
+
+      def decoded
+        @decoded ||= [@encoded].pack('H*')
+      end
+
+      def metadatas
+        @metadatas ||= Hash[decoded.split(';').map { |v| key, len, str = v.split(/[:=]/); [key, str] }].freeze
+      end
+
+      def zimbra_id
+        metadatas['id']
+      end
+
+      def is_admin?
+        @is_admin ||= metadatas['admin'] == '1'
+      end
+
+      def server_version
+        metadatas['version']
+      end
+
+      def expire_at
+        @expire_at ||= Time.at(metadatas['exp'].to_f / 1000).freeze
+      end
+    end
+  end
+end

data/lib/zm/client/common.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
 
 require 'zm/client/common/recipients'
-require 'zm/client/common/message'
+require 'zm/client/common/message'
+require 'zm/client/common/token_metadata'

data/lib/zm/client/connector/rest_account.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require 'openssl'
-require 'curb'
-
 module Zm
   module Client
     class RestAccountConnector

data/lib/zm/client/connector/soap_account.rb

@@ -11,6 +11,7 @@ module Zm
   module Client
     class SoapAccountConnector < SoapBaseConnector
 
+      # SOAP_PATH = '/service/soap/'
       MAILSPACE = 'urn:zimbraMail'
       ACCOUNTSPACE = 'urn:zimbraAccount'
       A_NODE_PROC = lambda { |n| { n: n.first, _content: n.last } }
@@ -18,8 +19,7 @@ module Zm
       A_NODE_PROC_ARROW_NAME = lambda { |n| { :@name => n.first, content!: n.last } }
 
       def initialize(scheme, host, port)
-        @uri = URI::HTTP.new(scheme, nil, host, port, nil, '/service/soap/', nil, nil, nil)
-        init_curl_client
+        super(scheme, host, port, '/service/soap/')
       end
 
       def auth_template(mail)
@@ -173,75 +173,41 @@ module Zm
       # -------------------------------
       # FOLDER
 
-      def get_folder(token, id)
-        soap_name = :GetFolderRequest
-        body = init_hash_request(token, soap_name)
-        req = { folder: { l: id } }
-        body[:Body][soap_name].merge!(req)
-        curl_request(body)
+      def get_folder(token, jsns)
+        jsns_request(:GetFolderRequest, token, jsns)
       end
 
-      def get_all_folders(token, view = nil, tr = nil)
-        soap_name = :GetFolderRequest
-        body = init_hash_request(token, soap_name)
-        req = { view: view, tr: tr }.reject { |_, v| v.nil? }
-        body[:Body][soap_name].merge!(req)
-        curl_request(body)
-      end
+      # def get_all_folders(token, view = nil, tr = nil)
+      #   soap_name = :GetFolderRequest
+      #   body = init_hash_request(token, soap_name)
+      #   req = { view: view, tr: tr }.reject { |_, v| v.nil? }
+      #   body[:Body][soap_name].merge!(req)
+      #   curl_request(body)
+      # end
 
-      def create_folder(token, folder_options)
-        soap_name = :CreateFolderRequest
-        # folder = { l: parent_id, name: name, view: view, color: color }.merge(options)
-        req = { folder: folder_options }
-        body = init_hash_request(token, soap_name)
-        body[:Body][soap_name].merge!(req)
-        curl_request(body)
+      def create_folder(token, jsns)
+        jsns_request(:CreateFolderRequest, token, jsns)
       end
 
-      def folder_action(token, op, id, options = {})
-        soap_name = :FolderActionRequest
-        action = { op: op, id: id }.merge(options)
-        req = { action: action }
-        body = init_hash_request(token, soap_name)
-        body[:Body][soap_name].merge!(req)
-        curl_request(body)
+      def folder_action(token, jsns)
+        jsns_request(:FolderActionRequest, token, jsns)
       end
 
       def get_all_search_folders(token)
-        body = init_hash_request(token, :GetSearchFolderRequest)
+        soap_name = :GetSearchFolderRequest
+        body = init_hash_request(token, soap_name)
         curl_request(body)
       end
 
       # -------------------------------
       # SEARCH FOLDER
 
-      def create_search_folder(token, name, query, types = 'messages', l = 1, color = nil, sort_by = nil)
-        search = {
-            name: name,
-            query: query,
-            types: types,
-            sortBy: sort_by,
-            color: color,
-            l: l
-        }.reject { |_, v| v.nil? }
-
-        req = { search: search }
-        body = init_hash_request(token, :CreateSearchFolderRequest)
-        body[:Body][:CreateSearchFolderRequest].merge!(req)
-        curl_request(body)
+      def create_search_folder(token, jsns)
+        jsns_request(:CreateSearchFolderRequest, token, jsns)
       end
 
-      def modify_search_folder(token, id, query, types = 'messages')
-        search = {
-          id: id,
-          query: query,
-          types: types
-        }.reject { |_, v| v.nil? }
-
-        req = { search: search }
-        body = init_hash_request(token, :ModifySearchFolderRequest)
-        body[:Body][:ModifySearchFolderRequest].merge!(req)
-        curl_request(body)
+      def modify_search_folder(token, jsns)
+        jsns_request(:ModifySearchFolderRequest, token, jsns)
       end
 
       # -------------------------------
@@ -265,12 +231,8 @@ module Zm
       # -------------------------------
       # SHARE
 
-      def create_mountpoint(token, link_option)
-        soap_name = :CreateMountpointRequest
-        req = { link: link_option }
-        body = init_hash_request(token, soap_name)
-        body[:Body][soap_name].merge!(req)
-        curl_request(body)
+      def create_mountpoint(token, jsns)
+        jsns_request(:CreateMountpointRequest, token, jsns)
       end
 
       def get_share_info(token, options = {})
@@ -281,49 +243,16 @@ module Zm
         curl_request(body)
       end
 
-      def get_rights(token, rights)
-        soap_name = :GetRightsRequest
-        ace = rights.map { |r| { right: r } }
-        req = { ace: ace }
-        body = init_hash_request(token, soap_name, ACCOUNTSPACE)
-        body[:Body][soap_name].merge!(req)
-        curl_request(body)
+      def get_rights(token, jsns)
+        jsns_request(:GetRightsRequest, token, jsns, ACCOUNTSPACE)
       end
 
-      def grant_rights(token, zid = nil, gt = nil, right = nil, d = nil, key = nil, pw = nil, deny = nil, chkgt = nil)
-        ace = {
-          zid: zid,
-          gt: gt,
-          right: right,
-          d: d,
-          key: key,
-          pw: pw,
-          deny: deny,
-          chkgt: chkgt
-        }.reject { |_, v| v.nil? }
-
-        req = { ace: ace }
-        body = init_hash_request(token, :GrantRightsRequest, ACCOUNTSPACE)
-        body[:Body][:GrantRightsRequest].merge!(req)
-        curl_request(body)
+      def grant_rights(token, jsns)
+        jsns_request(:GrantRightsRequest, token, jsns, ACCOUNTSPACE)
       end
 
-      def revoke_rights(token, zid = nil, gt = nil, right = nil, d = nil, key = nil, pw = nil, deny = nil, chkgt = nil)
-        ace = {
-          zid: zid,
-          gt: gt,
-          right: right,
-          d: d,
-          key: key,
-          pw: pw,
-          deny: deny,
-          chkgt: chkgt
-        }.reject { |_, v| v.nil? }
-
-        req = { ace: ace }
-        body = init_hash_request(token, :RevokeRightsRequest, ACCOUNTSPACE)
-        body[:Body][:RevokeRightsRequest].merge!(req)
-        curl_request(body)
+      def revoke_rights(token, jsns)
+        jsns_request(:RevokeRightsRequest, token, jsns, ACCOUNTSPACE)
       end
 
       # -------------------------------
@@ -331,7 +260,7 @@ module Zm
 
       def get_msg(token, id, options = {})
         req = { m: { id: id } }
-        req[:m].merge(options) unless options.empty?
+        req[:m].merge!(options) unless options.empty?
         body = init_hash_request(token, :GetMsgRequest)
         body[:Body][:GetMsgRequest].merge!(req)
         curl_request(body)
@@ -349,7 +278,7 @@ module Zm
         req = { m: m }
         body = init_hash_request(token, :SendMsgRequest)
         body[:Body][:SendMsgRequest].merge!(req)
-        curl_request(body)
+        # curl_request(body)
       end
 
       def add_msg(token, l, eml, d = nil, f = nil, tn = nil)
@@ -377,19 +306,12 @@ module Zm
         curl_request(body)
       end
 
-      def create_tag(token, name, color, rgb)
-        body = init_hash_request(token, :CreateTagRequest)
-        req = { tag: { name: name, color: color, rgb: rgb }.reject { |_, v| v.nil? } }
-        body[:Body][:CreateTagRequest].merge!(req)
-        curl_request(body)
+      def create_tag(token, jsns)
+        jsns_request(:CreateTagRequest, token, jsns)
       end
 
-      def tag_action(token, op, id, options = {})
-        action = { op: op, id: id }.merge(options)
-        req = { action: action }
-        body = init_hash_request(token, :TagActionRequest)
-        body[:Body][:TagActionRequest].merge!(req)
-        curl_request(body)
+      def tag_action(token, jsns)
+        jsns_request(:TagActionRequest, token, jsns)
       end
 
       # -------------------------------
@@ -486,18 +408,17 @@ module Zm
         curl_request(body)
       end
 
-      def delete_signature(token, id)
+      def delete_signature(token, jsns)
         soap_name = :DeleteSignatureRequest
-        req = { signature: { id: id } }
         body = init_hash_request(token, soap_name, ACCOUNTSPACE)
-        body[:Body][soap_name].merge!(req)
+        body[:Body][soap_name].merge!(jsns)
         curl_request(body)
       end
 
       # -------------------------------
       # GENERIC
 
-      def get_info(token, sections = 'mbox', rights = nil)
+      def get_info(token, sections = 'mbox,prefs,attrs,zimlets,props,idents,sigs,dsrcs,children', rights = nil)
         req = { rights: rights, sections: sections }.reject { |_, v| v.nil? }
         body = init_hash_request(token, :GetInfoRequest, ACCOUNTSPACE)
         body[:Body][:GetInfoRequest].merge!(req) if req.any?
@@ -512,7 +433,8 @@ module Zm
           offset: offset,
           limit: limit,
           sortBy: sortBy,
-          query: query
+          query: query,
+          header: [{ n: 'messageIdHeader' }]
         }.merge!(options)
         req.reject! { |_, v| v.nil? }
 
@@ -521,6 +443,28 @@ module Zm
         curl_request(body)
       end
 
+      def jsns_request(soap_name, token, jsns, namespace = MAILSPACE)
+        body = init_hash_request(token, soap_name, namespace)
+        body[:Body][soap_name].merge!(jsns) if jsns.is_a?(Hash)
+        curl_request(body)
+      end
+
+      def ranking_action(token, op, email = nil)
+        soap_name = :RankingActionRequest
+        req = {
+          action: {
+            op: op,
+            email: email
+          }
+        }
+        req[:action].delete_if { |_, v| v.nil? }
+
+        body = init_hash_request(token, soap_name)
+        body[:Body][soap_name].merge!(req) if req.any?
+
+        curl_request(body)
+      end
+
       private
 
       def compute_preauth(mail, ts, domainkey)
@@ -530,15 +474,15 @@ module Zm
         hmac.to_s
       end
 
-      def init_hash_request(token, soap_name, jsns = MAILSPACE)
+      def init_hash_request(token, soap_name, namespace = MAILSPACE)
         {
           Body: {
-            soap_name => { _jsns: jsns }
+            soap_name => { _jsns: namespace }
           }
         }.merge(hash_header(token))
       end
 
-      def init_hash_arrow_request(token, soap_name, jsns = MAILSPACE)
+      def init_hash_arrow_request(token, soap_name, namespace = MAILSPACE)
         { Envelope: {
             :@xmlns => 'http://schemas.xmlsoap.org/soap/envelope/',
             '@xmlns:urn' => 'urn:zimbra',
@@ -552,7 +496,7 @@ module Zm
               }
             },
             Body: {
-              soap_name => { :@xmlns => jsns }
+              soap_name => { :@xmlns => namespace }
             }
           }
         }