vonage-jwt 0.1.3 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e64f9df01478c092cf5f950c5fb61d56227a558cba788a693cffad050ed5a66
-  data.tar.gz: f72bd42ca910f5f6df52781eeb3d8d1ca658c261833bbe5ab68b3ef8f2571014
+  metadata.gz: 9d851f2a2dde78ab6552912fe891a5e97e847ebb2cfef9b65da52dd8d55a0ba5
+  data.tar.gz: e5f7e809b64741b1dfa3d4fa97a23aa6d73499648b31ae85cc1263a462fd29a2
 SHA512:
-  metadata.gz: e0fb624c08c1c06db4def2a97b50a10add0392f89f6279de7c5b70c987881f510720202b6b84a3d9365a61b32f43fb3783ed30aa95a31a5adc7d1bf08dcf5444
-  data.tar.gz: faa02b4e295b2a850191a956dbbe526c7feb498e3a51cd4ada6d9d66823036846e418092b06bf020e8cb7474bfa1f886a4fa47b30e2e746276ce49f62a9b6c43
+  metadata.gz: 74374a375bbf6c8aed98406fa6db1d053cc1f0388135b3ec2982318719839542d42c03935f0063728d7ce99b1130d53f9781d7ebe67561ec4fd75d2330b4302c
+  data.tar.gz: 1898208b67a593335db77d085aff7c9cd187ccf2ab1026e5f6cf9c7aad3e3074fa9d9ddb2a34cf73b2fecdaf81f6bfac396bb78cc4527ee71a555f34cd9bcbd2

data/README.md

@@ -27,9 +27,11 @@ Alternatively you can clone the repository:
 
 ## Usage
 
+### Generating a JWT
+
 By default the Vonage 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. 
+parameter during initialization.
 
 Example with no custom configuration:
 
@@ -51,10 +53,10 @@ Example providing custom configuration options:
         "/messages": {
           "methods": ["POST", "GET"],
           "filters": {
-            "from": "447977271009"  
-          }     
-        }  
-      }   
+            "from": "447977271009"
+          }
+        }
+      }
     }
   },
   subject: 'My_Custom_Subject'
@@ -62,6 +64,28 @@ Example providing custom configuration options:
 @token = @builder.jwt.generate
 ```
 
+### Decoding a JWT
+
+You can decode a JWT like so:
+
+```ruby
+Vonage::JWT.decode(token, nil, false)
+```
+
+where `token` is the JWT that you want to decode. The `Vonage::JWT::decode` method is essentially just a wrapper around the `ruby-jwt` library method of the same name, and usage is identical to what is [documented for that library](https://github.com/jwt/ruby-jwt#algorithms-and-usage).
+
+### Verifying a Signature
+
+For JWTs that are signed, you can verify a JWT signature like so:
+
+```ruby
+Vonage::JWT.verify_signature(token, signature_secret, algorithm)
+```
+
+where `token` is the signed JWT, `signature_secret` is the secret or key required by whichever algorithm was used to sign the JWT, and `algorithm` is a string indicating the algorithm that was used to sign the JWT (e.g. `'HS256'`, `'RS256'`, etc)
+
+The method will return `true` if the signature is verified and `false` if it is not.
+
 ## Documentation
 
 Vonage Ruby JWT documentation: https://www.rubydoc.info/github/Vonage/vonage-jwt

data/lib/vonage-jwt/jwt.rb

@@ -29,5 +29,18 @@ module Vonage
       hash.merge!(generator.additional_claims) if !generator.additional_claims.empty?
       hash
     end
+
+    def self.decode(token, secret = nil, verify = true, opts = {}, &block)
+      ::JWT.decode(token, secret, verify, opts, &block)
+    end
+
+    def self.verify_signature(token, signature_secret, algorithm)
+      begin
+        decode(token, signature_secret, true, {algorithm: algorithm})
+        return true
+      rescue ::JWT::VerificationError
+        return false
+      end
+    end
   end
 end

data/lib/vonage-jwt/version.rb

@@ -2,6 +2,6 @@
 
 module Vonage
   class JWT
-    VERSION = '0.1.3'
+    VERSION = '0.2.1'
   end
 end

data/vonage-jwt.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |s|
   s.summary = 'This is the Ruby client library to generate Vonage JSON Web Tokens (JWTs).'
   s.files = Dir.glob('lib/**/*.rb') + %w[LICENSE.txt README.md vonage-jwt.gemspec]
   s.required_ruby_version = '>= 2.5.0'
-  s.add_dependency('jwt', '~> 2')
+  s.add_dependency('jwt', '>= 2.0', '< 4.0')
   s.require_path = 'lib'
   s.metadata = {
     'homepage' => 'https://github.com/Vonage/vonage-jwt-ruby',

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: vonage-jwt
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.1
 platform: ruby
 authors:
 - Vonage
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-08-08 00:00:00.000000000 Z
+date: 2025-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '2'
+        version: '4.0'
 description: Vonage JWT Generator for Ruby
 email:
 - devrel@vonage.com
@@ -47,7 +53,7 @@ metadata:
   bug_tracker_uri: https://github.com/Vonage/vonage-jwt-ruby/issues
   changelog_uri: https://github.com/Vonage/vonage-jwt-ruby/blob/main/CHANGES.md
   documentation_uri: https://rubydoc.info/github/Vonage/vonage-jwt-ruby
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -62,8 +68,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key: 
+rubygems_version: 3.5.3
+signing_key:
 specification_version: 4
 summary: This is the Ruby client library to generate Vonage JSON Web Tokens (JWTs).
 test_files: []