aws-sdk-iamtoolbox 1.12.0 → 1.14.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d9ee21cc02525204b5579d152c130c6f29b784c5c837be6f7cba547040806eec
4
- data.tar.gz: 3fe78b9ba57235d30ee21ad551cfda79474c7cb998c4d1a80c2077f32c5fa118
3
+ metadata.gz: e67be3f2efc389ffca9b66084a6138c742d4cea1d3a919e3ba80b35cc617af98
4
+ data.tar.gz: 8158cd15bcac006583869a3fa5b2cb7fb5e83a2c21fbd153f1903401db66ae7a
5
5
  SHA512:
6
- metadata.gz: 9c1d0ef20523c5991e4c8b62f48d1313e841373e9d77d629bc3c3f0a1c2e3018e3486e1e593886df59cc3683afb6d6e662abfc69e57292528cc23ff546a9cbf4
7
- data.tar.gz: 4acef870d37a21621b0628ba50ae41758d8620dd7dd4465f8c6b6a76c78fd0e2ca8ff2c3f84c0c203bc62960fec2968dc96686abc25b7df7ac70b30e1e6e710c
6
+ metadata.gz: 8545d7efdcf1416ea1a4eef6bcb9ebd9c6bbe357361893f835724de39cb4a2aa0eaa76f35781472d388626d00f25a5b14c62d77492c3ddce94cd6b4c01ac313d
7
+ data.tar.gz: f23071411e2790e2d7e81d0e9a8bd6e581749065c205d09ad57f800ab739f9dccb34cc559eb30654a11a2c24969f4b571a77c23df656cad6d500637f73452093
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.14.0 (2026-11-18)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.13.0 (2026-11-16)
10
+ ------------------
11
+
12
+ * Feature - AWS IAM adds the GetRequestAuthorizationPolicy operation, per-check authorization results (checks) and extra policy metadata for resource-based policies (policySource) in GetRequestAuthorizationDetails for Access Troubleshooter.
13
+
4
14
  1.12.0 (2026-11-11)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.12.0
1
+ 1.14.0
@@ -490,6 +490,9 @@ module Aws::IAMToolbox
490
490
  # services include an authorization ID in the access denied error
491
491
  # message. Pass that ID to this operation to retrieve the details.
492
492
  #
493
+ # To retrieve the content for a policy in the `policies` list, call
494
+ # `GetRequestAuthorizationPolicy`.
495
+ #
493
496
  # Authorization details are available for at least 24 hours after the
494
497
  # denial.
495
498
  #
@@ -516,7 +519,7 @@ module Aws::IAMToolbox
516
519
  # @example Request syntax with placeholder values
517
520
  #
518
521
  # resp = client.get_request_authorization_details({
519
- # authorization_id: "GetRequestAuthorizationDetailsInputAuthorizationIdString", # required
522
+ # authorization_id: "AuthorizationId", # required
520
523
  # next_token: "String",
521
524
  # })
522
525
  #
@@ -533,12 +536,25 @@ module Aws::IAMToolbox
533
536
  # resp.evaluations[0].matched_policies[0].matched_statements #=> Array
534
537
  # resp.evaluations[0].matched_policies[0].matched_statements[0].sid #=> String
535
538
  # resp.evaluations[0].matched_policies[0].matched_statements[0].evaluated_effect #=> String, one of "ALLOW", "DENY"
539
+ # resp.evaluations[0].checks #=> Array
540
+ # resp.evaluations[0].checks[0].check_type #=> String, one of "SERVICE_CONTROL_POLICY", "RESOURCE_CONTROL_POLICY", "VPC_ENDPOINT", "RESOURCE", "PRINCIPAL", "PERMISSIONS_BOUNDARY", "SESSION"
541
+ # resp.evaluations[0].checks[0].evaluated_effect #=> String, one of "ALLOW", "NO_IMPACT", "IMPLICIT_DENY", "EXPLICIT_DENY"
542
+ # resp.evaluations[0].checks[0].target_arn #=> String
543
+ # resp.evaluations[0].checks[0].relevant_policy_types #=> Array
544
+ # resp.evaluations[0].checks[0].relevant_policy_types[0] #=> String, one of "IDENTITY_BASED_POLICY", "RESOURCE_BASED_POLICY", "PERMISSIONS_BOUNDARY", "SESSION_POLICY", "SERVICE_CONTROL_POLICY", "RESOURCE_CONTROL_POLICY", "VPC_ENDPOINT_POLICY"
545
+ # resp.evaluations[0].checks[0].matched_policies #=> Array
546
+ # resp.evaluations[0].checks[0].matched_policies[0].uri #=> String
547
+ # resp.evaluations[0].checks[0].matched_policies[0].matched_statements #=> Array
548
+ # resp.evaluations[0].checks[0].matched_policies[0].matched_statements[0].sid #=> String
549
+ # resp.evaluations[0].checks[0].matched_policies[0].matched_statements[0].evaluated_effect #=> String, one of "ALLOW", "DENY"
536
550
  # resp.policies #=> Array
537
551
  # resp.policies[0].type #=> String, one of "IDENTITY_BASED_POLICY", "RESOURCE_BASED_POLICY", "PERMISSIONS_BOUNDARY", "SESSION_POLICY", "SERVICE_CONTROL_POLICY", "RESOURCE_CONTROL_POLICY", "VPC_ENDPOINT_POLICY"
538
552
  # resp.policies[0].inline #=> Boolean
539
553
  # resp.policies[0].uri #=> String
540
554
  # resp.policies[0].attached_to #=> Array
541
555
  # resp.policies[0].attached_to[0].arn #=> String
556
+ # resp.policies[0].policy_source #=> Hash
557
+ # resp.policies[0].policy_source["String"] #=> String
542
558
  # resp.next_token #=> String
543
559
  #
544
560
  # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/GetRequestAuthorizationDetails AWS API Documentation
@@ -550,6 +566,60 @@ module Aws::IAMToolbox
550
566
  req.send_request(options)
551
567
  end
552
568
 
569
+ # Retrieves a policy that was evaluated for a specific access denied
570
+ # request. The operation returns the structured JSON document of the
571
+ # policy that was captured with the original authorization request. It
572
+ # doesn't retrieve the current version of the policy.
573
+ #
574
+ # For some AWS services and policy types, the returned policy document
575
+ # includes all actions relevant to the service that processed the denied
576
+ # request, but might omit actions for other services.
577
+ #
578
+ # Specify the authorization ID from the access denied error message and
579
+ # the policy URI returned by `GetRequestAuthorizationDetails` for the
580
+ # same authorization ID.
581
+ #
582
+ # Access depends on the account and organization recorded for the
583
+ # principal that made the denied request. If an organization was
584
+ # recorded, the calling principal must belong to that organization.
585
+ # Otherwise, the calling principal must belong to the recorded account.
586
+ #
587
+ # To use this operation, you must have the
588
+ # `iam:GetRequestAuthorizationPolicy` permission.
589
+ #
590
+ # @option params [required, String] :authorization_id
591
+ # The authorization ID received in the access denied error message. This
592
+ # ID identifies the request whose evaluated policy you want to retrieve.
593
+ #
594
+ # @option params [required, String] :policy_uri
595
+ # The URI of the policy to retrieve. Use the `uri` value from the
596
+ # `policies` list returned by `GetRequestAuthorizationDetails` for the
597
+ # same authorization ID.
598
+ #
599
+ # @return [Types::GetRequestAuthorizationPolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
600
+ #
601
+ # * {Types::GetRequestAuthorizationPolicyOutput#policy_document #policy_document} => Hash,Array,String,Numeric,Boolean
602
+ #
603
+ # @example Request syntax with placeholder values
604
+ #
605
+ # resp = client.get_request_authorization_policy({
606
+ # authorization_id: "AuthorizationId", # required
607
+ # policy_uri: "PolicyUri", # required
608
+ # })
609
+ #
610
+ # @example Response structure
611
+ #
612
+ #
613
+ #
614
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/GetRequestAuthorizationPolicy AWS API Documentation
615
+ #
616
+ # @overload get_request_authorization_policy(params = {})
617
+ # @param [Hash] params ({})
618
+ def get_request_authorization_policy(params = {}, options = {})
619
+ req = build_request(:get_request_authorization_policy, params)
620
+ req.send_request(options)
621
+ end
622
+
553
623
  # @!endgroup
554
624
 
555
625
  # @param params ({})
@@ -568,7 +638,7 @@ module Aws::IAMToolbox
568
638
  tracer: tracer
569
639
  )
570
640
  context[:gem_name] = 'aws-sdk-iamtoolbox'
571
- context[:gem_version] = '1.12.0'
641
+ context[:gem_version] = '1.14.0'
572
642
  Seahorse::Client::Request.new(handlers, context)
573
643
  end
574
644
 
