aws-sdk-core 3.178.0 → 3.233.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (196) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +709 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-defaults/default_configuration.rb +1 -2
  5. data/lib/aws-defaults.rb +4 -1
  6. data/lib/aws-sdk-core/arn.rb +1 -3
  7. data/lib/aws-sdk-core/assume_role_credentials.rb +13 -5
  8. data/lib/aws-sdk-core/assume_role_web_identity_credentials.rb +14 -7
  9. data/lib/aws-sdk-core/binary/decode_handler.rb +3 -9
  10. data/lib/aws-sdk-core/binary/encode_handler.rb +1 -1
  11. data/lib/aws-sdk-core/binary/event_builder.rb +34 -37
  12. data/lib/aws-sdk-core/binary/event_stream_decoder.rb +1 -0
  13. data/lib/aws-sdk-core/binary/event_stream_encoder.rb +4 -3
  14. data/lib/aws-sdk-core/cbor/decoder.rb +308 -0
  15. data/lib/aws-sdk-core/cbor/encoder.rb +243 -0
  16. data/lib/aws-sdk-core/cbor.rb +53 -0
  17. data/lib/aws-sdk-core/client_side_monitoring.rb +9 -0
  18. data/lib/aws-sdk-core/client_stubs.rb +33 -55
  19. data/lib/aws-sdk-core/credential_provider.rb +5 -1
  20. data/lib/aws-sdk-core/credential_provider_chain.rb +38 -11
  21. data/lib/aws-sdk-core/credentials.rb +19 -6
  22. data/lib/aws-sdk-core/ec2_metadata.rb +1 -1
  23. data/lib/aws-sdk-core/ecs_credentials.rb +79 -11
  24. data/lib/aws-sdk-core/endpoints/endpoint.rb +3 -1
  25. data/lib/aws-sdk-core/endpoints/matchers.rb +21 -19
  26. data/lib/aws-sdk-core/endpoints.rb +101 -21
  27. data/lib/aws-sdk-core/error_handler.rb +46 -0
  28. data/lib/aws-sdk-core/errors.rb +14 -5
  29. data/lib/aws-sdk-core/event_emitter.rb +1 -17
  30. data/lib/aws-sdk-core/ini_parser.rb +8 -1
  31. data/lib/aws-sdk-core/instance_profile_credentials.rb +168 -155
  32. data/lib/aws-sdk-core/json/builder.rb +8 -1
  33. data/lib/aws-sdk-core/json/error_handler.rb +29 -13
  34. data/lib/aws-sdk-core/json/handler.rb +13 -6
  35. data/lib/aws-sdk-core/json/json_engine.rb +3 -1
  36. data/lib/aws-sdk-core/json/oj_engine.rb +7 -1
  37. data/lib/aws-sdk-core/json/parser.rb +33 -3
  38. data/lib/aws-sdk-core/json.rb +43 -14
  39. data/lib/aws-sdk-core/log/param_filter.rb +2 -2
  40. data/lib/aws-sdk-core/log/param_formatter.rb +7 -3
  41. data/lib/aws-sdk-core/log.rb +10 -0
  42. data/lib/aws-sdk-core/lru_cache.rb +75 -0
  43. data/lib/aws-sdk-core/pageable_response.rb +1 -1
  44. data/lib/aws-sdk-core/param_validator.rb +9 -4
  45. data/lib/aws-sdk-core/plugins/bearer_authorization.rb +2 -0
  46. data/lib/aws-sdk-core/plugins/checksum_algorithm.rb +332 -167
  47. data/lib/aws-sdk-core/plugins/client_metrics_plugin.rb +1 -1
  48. data/lib/aws-sdk-core/plugins/client_metrics_send_plugin.rb +14 -2
  49. data/lib/aws-sdk-core/plugins/credentials_configuration.rb +78 -56
  50. data/lib/aws-sdk-core/plugins/endpoint_pattern.rb +40 -32
  51. data/lib/aws-sdk-core/plugins/global_configuration.rb +8 -9
  52. data/lib/aws-sdk-core/plugins/http_checksum.rb +3 -8
  53. data/lib/aws-sdk-core/plugins/invocation_id.rb +1 -11
  54. data/lib/aws-sdk-core/plugins/logging.rb +2 -0
  55. data/lib/aws-sdk-core/plugins/protocols/api_gateway.rb +3 -1
  56. data/lib/aws-sdk-core/plugins/protocols/ec2.rb +2 -24
  57. data/lib/aws-sdk-core/plugins/protocols/json_rpc.rb +6 -8
  58. data/lib/aws-sdk-core/plugins/protocols/query.rb +4 -2
  59. data/lib/aws-sdk-core/plugins/protocols/rest_json.rb +3 -15
  60. data/lib/aws-sdk-core/plugins/protocols/rest_xml.rb +3 -0
  61. data/lib/aws-sdk-core/plugins/protocols/rpc_v2.rb +17 -0
  62. data/lib/aws-sdk-core/plugins/regional_endpoint.rb +74 -25
  63. data/lib/aws-sdk-core/plugins/request_compression.rb +11 -2
  64. data/lib/aws-sdk-core/plugins/retry_errors.rb +12 -3
  65. data/lib/aws-sdk-core/plugins/sign.rb +55 -34
  66. data/lib/aws-sdk-core/plugins/signature_v2.rb +2 -1
  67. data/lib/aws-sdk-core/plugins/signature_v4.rb +2 -1
  68. data/lib/aws-sdk-core/plugins/stub_responses.rb +59 -9
  69. data/lib/aws-sdk-core/plugins/telemetry.rb +75 -0
  70. data/lib/aws-sdk-core/plugins/transfer_encoding.rb +16 -9
  71. data/lib/aws-sdk-core/plugins/user_agent.rb +101 -26
  72. data/lib/aws-sdk-core/plugins.rb +39 -0
  73. data/lib/aws-sdk-core/process_credentials.rb +48 -29
  74. data/lib/aws-sdk-core/query/ec2_handler.rb +27 -0
  75. data/lib/aws-sdk-core/query/ec2_param_builder.rb +5 -7
  76. data/lib/aws-sdk-core/query/handler.rb +4 -4
  77. data/lib/aws-sdk-core/query/param_builder.rb +2 -2
  78. data/lib/aws-sdk-core/query.rb +2 -1
  79. data/lib/aws-sdk-core/refreshing_credentials.rb +12 -6
  80. data/lib/aws-sdk-core/resources.rb +8 -0
  81. data/lib/aws-sdk-core/rest/content_type_handler.rb +60 -0
  82. data/lib/aws-sdk-core/rest/handler.rb +3 -4
  83. data/lib/aws-sdk-core/rest/request/body.rb +32 -5
  84. data/lib/aws-sdk-core/rest/request/endpoint.rb +24 -4
  85. data/lib/aws-sdk-core/rest/request/headers.rb +15 -7
  86. data/lib/aws-sdk-core/rest/request/querystring_builder.rb +62 -36
  87. data/lib/aws-sdk-core/rest/response/body.rb +15 -1
  88. data/lib/aws-sdk-core/rest/response/header_list_parser.rb +79 -0
  89. data/lib/aws-sdk-core/rest/response/headers.rb +8 -3
  90. data/lib/aws-sdk-core/rest.rb +1 -0
  91. data/lib/aws-sdk-core/rpc_v2/builder.rb +62 -0
  92. data/lib/aws-sdk-core/rpc_v2/cbor_engine.rb +18 -0
  93. data/lib/aws-sdk-core/rpc_v2/content_type_handler.rb +47 -0
  94. data/lib/aws-sdk-core/rpc_v2/error_handler.rb +95 -0
  95. data/lib/aws-sdk-core/rpc_v2/handler.rb +79 -0
  96. data/lib/aws-sdk-core/rpc_v2/parser.rb +98 -0
  97. data/lib/aws-sdk-core/rpc_v2.rb +69 -0
  98. data/lib/aws-sdk-core/shared_config.rb +113 -41
  99. data/lib/aws-sdk-core/shared_credentials.rb +1 -7
  100. data/lib/aws-sdk-core/sso_credentials.rb +4 -1
  101. data/lib/aws-sdk-core/static_token_provider.rb +1 -2
  102. data/lib/aws-sdk-core/stubbing/protocols/ec2.rb +12 -11
  103. data/lib/aws-sdk-core/stubbing/protocols/json.rb +11 -10
  104. data/lib/aws-sdk-core/stubbing/protocols/query.rb +7 -6
  105. data/lib/aws-sdk-core/stubbing/protocols/rest.rb +2 -1
  106. data/lib/aws-sdk-core/stubbing/protocols/rest_json.rb +9 -8
  107. data/lib/aws-sdk-core/stubbing/protocols/rest_xml.rb +6 -5
  108. data/lib/aws-sdk-core/stubbing/protocols/rpc_v2.rb +39 -0
  109. data/lib/aws-sdk-core/stubbing/stub_data.rb +11 -0
  110. data/lib/aws-sdk-core/stubbing.rb +22 -0
  111. data/lib/aws-sdk-core/telemetry/base.rb +177 -0
  112. data/lib/aws-sdk-core/telemetry/no_op.rb +70 -0
  113. data/lib/aws-sdk-core/telemetry/otel.rb +235 -0
  114. data/lib/aws-sdk-core/telemetry/span_kind.rb +22 -0
  115. data/lib/aws-sdk-core/telemetry/span_status.rb +59 -0
  116. data/lib/aws-sdk-core/telemetry.rb +78 -0
  117. data/lib/aws-sdk-core/token.rb +3 -3
  118. data/lib/aws-sdk-core/token_provider.rb +4 -0
  119. data/lib/aws-sdk-core/token_provider_chain.rb +2 -6
  120. data/lib/aws-sdk-core/util.rb +41 -1
  121. data/lib/aws-sdk-core/waiters/poller.rb +10 -5
  122. data/lib/aws-sdk-core/xml/builder.rb +17 -9
  123. data/lib/aws-sdk-core/xml/error_handler.rb +35 -43
  124. data/lib/aws-sdk-core/xml/parser/frame.rb +4 -20
  125. data/lib/aws-sdk-core/xml/parser/stack.rb +2 -0
  126. data/lib/aws-sdk-core/xml/parser.rb +2 -6
  127. data/lib/aws-sdk-core.rb +82 -107
  128. data/lib/aws-sdk-sso/client.rb +189 -96
  129. data/lib/aws-sdk-sso/client_api.rb +7 -0
  130. data/lib/aws-sdk-sso/endpoint_parameters.rb +9 -6
  131. data/lib/aws-sdk-sso/endpoint_provider.rb +30 -28
  132. data/lib/aws-sdk-sso/endpoints.rb +2 -54
  133. data/lib/aws-sdk-sso/plugins/endpoints.rb +23 -22
  134. data/lib/aws-sdk-sso/types.rb +1 -0
  135. data/lib/aws-sdk-sso.rb +15 -11
  136. data/lib/aws-sdk-ssooidc/client.rb +609 -129
  137. data/lib/aws-sdk-ssooidc/client_api.rb +94 -1
  138. data/lib/aws-sdk-ssooidc/endpoint_parameters.rb +9 -6
  139. data/lib/aws-sdk-ssooidc/endpoint_provider.rb +30 -28
  140. data/lib/aws-sdk-ssooidc/endpoints.rb +2 -40
  141. data/lib/aws-sdk-ssooidc/errors.rb +62 -0
  142. data/lib/aws-sdk-ssooidc/plugins/endpoints.rb +23 -20
  143. data/lib/aws-sdk-ssooidc/types.rb +419 -53
  144. data/lib/aws-sdk-ssooidc.rb +15 -11
  145. data/lib/aws-sdk-sts/client.rb +414 -147
  146. data/lib/aws-sdk-sts/client_api.rb +48 -9
  147. data/lib/aws-sdk-sts/customizations.rb +5 -2
  148. data/lib/aws-sdk-sts/endpoint_parameters.rb +10 -9
  149. data/lib/aws-sdk-sts/endpoint_provider.rb +52 -57
  150. data/lib/aws-sdk-sts/endpoints.rb +2 -118
  151. data/lib/aws-sdk-sts/errors.rb +15 -0
  152. data/lib/aws-sdk-sts/plugins/endpoints.rb +23 -30
  153. data/lib/aws-sdk-sts/presigner.rb +3 -7
  154. data/lib/aws-sdk-sts/types.rb +209 -27
  155. data/lib/aws-sdk-sts.rb +15 -11
  156. data/lib/seahorse/client/async_base.rb +4 -5
  157. data/lib/seahorse/client/async_response.rb +19 -0
  158. data/lib/seahorse/client/base.rb +18 -21
  159. data/lib/seahorse/client/h2/connection.rb +18 -28
  160. data/lib/seahorse/client/h2/handler.rb +14 -3
  161. data/lib/seahorse/client/handler.rb +1 -1
  162. data/lib/seahorse/client/http/response.rb +1 -1
  163. data/lib/seahorse/client/net_http/connection_pool.rb +15 -12
  164. data/lib/seahorse/client/net_http/handler.rb +21 -9
  165. data/lib/seahorse/client/net_http/patches.rb +1 -4
  166. data/lib/seahorse/client/networking_error.rb +1 -1
  167. data/lib/seahorse/client/plugin.rb +9 -0
  168. data/lib/seahorse/client/plugins/endpoint.rb +0 -1
  169. data/lib/seahorse/client/plugins/h2.rb +4 -4
  170. data/lib/seahorse/client/plugins/net_http.rb +57 -16
  171. data/lib/seahorse/client/plugins/request_callback.rb +31 -0
  172. data/lib/seahorse/client/request_context.rb +9 -2
  173. data/lib/seahorse/client/response.rb +8 -0
  174. data/lib/seahorse/model/shapes.rb +2 -2
  175. data/lib/seahorse/util.rb +2 -1
  176. data/sig/aws-sdk-core/async_client_stubs.rbs +21 -0
  177. data/sig/aws-sdk-core/client_stubs.rbs +10 -0
  178. data/sig/aws-sdk-core/errors.rbs +22 -0
  179. data/sig/aws-sdk-core/resources/collection.rbs +21 -0
  180. data/sig/aws-sdk-core/structure.rbs +4 -0
  181. data/sig/aws-sdk-core/telemetry/base.rbs +46 -0
  182. data/sig/aws-sdk-core/telemetry/otel.rbs +22 -0
  183. data/sig/aws-sdk-core/telemetry/span_kind.rbs +15 -0
  184. data/sig/aws-sdk-core/telemetry/span_status.rbs +24 -0
  185. data/sig/aws-sdk-core/waiters/errors.rbs +20 -0
  186. data/sig/aws-sdk-core.rbs +7 -0
  187. data/sig/seahorse/client/async_base.rbs +18 -0
  188. data/sig/seahorse/client/base.rbs +25 -0
  189. data/sig/seahorse/client/handler_builder.rbs +16 -0
  190. data/sig/seahorse/client/response.rbs +61 -0
  191. metadata +105 -23
  192. /data/lib/aws-sdk-core/xml/parser/{engines/libxml.rb → libxml_engine.rb} +0 -0
  193. /data/lib/aws-sdk-core/xml/parser/{engines/nokogiri.rb → nokogiri_engine.rb} +0 -0
  194. /data/lib/aws-sdk-core/xml/parser/{engines/oga.rb → oga_engine.rb} +0 -0
  195. /data/lib/aws-sdk-core/xml/parser/{engines/ox.rb → ox_engine.rb} +0 -0
  196. /data/lib/aws-sdk-core/xml/parser/{engines/rexml.rb → rexml_engine.rb} +0 -0
