Class: AwsAssumeRole::Vendored::Aws::AssumeRoleCredentials

Inherits:
Object
  • Object
show all
Includes:
Aws::CredentialProvider, Aws::RefreshingCredentials
Defined in:
lib/aws_assume_role/vendored/aws/assume_role_credentials.rb

Overview

An auto-refreshing credential provider that works by assuming a role via Aws::STS::Client#assume_role.

role_credentials = Aws::AssumeRoleCredentials.new(
  client: Aws::STS::Client.new(...),
  role_arn: "linked::account::arn",
  role_session_name: "session-name"
)

ec2 = Aws::EC2::Client.new(credentials: role_credentials)

If you omit `:client` option, a new STS::Client object will be constructed.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ AssumeRoleCredentials

Returns a new instance of AssumeRoleCredentials.

Parameters:

  • options (Hash) (defaults to: {})

    a customizable set of options

Options Hash (options):

  • :role_arn (required, String)
  • :role_session_name (required, String)
  • :policy (String)
  • :duration_seconds (Integer)
  • :external_id (String)
  • :client (STS::Client)

27
28
29
30
31
32
33
34
35
36
37
38
39
40
# File 'lib/aws_assume_role/vendored/aws/assume_role_credentials.rb', line 27

def initialize(options = {}, **)

    client_opts = {}
    @assume_role_params = {}
    options.each_pair do |key, value|
        if self.class.assume_role_options.include?(key)
            @assume_role_params[key] = value
        else
            client_opts[key] = value
        end
    end
    @client = client_opts[:client] || ::Aws::STS::Client.new(client_opts)
    super
end

Instance Attribute Details

#clientSTS::Client (readonly)

Returns:

  • (STS::Client)

43
44
45
# File 'lib/aws_assume_role/vendored/aws/assume_role_credentials.rb', line 43

def client
  @client
end

Class Method Details

.assume_role_optionsObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


59
60
61
62
63
64
# File 'lib/aws_assume_role/vendored/aws/assume_role_credentials.rb', line 59

def assume_role_options
    @aro ||= begin
        input = ::Aws::STS::Client.api.operation(:assume_role).input
        Set.new(input.shape.member_names)
    end
end