@@ -19,14 +19,20 @@ module Aws::IAMToolbox
19
19
  AttachedToArnString = Shapes::StringShape.new(name: 'AttachedToArnString')
20
20
  AttachedToList = Shapes::ListShape.new(name: 'AttachedToList')
21
21
  AuthorizationContext = Shapes::MapShape.new(name: 'AuthorizationContext')
22
+ AuthorizationId = Shapes::StringShape.new(name: 'AuthorizationId')
22
23
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
24
+ Check = Shapes::StructureShape.new(name: 'Check')
25
+ CheckEffect = Shapes::StringShape.new(name: 'CheckEffect')
26
+ CheckList = Shapes::ListShape.new(name: 'CheckList')
27
+ CheckType = Shapes::StringShape.new(name: 'CheckType')
23
28
  Document = Shapes::DocumentShape.new(name: 'Document', document: true)
24
29
  EvaluatedEffect = Shapes::StringShape.new(name: 'EvaluatedEffect')
25
30
  Evaluation = Shapes::StructureShape.new(name: 'Evaluation')
26
31
  Evaluations = Shapes::ListShape.new(name: 'Evaluations')
27
32
  GetRequestAuthorizationDetailsInput = Shapes::StructureShape.new(name: 'GetRequestAuthorizationDetailsInput')
28
- GetRequestAuthorizationDetailsInputAuthorizationIdString = Shapes::StringShape.new(name: 'GetRequestAuthorizationDetailsInputAuthorizationIdString')
29
33
  GetRequestAuthorizationDetailsOutput = Shapes::StructureShape.new(name: 'GetRequestAuthorizationDetailsOutput')
34
+ GetRequestAuthorizationPolicyInput = Shapes::StructureShape.new(name: 'GetRequestAuthorizationPolicyInput')
35
+ GetRequestAuthorizationPolicyOutput = Shapes::StructureShape.new(name: 'GetRequestAuthorizationPolicyOutput')
30
36
  InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
31
37
  MatchedPolicy = Shapes::StructureShape.new(name: 'MatchedPolicy')
32
38
  MatchedPolicyList = Shapes::ListShape.new(name: 'MatchedPolicyList')
@@ -34,7 +40,10 @@ module Aws::IAMToolbox
34
40
  MatchedStatementList = Shapes::ListShape.new(name: 'MatchedStatementList')
35
41
  PolicyInfo = Shapes::StructureShape.new(name: 'PolicyInfo')
36
42
  PolicyInfoList = Shapes::ListShape.new(name: 'PolicyInfoList')
43
+ PolicySource = Shapes::MapShape.new(name: 'PolicySource')
37
44
  PolicyType = Shapes::StringShape.new(name: 'PolicyType')
45
+ PolicyTypeList = Shapes::ListShape.new(name: 'PolicyTypeList')
46
+ PolicyUri = Shapes::StringShape.new(name: 'PolicyUri')
38
47
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
39
48
  StatementEffect = Shapes::StringShape.new(name: 'StatementEffect')
40
49
  String = Shapes::StringShape.new(name: 'String')
@@ -51,16 +60,26 @@ module Aws::IAMToolbox
51
60
  AuthorizationContext.key = Shapes::ShapeRef.new(shape: String)
52
61
  AuthorizationContext.value = Shapes::ShapeRef.new(shape: Document)
53
62
 
63
+ Check.add_member(:check_type, Shapes::ShapeRef.new(shape: CheckType, required: true, location_name: "checkType"))
64
+ Check.add_member(:evaluated_effect, Shapes::ShapeRef.new(shape: CheckEffect, required: true, location_name: "evaluatedEffect"))
65
+ Check.add_member(:target_arn, Shapes::ShapeRef.new(shape: String, location_name: "targetArn"))
66
+ Check.add_member(:relevant_policy_types, Shapes::ShapeRef.new(shape: PolicyTypeList, location_name: "relevantPolicyTypes"))
67
+ Check.add_member(:matched_policies, Shapes::ShapeRef.new(shape: MatchedPolicyList, location_name: "matchedPolicies"))
68
+ Check.struct_class = Types::Check
69
+
70
+ CheckList.member = Shapes::ShapeRef.new(shape: Check)
71
+
54
72
  Evaluation.add_member(:action, Shapes::ShapeRef.new(shape: String, required: true, location_name: "action"))
55
73
  Evaluation.add_member(:resource, Shapes::ShapeRef.new(shape: String, required: true, location_name: "resource"))