@@ -7,34 +7,34 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
- require 'seahorse/client/plugins/content_length.rb'
11
- require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
- require 'aws-sdk-core/plugins/logging.rb'
13
- require 'aws-sdk-core/plugins/param_converter.rb'
14
- require 'aws-sdk-core/plugins/param_validator.rb'
15
- require 'aws-sdk-core/plugins/user_agent.rb'
16
- require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
- require 'aws-sdk-core/plugins/retry_errors.rb'
18
- require 'aws-sdk-core/plugins/global_configuration.rb'
19
- require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
- require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
- require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
- require 'aws-sdk-core/plugins/response_paging.rb'
23
- require 'aws-sdk-core/plugins/stub_responses.rb'
24
- require 'aws-sdk-core/plugins/idempotency_token.rb'
25
- require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
26
- require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
- require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
- require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
- require 'aws-sdk-core/plugins/http_checksum.rb'
30
- require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
- require 'aws-sdk-core/plugins/request_compression.rb'
32
- require 'aws-sdk-core/plugins/defaults_mode.rb'
33
- require 'aws-sdk-core/plugins/recursion_detection.rb'
34
- require 'aws-sdk-core/plugins/sign.rb'
35
- require 'aws-sdk-core/plugins/protocols/rest_json.rb'
36
-
37
- Aws::Plugins::GlobalConfiguration.add_identifier(:ssooidc)
10
+ require 'seahorse/client/plugins/content_length'
11
+ require 'aws-sdk-core/plugins/credentials_configuration'
12
+ require 'aws-sdk-core/plugins/logging'
13
+ require 'aws-sdk-core/plugins/param_converter'
14
+ require 'aws-sdk-core/plugins/param_validator'
15
+ require 'aws-sdk-core/plugins/user_agent'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors'
17
+ require 'aws-sdk-core/plugins/retry_errors'
18
+ require 'aws-sdk-core/plugins/global_configuration'
19
+ require 'aws-sdk-core/plugins/regional_endpoint'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern'
22
+ require 'aws-sdk-core/plugins/response_paging'
23
+ require 'aws-sdk-core/plugins/stub_responses'
24
+ require 'aws-sdk-core/plugins/idempotency_token'
25
+ require 'aws-sdk-core/plugins/invocation_id'
26
+ require 'aws-sdk-core/plugins/jsonvalue_converter'
27
+ require 'aws-sdk-core/plugins/client_metrics_plugin'
28
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin'
29
+ require 'aws-sdk-core/plugins/transfer_encoding'
30
+ require 'aws-sdk-core/plugins/http_checksum'
31
+ require 'aws-sdk-core/plugins/checksum_algorithm'
32
+ require 'aws-sdk-core/plugins/request_compression'
33
+ require 'aws-sdk-core/plugins/defaults_mode'
34
+ require 'aws-sdk-core/plugins/recursion_detection'
35
+ require 'aws-sdk-core/plugins/telemetry'
36
+ require 'aws-sdk-core/plugins/sign'
37
+ require 'aws-sdk-core/plugins/protocols/rest_json'
38
38
 
