ruby_magic_link 0.0.1 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b388ac403bc4f6041bc487bcd64d8a7fff1712a1e2691aa5477ab52652f3f5f9
-  data.tar.gz: fc942055ed95c2ead29a6dae7cd8b9d332714a93fe9216590362d09fdbce3138
+  metadata.gz: 265ece5de19cf999679f6006cc8aa2ac2df56284c55e50acc44825d0ffa013fc
+  data.tar.gz: bf4848c3854c3fda2fa7858ddc79b7fdb39e36896548a580bc6fa51774d16160
 SHA512:
-  metadata.gz: 38d0072644a3b821b222652c96841c4e5321d503e78e980844e6a02498c53ee4d6d1a9b72e4968c6f50f2e8f98bbd332458761c26608354e1a6aa12fafad5e5a
-  data.tar.gz: e2e316ddc3cb71ae527400393a58285fca52101eb96e4aa322275d561760ba7fbd3ee2e2555415a3e2191bcde73781666a30899591373ec452634f041de8273d
+  metadata.gz: 95c41caf541fa90039f2231b994723d4d48ddba1aab9eb26bb4b2f09e0502997cf710d3e777fe89d423f5f572b3c66809c93604a0c66acfdb9bce2b81f91d137
+  data.tar.gz: c4eaa959ba5d81dda9db387f53131924f7089c00c58e11b7e402f23d5860bb8c8ad41460552dd393192d3f459264ec16271fb45fd74cc033c1ae0275131ee9b4

data/README.md

@@ -1,3 +1,80 @@
+![CI](https://github.com/igorkorepanov/ruby_magic_link/actions/workflows/main.yml/badge.svg)
+
+# RubyMagicLink
+
+RubyMagicLink: A gem crafted for the secure generation of tokens, ensuring the safe transmission of data within your Ruby application. Useful for creating magic links—single-use URLs empowering users to perform actions without a password.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ruby_magic_link'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it manually using:
+
+```bash
+gem install ruby_magic_link
+```
+
+## Usage
+### Configuration
+
+For Rails applications, create an initializer file in the `config/initializers` directory.
+
+```ruby
+# config/initializers/ruby_magic_link.rb
+
+RubyMagicLink.setup do |config|
+  config.secret_key = 'your_secret_key'
+end
+```
+
+Replace `your_secret_key` with a strong secret key. Keep this key confidential and do not expose it in your public repositories.
+
+To generate a secret key, run the following rake task:
+
+```bash
+bundle exec rake ruby_magic_link:generate_key
+```
+
+### Simple Example
+
+Encode your data:
+
+```ruby
+payload = {
+  user_id: 123_456,
+  action: :authenticate
+}
+encrypted_data = RubyMagicLink::Token.create(payload, expires_in: Time.now.to_i + 3600)
+url = "https://example.com/magic_links?data=#{encrypted_data}"
+
+# Send the generated URL in an email or through other communication channels.
+```
+
+Decode your data:
+
+```ruby
+class MagicLinksController < ApplicationController
+  def index
+    token = RubyMagicLink::Token.decode(params[:data])
+    if token.valid? && token.payload['action'] == 'authenticate'
+      sign_in(:user, token.payload['user_id'])
+      redirect_to home_path
+    end
+  end
+end
+```
+
+
 ## License
 
 Copyright (c) 2024 Igor Korepanov

data/lib/ruby_magic_link/ruby_magic_link.rb

@@ -2,7 +2,7 @@
 
 module RubyMagicLink
   class Configuration
-    attr_accessor :secret_key, :token_expiration
+    attr_accessor :secret_key
   end
 
   class << self

data/lib/ruby_magic_link/tasks.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'rake'
+require 'securerandom'
+
+namespace :ruby_magic_link do
+  task :generate_key do
+    puts SecureRandom.hex(16)
+  end
+end

data/lib/ruby_magic_link/token.rb

@@ -6,47 +6,25 @@ require 'json'
 
 module RubyMagicLink
   module Token
-    DELIMITER = '!'
+    DELIMITER = '|'
     ALGORITHM = 'AES-256-CBC'
 
-    class TokenObject
-      def initialize(data)
-        @data = data
-      end
-
-      def expired?
-        decoded_data['expires_in'] < Time.now.to_i
-      end
-
-      def payload
-        decoded_data['payload']
-      end
-
-      private
-
-      def decoded_data
-        @decoded_data ||= RubyMagicLink::Token.decode_token(data)
-      end
-
-      attr_reader :data
-    end
-
     module_function
 
     def create(payload, expires_in: nil)
       data = { payload: payload }
-      data[:expires_in] = expires_in if expires_in
+      data[:expires_in] = Time.now.to_i + expires_in if expires_in
       iv = OpenSSL::Random.random_bytes(16)
-      str = JSON.generate(data)
-      Base64.urlsafe_encode64(Base64.urlsafe_encode64(iv) + DELIMITER + encrypt(str, RubyMagicLink.config.secret_key, iv))
+      encrypted_data = encrypt(JSON.generate(data), RubyMagicLink.config.secret_key, iv)
+      Base64.urlsafe_encode64(Base64.urlsafe_encode64(iv) + DELIMITER + encrypted_data)
     end
 
     def decode(data)
-      TokenObject.new(data)
+      RubyMagicLink::TokenObject.new(data)
     end
 
     def decode_token(data)
-      raw_iv, data =  Base64.urlsafe_decode64(data).split(DELIMITER, 2)
+      raw_iv, data = Base64.urlsafe_decode64(data).split(DELIMITER, 2)
       JSON.parse(decrypt(data, RubyMagicLink.config.secret_key, Base64.urlsafe_decode64(raw_iv)))
     end
 

data/lib/ruby_magic_link/token_object.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module RubyMagicLink
+  class TokenObject
+    def initialize(data)
+      @data = data
+    end
+
+    def valid?
+      !expired?
+    end
+
+    def expired?
+      if decoded_data['expires_in']
+        decoded_data['expires_in'] < Time.now.to_i
+      else
+        false
+      end
+    end
+
+    def payload
+      decoded_data['payload']
+    end
+
+    private
+
+    def decoded_data
+      @decoded_data ||= RubyMagicLink::Token.decode_token(data)
+    end
+
+    attr_reader :data
+  end
+end

data/lib/ruby_magic_link/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyMagicLink
-  VERSION = '0.0.1'
+  VERSION = '1.0.1'
 end

data/lib/ruby_magic_link.rb

@@ -1,4 +1,6 @@
 # frozen_string_literal: true
 
 require 'ruby_magic_link/ruby_magic_link'
-require 'ruby_magic_link/token'
+require 'ruby_magic_link/token'
+require 'ruby_magic_link/token_object'
+require 'ruby_magic_link/tasks'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_magic_link
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.1
 platform: ruby
 authors:
 - Igor Korepanov
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-04 00:00:00.000000000 Z
+date: 2024-02-08 00:00:00.000000000 Z
 dependencies: []
 description: Magic links for ruby web applications
 email: noemail@example.com
@@ -20,7 +20,9 @@ files:
 - README.md
 - lib/ruby_magic_link.rb
 - lib/ruby_magic_link/ruby_magic_link.rb
+- lib/ruby_magic_link/tasks.rb
 - lib/ruby_magic_link/token.rb
+- lib/ruby_magic_link/token_object.rb
 - lib/ruby_magic_link/version.rb
 homepage: https://github.com/igorkorepanov/ruby_magic_link
 licenses: