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
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 17

def initialize(thingspace_oauth_credentials, config)
  auth_params = {}
  @_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?
  @_o_auth_api = OauthAuthorizationController.new(config)
  auth_params['Authorization'] = "Bearer #{@_oauth_token.access_token}" unless @_oauth_token.nil?

  super auth_params
end

Instance Method Details

#build_basic_auth_headerString

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

Returns:

  • (String)

    The value of the Authentication header.



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

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

#error_messageObject

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.



46
47
48
49
50
51
52
53
54
55
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 46

def fetch_token(additional_params: nil)
  token = @_o_auth_api.request_token_thingspace_oauth(
    build_basic_auth_header,
    _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.



60
61
62
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 60

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

#validBoolean

Validates the oAuth token.

Returns:

  • (Boolean)

    true if the token is present and not expired.



33
34
35
# File 'lib/verizon/http/auth/thingspace_oauth.rb', line 33

def valid
  !@_oauth_token.nil? && !token_expired?(@_oauth_token)
end