56
74
  Evaluation.add_member(:context, Shapes::ShapeRef.new(shape: AuthorizationContext, location_name: "context"))
57
75
  Evaluation.add_member(:evaluated_effect, Shapes::ShapeRef.new(shape: EvaluatedEffect, location_name: "evaluatedEffect"))
58
- Evaluation.add_member(:matched_policies, Shapes::ShapeRef.new(shape: MatchedPolicyList, location_name: "matchedPolicies"))
76
+ Evaluation.add_member(:matched_policies, Shapes::ShapeRef.new(shape: MatchedPolicyList, deprecated: true, location_name: "matchedPolicies", metadata: {"deprecatedMessage" => "Use checks, which group matched policies by the requirement they apply to.", "deprecatedSince" => "2026-11-13"}))
77
+ Evaluation.add_member(:checks, Shapes::ShapeRef.new(shape: CheckList, location_name: "checks"))
59
78
  Evaluation.struct_class = Types::Evaluation
60
79
 
61
80
  Evaluations.member = Shapes::ShapeRef.new(shape: Evaluation)
62
81
 
63
- GetRequestAuthorizationDetailsInput.add_member(:authorization_id, Shapes::ShapeRef.new(shape: GetRequestAuthorizationDetailsInputAuthorizationIdString, required: true, location: "uri", location_name: "authorizationId"))
82
+ GetRequestAuthorizationDetailsInput.add_member(:authorization_id, Shapes::ShapeRef.new(shape: AuthorizationId, required: true, location: "uri", location_name: "authorizationId"))
64
83
  GetRequestAuthorizationDetailsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location: "querystring", location_name: "nextToken"))
65
84
  GetRequestAuthorizationDetailsInput.struct_class = Types::GetRequestAuthorizationDetailsInput
66
85
 
@@ -70,6 +89,13 @@ module Aws::IAMToolbox
70
89
  GetRequestAuthorizationDetailsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
71
90
  GetRequestAuthorizationDetailsOutput.struct_class = Types::GetRequestAuthorizationDetailsOutput
72
91
 
92
+ GetRequestAuthorizationPolicyInput.add_member(:authorization_id, Shapes::ShapeRef.new(shape: AuthorizationId, required: true, location: "uri", location_name: "authorizationId"))
93
+ GetRequestAuthorizationPolicyInput.add_member(:policy_uri, Shapes::ShapeRef.new(shape: PolicyUri, required: true, location: "querystring", location_name: "policyUri"))
94
+ GetRequestAuthorizationPolicyInput.struct_class = Types::GetRequestAuthorizationPolicyInput
95
+
96
+ GetRequestAuthorizationPolicyOutput.add_member(:policy_document, Shapes::ShapeRef.new(shape: Document, required: true, location_name: "policyDocument"))
97
+ GetRequestAuthorizationPolicyOutput.struct_class = Types::GetRequestAuthorizationPolicyOutput
98
+
73
99
  InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
74
100
  InternalServerException.struct_class = Types::InternalServerException
75
101
 
@@ -89,10 +115,16 @@ module Aws::IAMToolbox
89
115
  PolicyInfo.add_member(:inline, Shapes::ShapeRef.new(shape: Boolean, location_name: "inline"))
90
116
  PolicyInfo.add_member(:uri, Shapes::ShapeRef.new(shape: String, location_name: "uri"))
91
117
  PolicyInfo.add_member(:attached_to, Shapes::ShapeRef.new(shape: AttachedToList, location_name: "attachedTo"))
118
+ PolicyInfo.add_member(:policy_source, Shapes::ShapeRef.new(shape: PolicySource, location_name: "policySource"))
92
119
  PolicyInfo.struct_class = Types::PolicyInfo
93
120
 
94
121
  PolicyInfoList.member = Shapes::ShapeRef.new(shape: PolicyInfo)
95
122
 
123
+ PolicySource.key = Shapes::ShapeRef.new(shape: String)
124
+ PolicySource.value = Shapes::ShapeRef.new(shape: String)
125
+
126
+ PolicyTypeList.member = Shapes::ShapeRef.new(shape: PolicyType)
127
+
96
128
  ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
97
129
  ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
98
130
 
@@ -134,6 +166,18 @@ module Aws::IAMToolbox
134
166
  }
135
167
  )
136
168
  end)
