Module: Fog::Compute::Brightbox::Shared

Includes:
Brightbox::OAuth2
Included in:
Mock, Real
Defined in:
lib/fog/brightbox/compute.rb

Instance Method Summary collapse

Methods included from Brightbox::OAuth2

#request_access_token

Instance Method Details

#access_token ⇒ String?

Returns the current access token or nil

Returns:



235
236
237
 
# File 'lib/fog/brightbox/compute.rb', line 235

def access_token
  @credentials.access_token
end

#access_token_available? ⇒ Boolean

Returns true if an access token is set

Returns:

  • (Boolean) 


229
230
231
 
# File 'lib/fog/brightbox/compute.rb', line 229

def access_token_available?
  !! @credentials.access_token
end

#account ⇒ Fog::Compute::Brightbox::Account

Returns the scoped account being used for requests

  • For API clients this is the owning account

  • For User applications this is the account specified by either account_id option on the service or the brightbox_account setting in your configuration

Returns:



216
217
218
219
 
# File 'lib/fog/brightbox/compute.rb', line 216

def 
   = .merge(:service => self)
  Fog::Compute::Brightbox::Account.new()
end

#authenticating_as_user? ⇒ Boolean

Returns true if authentication is being performed as a user

Returns:

  • (Boolean) 


223
224
225
 
# File 'lib/fog/brightbox/compute.rb', line 223

def authenticating_as_user?
  @credentials.user_details?
end

#default_image ⇒ String?

Returns an identifier for the default image for use

Currently tries to find the latest version Ubuntu LTS (i686) widening up to the latest, official version of Ubuntu available.

Highly recommended that you actually select the image you want to run on your servers yourself!

Returns:



277
278
279
280
 
# File 'lib/fog/brightbox/compute.rb', line 277

def default_image
  return @default_image_id unless @default_image_id.nil?
  @default_image_id = Fog.credentials[:brightbox_default_image] || select_default_image
end

#get_access_token ⇒ String

Requests a new access token

Returns:

  • (String) —

    New access token



248
249
250
251
252
253
254
255
 
# File 'lib/fog/brightbox/compute.rb', line 248

def get_access_token
  begin
    get_access_token!
  rescue Excon::Errors::Unauthorized, Excon::Errors::BadRequest
    @credentials.update_tokens(nil, nil)
  end
  @credentials.access_token
end

#get_access_token! ⇒ String

Requests a new access token and raises if there is a problem

Returns:

  • (String) —

    New access token

Raises:

  • (Excon::Errors::BadRequest) —

    The credentials are expired or incorrect



262
263
264
265
266
 
# File 'lib/fog/brightbox/compute.rb', line 262

def get_access_token!
  response = request_access_token(@auth_connection, @credentials)
  update_credentials_from_response(@credentials, response)
  @credentials.access_token
end

#initialize(options) ⇒ Object

Note:

If you create service using just a refresh token when it expires the service will no longer be able to authenticate.

Creates a new instance of the Brightbox Compute service

Parameters:

Options Hash (options):

  • :brightbox_api_url (String) —

    Override the default (or configured) API endpoint

  • :brightbox_auth_url (String) —

    Override the default (or configured) API authentication endpoint

  • :brightbox_client_id (String) —

    Client identifier to authenticate with (overrides configured)

  • :brightbox_secret (String) —

    Client secret to authenticate with (overrides configured)

  • :brightbox_username (String) —

    Email or user identifier for user based authentication

  • :brightbox_password (String) —

    Password for user based authentication

  • :brightbox_account (String) —

    Account identifier to scope this connection to

  • :connection_options (String) —

    Settings to pass to underlying Fog::Connection

  • :persistent (Boolean) —

    Sets a persistent HTTP Fog::Connection

  • :brightbox_access_token (String) —

    Sets the OAuth access token to use rather than requesting a new token

  • :brightbox_refresh_token (String) —

    Sets the refresh token to use when requesting a newer access token

  • :brightbox_token_management (String) —

    Overide the existing behaviour to request access tokens if expired (default is ‘true`)



158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
 
# File 'lib/fog/brightbox/compute.rb', line 158

def initialize(options)
  # Currently authentication and api endpoints are the same but may change
  @auth_url            = options[:brightbox_auth_url]  || Fog.credentials[:brightbox_auth_url] || API_URL
  @auth_connection     = Fog::Connection.new(@auth_url)

  @api_url             = options[:brightbox_api_url]   || Fog.credentials[:brightbox_api_url]  || API_URL
  @connection_options  = options[:connection_options]  || {}
  @persistent          = options[:persistent]          || false
  @connection          = Fog::Connection.new(@api_url, @persistent, @connection_options)

  # Authentication options
  client_id            = options[:brightbox_client_id] || Fog.credentials[:brightbox_client_id]
  client_secret        = options[:brightbox_secret]    || Fog.credentials[:brightbox_secret]

  username             = options[:brightbox_username]  || Fog.credentials[:brightbox_username]
  password             = options[:brightbox_password]  || Fog.credentials[:brightbox_password]
  @configured_account  = options[:brightbox_account]   || Fog.credentials[:brightbox_account]
  # Request account can be changed at anytime and changes behaviour of future requests
  @scoped_account      = @configured_account

  credential_options   = {:username => username, :password => password}
  @credentials         = CredentialSet.new(client_id, client_secret, credential_options)

  # If existing tokens have been cached, allow continued use of them in the service
  @credentials.update_tokens(options[:brightbox_access_token], options[:brightbox_refresh_token])

  @token_management    = options.fetch(:brightbox_token_management, true)
end

#refresh_token ⇒ String?

Returns the current refresh token or nil

Returns:



241
242
243
 
# File 'lib/fog/brightbox/compute.rb', line 241

def refresh_token
  @credentials.refresh_token
end

#scoped_account(options_account = nil) ⇒ String?

This returns the account identifier that the request should be scoped by based on the options passed to the request and current configuration

Parameters:

  • options_account (String) (defaults to: nil) —

    Any identifier passed into the request

Returns:

  • (String, nil) —

    The account identifier to scope the request to or nil



199
200
201
 
# File 'lib/fog/brightbox/compute.rb', line 199

def ( = nil)
  [, @scoped_account].compact.first
end

#scoped_account=(scoped_account) ⇒ Object

Sets the scoped account for future requests

Parameters:

  • scoped_account (String) —

    Identifier of the account to scope request to



189
190
191
 
# File 'lib/fog/brightbox/compute.rb', line 189

def scoped_account=()
  @scoped_account = 
end

#scoped_account_reset ⇒ Object

Resets the scoped account back to intially configured one



204
205
206
 
# File 'lib/fog/brightbox/compute.rb', line 204

def 
  @scoped_account = @configured_account
end