licensemanager-sdk 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 109085116bb45d1e2904e64567d7cee70a75d80561956198efef6c26e56bf2a7
+  data.tar.gz: 668141b8e9c77be6c348933816f078c1388afbe5db0e5ce233aa5ab6e22f3125
+SHA512:
+  metadata.gz: 8d9a4981a412d9106de85d1f9247048e3f10607f35b7ff8fc3bba0d9ac5b8adfbea4d8bb3ebfb75569ee84f50580db03f581cb112da7881177ef1cf0c8d0ee3a
+  data.tar.gz: db6b0b4878e914ccde9add2dfe77760fe202bfd2a4517eb8deeee118ef29c4bf4acfac33ba333b6e4dc8951f4a4609223218c13e7def0c703c07a7d3581e9bdb

data/README.md

@@ -0,0 +1,60 @@
+# licensemanager-sdk — Ruby
+
+SDK cliente para a API de validação do LicenseManager. Compatível com Ruby 3.0+ e Ruby on Rails.
+
+## Instalação
+
+```ruby
+# Gemfile
+gem "licensemanager-sdk"
+```
+
+```bash
+bundle install
+```
+
+Ou diretamente:
+
+```bash
+gem install licensemanager-sdk
+```
+
+## Uso (Ruby puro)
+
+```ruby
+require "licensemanager_sdk"
+
+client = LicenseManagerSdk::Client.new(
+  base_url:   "https://licensemanager-api.enzojb.com.br",
+  token:      "seu-token",
+  license_id: "guid-da-licenca"
+)
+
+login = client.login("usuario@empresa.com")
+if login.authorized
+  client.heartbeat(login.session_id)
+  client.logout(login.session_id)
+end
+
+inst = client.validate_installation("MACHINE-001")
+puts "Instalação: #{inst.installation_id}" if inst.authorized
+```
+
+## Uso (Rails — initializer)
+
+```ruby
+# config/initializers/licensemanager.rb
+require "licensemanager_sdk"
+
+LICENSE_CLIENT = LicenseManagerSdk::Client.new(
+  base_url:   ENV.fetch("LICENSE_API_URL"),
+  token:      ENV.fetch("LICENSE_TOKEN"),
+  license_id: ENV.fetch("LICENSE_ID")
+)
+```
+
+## Testes
+
+```bash
+bundle exec rspec
+```

data/lib/licensemanager_sdk/client.rb

@@ -0,0 +1,124 @@
+module LicenseManagerSdk
+  # Cliente para a API de validação do LicenseManager.
+  # Encapsula geração de HMAC-SHA256 e os 4 endpoints de validação.
+  #
+  # @example Uso básico
+  #   client = LicenseManagerSdk::Client.new(
+  #     base_url:   "https://licensemanager-api.enzojb.com.br",
+  #     token:      "seu-token",
+  #     license_id: "guid-da-licenca"
+  #   )
+  #   login = client.login("usuario@empresa.com")
+  #   client.heartbeat(login.session_id) if login.authorized
+  class Client
+    MAX_RETRIES = 3
+
+    def initialize(base_url:, token:, license_id:, timeout: 30)
+      raise ArgumentError, "base_url é obrigatório" if base_url.nil? || base_url.strip.empty?
+      raise ArgumentError, "token é obrigatório"    if token.nil?    || token.strip.empty?
+      raise ArgumentError, "license_id é obrigatório" if license_id.nil? || license_id.strip.empty?
+
+      @base_url   = base_url.chomp("/")
+      @token      = token
+      @license_id = license_id
+      @timeout    = timeout
+    end
+
+    # Valida login de um usuário numa licença.
+    # @param user_id [String] identificador único do usuário
+    # @return [LoginResult]
+    def login(user_id)
+      body = { idLicenca: @license_id, identificadorUsuario: user_id }
+      data = post("api/validacao/login", body)
+      LoginResult.new(
+        authorized: data["autorizado"] || false,
+        session_id: data["idSessao"]
+      )
+    end
+
+    # Envia heartbeat para manter a sessão ativa.
+    # @param session_id [String]
+    def heartbeat(session_id)
+      body = { idLicenca: @license_id, idSessao: session_id }
+      post("api/validacao/heartbeat", body)
+      nil
+    end
+
+    # Encerra a sessão (idempotente).
+    # @param session_id [String]
+    def logout(session_id)
+      body = { idLicenca: @license_id, idSessao: session_id }
+      post("api/validacao/logout", body)
+      nil
+    end
+
+    # Valida ou registra uma instalação da aplicação cliente.
+    # @param machine_id [String] identificador único da máquina
+    # @return [InstallationResult]
+    def validate_installation(machine_id)
+      body = { idLicenca: @license_id, identificadorMaquina: machine_id }
+      data = post("api/validacao/instalacao", body)
+      InstallationResult.new(
+        authorized:        data["autorizado"]    || false,
+        installation_id:   data["idInstalacao"],
+        already_registered: data["jaRegistrada"] || false
+      )
+    end
+
+    # @api private
+    def compute_signature(license_id, timestamp, body_json)
+      payload = "#{license_id}:#{timestamp}:#{body_json}"
+      OpenSSL::HMAC.hexdigest("SHA256", @token, payload)
+    end
+
+    private
+
+    def post(path, body)
+      body_json  = JSON.generate(body)
+      timestamp  = Time.now.utc.strftime("%Y-%m-%dT%H:%M:%SZ")
+      nonce      = SecureRandom.hex(16)
+      signature  = compute_signature(@license_id, timestamp, body_json)
+
+      uri = URI.parse("#{@base_url}/#{path}")
+      headers = {
+        "Content-Type" => "application/json",
+        "X-Token"      => @token,
+        "X-Timestamp"  => timestamp,
+        "X-Nonce"      => nonce,
+        "X-Signature"  => signature
+      }
+
+      last_error = nil
+      MAX_RETRIES.times do |attempt|
+        begin
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.use_ssl     = uri.scheme == "https"
+          http.read_timeout = @timeout
+          http.open_timeout = @timeout
+
+          response = http.post(uri.request_uri, body_json, headers)
+          code = response.code.to_i
+
+          if (code == 429 || code >= 500) && attempt < MAX_RETRIES - 1
+            sleep(2**attempt)
+            next
+          end
+
+          unless response.is_a?(Net::HTTPSuccess)
+            raise LicenseManagerError.new(code, response.body.to_s)
+          end
+
+          body = response.body
+          return (body.nil? || body.empty?) ? {} : JSON.parse(body)
+        rescue LicenseManagerError
+          raise
+        rescue StandardError => e
+          last_error = e
+          sleep(2**attempt) if attempt < MAX_RETRIES - 1
+        end
+      end
+
+      raise LicenseManagerError.new(0, "Erro de rede: #{last_error&.message}")
+    end
+  end
+end