169
+
170
+ api.add_operation(:get_request_authorization_policy, Seahorse::Model::Operation.new.tap do |o|
171
+ o.name = "GetRequestAuthorizationPolicy"
172
+ o.http_method = "GET"
173
+ o.http_request_uri = "/authorization-details/{authorizationId}/policy"
174
+ o.input = Shapes::ShapeRef.new(shape: GetRequestAuthorizationPolicyInput)
175
+ o.output = Shapes::ShapeRef.new(shape: GetRequestAuthorizationPolicyOutput)
176
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
177
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
178
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
179
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
180
+ end)
137
181
  end
138
182
 
139
183
  end
@@ -46,6 +46,86 @@ module Aws::IAMToolbox
46
46
  include Aws::Structure
47
47
  end
48
48
 
49
+ # Represents one authorization requirement considered during an
50
+ # evaluation and its result.
51
+ #
52
+ # @!attribute [rw] check_type
53
+ # The type of requirement that the check evaluates. Valid values:
54
+ #
55
+ # * `SERVICE_CONTROL_POLICY` - The service control policies (SCPs)
56
+ # attached to one organization target, such as a root,
57
+ # organizational unit, or account, that apply to the principal.
58
+ #
59
+ # * `RESOURCE_CONTROL_POLICY` - The resource control policies (RCPs)
60
+ # attached to one organization target that apply to the resource.
61
+ #
62
+ # * `VPC_ENDPOINT` - The VPC endpoint policy for the endpoint through
63
+ # which the request passes.
64
+ #
65
+ # * `RESOURCE` - The resource owner's resource-based policies, when
66
+ # the owner must allow the request separately, such as a
67
+ # cross-account request or a request to an AWS KMS key.
68
+ #
69
+ # * `PRINCIPAL` - The principal's identity-based policies attached to
70
+ # the IAM user or role.
71
+ #
72
+ # * `PERMISSIONS_BOUNDARY` - The permissions boundary on the IAM user
73
+ # or role.
74
+ #
75
+ # * `SESSION` - The role session that made the request, decided by its
76
+ # session policies.
77
+ # @return [String]
78
+ #
79
+ # @!attribute [rw] evaluated_effect
80
+ # The result of evaluating this requirement. Valid values:
81
+ #
82
+ # * `ALLOW` - A statement that applies to this check allows the
83
+ # request.
84
+ #
85
+ # * `EXPLICIT_DENY` - A deny statement that applies to this check
86
+ # matches.
87
+ #
88
+ # * `IMPLICIT_DENY` - The check required an allow and nothing that
89
+ # applies to it allows the request.
90
+ #
91
+ # * `NO_IMPACT` - No statement in this check matched, and no allow was
92
+ # needed because another path allowed the request.
93
+ # @return [String]
94
+ #
95
+ # @!attribute [rw] target_arn
96
+ # The ARN that distinguishes this check from other checks of the same
97
+ # type. This value is absent when the check type alone identifies the
98
+ # check. For SCP and RCP checks, this is the AWS Organizations ARN of
99
+ # the root, organizational unit, or account that the evaluated
100
+ # policies are attached to.
101
+ # @return [String]
102
+ #
103
+ # @!attribute [rw] relevant_policy_types
104
+ # The policy types used to satisfy this check, plus the type of every
105
+ # policy with a statement that matched in it. `matchedPolicies` lists
106
+ # matching policies in the top-level `policies` list.
107
+ # @return [Array<String>]
108
+ #
109
+ # @!attribute [rw] matched_policies
110
+ # Policies in this list have statements that matched for this check.
111
+ # Each URI corresponds to an entry in the top-level `policies` list.
112
+ # Only policies in the top-level list are included. The check effect
113
+ # can reflect a matched policy omitted from this list, so this list
114
+ # can be empty even when the effect is `ALLOW`.
115
+ # @return [Array<Types::MatchedPolicy>]
116
+ #
117
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/Check AWS API Documentation
118
+ #
119
+ class Check < Struct.new(
120
+ :check_type,
121
+ :evaluated_effect,
122
+ :target_arn,
123
+ :relevant_policy_types,
124
+ :matched_policies)
125
+ SENSITIVE = []
126
+ include Aws::Structure
127
+ end
128
+
49
129
  # Represents an individual evaluation for a single action and resource
50
130
  # pair. This includes the context, the resulting effect, and any
51
131
  # policies that matched.
@@ -72,15 +152,44 @@ module Aws::IAMToolbox
72
152
  #
73
153
  # * `EXPLICIT_DENY` - The action was explicitly denied by a policy.
74
154
  #