39
39
  module Aws::SSOOIDC
40
40
  # An API client for SSOOIDC. To construct a client, you need to configure a `:region` and `:credentials`.
@@ -72,6 +72,7 @@ module Aws::SSOOIDC
72
72
  add_plugin(Aws::Plugins::ResponsePaging)
73
73
  add_plugin(Aws::Plugins::StubResponses)
74
74
  add_plugin(Aws::Plugins::IdempotencyToken)
75
+ add_plugin(Aws::Plugins::InvocationId)
75
76
  add_plugin(Aws::Plugins::JsonvalueConverter)
76
77
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
77
78
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -81,15 +82,21 @@ module Aws::SSOOIDC
81
82
  add_plugin(Aws::Plugins::RequestCompression)
82
83
  add_plugin(Aws::Plugins::DefaultsMode)
83
84
  add_plugin(Aws::Plugins::RecursionDetection)
85
+ add_plugin(Aws::Plugins::Telemetry)
84
86
  add_plugin(Aws::Plugins::Sign)
85
87
  add_plugin(Aws::Plugins::Protocols::RestJson)
86
88
  add_plugin(Aws::SSOOIDC::Plugins::Endpoints)
87
89
 
88
90
  # @overload initialize(options)
89
91
  # @param [Hash] options
92
+ #
93
+ # @option options [Array<Seahorse::Client::Plugin>] :plugins ([]])
94
+ # A list of plugins to apply to the client. Each plugin is either a
95
+ # class name or an instance of a plugin class.
96
+ #
90
97
  # @option options [required, Aws::CredentialProvider] :credentials
91
- # Your AWS credentials. This can be an instance of any one of the
92
- # following classes:
98
+ # Your AWS credentials used for authentication. This can be any class that includes and implements
99
+ # `Aws::CredentialProvider`, or instance of any one of the following classes:
93
100
  #
94
101
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
95
102
  # credentials.
@@ -117,20 +124,24 @@ module Aws::SSOOIDC
117
124
  # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
118
125
  # from the Cognito Identity service.
119
126
  #
120
- # When `:credentials` are not configured directly, the following
121
- # locations will be searched for credentials:
127
+ # When `:credentials` are not configured directly, the following locations will be searched for credentials:
122
128
  #
123
129
  # * `Aws.config[:credentials]`
124
- # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
125
- # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
130
+ #
131
+ # * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
132
+ # `:account_id` options.
133
+ #
134
+ # * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
135
+ # `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.
136
+ #
126
137
  # * `~/.aws/credentials`
138
+ #
127
139
  # * `~/.aws/config`
128
- # * EC2/ECS IMDS instance profile - When used by default, the timeouts
129
- # are very aggressive. Construct and pass an instance of
130
- # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
131
- # enable retries and extended timeouts. Instance profile credential
132
- # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
133
- # to true.
140
+ #
141
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive.
142
+ # Construct and pass an instance of `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
143
+ # enable retries and extended timeouts. Instance profile credential fetching can be disabled by
144
+ # setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
134
145
  #
135
146
  # @option options [required, String] :region
136
147
  # The AWS region to connect to. The configured `:region` is
@@ -146,6 +157,8 @@ module Aws::SSOOIDC
146
157
  #
147
158
  # @option options [String] :access_key_id
148
159
  #
160
+ # @option options [String] :account_id
161
+ #
149
162
  # @option options [Boolean] :active_endpoint_cache (false)
150
163
  # When set to `true`, a thread polling for endpoints will be running in
151
164
  # the background every 60 secs (default). Defaults to `false`.
@@ -156,6 +169,11 @@ module Aws::SSOOIDC
156
169
  # When false, the request will raise a `RetryCapacityNotAvailableError` and will
157
170
  # not retry instead of sleeping.
158
171
  #
172
+ # @option options [Array<String>] :auth_scheme_preference
173
+ # A list of preferred authentication schemes to use when making a request. Supported values are:
174
+ # `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
175
+ # shared config as `auth_scheme_preference`, the value should be a comma-separated list.
176
+ #
159
177
  # @option options [Boolean] :client_side_monitoring (false)
160
178
  # When `true`, client-side metrics will be collected for all API requests from
161
179
  # this client.
@@ -189,17 +207,22 @@ module Aws::SSOOIDC
189
207
  # accepted modes and the configuration defaults that are included.
190
208
  #
191
209
  # @option options [Boolean] :disable_host_prefix_injection (false)
192
- # Set to true to disable SDK automatically adding host prefix
193
- # to default service endpoint when available.
210
+ # When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
194
211
  #
195
212
  # @option options [Boolean] :disable_request_compression (false)
196
213
  # When set to 'true' the request body will not be compressed
197
214
  # for supported operations.
198
215
  #
199
- # @option options [String] :endpoint
200
- # The client endpoint is normally constructed from the `:region`
201
- # option. You should only configure an `:endpoint` when connecting
202
- # to test or custom endpoints. This should be a valid HTTP(S) URI.
216
+ # @option options [String, URI::HTTPS, URI::HTTP] :endpoint
217
+ # Normally you should not configure the `:endpoint` option
218
+ # directly. This is normally constructed from the `:region`
219
+ # option. Configuring `:endpoint` is normally reserved for
220
+ # connecting to test or custom endpoints. The endpoint should
221
+ # be a URI formatted like:
222
+ #
223
+ # 'http://example.com'
224
+ # 'https://example.com'
225
+ # 'http://example.com:123'
203
226
  #
204
227
  # @option options [Integer] :endpoint_cache_max_entries (1000)
205
228
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -237,14 +260,37 @@ module Aws::SSOOIDC
237
260
  # 4 times. Used in `standard` and `adaptive` retry modes.
238
261
  #
239
262
  # @option options [String] :profile ("default")
240
- # Used when loading credentials from the shared credentials file
241
- # at HOME/.aws/credentials. When not specified, 'default' is used.
263
+ # Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
264
+ # When not specified, 'default' is used.
265
+ #
266
+ # @option options [String] :request_checksum_calculation ("when_supported")
267
+ # Determines when a checksum will be calculated for request payloads. Values are:
268
+ #
269
+ # * `when_supported` - (default) When set, a checksum will be
270
+ # calculated for all request payloads of operations modeled with the
271
+ # `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
272
+ # `requestAlgorithmMember` is modeled.
273
+ # * `when_required` - When set, a checksum will only be calculated for
274
+ # request payloads of operations modeled with the `httpChecksum` trait where
275
+ # `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
276
+ # is modeled and supplied.
242
277
  #
243
278
  # @option options [Integer] :request_min_compression_size_bytes (10240)
244
279
  # The minimum size in bytes that triggers compression for request
245
280
  # bodies. The value must be non-negative integer value between 0
246
281
  # and 10485780 bytes inclusive.
247
282
  #
283
+ # @option options [String] :response_checksum_validation ("when_supported")
284
+ # Determines when checksum validation will be performed on response payloads. Values are:
285
+ #
286
+ # * `when_supported` - (default) When set, checksum validation is performed on all
287
+ # response payloads of operations modeled with the `httpChecksum` trait where
288
+ # `responseAlgorithms` is modeled, except when no modeled checksum algorithms
289
+ # are supported.
290
+ # * `when_required` - When set, checksum validation is not performed on
291
+ # response payloads of operations unless the checksum algorithm is supported and
292
+ # the `requestValidationModeMember` member is set to `ENABLED`.
293
+ #
248
294
  # @option options [Proc] :retry_backoff
249
295
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
250
296
  # This option is only used in the `legacy` retry mode.
@@ -289,16 +335,25 @@ module Aws::SSOOIDC
289
335
  # throttling. This is a provisional mode that may change behavior
290
336
  # in the future.
291
337
  #
292
- #
293
338
  # @option options [String] :sdk_ua_app_id
294
339
  # A unique and opaque application ID that is appended to the
