Module: Philiprehberger::SignedPayload

Defined in:
lib/philiprehberger/signed_payload.rb,
lib/philiprehberger/signed_payload/errors.rb,
lib/philiprehberger/signed_payload/signer.rb,
lib/philiprehberger/signed_payload/version.rb

Defined Under Namespace

Classes: Error, ExpiredToken, InvalidSignature, MalformedToken, Signer

Constant Summary collapse

VERSION =
'0.3.1'

Class Method Summary collapse

Class Method Details

.decode(token) ⇒ Object



36
37
38
39
40
41
42
43
44
# File 'lib/philiprehberger/signed_payload.rb', line 36

def self.decode(token)
  encoded, _sig = token.to_s.split('.')
  raise MalformedToken, 'invalid token format' unless token.to_s.split('.').length == 2

  parsed = JSON.parse(Base64.urlsafe_decode64(encoded))
  parsed['data']
rescue JSON::ParserError
  raise MalformedToken, 'invalid payload encoding'
end

.expired?(token) ⇒ Boolean

Returns:

  • (Boolean)


28
29
30
# File 'lib/philiprehberger/signed_payload.rb', line 28

def self.expired?(token)
  Signer.new(key: 'unused').expired?(token)
end

.peek(token) ⇒ Object



32
33
34
# File 'lib/philiprehberger/signed_payload.rb', line 32

def self.peek(token)
  Signer.new(key: 'unused').peek(token)
end

.refresh(token, key:, expires_in:, algorithm: :sha256) ⇒ Object



24
25
26
# File 'lib/philiprehberger/signed_payload.rb', line 24

def self.refresh(token, key:, expires_in:, algorithm: :sha256)
  Signer.new(key: key, algorithm: algorithm).refresh(token, expires_in: expires_in)
end

.sign(data, key:, algorithm: :sha256, expires_in: nil) ⇒ Object



12
13
14
# File 'lib/philiprehberger/signed_payload.rb', line 12

def self.sign(data, key:, algorithm: :sha256, expires_in: nil)
  Signer.new(key: key, algorithm: algorithm).sign(data, expires_in: expires_in)
end

.valid?(token, key:, algorithm: :sha256) ⇒ Boolean

Returns:

  • (Boolean)


20
21
22
# File 'lib/philiprehberger/signed_payload.rb', line 20

def self.valid?(token, key:, algorithm: :sha256)
  Signer.new(key: key, algorithm: algorithm).valid?(token)
end

.verify(token, key:, algorithm: :sha256) ⇒ Object



16
17
18
# File 'lib/philiprehberger/signed_payload.rb', line 16

def self.verify(token, key:, algorithm: :sha256)
  Signer.new(key: key, algorithm: algorithm).verify(token)
end