75
- # * `IMPLICIT_DENY` - The action was denied because no policy allowed
76
- # it.
155
+ # * `IMPLICIT_DENY` - The action was denied because at least one
156
+ # required authorization check had no matching allow statement.
77
157
  # @return [String]
78
158
  #
79
159
  # @!attribute [rw] matched_policies
80
- # The policies that matched during evaluation of this action and
81
- # resource. An implicit denial produces no matched policies.
160
+ # `matchedPolicies` is deprecated. Use `checks` instead. This value
161
+ # contains the policies that matched during evaluation of this action
162
+ # and resource.
82
163
  # @return [Array<Types::MatchedPolicy>]
83
164
  #
165
+ # @!attribute [rw] checks
166
+ # `checks` contains the authorization checks that explain an
167
+ # evaluation result. Each check is one authorization requirement and
168
+ # reports its result and policies from the top-level `policies` list
169
+ # with matching statements. The output lists RCP checks from the
170
+ # organization root to the account, then SCP checks from the
171
+ # organization root to the account. It then lists VPC endpoint,
172
+ # resource, principal, permissions boundary, and session checks. When
173
+ # `checks` is present, an `EXPLICIT_DENY` evaluation includes an
174
+ # `EXPLICIT_DENY` check. When `checks` is present for an
175
+ # `IMPLICIT_DENY` evaluation, it includes an `IMPLICIT_DENY` check and
176
+ # no `EXPLICIT_DENY` check. For more information about how IAM
177
+ # evaluates policies, see [Policy evaluation logic][1].
178
+ #
179
+ # `PRINCIPAL`, `PERMISSIONS_BOUNDARY`, and `SESSION` checks appear
180
+ # when they apply to the principal that made the request, even if none
181
+ # of their policies matched. A missing allow produces `IMPLICIT_DENY`,
182
+ # or `NO_IMPACT` when another path already allowed the request.
183
+ #
184
+ # Returned when the caller is in the request principal's account or
185
+ # organization. The absence of `checks` does not mean no authorization
186
+ # checks applied.
187
+ #
188
+ #
189
+ #
190
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic_policy-eval-denyallow.html
191
+ # @return [Array<Types::Check>]
192
+ #
84
193
  # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/Evaluation AWS API Documentation
85
194
  #
86
195
  class Evaluation < Struct.new(
@@ -88,7 +197,8 @@ module Aws::IAMToolbox
88
197
  :resource,
89
198
  :context,
90
199
  :evaluated_effect,
91
- :matched_policies)
200
+ :matched_policies,
201
+ :checks)
92
202
  SENSITIVE = []
93
203
  include Aws::Structure
94
204
  end
@@ -143,6 +253,44 @@ module Aws::IAMToolbox
143
253
  include Aws::Structure
144
254
  end
145
255
 
256
+ # @!attribute [rw] authorization_id
257
+ # The authorization ID received in the access denied error message.
258
+ # This ID identifies the request whose evaluated policy you want to
259
+ # retrieve.
260
+ # @return [String]
261
+ #
262
+ # @!attribute [rw] policy_uri
263
+ # The URI of the policy to retrieve. Use the `uri` value from the
264
+ # `policies` list returned by `GetRequestAuthorizationDetails` for the
265
+ # same authorization ID.
266
+ # @return [String]
267
+ #
268
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/GetRequestAuthorizationPolicyInput AWS API Documentation
269
+ #
270
+ class GetRequestAuthorizationPolicyInput < Struct.new(
271
+ :authorization_id,
272
+ :policy_uri)
273
+ SENSITIVE = []
274
+ include Aws::Structure
275
+ end
276
+
277
+ # @!attribute [rw] policy_document
278
+ # The policy document evaluated for the denied request, returned as a
279
+ # JSON object.
280
+ #
281
+ # For some AWS services and policy types, this document includes all
282
+ # actions relevant to the service that processed the denied request,
283
+ # but might omit actions for other services.
284
+ # @return [Hash,Array,String,Numeric,Boolean]
285
+ #
286
+ # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/GetRequestAuthorizationPolicyOutput AWS API Documentation
287
+ #
288
+ class GetRequestAuthorizationPolicyOutput < Struct.new(
289
+ :policy_document)
290
+ SENSITIVE = []
291
+ include Aws::Structure
292
+ end
293
+
146
294
  # An unexpected error occurred while processing the request. Try again.
147
295
  #
148
296
  # @!attribute [rw] message
@@ -207,7 +355,8 @@ module Aws::IAMToolbox
207
355
 
208
356
  # Contains details about a policy evaluated during authorization.