295
- # User-Agent header as app/<sdk_ua_app_id>. It should have a
296
- # maximum length of 50.
340
+ # User-Agent header as app/sdk_ua_app_id. It should have a
341
+ # maximum length of 50. This variable is sourced from environment
342
+ # variable AWS_SDK_UA_APP_ID or the shared config profile attribute sdk_ua_app_id.
297
343
  #
298
344
  # @option options [String] :secret_access_key
299
345
  #
300
346
  # @option options [String] :session_token
301
347
  #
348
+ # @option options [Array] :sigv4a_signing_region_set
349
+ # A list of regions that should be signed with SigV4a signing. When
350
+ # not passed, a default `:sigv4a_signing_region_set` is searched for
351
+ # in the following locations:
352
+ #
353
+ # * `Aws.config[:sigv4a_signing_region_set]`
354
+ # * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
355
+ # * `~/.aws/config`
356
+ #
302
357
  # @option options [Boolean] :stub_responses (false)
303
358
  # Causes the client to return stubbed responses. By default
304
359
  # fake responses are generated and returned. You can specify
@@ -308,9 +363,19 @@ module Aws::SSOOIDC
308
363
  # ** Please note ** When response stubbing is enabled, no HTTP
309
364
  # requests are made, and retries are disabled.
310
365
  #
366
+ # @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
367
+ # Allows you to provide a telemetry provider, which is used to
368
+ # emit telemetry data. By default, uses `NoOpTelemetryProvider` which
369
+ # will not record or emit any telemetry data. The SDK supports the
370
+ # following telemetry providers:
371
+ #
372
+ # * OpenTelemetry (OTel) - To use the OTel provider, install and require the
373
+ # `opentelemetry-sdk` gem and then, pass in an instance of a
374
+ # `Aws::Telemetry::OTelProvider` for telemetry provider.
375
+ #
311
376
  # @option options [Aws::TokenProvider] :token_provider
312
- # A Bearer Token Provider. This can be an instance of any one of the
313
- # following classes:
377
+ # Your Bearer token used for authentication. This can be any class that includes and implements
378
+ # `Aws::TokenProvider`, or instance of any one of the following classes:
314
379
  #
315
380
  # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
316
381
  # tokens.
@@ -335,52 +400,75 @@ module Aws::SSOOIDC
335
400
  # sending the request.
336
401
  #
337
402
  # @option options [Aws::SSOOIDC::EndpointProvider] :endpoint_provider
338
- # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::SSOOIDC::EndpointParameters`
339
- #
340
- # @option options [URI::HTTP,String] :http_proxy A proxy to send
341
- # requests through. Formatted like 'http://proxy.com:123'.
342
- #
343
- # @option options [Float] :http_open_timeout (15) The number of
344
- # seconds to wait when opening a HTTP session before raising a
345
- # `Timeout::Error`.
346
- #
347
- # @option options [Float] :http_read_timeout (60) The default
348
- # number of seconds to wait for response data. This value can
349
- # safely be set per-request on the session.
350
- #
351
- # @option options [Float] :http_idle_timeout (5) The number of
352
- # seconds a connection is allowed to sit idle before it is
353
- # considered stale. Stale connections are closed and removed
354
- # from the pool before making a request.
355
- #
356
- # @option options [Float] :http_continue_timeout (1) The number of
357
- # seconds to wait for a 100-continue response before sending the
358
- # request body. This option has no effect unless the request has
359
- # "Expect" header set to "100-continue". Defaults to `nil` which
360
- # disables this behaviour. This value can safely be set per
361
- # request on the session.
403
+ # The endpoint provider used to resolve endpoints. Any object that responds to
404
+ # `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
405
+ # `Aws::SSOOIDC::EndpointParameters`.
406
+ #
407
+ # @option options [Float] :http_continue_timeout (1)
408
+ # The number of seconds to wait for a 100-continue response before sending the
409
+ # request body. This option has no effect unless the request has "Expect"
410
+ # header set to "100-continue". Defaults to `nil` which disables this
411
+ # behaviour. This value can safely be set per request on the session.
412
+ #
413
+ # @option options [Float] :http_idle_timeout (5)
414
+ # The number of seconds a connection is allowed to sit idle before it
415
+ # is considered stale. Stale connections are closed and removed from the
416
+ # pool before making a request.
417
+ #
418
+ # @option options [Float] :http_open_timeout (15)
419
+ # The default number of seconds to wait for response data.
420
+ # This value can safely be set per-request on the session.
421
+ #
422
+ # @option options [URI::HTTP,String] :http_proxy
423
+ # A proxy to send requests through. Formatted like 'http://proxy.com:123'.
424
+ #
425
+ # @option options [Float] :http_read_timeout (60)
426
+ # The default number of seconds to wait for response data.
427
+ # This value can safely be set per-request on the session.
428
+ #
429
+ # @option options [Boolean] :http_wire_trace (false)
430
+ # When `true`, HTTP debug output will be sent to the `:logger`.
431
+ #
432
+ # @option options [Proc] :on_chunk_received
433
+ # When a Proc object is provided, it will be used as callback when each chunk
434
+ # of the response body is received. It provides three arguments: the chunk,
435
+ # the number of bytes received, and the total number of
436
+ # bytes in the response (or nil if the server did not send a `content-length`).
437
+ #
438
+ # @option options [Proc] :on_chunk_sent
439
+ # When a Proc object is provided, it will be used as callback when each chunk
440
+ # of the request body is sent. It provides three arguments: the chunk,
441
+ # the number of bytes read from the body, and the total number of
442
+ # bytes in the body.
443
+ #
444
+ # @option options [Boolean] :raise_response_errors (true)
445
+ # When `true`, response errors are raised.
446
+ #
447
+ # @option options [String] :ssl_ca_bundle
448
+ # Full path to the SSL certificate authority bundle file that should be used when
449
+ # verifying peer certificates. If you do not pass `:ssl_ca_bundle` or
450
+ # `:ssl_ca_directory` the the system default will be used if available.
451
+ #
452
+ # @option options [String] :ssl_ca_directory
453
+ # Full path of the directory that contains the unbundled SSL certificate
454
+ # authority files for verifying peer certificates. If you do
455
+ # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
456
+ # default will be used if available.
362
457
  #
363
- # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
364
- # in seconds.
458
+ # @option options [String] :ssl_ca_store
459
+ # Sets the X509::Store to verify peer certificate.
365
460
  #
366
- # @option options [Boolean] :http_wire_trace (false) When `true`,
367
- # HTTP debug output will be sent to the `:logger`.
461
+ # @option options [OpenSSL::X509::Certificate] :ssl_cert
462
+ # Sets a client certificate when creating http connections.
368
463
  #
369
- # @option options [Boolean] :ssl_verify_peer (true) When `true`,
370
- # SSL peer certificates are verified when establishing a
371
- # connection.
464
+ # @option options [OpenSSL::PKey] :ssl_key
465
+ # Sets a client key when creating http connections.
372
466
  #
373
- # @option options [String] :ssl_ca_bundle Full path to the SSL
374
- # certificate authority bundle file that should be used when
375
- # verifying peer certificates. If you do not pass
376
- # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
377
- # will be used if available.
467
+ # @option options [Float] :ssl_timeout
468
+ # Sets the SSL timeout in seconds
378
469
  #
379
- # @option options [String] :ssl_ca_directory Full path of the
380
- # directory that contains the unbundled SSL certificate
381
- # authority files for verifying peer certificates. If you do
382
- # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
383
- # system default will be used if available.
470
+ # @option options [Boolean] :ssl_verify_peer (true)
471
+ # When `true`, SSL peer certificates are verified when establishing a connection.
384
472
  #
385
473
  def initialize(*args)
386
474
  super
@@ -388,61 +476,66 @@ module Aws::SSOOIDC
388
476
 
389
477
  # @!group API Operations
390
478
 
391
- # Creates and returns an access token for the authorized client. The
392
- # access token issued will be used to fetch short-term credentials for
393
- # the assigned roles in the AWS account.
479
+ # Creates and returns access and refresh tokens for clients that are
480
+ # authenticated using client secrets. The access token can be used to
481
+ # fetch short-lived credentials for the assigned AWS accounts or to
482
+ # access application APIs using `bearer` authentication.
394
483
  #
395
484
  # @option params [required, String] :client_id
396
- # The unique identifier string for each client. This value should come
397
- # from the persisted result of the RegisterClient API.
485
+ # The unique identifier string for the client or application. This value
486
+ # comes from the result of the RegisterClient API.
398
487
  #
399
488
  # @option params [required, String] :client_secret
400
489
  # A secret string generated for the client. This value should come from
401
490
  # the persisted result of the RegisterClient API.
402
491
  #
403
492
  # @option params [required, String] :grant_type
