epersonate 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4f5397d177275ef4d9bd5832af1859a947cd70555667355277ebdc80c097c18c
+  data.tar.gz: 13a56d530a8c5df1b9ff4a4b33a3712c9b6f08d17a05f1b1251300a0a684c101
+SHA512:
+  metadata.gz: 5c0b65470e93e13144fd5e781fb1a16ab088a7123b1fafcc7acd65ccc3ea98ac2ea9c855bc273d77e4e23f3704865102d7217a9b7fde3443fa54b90448d897fa
+  data.tar.gz: c8ad1da890e855008b64015218d08a03059f52361d441acad4fb18339dc03c4ca255a664351f5ac48b811a5043b5f88784bdeea87b8889c8b5493ec912aec17d

data/.gitignore

@@ -0,0 +1,8 @@
+doc
+.gem
+*.gem
+*.iml
+.bundle
+Gemfile.lock
+pkg/*
+*.swp

data/README.md

@@ -0,0 +1,74 @@
+# Epersonate Gem
+
+> [Official Ruby Wrapper](https://rubygems.org/gems/epersonate) for EPersonate API.
+
+## EPersonate Documentation
+
+[Official EPersonate Documentation](https://docs.epersonate.com)
+
+## Installation
+
+```bash
+gem install epersonate
+```
+
+### Usage
+
+```ruby
+require 'epersonate'
+```
+
+### Using Personal Access Token
+
+Go to https://epersonate.com/app/settings > Personal Access Token > Create Personal Access Token
+
+Add this token to your environment variables.
+ 
+```ruby
+epersonate = Epersonate.new(EPERSONATE_TOKEN)
+```
+
+**Note: Replace `EPERSONATE_TOKEN` with the token generated before.**
+
+## Example Usage
+
+In a classic Rails application with a `sessions_controller.rb`
+
+```ruby
+class SessionsController < ApplicationController
+
+    def login
+        (...)
+        current_user(user)
+    end
+
+    def current_user=(user)
+        @current_user = user
+    end
+
+    def current_user
+        if (@current_user)
+            return @current_user
+        end
+
+        impersonation = epersonate.verify({request: request})
+
+        if (impersonation["valid"])
+            @current_user = User.find(impersonation["userId"].to_i)
+        else
+            remember_token = User.hexdigest(cookies[:remember_token])
+            @current_user ||= User.find_by(remember_token: remember_token)
+        end
+    end
+end
+```
+
+
+## Deploy
+
+ - Update version in epersonate.gemspec
+
+```bash
+gem build epersonate.gemspec
+gem push epersonate.x.x.x.gem
+```

data/epersonate.gemspec

@@ -0,0 +1,14 @@
+
+Gem::Specification.new do |s|
+  s.name          = 'epersonate'
+  s.version       = "0.0.1"
+  s.date          = '2020-07-28'
+  s.summary       = "Epersonate Ruby API Wrapper"
+  s.description   = "Epersonate Ruby API Wrapper"
+  s.authors       = ["Kevin Antoine"]
+  s.email         = 'kevin@epersonate.com'
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+  s.homepage      = 'https://rubygems.org/gems/epersonate'
+  s.license       = 'MIT'
+end

data/lib/epersonate.rb

@@ -0,0 +1,41 @@
+require 'net/http'
+require 'uri'
+require 'json'
+
+BASE_URL = "https://api.epersonate.com"
+EPERSONATE_HEADER = 'x-epersonate';
+
+class Epersonate
+    def initialize(token)
+        @personal_access_token = token
+    end
+
+    def verify(args)
+        token = args[:token] || (args[:request] && args[:request].cookies[EPERSONATE_HEADER])
+        unless token
+            return {
+                valid: false
+            }
+        end
+        uri = URI.parse(BASE_URL + "/api/v1/impersonations")
+        header = {
+            'Content-Type': 'application/json',
+            'Authorization': "Bearer " + @personal_access_token
+        }
+        body = {
+            token: token
+        }
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        req = Net::HTTP::Post.new(uri.request_uri, header)
+        req.body = body.to_json
+        response = http.request(req)
+        if response.code == "200"
+            return ActiveSupport::JSON.decode(response.body)
+        end
+
+        return {
+            valid: false
+        }
+    end
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: epersonate
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Kevin Antoine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-07-28 00:00:00.000000000 Z
+dependencies: []
+description: Epersonate Ruby API Wrapper
+email: kevin@epersonate.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- README.md
+- epersonate.gemspec
+- lib/epersonate.rb
+homepage: https://rubygems.org/gems/epersonate
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Epersonate Ruby API Wrapper
+test_files: []