209
357
  # Details include the policy type, whether it is inline or managed, a
210
- # URI that identifies it, and the entities it is attached to.
358
+ # URI that identifies it, the entities it is attached to, and its
359
+ # source, if present.
211
360
  #
212
361
  # @!attribute [rw] type
213
362
  # The type of policy. Valid values:
@@ -218,7 +367,9 @@ module Aws::IAMToolbox
218
367
  # * `PERMISSIONS_BOUNDARY` - A permissions boundary for an IAM entity.
219
368
  #
220
369
  # * `RESOURCE_BASED_POLICY` - A resource-based policy attached to a
221
- # resource.
370
+ # resource. An AWS service can evaluate and report a policy kind it
371
+ # defines, such as a KMS grant, as `RESOURCE_BASED_POLICY`.
372
+ # `policySource` identifies the kind.
222
373
  #
223
374
  # * `RESOURCE_CONTROL_POLICY` - A resource control policy (RCP) in AWS
224
375
  # Organizations.
@@ -239,8 +390,10 @@ module Aws::IAMToolbox
239
390
  #
240
391
  # @!attribute [rw] uri
241
392
  # A URI that identifies the policy. Use this URI to cross-reference
242
- # the policy with the matching policies in each evaluation. The value
243
- # depends on the policy type:
393
+ # the policy with the matching policies in each evaluation. To
394
+ # retrieve the policy document, pass this URI as the `policyUri`
395
+ # parameter of `GetRequestAuthorizationPolicy`, together with the same
396
+ # authorization ID. The value depends on the policy type:
244
397
  #
245
398
  # * For managed policies, this is the policy ARN.
246
399
  #
@@ -255,22 +408,44 @@ module Aws::IAMToolbox
255
408
  # entities at different levels of the organization hierarchy.
256
409
  # @return [Array<Types::AttachedTo>]
257
410
  #
411
+ # @!attribute [rw] policy_source
412
+ # What the policy was built from, such as a KMS key policy or grant.
413
+ # Absent for other policies.
414
+ #
415
+ # The `type` and `typeName` keys are always present. `type` identifies
416
+ # the policy-source kind. `typeName` is its readable name. Compare
417
+ # `type`, not `typeName`.
418
+ #
419
+ # A policy source can include additional keys that depend on its type.
420
+ # For example, a KMS grant includes a `grantId` key that identifies
421
+ # the grant. A grant has no ARN. Use the grant ID with the KMS key ARN
422
+ # in `attachedTo` to find the grant with the AWS KMS `ListGrants`
423
+ # operation.
424
+ #
425
+ # New types and keys can be added, so clients should ignore types and
426
+ # keys they don't recognize.
427
+ # @return [Hash<String,String>]
428
+ #
258
429
  # @see http://docs.aws.amazon.com/goto/WebAPI/iam-toolbox-2018-05-10/PolicyInfo AWS API Documentation
259
430
  #
260
431
  class PolicyInfo < Struct.new(
261
432
  :type,
262
433
  :inline,
263
434
  :uri,
264
- :attached_to)
435
+ :attached_to,
436
+ :policy_source)
265
437
  SENSITIVE = []
266
438
  include Aws::Structure
267
439
  end
268
440
 
269
- # The requested authorization details do not exist in this region or
270
- # have expired. Verify that the authorization ID from the access denied
271
- # error message is correct and the call is made in the region where the
272
- # denial occurred. Ensure that the calling principal belongs to the same
273
- # account or organization as the original denied request.
441
+ # The requested policy or authorization details do not exist in this
442
+ # region or have expired. Verify that the authorization ID from the
443
+ # access denied error message is correct and the call is made in the
444
+ # region where the denial occurred. Ensure that the calling principal
445
+ # belongs to the same account or organization as the original denied
446
+ # request. If you specified a policy URI, verify that it is from the
447
+ # `policies` list that `GetRequestAuthorizationDetails` returns for the
448
+ # same authorization ID.
274
449
  #
275
450
  # @!attribute [rw] message
276
451
  # @return [String]
@@ -55,7 +55,7 @@ module Aws::IAMToolbox
55
55
  autoload :EndpointProvider, 'aws-sdk-iamtoolbox/endpoint_provider'
56
56
  autoload :Endpoints, 'aws-sdk-iamtoolbox/endpoints'
57
57
 
58
- GEM_VERSION = '1.12.0'
58
+ GEM_VERSION = '1.14.0'
59
59
 