404
- # Supports grant types for the authorization code, refresh token, and
405
- # device code request. For device code requests, specify the following
406
- # value:
493
+ # Supports the following OAuth grant types: Authorization Code, Device
494
+ # Code, and Refresh Token. Specify one of the following values,
495
+ # depending on the grant type that you want:
496
+ #
497
+ # * Authorization Code - `authorization_code`
407
498
  #
408
- # `urn:ietf:params:oauth:grant-type:device_code `
499
+ # * Device Code - `urn:ietf:params:oauth:grant-type:device_code`
409
500
  #
410
- # For information about how to obtain the device code, see the
411
- # StartDeviceAuthorization topic.
501
+ # * Refresh Token - `refresh_token`
412
502
  #
413
503
  # @option params [String] :device_code
414
- # Used only when calling this API for the device code grant type. This
415
- # short-term code is used to identify this authentication attempt. This
416
- # should come from an in-memory reference to the result of the
417
- # StartDeviceAuthorization API.
504
+ # Used only when calling this API for the Device Code grant type. This
505
+ # short-lived code is used to identify this authorization request. This
506
+ # comes from the result of the StartDeviceAuthorization API.
418
507
  #
419
508
  # @option params [String] :code
420
- # The authorization code received from the authorization service. This
421
- # parameter is required to perform an authorization grant request to get
422
- # access to a token.
509
+ # Used only when calling this API for the Authorization Code grant type.
510
+ # The short-lived code is used to identify this authorization request.
423
511
  #
424
512
  # @option params [String] :refresh_token
425
- # Currently, `refreshToken` is not yet implemented and is not supported.
513
+ # Used only when calling this API for the Refresh Token grant type. This
514
+ # token is used to refresh short-lived tokens, such as the access token,
515
+ # that might expire.
516
+ #
426
517
  # For more information about the features and limitations of the current
427
518
  # IAM Identity Center OIDC implementation, see *Considerations for Using
428
519
  # this Guide* in the [IAM Identity Center OIDC API Reference][1].
429
520
  #
430
- # The token used to obtain an access token in the event that the access
431
- # token is invalid or expired.
432
- #
433
521
  #
434
522
  #
435
523
  # [1]: https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html
436
524
  #
437
525
  # @option params [Array<String>] :scope
438
- # The list of scopes that is defined by the client. Upon authorization,
439
- # this list is used to restrict permissions when granting an access
440
- # token.
526
+ # The list of scopes for which authorization is requested. This
527
+ # parameter has no effect; the access token will always include all
528
+ # scopes configured during client registration.
441
529
  #
442
530
  # @option params [String] :redirect_uri
443
- # The location of the application that will receive the authorization
444
- # code. Users authorize the service to send the request to this
445
- # location.
531
+ # Used only when calling this API for the Authorization Code grant type.
532
+ # This value specifies the location of the client or application that
533
+ # has registered to receive the authorization code.
534
+ #
535
+ # @option params [String] :code_verifier
536
+ # Used only when calling this API for the Authorization Code grant type.
537
+ # This value is generated by the client and presented to validate the
538
+ # original code challenge value the client passed at authorization time.
446
539
  #
447
540
  # @return [Types::CreateTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
448
541
  #
@@ -452,6 +545,44 @@ module Aws::SSOOIDC
452
545
  # * {Types::CreateTokenResponse#refresh_token #refresh_token} => String
453
546
  # * {Types::CreateTokenResponse#id_token #id_token} => String
454
547
  #
548
+ #
549
+ # @example Example: Call OAuth/OIDC /token endpoint for Device Code grant with Secret authentication
550
+ #
551
+ # resp = client.create_token({
552
+ # client_id: "_yzkThXVzLWVhc3QtMQEXAMPLECLIENTID",
553
+ # client_secret: "VERYLONGSECRETeyJraWQiOiJrZXktMTU2NDAyODA5OSIsImFsZyI6IkhTMzg0In0",
554
+ # device_code: "yJraWQiOiJrZXktMTU2Njk2ODA4OCIsImFsZyI6IkhTMzIn0EXAMPLEDEVICECODE",
555
+ # grant_type: "urn:ietf:params:oauth:grant-type:device-code",
556
+ # })
557
+ #
558
+ # resp.to_h outputs the following:
559
+ # {
560
+ # access_token: "aoal-YigITUDiNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZidEXAMPLEACCESSTOKEN",
561
+ # expires_in: 1579729529,
562
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
563
+ # token_type: "Bearer",
564
+ # }
565
+ #
566
+ # @example Example: Call OAuth/OIDC /token endpoint for Refresh Token grant with Secret authentication
567
+ #
568
+ # resp = client.create_token({
569
+ # client_id: "_yzkThXVzLWVhc3QtMQEXAMPLECLIENTID",
570
+ # client_secret: "VERYLONGSECRETeyJraWQiOiJrZXktMTU2NDAyODA5OSIsImFsZyI6IkhTMzg0In0",
571
+ # grant_type: "refresh_token",
572
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
573
+ # scope: [
574
+ # "codewhisperer:completions",
575
+ # ],
576
+ # })
577
+ #
578
+ # resp.to_h outputs the following:
579
+ # {
580
+ # access_token: "aoal-YigITUDiNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZidEXAMPLEACCESSTOKEN",
581
+ # expires_in: 1579729529,
582
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
583
+ # token_type: "Bearer",
584
+ # }
585
+ #
455
586
  # @example Request syntax with placeholder values
456
587
  #
457
588
  # resp = client.create_token({
@@ -463,6 +594,7 @@ module Aws::SSOOIDC
463
594
  # refresh_token: "RefreshToken",
464
595
  # scope: ["Scope"],
465
596
  # redirect_uri: "URI",
597
+ # code_verifier: "CodeVerifier",
466
598
  # })
467
599
  #
468
600
  # @example Response structure
@@ -482,9 +614,270 @@ module Aws::SSOOIDC
482
614
  req.send_request(options)
483
615
  end
484
616
 
