File: credentials_configuration.rb

package info (click to toggle)
ruby-aws-sdk-core 3.242.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,420 kB
  • sloc: ruby: 18,795; makefile: 4
file content (127 lines) | stat: -rw-r--r-- 4,781 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
# frozen_string_literal: true

module Aws
  # @api private
  module Plugins
    # @api private
    class CredentialsConfiguration < Seahorse::Client::Plugin

      option(:access_key_id, doc_type: String, docstring: '')

      option(:secret_access_key, doc_type: String, docstring: '')

      option(:session_token, doc_type: String, docstring: '')

      option(:account_id, doc_type: String, docstring: '')

      option(
        :profile,
        doc_default: 'default',
        doc_type: String,
        docstring: <<~DOCS)
          Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
          When not specified, 'default' is used.
        DOCS

      option(
        :credentials,
        required: true,
        doc_type: 'Aws::CredentialProvider',
        rbs_type: 'untyped',
        docstring: <<~DOCS
          Your AWS credentials used for authentication. This can be any class that includes and implements
          `Aws::CredentialProvider`, or instance of any one of the following classes:

          * `Aws::Credentials` - Used for configuring static, non-refreshing
            credentials.

          * `Aws::SharedCredentials` - Used for loading static credentials from a
            shared file, such as `~/.aws/config`.

          * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.

          * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
            assume a role after providing credentials via the web.

          * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
            access token generated from `aws login`.

          * `Aws::ProcessCredentials` - Used for loading credentials from a
            process that outputs to stdout.

          * `Aws::InstanceProfileCredentials` - Used for loading credentials
            from an EC2 IMDS on an EC2 instance.

          * `Aws::ECSCredentials` - Used for loading credentials from
            instances running in ECS.

          * `Aws::CognitoIdentityCredentials` - Used for loading credentials
            from the Cognito Identity service.

          When `:credentials` are not configured directly, the following locations will be searched for credentials:

          * `Aws.config[:credentials]`

          * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
            `:account_id` options.

          * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
            `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.

          * `~/.aws/credentials`

          * `~/.aws/config`

          * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive.
            Construct and pass an instance of `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
            enable retries and extended timeouts. Instance profile credential fetching can be disabled by
            setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
        DOCS
      ) do |config|
        CredentialProviderChain.new(config).resolve
      end

      option(:instance_profile_credentials_retries, 0)

      option(:instance_profile_credentials_timeout, 1)

      option(
        :token_provider,
        doc_type: 'Aws::TokenProvider',
        rbs_type: 'untyped',
        docstring: <<~DOCS
          Your Bearer token used for authentication. This can be any class that includes and implements
          `Aws::TokenProvider`, or instance of any one of the following classes:

          * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
            tokens.

          * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
            access token generated from `aws login`.

          When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
          will be used to search for tokens configured for your profile in shared configuration files.
        DOCS
      ) do |config|
        TokenProviderChain.new(config).resolve
      end

      option(
        :auth_scheme_preference,
        doc_type: 'Array<String>',
        rbs_type: 'Array[String]',
        docstring: <<~DOCS
          A list of preferred authentication schemes to use when making a request. Supported values are:
          `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
          shared config as `auth_scheme_preference`, the value should be a comma-separated list.
        DOCS
      ) do |config|
        value =
          ENV['AWS_AUTH_SCHEME_PREFERENCE'] ||
          Aws.shared_config.auth_scheme_preference(profile: config.profile) ||
          ''
        value.gsub(' ', '').gsub("\t", '').split(',')
      end
    end
  end
end