data/lib/licensemanager_sdk/errors.rb

@@ -0,0 +1,11 @@
+module LicenseManagerSdk
+  class LicenseManagerError < StandardError
+    attr_reader :status_code, :response_body
+
+    def initialize(status_code, response_body)
+      super("LicenseManager API error #{status_code}: #{response_body}")
+      @status_code   = status_code
+      @response_body = response_body
+    end
+  end
+end

data/lib/licensemanager_sdk/models.rb

@@ -0,0 +1,4 @@
+module LicenseManagerSdk
+  LoginResult = Struct.new(:authorized, :session_id, keyword_init: true)
+  InstallationResult = Struct.new(:authorized, :installation_id, :already_registered, keyword_init: true)
+end

data/lib/licensemanager_sdk/version.rb

@@ -0,0 +1,3 @@
+module LicenseManagerSdk
+  VERSION = "1.0.0"
+end

data/lib/licensemanager_sdk.rb

@@ -0,0 +1,11 @@
+require "net/http"
+require "json"
+require "openssl"
+require "securerandom"
+require "time"
+require "uri"
+
+require_relative "licensemanager_sdk/version"
+require_relative "licensemanager_sdk/errors"
+require_relative "licensemanager_sdk/models"
+require_relative "licensemanager_sdk/client"

data/licensemanager_sdk.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |spec|
+  spec.name          = "licensemanager-sdk"
+  spec.version       = "1.0.0"
+  spec.authors       = ["LicenciamentoSoftware"]
+  spec.summary       = "SDK cliente para a API de validação do LicenseManager"
+  spec.description   = "Encapsula autenticação HMAC-SHA256 e os endpoints de validação de licença."
+  spec.homepage      = "https://github.com/carloscampos2014/LicenciamentoSoftware"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.files         = Dir["lib/**/*.rb", "README.md", "licensemanager_sdk.gemspec"]
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: licensemanager-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- LicenciamentoSoftware
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-07 00:00:00.000000000 Z
+dependencies: []
+description: Encapsula autenticação HMAC-SHA256 e os endpoints de validação de licença.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/licensemanager_sdk.rb
+- lib/licensemanager_sdk/client.rb
+- lib/licensemanager_sdk/errors.rb
+- lib/licensemanager_sdk/models.rb
+- lib/licensemanager_sdk/version.rb
+- licensemanager_sdk.gemspec
+homepage: https://github.com/carloscampos2014/LicenciamentoSoftware
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: SDK cliente para a API de validação do LicenseManager
+test_files: []