Class: Verizon::ThingspaceOauth

Inherits:
CoreLibrary::HeaderAuth
  • Object
show all
Includes:
CoreLibrary
Defined in:
lib/verizon/http/auth/thingspace_oauth.rb

Overview

Utility class for OAuth 2 authorization and token management.

Instance Method Summary collapse

Constructor Details

#initialize(thingspace_oauth_credentials, config) ⇒ ThingspaceOauth

Initialization constructor.



17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 17

def initialize(thingspace_oauth_credentials, config)
  @_oauth_client_id = thingspace_oauth_credentials.oauth_client_id unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_client_id.nil?
  @_oauth_client_secret = thingspace_oauth_credentials.oauth_client_secret unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_client_secret.nil?
  @_oauth_token = thingspace_oauth_credentials.oauth_token unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_token.nil?
  @_oauth_scopes = thingspace_oauth_credentials.oauth_scopes unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_scopes.nil?
  @_oauth_clock_skew = thingspace_oauth_credentials.oauth_clock_skew unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_clock_skew.nil?
  @_oauth_token_provider = thingspace_oauth_credentials.oauth_token_provider unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_token_provider.nil?
  @_oauth_on_token_update = thingspace_oauth_credentials.oauth_on_token_update unless
    thingspace_oauth_credentials.nil? || thingspace_oauth_credentials.oauth_on_token_update.nil?
  @_o_auth_api = OauthAuthorizationController.new(config)
  super({})
end

Instance Method Details

#apply(http_request) ⇒ Object 



71
72
73
74
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 71

def apply(http_request)
  auth_params = { 'Authorization' => "Bearer #{@_oauth_token.access_token}" }
  AuthHelper.apply(auth_params, http_request.method(:add_header))
end

#build_basic_auth_header ⇒ String

Builds the basic auth header for endpoints in the OAuth Authorization Controller.

Returns:

  • (String) —

    The value of the Authentication header.



45
46
47
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 45

def build_basic_auth_header
  "Basic #{AuthHelper.get_base64_encoded_value(@_oauth_client_id, @_oauth_client_secret)}"
end

#error_message ⇒ Object

Display error message on occurrence of authentication failure.



12
13
14
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 12

def error_message
  'ThingspaceOauth: OAuthToken is undefined or expired.'
end

#fetch_token(additional_params: nil) ⇒ OAuthToken

Fetches the token.

Parameters:

  • additional_params (Hash) (defaults to: nil) —

    Any additional form parameters.

Returns:

  • (OAuthToken) —

    The oAuth token instance.



52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 52

def fetch_token(additional_params: nil)
  token = @_o_auth_api.request_token_thingspace_oauth(
    build_basic_auth_header,
    scope: !@_oauth_scopes.nil? ? Array(@_oauth_scopes).compact.join(' ') : @_oauth_scopes,
    _field_parameters: additional_params
  ).data
  if token.respond_to?('expires_in') && !token.expires_in.nil?
    token.expiry = AuthHelper.get_token_expiry(token.expires_in, Time.now.utc.to_i)
  end
  token
end

#token_expired?(token) ⇒ Boolean

Checks if OAuth token has expired.

Parameters:

  • token (OAuthToken) —

    The oAuth token instance.

Returns:

  • (Boolean) —

    true if the token’s expiry exist and also the token is expired, false otherwise.



67
68
69
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 67

def token_expired?(token)
  token.respond_to?('expiry') && AuthHelper.token_expired?(token.expiry, @_oauth_clock_skew)
end

#valid ⇒ Boolean

Validates the oAuth token.

Returns:

  • (Boolean) —

    true if the token is present and not expired.



38
39
40
41
 
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 38

def valid
  @_oauth_token = get_token_from_provider
  @_oauth_token.is_a?(OAuthToken) && !token_expired?(@_oauth_token)
end