nexmo-jwt 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8810bf15b38858eab28165f9fe3e206cac5f3ed14bbe775b8f1086c440cd48aa
+  data.tar.gz: a2edfdeba6628732c4e4c9fbdc8ececdb4b0b0029e5c2dfcd9a577ab8bc64922
+SHA512:
+  metadata.gz: 0cd2beaf48a5a9ea952e67decb88381f096133be034570004151220bf7a642f2cb69618cbb7aa4e8315868b381c06baf17f1ab3e216c5a2cd907175b3f362a0d
+  data.tar.gz: 348c52c22c21ea98c379128e1062b6ce55a3c6c3b031cf9a34afd88147ba7d14ce4e5da86362faea083629f0c05ebea64602f243ea077fcf05c1d525818acdfb

data/LICENSE.txt

@@ -0,0 +1,24 @@
+The MIT License (MIT)
+
+Copyright (c) 2016-2020 Nexmo Inc
+
+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:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,80 @@
+# Nexmo JWT Generator for Ruby
+
+[![Gem Version](https://badge.fury.io/rb/nexmo-jwt.svg)](https://badge.fury.io/rb/nexmo-jwt) [![Build Status](https://api.travis-ci.org/Nexmo/nexmo-jwt-ruby.svg?branch=master)](https://travis-ci.org/Nexmo/nexmo-jwt-ruby) [![Coverage Status](https://coveralls.io/repos/github/Nexmo/nexmo-jwt-ruby/badge.svg?branch=coveralls)](https://coveralls.io/github/Nexmo/nexmo-jwt-ruby?branch=master)[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
+
+<img src="https://developer.nexmo.com/assets/images/Vonage_Nexmo.svg" height="48px" alt="Nexmo is now known as Vonage" />
+
+This is the Ruby library to generate Nexmo JSON Web Tokens (JWTs). To use it you'll
+need a Nexmo account. Sign up [for free at nexmo.com][signup].
+
+* [Requirements](#requirements)
+* [Installation](#installation)
+* [Usage](#usage)
+* [Documentation](#documentation)
+* [License](#license)
+
+## Requirements
+
+The JWT generator supports Ruby version 2.5 or newer.
+
+## Installation
+
+To install the Ruby client library using Rubygems:
+
+    gem install nexmo-jwt
+
+Alternatively you can clone the repository:
+
+    git clone git@github.com:Nexmo/nexmo-jwt-ruby.git
+
+## Usage
+
+By default the Nexmo JWT generator creates a short lived JWT (15 minutes) per request.
+To generate a long lived JWT for multiple requests, specify a longer value in the `exp`
+parameter during initialization. 
+
+Example with no custom configuration:
+
+```ruby
+@builder = Nexmo::JWTBuilder.new(application_id: YOUR_APPLICATION_ID, private_key: YOUR_PRIVATE_KEY)
+@token = @builder.jwt.generate
+```
+
+Example providing custom configuration options:
+
+```ruby
+@builder = Nexmo::JWTBuilder.new(
+  application_id: YOUR_APPLICATION_ID,
+  private_key: YOUR_PRIVATE_KEY,
+  ttl: 500,
+  paths: {
+    "acl": {
+      "paths": {
+        "/messages": {
+          "methods": ["POST", "GET"],
+          "filters": {
+            "from": "447977271009"  
+          }     
+        }  
+      }   
+    }
+  },
+  subject: 'My_Custom_Subject'
+)
+@token = @builder.jwt.generate
+```
+
+## Documentation
+
+Nexmo Ruby JWT documentation: https://www.rubydoc.info/github/nexmo/nexmo-jwt
+
+Nexmo Ruby code examples: https://github.com/Nexmo/nexmo-ruby-code-snippets
+
+Nexmo API reference: https://developer.nexmo.com/api
+
+## License
+
+This library is released under the [MIT License][license]
+
+[signup]: https://dashboard.nexmo.com/sign-up?utm_source=DEV_REL&utm_medium=github&utm_campaign=ruby-client-library
+[license]: LICENSE.txt

data/lib/nexmo-jwt.rb

@@ -0,0 +1,4 @@
+require_relative 'nexmo-jwt/jwt_builder'
+
+module Nexmo
+end

data/lib/nexmo-jwt/jwt.rb

@@ -0,0 +1,31 @@
+require 'jwt'
+
+module Nexmo
+  class JWT
+    attr_accessor :generator, :typ, :iat
+
+    def initialize(params = {})
+      @generator = params.fetch(:generator)
+      @typ = params.fetch(:typ, 'JWT')
+      @iat = params.fetch(:iat, Time.now.to_i)
+    end
+
+    def generate
+      ::JWT.encode(to_payload, generator.private_key, generator.alg)
+    end
+
+    def to_payload
+      hash = {
+        iat: iat,
+        jti: generator.jti,
+        exp: generator.exp + generator.ttl,
+        sub: generator.subject,
+        application_id: generator.application_id,
+        typ: typ
+      }
+      hash.merge!(paths: generator.paths) if generator.paths
+      hash.merge!(nbf: generator.nbf) if generator.nbf
+      hash
+    end
+  end
+end

data/lib/nexmo-jwt/jwt_builder.rb

@@ -0,0 +1,112 @@
+require 'openssl'
+require 'securerandom'
+require_relative 'jwt'
+
+module Nexmo
+  class JWTBuilder
+    # Generate an encoded JSON Web Token.
+    #
+    # By default the Nexmo JWT generator creates a short lived (15 minutes) JWT per request.
+    #
+    # To generate a long lived JWT for multiple requests, specify a longer value in the `exp`
+    # parameter during initialization. 
+    #
+    # Example with no custom configuration:
+    #
+    # @example
+    #   @builder = Nexmo::JWTBuilder.new(application_id: YOUR_APPLICATION_ID, private_key: YOUR_PRIVATE_KEY)
+    #   @token = @builder.jwt.generate
+    #
+    # Example providing custom configuration options:
+    #
+    # @example
+    #   @generator = Nexmo::JWTBuilder.new(
+    #     application_id: YOUR_APPLICATION_ID,
+    #     private_key: YOUR_PRIVATE_KEY,
+    #     ttl: 500,
+    #     subject: 'My_Custom_Subject'
+    #   )
+    #   @token = @builder.jwt.generate
+    #
+    # @param [String] application_id
+    # @param [Integer] iat
+    # @param [SecureRandom::UUIDv4] jti
+    # @param [Integer] nbf
+    # @param [Integer] exp
+    # @param [Hash] paths
+    # @param [String] sub
+    # @param [String, OpenSSL::PKey::RSA] private_key
+    #
+    # @return [String]
+    #
+    attr_accessor :application_id, :private_key, :jti, :nbf, :ttl, :exp, :alg, :paths, :subject, :jwt
+
+    def initialize(params = {})
+      @application_id = set_application_id(params.fetch(:application_id))
+      @private_key = set_private_key(params.fetch(:private_key))
+      @jti = params.fetch(:jti, SecureRandom.uuid)
+      @nbf = params.fetch(:nbf, nil)
+      @ttl = params.fetch(:ttl, 900)
+      @exp = params.fetch(:exp, 0)
+      @alg = params.fetch(:alg, 'RS256')
+      @paths = params.fetch(:paths, nil)
+      @subject = params.fetch(:subject, 'Subject')
+      @jwt = Nexmo::JWT.new(:generator => self)
+
+      after_initialize!(self)
+    end
+
+    def after_initialize!(builder)
+      validate_not_before(builder.nbf) if builder.nbf
+      validate_time_to_live(builder.ttl)
+      validate_paths(builder.paths) if builder.paths
+      validate_subject(builder.subject) if builder.subject
+    end
+
+    def set_application_id(application_id)
+      validate_application_id(application_id)
+
+      application_id
+    end
+
+    def set_private_key(private_key)
+      validate_private_key(private_key)
+
+      if File.exist?(private_key)
+        key = OpenSSL::PKey::RSA.new(File.read(private_key))
+      else
+        key = OpenSSL::PKey::RSA.new(private_key)
+      end
+
+      key
+    end
+
+    def set_exp
+      Time.now.to_i
+    end
+
+    def validate_application_id(application_id)
+      raise ArgumentError, "Missing required 'application_id' parameter" if application_id.nil?
+    end
+
+    def validate_private_key(private_key)
+      raise ArgumentError, "Missing required 'private_key' parameter" if private_key.nil?
+    end
+
+    def validate_not_before(nbf)
+      raise ArgumentError, "Expected Integer parameter type for NotBefore 'nbf' parameter" unless nbf.is_a?(Integer)
+    end
+
+    def validate_time_to_live(ttl)
+      raise ArgumentError, "Expected Integer parameter type for TimeToLive 'ttl' parameter" unless ttl.is_a?(Integer)
+    end
+
+    def validate_paths(acl_paths)
+      raise ArgumentError, "Expected Hash parameter type for Paths 'paths' parameter" unless acl_paths.is_a?(Hash)
+    end
+
+    def validate_subject(subject)
+      raise ArgumentError, "Expected String parameter type for Subject 'subject' parameter" unless subject.is_a?(String)
+    end
+  end
+end

data/lib/nexmo-jwt/version.rb

@@ -0,0 +1,5 @@
+module Nexmo
+  class JWT
+    VERSION = '0.1.0'
+  end
+end

data/nexmo-jwt.gemspec

@@ -0,0 +1,24 @@
+require File.expand_path('lib/nexmo-jwt/version', File.dirname(__FILE__))
+
+Gem::Specification.new do |s|
+  s.name = 'nexmo-jwt'
+  s.version = Nexmo::JWT::VERSION
+  s.license = 'MIT'
+  s.platform = Gem::Platform::RUBY
+  s.authors = ['Nexmo']
+  s.email = ['devrel@nexmo.com']
+  s.homepage = 'https://github.com/Nexmo/nexmo-jwt-ruby'
+  s.description = 'Nexmo JWT Generator for Ruby'
+  s.summary = 'This is the Ruby client library to generate Nexmo JSON Web Tokens (JWTs).'
+  s.files = Dir.glob('lib/**/*.rb') + %w(LICENSE.txt README.md nexmo-jwt.gemspec)
+  s.required_ruby_version = '>= 2.5.0'
+  s.add_dependency('jwt', '~> 2')
+  s.require_path = 'lib'
+  s.metadata = {
+    'homepage' => 'https://github.com/Nexmo/nexmo-jwt-ruby',
+    'source_code_uri' => 'https://github.com/Nexmo/nexmo-jwt-ruby',
+    'bug_tracker_uri' => 'https://github.com/Nexmo/nexmo-jwt-ruby/issues',
+    'changelog_uri' => 'https://github.com/Nexmo/nexmo-jwt-ruby/blob/master/CHANGES.md',
+    'documentation_uri' => 'https://www.rubydoc.info/github/nexmo/nexmo-jwt'
+  }
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: nexmo-jwt
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nexmo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-07-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+description: Nexmo JWT Generator for Ruby
+email:
+- devrel@nexmo.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/nexmo-jwt.rb
+- lib/nexmo-jwt/jwt.rb
+- lib/nexmo-jwt/jwt_builder.rb
+- lib/nexmo-jwt/version.rb
+- nexmo-jwt.gemspec
+homepage: https://github.com/Nexmo/nexmo-jwt-ruby
+licenses:
+- MIT
+metadata:
+  homepage: https://github.com/Nexmo/nexmo-jwt-ruby
+  source_code_uri: https://github.com/Nexmo/nexmo-jwt-ruby
+  bug_tracker_uri: https://github.com/Nexmo/nexmo-jwt-ruby/issues
+  changelog_uri: https://github.com/Nexmo/nexmo-jwt-ruby/blob/master/CHANGES.md
+  documentation_uri: https://www.rubydoc.info/github/nexmo/nexmo-jwt
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.0
+signing_key: 
+specification_version: 4
+summary: This is the Ruby client library to generate Nexmo JSON Web Tokens (JWTs).
+test_files: []