485
- # Registers a client with IAM Identity Center. This allows clients to
486
- # initiate device authorization. The output should be persisted for
487
- # reuse through many authentication requests.
617
+ # Creates and returns access and refresh tokens for authorized client
618
+ # applications that are authenticated using any IAM entity, such as a
619
+ # service role or user. These tokens might contain defined scopes that
620
+ # specify permissions such as `read:profile` or `write:data`. Through
621
+ # downscoping, you can use the scopes parameter to request tokens with
622
+ # reduced permissions compared to the original client application's
623
+ # permissions or, if applicable, the refresh token's scopes. The access
624
+ # token can be used to fetch short-lived credentials for the assigned
625
+ # Amazon Web Services accounts or to access application APIs using
626
+ # `bearer` authentication.
627
+ #
628
+ # <note markdown="1"> This API is used with Signature Version 4. For more information, see
629
+ # [Amazon Web Services Signature Version 4 for API Requests][1].
630
+ #
631
+ # </note>
632
+ #
633
+ #
634
+ #
635
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html
636
+ #
637
+ # @option params [required, String] :client_id
638
+ # The unique identifier string for the client or application. This value
639
+ # is an application ARN that has OAuth grants configured.
640
+ #
641
+ # @option params [required, String] :grant_type
642
+ # Supports the following OAuth grant types: Authorization Code, Refresh
643
+ # Token, JWT Bearer, and Token Exchange. Specify one of the following
644
+ # values, depending on the grant type that you want:
645
+ #
646
+ # * Authorization Code - `authorization_code`
647
+ #
648
+ # * Refresh Token - `refresh_token`
649
+ #
650
+ # * JWT Bearer - `urn:ietf:params:oauth:grant-type:jwt-bearer`
651
+ #
652
+ # * Token Exchange - `urn:ietf:params:oauth:grant-type:token-exchange`
653
+ #
654
+ # @option params [String] :code
655
+ # Used only when calling this API for the Authorization Code grant type.
656
+ # This short-lived code is used to identify this authorization request.
657
+ # The code is obtained through a redirect from IAM Identity Center to a
658
+ # redirect URI persisted in the Authorization Code GrantOptions for the
659
+ # application.
660
+ #
661
+ # @option params [String] :refresh_token
662
+ # Used only when calling this API for the Refresh Token grant type. This
663
+ # token is used to refresh short-lived tokens, such as the access token,
664
+ # that might expire.
665
+ #
666
+ # For more information about the features and limitations of the current
667
+ # IAM Identity Center OIDC implementation, see *Considerations for Using
668
+ # this Guide* in the [IAM Identity Center OIDC API Reference][1].
669
+ #
670
+ #
671
+ #
672
+ # [1]: https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html
673
+ #
674
+ # @option params [String] :assertion
675
+ # Used only when calling this API for the JWT Bearer grant type. This
676
+ # value specifies the JSON Web Token (JWT) issued by a trusted token
677
+ # issuer. To authorize a trusted token issuer, configure the JWT Bearer
678
+ # GrantOptions for the application.
679
+ #
680
+ # @option params [Array<String>] :scope
681
+ # The list of scopes for which authorization is requested. The access
682
+ # token that is issued is limited to the scopes that are granted. If the
683
+ # value is not specified, IAM Identity Center authorizes all scopes
684
+ # configured for the application, including the following default
685
+ # scopes: `openid`, `aws`, `sts:identity_context`.
686
+ #
687
+ # @option params [String] :redirect_uri
688
+ # Used only when calling this API for the Authorization Code grant type.
689
+ # This value specifies the location of the client or application that
690
+ # has registered to receive the authorization code.
691
+ #
692
+ # @option params [String] :subject_token
693
+ # Used only when calling this API for the Token Exchange grant type.
694
+ # This value specifies the subject of the exchange. The value of the
695
+ # subject token must be an access token issued by IAM Identity Center to
696
+ # a different client or application. The access token must have
697
+ # authorized scopes that indicate the requested application as a target
698
+ # audience.
699
+ #
700
+ # @option params [String] :subject_token_type
701
+ # Used only when calling this API for the Token Exchange grant type.
702
+ # This value specifies the type of token that is passed as the subject
703
+ # of the exchange. The following value is supported:
704
+ #
705
+ # * Access Token - `urn:ietf:params:oauth:token-type:access_token`
706
+ #
707
+ # @option params [String] :requested_token_type
708
+ # Used only when calling this API for the Token Exchange grant type.
709
+ # This value specifies the type of token that the requester can receive.
710
+ # The following values are supported:
711
+ #
712
+ # * Access Token - `urn:ietf:params:oauth:token-type:access_token`
713
+ #
714
+ # * Refresh Token - `urn:ietf:params:oauth:token-type:refresh_token`
715
+ #
716
+ # @option params [String] :code_verifier
717
+ # Used only when calling this API for the Authorization Code grant type.
718
+ # This value is generated by the client and presented to validate the
719
+ # original code challenge value the client passed at authorization time.
720
+ #
721
+ # @return [Types::CreateTokenWithIAMResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
722
+ #
723
+ # * {Types::CreateTokenWithIAMResponse#access_token #access_token} => String
724
+ # * {Types::CreateTokenWithIAMResponse#token_type #token_type} => String
725
+ # * {Types::CreateTokenWithIAMResponse#expires_in #expires_in} => Integer
726
+ # * {Types::CreateTokenWithIAMResponse#refresh_token #refresh_token} => String
727
+ # * {Types::CreateTokenWithIAMResponse#id_token #id_token} => String
728
+ # * {Types::CreateTokenWithIAMResponse#issued_token_type #issued_token_type} => String
729
+ # * {Types::CreateTokenWithIAMResponse#scope #scope} => Array&lt;String&gt;
730
+ # * {Types::CreateTokenWithIAMResponse#aws_additional_details #aws_additional_details} => Types::AwsAdditionalDetails
731
+ #
732
+ #
733
+ # @example Example: Call OAuth/OIDC /token endpoint for Authorization Code grant with IAM authentication
734
+ #
735
+ # resp = client.create_token_with_iam({
736
+ # client_id: "arn:aws:sso::123456789012:application/ssoins-111111111111/apl-222222222222",
737
+ # code: "yJraWQiOiJrZXktMTU2Njk2ODA4OCIsImFsZyI6IkhTMzg0In0EXAMPLEAUTHCODE",
738
+ # grant_type: "authorization_code",
739
+ # redirect_uri: "https://mywebapp.example/redirect",
740
+ # scope: [
741
+ # "openid",
742
+ # "aws",
743
+ # "sts:identity_context",
744
+ # ],
745
+ # })
746
+ #
747
+ # resp.to_h outputs the following:
748
+ # {
749
+ # access_token: "aoal-YigITUDiNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZidEXAMPLEACCESSTOKEN",
750
+ # aws_additional_details: {
751
+ # identity_context: "EXAMPLEIDENTITYCONTEXT",
752
+ # },
753
+ # expires_in: 1579729529,
754
+ # id_token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhd3M6aWRlbnRpdHlfc3RvcmVfaWQiOiJkLTMzMzMzMzMzMzMiLCJzdWIiOiI3MzA0NDhmMi1lMGExLTcwYTctYzk1NC0wMDAwMDAwMDAwMDAiLCJhd3M6aW5zdGFuY2VfYWNjb3VudCI6IjExMTExMTExMTExMSIsInN0czppZGVudGl0eV9jb250ZXh0IjoiRVhBTVBMRUlERU5USVRZQ09OVEVYVCIsInN0czphdWRpdF9jb250ZXh0IjoiRVhBTVBMRUFVRElUQ09OVEVYVCIsImlzcyI6Imh0dHBzOi8vaWRlbnRpdHljZW50ZXIuYW1hem9uYXdzLmNvbS9zc29pbnMtMTExMTExMTExMTExIiwiYXdzOmlkZW50aXR5X3N0b3JlX2FybiI6ImFybjphd3M6aWRlbnRpdHlzdG9yZTo6MTExMTExMTExMTExOmlkZW50aXR5c3RvcmUvZC0zMzMzMzMzMzMzIiwiYXVkIjoiYXJuOmF3czpzc286OjEyMzQ1Njc4OTAxMjphcHBsaWNhdGlvbi9zc29pbnMtMTExMTExMTExMTExL2FwbC0yMjIyMjIyMjIyMjIiLCJhd3M6aW5zdGFuY2VfYXJuIjoiYXJuOmF3czpzc286OjppbnN0YW5jZS9zc29pbnMtMTExMTExMTExMTExIiwiYXdzOmNyZWRlbnRpYWxfaWQiOiJfWlIyTjZhVkJqMjdGUEtheWpfcEtwVjc3QVBERl80MXB4ZXRfWWpJdUpONlVJR2RBdkpFWEFNUExFQ1JFRElEIiwiYXV0aF90aW1lIjoiMjAyMC0wMS0yMlQxMjo0NToyOVoiLCJleHAiOjE1Nzk3Mjk1MjksImlhdCI6MTU3OTcyNTkyOX0.Xyah6qbk78qThzJ41iFU2yfGuRqqtKXHrJYwQ8L9Ip0",
755
+ # issued_token_type: "urn:ietf:params:oauth:token-type:refresh_token",
756
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
757
+ # scope: [
758
+ # "openid",
759
+ # "aws",
760
+ # "sts:identity_context",
761
+ # ],
762
+ # token_type: "Bearer",
763
+ # }
764
+ #
765
+ # @example Example: Call OAuth/OIDC /token endpoint for Refresh Token grant with IAM authentication
766
+ #
767
+ # resp = client.create_token_with_iam({
768
+ # client_id: "arn:aws:sso::123456789012:application/ssoins-111111111111/apl-222222222222",
769
+ # grant_type: "refresh_token",
770
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
771
+ # })
772
+ #
773
+ # resp.to_h outputs the following:
774
+ # {
775
+ # access_token: "aoal-YigITUDiNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZidEXAMPLEACCESSTOKEN",
776
+ # expires_in: 1579729529,
777
+ # issued_token_type: "urn:ietf:params:oauth:token-type:refresh_token",
778
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
779
+ # scope: [
780
+ # "openid",
781
+ # "aws",
782
+ # "sts:identity_context",
783
+ # ],
784
+ # token_type: "Bearer",
785
+ # }
786
+ #
787
+ # @example Example: Call OAuth/OIDC /token endpoint for JWT Bearer grant with IAM authentication
788
+ #
789
+ # resp = client.create_token_with_iam({
790
+ # assertion: "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IjFMVE16YWtpaGlSbGFfOHoyQkVKVlhlV01xbyJ9.eyJ2ZXIiOiIyLjAiLCJpc3MiOiJodHRwczovL2xvZ2luLm1pY3Jvc29mdG9ubGluZS5jb20vOTEyMjA0MGQtNmM2Ny00YzViLWIxMTItMzZhMzA0YjY2ZGFkL3YyLjAiLCJzdWIiOiJBQUFBQUFBQUFBQUFBQUFBQUFBQUFJa3pxRlZyU2FTYUZIeTc4MmJidGFRIiwiYXVkIjoiNmNiMDQwMTgtYTNmNS00NmE3LWI5OTUtOTQwYzc4ZjVhZWYzIiwiZXhwIjoxNTM2MzYxNDExLCJpYXQiOjE1MzYyNzQ3MTEsIm5iZiI6MTUzNjI3NDcxMSwibmFtZSI6IkFiZSBMaW5jb2xuIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiQWJlTGlAbWljcm9zb2Z0LmNvbSIsIm9pZCI6IjAwMDAwMDAwLTAwMDAtMDAwMC02NmYzLTMzMzJlY2E3ZWE4MSIsInRpZCI6IjkxMjIwNDBkLTZjNjctNGM1Yi1iMTEyLTM2YTMwNGI2NmRhZCIsIm5vbmNlIjoiMTIzNTIzIiwiYWlvIjoiRGYyVVZYTDFpeCFsTUNXTVNPSkJjRmF0emNHZnZGR2hqS3Y4cTVnMHg3MzJkUjVNQjVCaXN2R1FPN1lXQnlqZDhpUURMcSFlR2JJRGFreXA1bW5PcmNkcUhlWVNubHRlcFFtUnA2QUlaOGpZIn0.1AFWW-Ck5nROwSlltm7GzZvDwUkqvhSQpm55TQsmVo9Y59cLhRXpvB8n-55HCr9Z6G_31_UbeUkoz612I2j_Sm9FFShSDDjoaLQr54CreGIJvjtmS3EkK9a7SJBbcpL1MpUtlfygow39tFjY7EVNW9plWUvRrTgVk7lYLprvfzw-CIqw3gHC-T7IK_m_xkr08INERBtaecwhTeN4chPC4W3jdmw_lIxzC48YoQ0dB1L9-ImX98Egypfrlbm0IBL5spFzL6JDZIRRJOu8vecJvj1mq-IUhGt0MacxX8jdxYLP-KUu2d9MbNKpCKJuZ7p8gwTL5B7NlUdh_dmSviPWrw",
791
+ # client_id: "arn:aws:sso::123456789012:application/ssoins-111111111111/apl-222222222222",
792
+ # grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
793
+ # })
794
+ #
795
+ # resp.to_h outputs the following:
796
+ # {
797
+ # access_token: "aoal-YigITUDiNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZidEXAMPLEACCESSTOKEN",
798
+ # aws_additional_details: {
799
+ # identity_context: "EXAMPLEIDENTITYCONTEXT",
800
+ # },
801
+ # expires_in: 1579729529,
802
+ # id_token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhd3M6aWRlbnRpdHlfc3RvcmVfaWQiOiJkLTMzMzMzMzMzMzMiLCJzdWIiOiI3MzA0NDhmMi1lMGExLTcwYTctYzk1NC0wMDAwMDAwMDAwMDAiLCJhd3M6aW5zdGFuY2VfYWNjb3VudCI6IjExMTExMTExMTExMSIsInN0czppZGVudGl0eV9jb250ZXh0IjoiRVhBTVBMRUlERU5USVRZQ09OVEVYVCIsInN0czphdWRpdF9jb250ZXh0IjoiRVhBTVBMRUFVRElUQ09OVEVYVCIsImlzcyI6Imh0dHBzOi8vaWRlbnRpdHljZW50ZXIuYW1hem9uYXdzLmNvbS9zc29pbnMtMTExMTExMTExMTExIiwiYXdzOmlkZW50aXR5X3N0b3JlX2FybiI6ImFybjphd3M6aWRlbnRpdHlzdG9yZTo6MTExMTExMTExMTExOmlkZW50aXR5c3RvcmUvZC0zMzMzMzMzMzMzIiwiYXVkIjoiYXJuOmF3czpzc286OjEyMzQ1Njc4OTAxMjphcHBsaWNhdGlvbi9zc29pbnMtMTExMTExMTExMTExL2FwbC0yMjIyMjIyMjIyMjIiLCJhd3M6aW5zdGFuY2VfYXJuIjoiYXJuOmF3czpzc286OjppbnN0YW5jZS9zc29pbnMtMTExMTExMTExMTExIiwiYXdzOmNyZWRlbnRpYWxfaWQiOiJfWlIyTjZhVkJqMjdGUEtheWpfcEtwVjc3QVBERl80MXB4ZXRfWWpJdUpONlVJR2RBdkpFWEFNUExFQ1JFRElEIiwiYXV0aF90aW1lIjoiMjAyMC0wMS0yMlQxMjo0NToyOVoiLCJleHAiOjE1Nzk3Mjk1MjksImlhdCI6MTU3OTcyNTkyOX0.Xyah6qbk78qThzJ41iFU2yfGuRqqtKXHrJYwQ8L9Ip0",
803
+ # issued_token_type: "urn:ietf:params:oauth:token-type:refresh_token",
804
+ # refresh_token: "aorvJYubGpU6i91YnH7Mfo-AT2fIVa1zCfA_Rvq9yjVKIP3onFmmykuQ7E93y2I-9Nyj-A_sVvMufaLNL0bqnDRtgAkc0:MGUCMFrRsktMRVlWaOR70XGMFGLL0SlcCw4DiYveIiOVx1uK9BbD0gvAddsW3UTLozXKMgIxAJ3qxUvjpnlLIOaaKOoa/FuNgqJVvr9GMwDtnAtlh9iZzAkEXAMPLEREFRESHTOKEN",
805
+ # scope: [
806
+ # "openid",
807
+ # "aws",
808
+ # "sts:identity_context",
809
+ # ],
810
+ # token_type: "Bearer",
811
+ # }
812
+ #
813
+ # @example Example: Call OAuth/OIDC /token endpoint for Token Exchange grant with IAM authentication
814
+ #
815
+ # resp = client.create_token_with_iam({
816
+ # client_id: "arn:aws:sso::123456789012:application/ssoins-111111111111/apl-222222222222",
817
+ # grant_type: "urn:ietf:params:oauth:grant-type:token-exchange",
818
+ # requested_token_type: "urn:ietf:params:oauth:token-type:access_token",
819
+ # subject_token: "aoak-Hig8TUDPNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZDIFFERENTACCESSTOKEN",
820
+ # subject_token_type: "urn:ietf:params:oauth:token-type:access_token",
821
+ # })
822
+ #
823
+ # resp.to_h outputs the following:
824
+ # {
825
+ # access_token: "aoal-YigITUDiNX1xZwOMXM5MxOWDL0E0jg9P6_C_jKQPxS_SKCP6f0kh1Up4g7TtvQqkMnD-GJiU_S1gvug6SrggAkc0:MGYCMQD3IatVjV7jAJU91kK3PkS/SfA2wtgWzOgZWDOR7sDGN9t0phCZz5It/aes/3C1Zj0CMQCKWOgRaiz6AIhza3DSXQNMLjRKXC8F8ceCsHlgYLMZ7hZidEXAMPLEACCESSTOKEN",
826
+ # aws_additional_details: {
827
+ # identity_context: "EXAMPLEIDENTITYCONTEXT",
828
+ # },
829
+ # expires_in: 1579729529,
830
+ # id_token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhd3M6aWRlbnRpdHlfc3RvcmVfaWQiOiJkLTMzMzMzMzMzMzMiLCJzdWIiOiI3MzA0NDhmMi1lMGExLTcwYTctYzk1NC0wMDAwMDAwMDAwMDAiLCJhd3M6aW5zdGFuY2VfYWNjb3VudCI6IjExMTExMTExMTExMSIsInN0czppZGVudGl0eV9jb250ZXh0IjoiRVhBTVBMRUlERU5USVRZQ09OVEVYVCIsImlzcyI6Imh0dHBzOi8vaWRlbnRpdHljZW50ZXIuYW1hem9uYXdzLmNvbS9zc29pbnMtMTExMTExMTExMTExIiwiYXdzOmlkZW50aXR5X3N0b3JlX2FybiI6ImFybjphd3M6aWRlbnRpdHlzdG9yZTo6MTExMTExMTExMTExOmlkZW50aXR5c3RvcmUvZC0zMzMzMzMzMzMzIiwiYXVkIjoiYXJuOmF3czpzc286OjEyMzQ1Njc4OTAxMjphcHBsaWNhdGlvbi9zc29pbnMtMTExMTExMTExMTExL2FwbC0yMjIyMjIyMjIyMjIiLCJhd3M6aW5zdGFuY2VfYXJuIjoiYXJuOmF3czpzc286OjppbnN0YW5jZS9zc29pbnMtMTExMTExMTExMTExIiwiYXdzOmNyZWRlbnRpYWxfaWQiOiJfWlIyTjZhVkJqMjdGUEtheWpfcEtwVjc3QVBERl80MXB4ZXRfWWpJdUpONlVJR2RBdkpFWEFNUExFQ1JFRElEIiwiYXV0aF90aW1lIjoiMjAyMC0wMS0yMlQxMjo0NToyOVoiLCJleHAiOjE1Nzk3Mjk1MjksImlhdCI6MTU3OTcyNTkyOX0.5SYiW1kMsuUr7nna-l5tlakM0GNbMHvIM2_n0QD23jM",
831
+ # issued_token_type: "urn:ietf:params:oauth:token-type:access_token",
832
+ # scope: [
833
+ # "openid",
834
+ # "aws",
835
+ # "sts:identity_context",
836
+ # ],
837
+ # token_type: "Bearer",
838
+ # }
839
+ #
840
+ # @example Request syntax with placeholder values
841
+ #
842
+ # resp = client.create_token_with_iam({
843
+ # client_id: "ClientId", # required
844
+ # grant_type: "GrantType", # required
845
+ # code: "AuthCode",
846
+ # refresh_token: "RefreshToken",
847
+ # assertion: "Assertion",
848
+ # scope: ["Scope"],
849
+ # redirect_uri: "URI",
850
+ # subject_token: "SubjectToken",
851
+ # subject_token_type: "TokenTypeURI",
852
+ # requested_token_type: "TokenTypeURI",
853
+ # code_verifier: "CodeVerifier",
854
+ # })
855
+ #
856
+ # @example Response structure
857
+ #
858
+ # resp.access_token #=> String
859
+ # resp.token_type #=> String
860
+ # resp.expires_in #=> Integer
861
+ # resp.refresh_token #=> String
862
+ # resp.id_token #=> String
863
+ # resp.issued_token_type #=> String
864
+ # resp.scope #=> Array
865
+ # resp.scope[0] #=> String
866
+ # resp.aws_additional_details.identity_context #=> String
867
+ #
868
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/CreateTokenWithIAM AWS API Documentation
869
+ #
870
+ # @overload create_token_with_iam(params = {})
871
+ # @param [Hash] params ({})
872
+ def create_token_with_iam(params = {}, options = {})
873
+ req = build_request(:create_token_with_iam, params)
874
+ req.send_request(options)
875
+ end
876
+
877
+ # Registers a public client with IAM Identity Center. This allows
878
+ # clients to perform authorization using the authorization
879
+ # code grant with Proof Key for Code Exchange (PKCE) or the device
880
+ # code grant.
488
881
  #