60
60
  end
61
61
 
data/sig/client.rbs CHANGED
@@ -92,6 +92,17 @@ module Aws
92
92
  ?next_token: ::String
93
93
  ) -> _GetRequestAuthorizationDetailsResponseSuccess
94
94
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetRequestAuthorizationDetailsResponseSuccess
95
+
96
+ interface _GetRequestAuthorizationPolicyResponseSuccess
97
+ include ::Seahorse::Client::_ResponseSuccess[Types::GetRequestAuthorizationPolicyOutput]
98
+ def policy_document: () -> untyped
99
+ end
100
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IAMToolbox/Client.html#get_request_authorization_policy-instance_method
101
+ def get_request_authorization_policy: (
102
+ authorization_id: ::String,
103
+ policy_uri: ::String
104
+ ) -> _GetRequestAuthorizationPolicyResponseSuccess
105
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetRequestAuthorizationPolicyResponseSuccess
95
106
  end
96
107
  end
97
108
  end
data/sig/types.rbs CHANGED
@@ -18,12 +18,22 @@ module Aws::IAMToolbox
18
18
  SENSITIVE: []
19
19
  end
20
20
 
21
+ class Check
22
+ attr_accessor check_type: ("SERVICE_CONTROL_POLICY" | "RESOURCE_CONTROL_POLICY" | "VPC_ENDPOINT" | "RESOURCE" | "PRINCIPAL" | "PERMISSIONS_BOUNDARY" | "SESSION")
23
+ attr_accessor evaluated_effect: ("ALLOW" | "NO_IMPACT" | "IMPLICIT_DENY" | "EXPLICIT_DENY")
24
+ attr_accessor target_arn: ::String
25
+ attr_accessor relevant_policy_types: ::Array[("IDENTITY_BASED_POLICY" | "RESOURCE_BASED_POLICY" | "PERMISSIONS_BOUNDARY" | "SESSION_POLICY" | "SERVICE_CONTROL_POLICY" | "RESOURCE_CONTROL_POLICY" | "VPC_ENDPOINT_POLICY")]
26
+ attr_accessor matched_policies: ::Array[Types::MatchedPolicy]
27
+ SENSITIVE: []
28
+ end
29
+
21
30
  class Evaluation
22
31
  attr_accessor action: ::String
23
32
  attr_accessor resource: ::String
24
33
  attr_accessor context: ::Hash[::String, untyped]
25
34
  attr_accessor evaluated_effect: ("ALLOW" | "EXPLICIT_DENY" | "IMPLICIT_DENY")
26
35
  attr_accessor matched_policies: ::Array[Types::MatchedPolicy]
36
+ attr_accessor checks: ::Array[Types::Check]
27
37
  SENSITIVE: []
28
38
  end
29
39
 
@@ -41,6 +51,17 @@ module Aws::IAMToolbox
41
51
  SENSITIVE: []
42
52
  end
43
53
 
54
+ class GetRequestAuthorizationPolicyInput
55
+ attr_accessor authorization_id: ::String
56
+ attr_accessor policy_uri: ::String
57
+ SENSITIVE: []
58
+ end
59
+
60
+ class GetRequestAuthorizationPolicyOutput
61
+ attr_accessor policy_document: untyped
62
+ SENSITIVE: []
63
+ end
64
+
44
65
  class InternalServerException
45
66
  attr_accessor message: ::String
46
67
  SENSITIVE: []
@@ -63,6 +84,7 @@ module Aws::IAMToolbox
63
84
  attr_accessor inline: bool
64
85
  attr_accessor uri: ::String
65
86
  attr_accessor attached_to: ::Array[Types::AttachedTo]
87
+ attr_accessor policy_source: ::Hash[::String, ::String]
66
88
  SENSITIVE: []
67
89
  end
68
90
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-iamtoolbox
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.12.0
4
+ version: 1.14.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
@@ -18,7 +18,7 @@ dependencies:
18
18
  version: '3'
19
19
  - - ">="
20
20
  - !ruby/object:Gem::Version
21
- version: 3.268.0
21
+ version: 3.270.0
22
22
  type: :runtime
23
23
  prerelease: false
24
24
  version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
28
28
  version: '3'
29
29
  - - ">="
30
30
  - !ruby/object:Gem::Version
31
- version: 3.268.0
31
+ version: 3.270.0
32
32
  - !ruby/object:Gem::Dependency
33
33
  name: aws-sigv4
34
34
  requirement: !ruby/object:Gem::Requirement