Module: AWS::Core::CredentialProviders::Provider

Included in:
DefaultProvider, EC2Provider, ENVProvider, SessionProvider
Defined in:
lib/aws/core/credential_providers.rb

Overview

This module is mixed into the various credential provider classes. It provides a unified interface for getting credentials and refreshing them.

Constant Summary collapse

KEYS =

The list of possible keys in the hash returned by #credentials.

Set[:access_key_id, :secret_access_key, :session_token]

Instance Method Summary collapse

Instance Method Details

#access_key_idString

Returns the AWS access key id.

Returns:

  • (String)

    Returns the AWS access key id.

Raises:



51
52
53
# File 'lib/aws/core/credential_providers.rb', line 51

def access_key_id
  credentials[:access_key_id]
end

#credentialsHash

Returns a hash of credentials containg at least the :access_key_id and :secret_access_key. The hash may also contain a :session_token.

Returns:

  • (Hash)

    Returns a hash of credentials containg at least the :access_key_id and :secret_access_key. The hash may also contain a :session_token.

Raises:



38
39
40
41
42
43
44
45
46
47
# File 'lib/aws/core/credential_providers.rb', line 38

def credentials
  @cached_credentials ||= begin
    creds = get_credentials
    unless creds[:access_key_id] and creds[:secret_access_key]
      raise Errors::MissingCredentialsError
    end
    creds
  end
  @cached_credentials.dup
end

#refreshnil

Clears out cached/memoized credentials. Causes the provider to refetch credentials from the source.

Returns:

  • (nil)


71
72
73
# File 'lib/aws/core/credential_providers.rb', line 71

def refresh
  @cached_credentials = nil
end

#secret_access_keyString

Returns the AWS secret access key.

Returns:

  • (String)

    Returns the AWS secret access key.

Raises:



57
58
59
# File 'lib/aws/core/credential_providers.rb', line 57

def secret_access_key
  credentials[:secret_access_key]
end

#session_tokenString?

Returns the AWS session token or nil if these are not session credentials.

Returns:

  • (String, nil)

    Returns the AWS session token or nil if these are not session credentials.

Raises:



64
65
66
# File 'lib/aws/core/credential_providers.rb', line 64

def session_token
  credentials[:session_token]
end