489
882
  # @option params [required, String] :client_name
490
883
  # The friendly name of the client.
@@ -498,6 +891,35 @@ module Aws::SSOOIDC
498
891
  # this list is used to restrict permissions when granting an access
499
892
  # token.
500
893
  #
894
+ # @option params [Array<String>] :redirect_uris
895
+ # The list of redirect URI that are defined by the client. At completion
896
+ # of authorization, this list is used to restrict what locations the
897
+ # user agent can be redirected back to.
898
+ #
899
+ # @option params [Array<String>] :grant_types
900
+ # The list of OAuth 2.0 grant types that are defined by the client. This
901
+ # list is used to restrict the token granting flows available to the
902
+ # client. Supports the following OAuth 2.0 grant types: Authorization
903
+ # Code, Device Code, and Refresh Token.
904
+ #
905
+ # * Authorization Code - `authorization_code`
906
+ #
907
+ # * Device Code - `urn:ietf:params:oauth:grant-type:device_code`
908
+ #
909
+ # * Refresh Token - `refresh_token`
910
+ #
911
+ # @option params [String] :issuer_url
912
+ # The IAM Identity Center Issuer URL associated with an instance of IAM
913
+ # Identity Center. This value is needed for user access to resources
914
+ # through the client.
915
+ #
916
+ # @option params [String] :entitled_application_arn
917
+ # This IAM Identity Center application ARN is used to define
918
+ # administrator-managed configuration for public client access to
919
+ # resources. At authorization, the scopes, grants, and redirect URI
920
+ # available to this client will be restricted by this application
921
+ # resource.
922
+ #
501
923
  # @return [Types::RegisterClientResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
502
924
  #
503
925
  # * {Types::RegisterClientResponse#client_id #client_id} => String
@@ -507,12 +929,45 @@ module Aws::SSOOIDC
507
929
  # * {Types::RegisterClientResponse#authorization_endpoint #authorization_endpoint} => String
508
930
  # * {Types::RegisterClientResponse#token_endpoint #token_endpoint} => String
509
931
  #
932
+ #
933
+ # @example Example: Call OAuth/OIDC /register-client endpoint
934
+ #
935
+ # resp = client.register_client({
936
+ # client_name: "My IDE Plugin",
937
+ # client_type: "public",
938
+ # entitled_application_arn: "arn:aws:sso::ACCOUNTID:application/ssoins-1111111111111111/apl-1111111111111111",
939
+ # grant_types: [
940
+ # "authorization_code",
941
+ # "refresh_token",
942
+ # ],
943
+ # issuer_url: "https://identitycenter.amazonaws.com/ssoins-1111111111111111",
944
+ # redirect_uris: [
945
+ # "127.0.0.1:PORT/oauth/callback",
946
+ # ],
947
+ # scopes: [
948
+ # "sso:account:access",
949
+ # "codewhisperer:completions",
950
+ # ],
951
+ # })
952
+ #
953
+ # resp.to_h outputs the following:
954
+ # {
955
+ # client_id: "_yzkThXVzLWVhc3QtMQEXAMPLECLIENTID",
956
+ # client_id_issued_at: 1579725929,
957
+ # client_secret: "VERYLONGSECRETeyJraWQiOiJrZXktMTU2NDAyODA5OSIsImFsZyI6IkhTMzg0In0",
958
+ # client_secret_expires_at: 1587584729,
959
+ # }
960
+ #
510
961
  # @example Request syntax with placeholder values
511
962
  #
512
963
  # resp = client.register_client({
513
964
  # client_name: "ClientName", # required
514
965
  # client_type: "ClientType", # required
515
966
  # scopes: ["Scope"],
967
+ # redirect_uris: ["URI"],
968
+ # grant_types: ["GrantType"],
969
+ # issuer_url: "URI",
970
+ # entitled_application_arn: "ArnType",
516
971
  # })
517
972
  #
518
973
  # @example Response structure
@@ -546,8 +1001,9 @@ module Aws::SSOOIDC
546
1001
  # come from the persisted result of the RegisterClient API operation.
547
1002
  #
548
1003
  # @option params [required, String] :start_url
549
- # The URL for the AWS access portal. For more information, see [Using
550
- # the AWS access portal][1] in the *IAM Identity Center User Guide*.
1004
+ # The URL for the Amazon Web Services access portal. For more
1005
+ # information, see [Using the Amazon Web Services access portal][1] in
1006
+ # the *IAM Identity Center User Guide*.
551
1007
  #
552
1008
  #
553
1009
  #
@@ -562,6 +1018,25 @@ module Aws::SSOOIDC
562
1018
  # * {Types::StartDeviceAuthorizationResponse#expires_in #expires_in} => Integer
563
1019
  # * {Types::StartDeviceAuthorizationResponse#interval #interval} => Integer
564
1020
  #
1021
+ #
1022
+ # @example Example: Call OAuth/OIDC /start-device-authorization endpoint
1023
+ #
1024
+ # resp = client.start_device_authorization({
1025
+ # client_id: "_yzkThXVzLWVhc3QtMQEXAMPLECLIENTID",
1026
+ # client_secret: "VERYLONGSECRETeyJraWQiOiJrZXktMTU2NDAyODA5OSIsImFsZyI6IkhTMzg0In0",
1027
+ # start_url: "https://identitycenter.amazonaws.com/ssoins-111111111111",
1028
+ # })
1029
+ #
1030
+ # resp.to_h outputs the following:
1031
+ # {
1032
+ # device_code: "yJraWQiOiJrZXktMTU2Njk2ODA4OCIsImFsZyI6IkhTMzIn0EXAMPLEDEVICECODE",
1033
+ # expires_in: 1579729529,
1034
+ # interval: 1,
1035
+ # user_code: "makdfsk83yJraWQiOiJrZXktMTU2Njk2sImFsZyI6IkhTMzIn0EXAMPLEUSERCODE",
1036
+ # verification_uri: "https://directory-alias-example.awsapps.com/start/#/device",
1037
+ # verification_uri_complete: "https://directory-alias-example.awsapps.com/start/#/device?user_code=makdfsk83yJraWQiOiJrZXktMTU2Njk2sImFsZyI6IkhTMzIn0EXAMPLEUSERCODE",
1038
+ # }
1039
+ #
565
1040
  # @example Request syntax with placeholder values
566
1041
  #
567
1042
  # resp = client.start_device_authorization({
@@ -594,14 +1069,19 @@ module Aws::SSOOIDC
594
1069
  # @api private
595
1070
  def build_request(operation_name, params = {})
596
1071
  handlers = @handlers.for(operation_name)
1072
+ tracer = config.telemetry_provider.tracer_provider.tracer(
1073
+ Aws::Telemetry.module_to_tracer_name('Aws::SSOOIDC')
1074
+ )
597
1075
  context = Seahorse::Client::RequestContext.new(
598
1076
  operation_name: operation_name,
599
1077
  operation: config.api.operation(operation_name),
600
1078
  client: self,
601
1079
  params: params,
602
- config: config)
1080
+ config: config,
1081
+ tracer: tracer
1082
+ )
603
1083
  context[:gem_name] = 'aws-sdk-core'
604
- context[:gem_version] = '3.178.0'
1084
+ context[:gem_version] = '3.233.0'
605
1085
  Seahorse::Client::Request.new(handlers, context)
606
1086
  end
607
1087