aws-sdk-core 3.270.0 → 3.271.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.
@@ -55,16 +55,6 @@ module Aws::STS
55
55
  # Web Services Service Namespaces][1] in the Amazon Web Services
56
56
  # General Reference.
57
57
  #
58
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
59
- # session policy, managed policy ARNs, and session tags into a packed
60
- # binary format that has a separate limit. Your request can fail for
61
- # this limit even if your plaintext meets the other requirements. The
62
- # `PackedPolicySize` response element indicates by percentage how
63
- # close the policies and tags for your request are to the upper size
64
- # limit.
65
- #
66
- # </note>
67
- #
68
58
  # Passing policies to this operation returns new temporary
69
59
  # credentials. The resulting session's permissions are the
70
60
  # intersection of the role's identity-based policy and the session
@@ -102,16 +92,6 @@ module Aws::STS
102
92
  # include the tab (\\u0009), linefeed (\\u000A), and carriage return
103
93
  # (\\u000D) characters.
104
94
  #
105
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
106
- # session policy, managed policy ARNs, and session tags into a packed
107
- # binary format that has a separate limit. Your request can fail for
108
- # this limit even if your plaintext meets the other requirements. The
109
- # `PackedPolicySize` response element indicates by percentage how
110
- # close the policies and tags for your request are to the upper size
111
- # limit.
112
- #
113
- # </note>
114
- #
115
95
  # For more information about role session permissions, see [Session
116
96
  # policies][1].
117
97
  #
@@ -170,16 +150,6 @@ module Aws::STS
170
150
  # values can’t exceed 256 characters. For these and additional limits,
171
151
  # see [IAM and STS Character Limits][2] in the *IAM User Guide*.
172
152
  #
173
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
174
- # session policy, managed policy ARNs, and session tags into a packed
175
- # binary format that has a separate limit. Your request can fail for
176
- # this limit even if your plaintext meets the other requirements. The
177
- # `PackedPolicySize` response element indicates by percentage how
178
- # close the policies and tags for your request are to the upper size
179
- # limit.
180
- #
181
- # </note>
182
- #
183
153
  # You can pass a session tag with the same key as a tag that is
184
154
  # already attached to the role. When you do, session tags override a
185
155
  # role tag with the same key.
@@ -368,10 +338,10 @@ module Aws::STS
368
338
  # @return [Types::AssumedRoleUser]
369
339
  #
370
340
  # @!attribute [rw] packed_policy_size
371
- # A percentage value that indicates the packed size of the session
372
- # policies and session tags combined passed in the request. The
373
- # request fails if the packed size is greater than 100 percent, which
374
- # means the policies and tags exceeded the allowed space.
341
+ # The percentage (0-100) of the maximum allowed session token size
342
+ # that the returned session token consumes.
343
+ #
344
+ # This field is deprecated. Use `SessionTokenUtilization` instead.
375
345
  # @return [Integer]
376
346
  #
377
347
  # @!attribute [rw] source_identity
@@ -454,16 +424,6 @@ module Aws::STS
454
424
  # Web Services Service Namespaces][1] in the Amazon Web Services
455
425
  # General Reference.
456
426
  #
457
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
458
- # session policy, managed policy ARNs, and session tags into a packed
459
- # binary format that has a separate limit. Your request can fail for
460
- # this limit even if your plaintext meets the other requirements. The
461
- # `PackedPolicySize` response element indicates by percentage how
462
- # close the policies and tags for your request are to the upper size
463
- # limit.
464
- #
465
- # </note>
466
- #
467
427
  # Passing policies to this operation returns new temporary
468
428
  # credentials. The resulting session's permissions are the
469
429
  # intersection of the role's identity-based policy and the session
@@ -504,16 +464,6 @@ module Aws::STS
504
464
  # For more information about role session permissions, see [Session
505
465
  # policies][1].
506
466
  #
507
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
508
- # session policy, managed policy ARNs, and session tags into a packed
509
- # binary format that has a separate limit. Your request can fail for
510
- # this limit even if your plaintext meets the other requirements. The
511
- # `PackedPolicySize` response element indicates by percentage how
512
- # close the policies and tags for your request are to the upper size
513
- # limit.
514
- #
515
- # </note>
516
- #
517
467
  #
518
468
  #
519
469
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
@@ -595,15 +545,20 @@ module Aws::STS
595
545
  # @return [Types::AssumedRoleUser]
596
546
  #
597
547
  # @!attribute [rw] packed_policy_size
598
- # A percentage value that indicates the packed size of the session
599
- # policies and session tags combined passed in the request. The
600
- # request fails if the packed size is greater than 100 percent, which
601
- # means the policies and tags exceeded the allowed space.
548
+ # The percentage (0-100) of the maximum allowed session token size
549
+ # that the returned session token consumes.
550
+ #
551
+ # This field is deprecated. Use `SessionTokenUtilization` instead.
602
552
  # @return [Integer]
603
553
  #
604
554
  # @!attribute [rw] subject
605
555
  # The value of the `NameID` element in the `Subject` element of the
606
556
  # SAML assertion.
557
+ #
558
+ # This is not the trusted identity propagation subject
559
+ # (`aws:OriginIdentity/Subject`). When the session carries trusted
560
+ # identity propagation context, that value is returned in
561
+ # `TrustedIdentityPropagationContext`.
607
562
  # @return [String]
608
563
  #
609
564
  # @!attribute [rw] subject_type
@@ -616,10 +571,20 @@ module Aws::STS
616
571
  # For example, `urn:oasis:names:tc:SAML:2.0:nameid-format:transient`
617
572
  # is returned as `transient`. If the format includes any other prefix,
618
573
  # the format is returned with no modifications.
574
+ #
575
+ # This is not the trusted identity propagation subject type
576
+ # (`aws:OriginIdentity/SubjectType`). When the session carries trusted
577
+ # identity propagation context, that value is returned in
578
+ # `TrustedIdentityPropagationContext`.
619
579
  # @return [String]
620
580
  #
621
581
  # @!attribute [rw] issuer
622
582
  # The value of the `Issuer` element of the SAML assertion.
583
+ #
584
+ # This is not the trusted identity propagation issuer
585
+ # (`aws:OriginIdentity/Issuer`). When the session carries trusted
586
+ # identity propagation context, that value is returned in
587
+ # `TrustedIdentityPropagationContext`.
623
588
  # @return [String]
624
589
  #
625
590
  # @!attribute [rw] audience
@@ -687,6 +652,31 @@ module Aws::STS
687
652
  # for this response.
688
653
  # @return [Integer]
689
654
  #
655
+ # @!attribute [rw] trusted_identity_propagation_context
656
+ # The trusted identity propagation context that Amazon Web Services
657
+ # STS set in the session from the SAML assertion, through the context
658
+ # provider attached to the SAML identity provider. It is present only
659
+ # when Amazon Web Services STS set such context in the session. It
660
+ # contains the `aws:OriginIdentity/Subject`,
661
+ # `aws:OriginIdentity/SubjectType`, `aws:OriginIdentity/Issuer` and
662
+ # `aws:OriginIdentity/FederatedProviderArn` keys and the
663
+ # `aws:TransactionContext/IdentityProvider/*` keys that Amazon Web
664
+ # Services STS set in the session. Other keys in the session, such as
665
+ # `aws:IdentityCenterInstanceArn` and `aws:IdentityStoreArn` for an
666
+ # identity provider with an Identity Center instance attached, are not
667
+ # returned.
668
+ #
669
+ # Its `OriginIdentity` members share the names `Subject`,
670
+ # `SubjectType` and `Issuer` with members of this response but carry
671
+ # the trusted identity propagation values, which differ from the SAML
672
+ # assertion values.
673
+ #
674
+ # It is not returned when the SAML assertion is encrypted, even though
675
+ # the session carries the context.
676
+ #
677
+ # This element contains information about the end user. Do not log it.
678
+ # @return [Types::TrustedIdentityPropagationContext]
679
+ #
690
680
  # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/AssumeRoleWithSAMLResponse AWS API Documentation
691
681
  #
692
682
  class AssumeRoleWithSAMLResponse < Struct.new(
@@ -700,8 +690,9 @@ module Aws::STS
700
690
  :name_qualifier,
701
691
  :source_identity,
702
692
  :session_token_utilization,
703
- :session_token_size)
704
- SENSITIVE = []
693
+ :session_token_size,
694
+ :trusted_identity_propagation_context)
695
+ SENSITIVE = [:trusted_identity_propagation_context]
705
696
  include Aws::Structure
706
697
  end
707
698
 
@@ -788,16 +779,6 @@ module Aws::STS
788
779
  # Web Services Service Namespaces][1] in the Amazon Web Services
789
780
  # General Reference.
790
781
  #
791
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
792
- # session policy, managed policy ARNs, and session tags into a packed
793
- # binary format that has a separate limit. Your request can fail for
794
- # this limit even if your plaintext meets the other requirements. The
795
- # `PackedPolicySize` response element indicates by percentage how
796
- # close the policies and tags for your request are to the upper size
797
- # limit.
798
- #
799
- # </note>
800
- #
801
782
  # Passing policies to this operation returns new temporary
802
783
  # credentials. The resulting session's permissions are the
803
784
  # intersection of the role's identity-based policy and the session
@@ -838,16 +819,6 @@ module Aws::STS
838
819
  # For more information about role session permissions, see [Session
839
820
  # policies][1].
840
821
  #
841
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
842
- # session policy, managed policy ARNs, and session tags into a packed
843
- # binary format that has a separate limit. Your request can fail for
844
- # this limit even if your plaintext meets the other requirements. The
845
- # `PackedPolicySize` response element indicates by percentage how
846
- # close the policies and tags for your request are to the upper size
847
- # limit.
848
- #
849
- # </note>
850
- #
851
822
  #
852
823
  #
853
824
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
@@ -940,10 +911,10 @@ module Aws::STS
940
911
  # @return [Types::AssumedRoleUser]
941
912
  #
942
913
  # @!attribute [rw] packed_policy_size
943
- # A percentage value that indicates the packed size of the session
944
- # policies and session tags combined passed in the request. The
945
- # request fails if the packed size is greater than 100 percent, which
946
- # means the policies and tags exceeded the allowed space.
914
+ # The percentage (0-100) of the maximum allowed session token size
915
+ # that the returned session token consumes.
916
+ #
917
+ # This field is deprecated. Use `SessionTokenUtilization` instead.
947
918
  # @return [Integer]
948
919
  #
949
920
  # @!attribute [rw] provider
@@ -1002,6 +973,23 @@ module Aws::STS
1002
973
  # for this response.
1003
974
  # @return [Integer]
1004
975
  #
976
+ # @!attribute [rw] trusted_identity_propagation_context
977
+ # The trusted identity propagation context that Amazon Web Services
978
+ # STS set in the session from the web identity token, through the
979
+ # context provider attached to the OpenID Connect identity provider.
980
+ # It is present only when Amazon Web Services STS set such context in
981
+ # the session. It contains the `aws:OriginIdentity/Subject`,
982
+ # `aws:OriginIdentity/SubjectType`, `aws:OriginIdentity/Issuer` and
983
+ # `aws:OriginIdentity/FederatedProviderArn` keys and the
984
+ # `aws:TransactionContext/IdentityProvider/*` keys that Amazon Web
985
+ # Services STS set in the session. Other keys in the session, such as
986
+ # `aws:IdentityCenterInstanceArn` and `aws:IdentityStoreArn` for an
987
+ # identity provider with an Identity Center instance attached, are not
988
+ # returned.
989
+ #
990
+ # This element contains information about the end user. Do not log it.
991
+ # @return [Types::TrustedIdentityPropagationContext]
992
+ #
1005
993
  # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/AssumeRoleWithWebIdentityResponse AWS API Documentation
1006
994
  #
1007
995
  class AssumeRoleWithWebIdentityResponse < Struct.new(
@@ -1013,8 +1001,9 @@ module Aws::STS
1013
1001
  :audience,
1014
1002
  :source_identity,
1015
1003
  :session_token_utilization,
1016
- :session_token_size)
1017
- SENSITIVE = []
1004
+ :session_token_size,
1005
+ :trusted_identity_propagation_context)
1006
+ SENSITIVE = [:trusted_identity_propagation_context]
1018
1007
  include Aws::Structure
1019
1008
  end
1020
1009
 
@@ -1356,10 +1345,8 @@ module Aws::STS
1356
1345
  # @return [Types::Credentials]
1357
1346
  #
1358
1347
  # @!attribute [rw] packed_policy_size
1359
- # The percentage of the maximum policy size that is used by the
1360
- # session policy. The policy size is calculated as the sum of all the
1361
- # session policies and permission boundaries attached to the session.
1362
- # If the packed size exceeds 100%, the request fails.
1348
+ # This field is deprecated. It is not populated for
1349
+ # `GetDelegatedAccessToken`.
1363
1350
  # @return [Integer]
1364
1351
  #
1365
1352
  # @!attribute [rw] assumed_principal
@@ -1426,16 +1413,6 @@ module Aws::STS
1426
1413
  # include the tab (\\u0009), linefeed (\\u000A), and carriage return
1427
1414
  # (\\u000D) characters.
1428
1415
  #
1429
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
1430
- # session policy, managed policy ARNs, and session tags into a packed
1431
- # binary format that has a separate limit. Your request can fail for
1432
- # this limit even if your plaintext meets the other requirements. The
1433
- # `PackedPolicySize` response element indicates by percentage how
1434
- # close the policies and tags for your request are to the upper size
1435
- # limit.
1436
- #
1437
- # </note>
1438
- #
1439
1416
  #
1440
1417
  #
1441
1418
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
@@ -1476,16 +1453,6 @@ module Aws::STS
1476
1453
  # are granted in addition to the permissions that are granted by the
1477
1454
  # session policies.
1478
1455
  #
1479
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
1480
- # session policy, managed policy ARNs, and session tags into a packed
1481
- # binary format that has a separate limit. Your request can fail for
1482
- # this limit even if your plaintext meets the other requirements. The
1483
- # `PackedPolicySize` response element indicates by percentage how
1484
- # close the policies and tags for your request are to the upper size
1485
- # limit.
1486
- #
1487
- # </note>
1488
- #
1489
1456
  #
1490
1457
  #
1491
1458
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
@@ -1512,16 +1479,6 @@ module Aws::STS
1512
1479
  # values can’t exceed 256 characters. For these and additional limits,
1513
1480
  # see [IAM and STS Character Limits][2] in the *IAM User Guide*.
1514
1481
  #
1515
- # <note markdown="1"> An Amazon Web Services conversion compresses the passed inline
1516
- # session policy, managed policy ARNs, and session tags into a packed
1517
- # binary format that has a separate limit. Your request can fail for
1518
- # this limit even if your plaintext meets the other requirements. The
1519
- # `PackedPolicySize` response element indicates by percentage how
1520
- # close the policies and tags for your request are to the upper size
1521
- # limit.
1522
- #
1523
- # </note>
1524
- #
1525
1482
  # You can pass a session tag with the same key as a tag that is
1526
1483
  # already attached to the user you are federating. When you do,
1527
1484
  # session tags override a user tag with the same key.
@@ -1584,10 +1541,10 @@ module Aws::STS
1584
1541
  # @return [Types::FederatedUser]
1585
1542
  #
1586
1543
  # @!attribute [rw] packed_policy_size
1587
- # A percentage value that indicates the packed size of the session
1588
- # policies and session tags combined passed in the request. The
1589
- # request fails if the packed size is greater than 100 percent, which
1590
- # means the policies and tags exceeded the allowed space.
1544
+ # The percentage (0-100) of the maximum allowed session token size
1545
+ # that the returned session token consumes.
1546
+ #
1547
+ # This field is deprecated. Use `SessionTokenUtilization` instead.
1591
1548
  # @return [Integer]
1592
1549
  #
1593
1550
  # @!attribute [rw] session_token_utilization
@@ -1612,6 +1569,139 @@ module Aws::STS
1612
1569
  include Aws::Structure
1613
1570
  end
1614
1571
 
1572
+ # @!attribute [rw] policy
1573
+ # An IAM policy in JSON format that you want to use as a scope down
1574
+ # policy.
1575
+ #
1576
+ # A request must provide at least one of `Policy` or
1577
+ # `DurationSeconds`. Both parameters are optional individually, but
1578
+ # you must specify at least one of them.
1579
+ #
1580
+ # The resulting session's permissions are the intersection of the
1581
+ # calling session's existing permissions and this scope down policy.
1582
+ # You cannot use this scope down policy to grant more permissions than
1583
+ # the calling session already has.
1584
+ #
1585
+ # The plaintext of the scope down policy cannot exceed 2,048
1586
+ # characters. The JSON policy characters can be any ASCII character
1587
+ # from the space character to the end of the valid character list
1588
+ # (\\u0020 through \\u00FF). It can also include the tab (\\u0009),
1589
+ # linefeed (\\u000A), and carriage return (\\u000D) characters.
1590
+ #
1591
+ # <note markdown="1"> An internal conversion compresses the inline scope down policy into
1592
+ # a packed binary format that has a separate limit. If the packed
1593
+ # policy exceeds this limit, the request fails with
1594
+ # `PackedPolicyTooLarge`.
1595
+ #
1596
+ # If the document is not valid IAM policy JSON, the request fails with
1597
+ # `MalformedPolicyDocument`.
1598
+ #
1599
+ # </note>
1600
+ # @return [String]
1601
+ #
1602
+ # @!attribute [rw] duration_seconds
1603
+ # The duration, in seconds, of the resulting scoped down credentials.
1604
+ # The value can range from 1 second to 129,600 seconds (36 hours).
1605
+ #
1606
+ # If you do not specify this value, the scoped down credentials will
1607
+ # inherit the calling session's expiration time.
1608
+ # @return [Integer]
1609
+ #
1610
+ # @!attribute [rw] minimum_session_token_size
1611
+ # The minimum size, in bytes, of the session token that STS issues for
1612
+ # the request. STS increases the session token to at least this size,
1613
+ # regardless of its actual content. The value must not exceed 4,096
1614
+ # bytes. When set to 0 or not specified, the session token size is
1615
+ # unchanged.
1616
+ # @return [Integer]
1617
+ #
1618
+ # @!attribute [rw] scoped_session_description
1619
+ # A caller-supplied description of the scoped session. The value
1620
+ # cannot exceed 256 characters. This description is logged to
1621
+ # CloudTrail for the request, so you can use it to record the purpose
1622
+ # of the scoped session.
1623
+ # @return [String]
1624
+ #
1625
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/GetScopedCredentialsRequest AWS API Documentation
1626
+ #
1627
+ class GetScopedCredentialsRequest < Struct.new(
1628
+ :policy,
1629
+ :duration_seconds,
1630
+ :minimum_session_token_size,
1631
+ :scoped_session_description)
1632
+ SENSITIVE = []
1633
+ include Aws::Structure
1634
+ end
1635
+
1636
+ # Contains the response to a successful GetScopedCredentials request,
1637
+ # including the scoped-down temporary Amazon Web Services credentials
1638
+ # and metadata about the resulting session.
1639
+ #
1640
+ # @!attribute [rw] credentials
1641
+ # The temporary security credentials for the scoped down session,
1642
+ # which include an access key ID, a secret access key, and a security
1643
+ # token.
1644
+ #
1645
+ # <note markdown="1"> The size of the security token that STS API operations return is not
1646
+ # fixed. We strongly recommend that you make no assumptions about the
1647
+ # maximum size.
1648
+ #
1649
+ # </note>
1650
+ # @return [Types::Credentials]
1651
+ #
1652
+ # @!attribute [rw] session_info
1653
+ # Metadata about the resulting scoped session, including its
1654
+ # identifier and ARN. Because the identity does not change, the
1655
+ # identifiers reflect the same principal and session name as the
1656
+ # calling session.
1657
+ # @return [Types::ScopedSession]
1658
+ #
1659
+ # @!attribute [rw] session_token_utilization
1660
+ # The percentage (0-100) of the maximum allowed session token size
1661
+ # that the returned session token consumes.
1662
+ # @return [Integer]
1663
+ #
1664
+ # @!attribute [rw] session_token_size
1665
+ # The size, in bytes, of the session token returned in the Credentials
1666
+ # for this response.
1667
+ # @return [Integer]
1668
+ #
1669
+ # @!attribute [rw] scoped_policies_count
1670
+ # `GetScopedCredentials` can be called recursively and
1671
+ # `ScopedPoliciesCount` specifies the number of scope down policies
1672
+ # applied to the session. Each recursive call adds another scope down
1673
+ # policy layer. A maximum of 3 scope down policy layers are allowed
1674
+ # per session. If a session already has 3 `GetScopedCredentials`
1675
+ # scope-down policies, a subsequent `GetScopedCredentials` call that
1676
+ # supplies a `Policy` (attempting to append a fourth scope-down
1677
+ # policy) is denied.
1678
+ # @return [Integer]
1679
+ #
1680
+ # @!attribute [rw] source_identity
1681
+ # The source identity of the calling session, carried forward
1682
+ # unchanged. This operation never sets or modifies the source
1683
+ # identity; it reflects the value established when the source identity
1684
+ # was first set. For more information, see [Monitor and control
1685
+ # actions taken with assumed roles][1] in the IAM User Guide.
1686
+ #
1687
+ #
1688
+ #
1689
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_control-access_monitor.html
1690
+ # @return [String]
1691
+ #
1692
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/GetScopedCredentialsResponse AWS API Documentation
1693
+ #
1694
+ class GetScopedCredentialsResponse < Struct.new(
1695
+ :credentials,
1696
+ :session_info,
1697
+ :session_token_utilization,
1698
+ :session_token_size,
1699
+ :scoped_policies_count,
1700
+ :source_identity)
1701
+ SENSITIVE = []
1702
+ include Aws::Structure
1703
+ end
1704
+
1615
1705
  # @!attribute [rw] duration_seconds
1616
1706
  # The duration, in seconds, that the credentials should remain valid.
1617
1707
  # Acceptable durations for IAM user sessions range from 900 seconds
@@ -1727,6 +1817,68 @@ module Aws::STS
1727
1817
  # using P-384 curve with SHA-384).
1728
1818
  # @return [String]
1729
1819
  #
1820
+ # @!attribute [rw] scope
1821
+ # One or more OAuth 2.0 scope values to include in the JSON Web Token
1822
+ # (JWT). Amazon Web Services STS copies the value exactly as you send
1823
+ # it into the top-level `scope` claim of the token. If you don't
1824
+ # specify `Scope`, the token doesn't include a `scope` claim.
1825
+ #
1826
+ # Separate multiple values with a single space, as defined in [RFC
1827
+ # 6749, section 3.3][1] on the IETF website. Don't begin or end
1828
+ # `Scope` with a space. Each scope value can contain printable ASCII
1829
+ # characters except spaces, double quotation marks (`"`), commas
1830
+ # (`,`), and backslashes (``).
1831
+ #
1832
+ # You can't repeat a scope value. Scope values are case sensitive.
1833
+ # This means that `read` and `READ` are separate values.
1834
+ #
1835
+ # You can specify `Scope` only when `SubjectMode` is `OriginIdentity`
1836
+ # and you request exactly one audience. To specify `Scope`, the
1837
+ # calling principal must have permission for the
1838
+ # `sts:SetWebIdentityTokenScope` action in addition to
1839
+ # `sts:GetWebIdentityToken`. You can use the multivalued
1840
+ # `sts:IdentityTokenScope` condition key in a policy to control which
1841
+ # scope values a principal can request.
1842
+ #
1843
+ #
1844
+ #
1845
+ # [1]: https://www.rfc-editor.org/rfc/rfc6749#section-3.3
1846
+ # @return [String]
1847
+ #
1848
+ # @!attribute [rw] subject_mode
1849
+ # Specifies which identity STS puts in the `sub` (subject) claim of
1850
+ # the JSON Web Token (JWT). Valid values are `AWSIdentity` and
1851
+ # `OriginIdentity`. If you don't specify a value, Amazon Web Services
1852
+ # STS uses `AWSIdentity`.
1853
+ #
1854
+ # * `AWSIdentity` – The `sub` claim contains the ARN of the calling
1855
+ # Amazon Web Services principal.
1856
+ #
1857
+ # * `OriginIdentity` – The `sub` claim contains the value of the
1858
+ # `aws:OriginIdentity/Subject` key in the trusted identity
1859
+ # propagation context of the calling session. For example, this can
1860
+ # identify the human user or workload on whose behalf the calling
1861
+ # session acts. Amazon Web Services STS also adds a `subject_mode`
1862
+ # claim to the token.
1863
+ #
1864
+ # To use `OriginIdentity`, the trusted identity propagation context
1865
+ # of the calling session must contain the
1866
+ # `aws:OriginIdentity/Subject` key and either the
1867
+ # `aws:OriginIdentity/Issuer` key or the
1868
+ # `aws:OriginIdentity/FederatedProviderArn` key. If it doesn't, or
1869
+ # if the subject is blank, Amazon Web Services STS rejects the
1870
+ # request with a validation error.
1871
+ #
1872
+ # Amazon Web Services STS denies the request if the subject begins
1873
+ # with the text `arn:`, in any combination of uppercase and
1874
+ # lowercase letters. Amazon Web Services STS also denies the request
1875
+ # if the subject begins or ends with a space, or contains a control,
1876
+ # format, or separator character other than a space.
1877
+ #
1878
+ # You can use the `sts:SubjectMode` condition key in a policy to
1879
+ # control which subject modes a principal can request.
1880
+ # @return [String]
1881
+ #
1730
1882
  # @!attribute [rw] tags
1731
1883
  # An optional list of tags to include in the JSON Web Token (JWT).
1732
1884
  # These tags are added as custom claims to the JWT and can be used by
@@ -1739,6 +1891,8 @@ module Aws::STS
1739
1891
  :audience,
1740
1892
  :duration_seconds,
1741
1893
  :signing_algorithm,
1894
+ :scope,
1895
+ :subject_mode,
1742
1896
  :tags)
1743
1897
  SENSITIVE = []
1744
1898
  include Aws::Structure
@@ -1746,12 +1900,16 @@ module Aws::STS
1746
1900
 
1747
1901
  # @!attribute [rw] web_identity_token
1748
1902
  # A signed JSON Web Token (JWT) that represents the caller's Amazon
1749
- # Web Services identity. The token contains standard JWT claims such
1750
- # as subject, audience, expiration time, and additional identity
1751
- # attributes added by STS as custom claims. You can also add your own
1752
- # custom claims to the token by passing tags as request parameters to
1753
- # the `GetWebIdentityToken` API. The token is signed using the
1754
- # specified signing algorithm and can be verified using the
1903
+ # Web Services identity or, if you set `SubjectMode` to
1904
+ # `OriginIdentity`, the human user or workload on whose behalf the
1905
+ # calling session acts. The token contains standard JWT claims such as
1906
+ # subject, audience, expiration time, and additional identity
1907
+ # attributes added by STS as custom claims. These can include the
1908
+ # `principal_id` claim, which contains the ARN of the principal that
1909
+ # requested the token, whichever subject mode you use. You can also
1910
+ # add your own custom claims to the token by passing tags as request
1911
+ # parameters to the `GetWebIdentityToken` API. The token is signed
1912
+ # using the specified signing algorithm and can be verified using the
1755
1913
  # verification keys available at the issuer's JWKS endpoint.
1756
1914
  # @return [String]
1757
1915
  #
@@ -1807,6 +1965,24 @@ module Aws::STS
1807
1965
  include Aws::Structure
1808
1966
  end
1809
1967
 
1968
+ # The request was rejected because the requested `DurationSeconds` is
1969
+ # greater than the remaining lifetime of the calling session.
1970
+ # `GetScopedCredentials` cannot extend a session beyond its original
1971
+ # expiration. Request a duration that is less than or equal to the
1972
+ # calling session's remaining lifetime, or omit `DurationSeconds` to
1973
+ # inherit it.
1974
+ #
1975
+ # @!attribute [rw] message
1976
+ # @return [String]
1977
+ #
1978
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/InsufficientSessionLifetimeException AWS API Documentation
1979
+ #
1980
+ class InsufficientSessionLifetimeException < Struct.new(
1981
+ :message)
1982
+ SENSITIVE = []
1983
+ include Aws::Structure
1984
+ end
1985
+
1810
1986
  # The error returned if the message passed to
1811
1987
  # `DecodeAuthorizationMessage` was invalid. This can happen if the token
1812
1988
  # contains invalid characters, such as line breaks, or if the message
@@ -1823,6 +1999,22 @@ module Aws::STS
1823
1999
  include Aws::Structure
1824
2000
  end
1825
2001
 
2002
+ # The request was rejected because the context assertion that was
2003
+ # provided is invalid. This can happen if the context assertion supplied
2004
+ # in the `ProvidedContexts` parameter is malformed, has expired, or does
2005
+ # not match a trusted context provider.
2006
+ #
2007
+ # @!attribute [rw] message
2008
+ # @return [String]
2009
+ #
2010
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/InvalidContextAssertionException AWS API Documentation
2011
+ #
2012
+ class InvalidContextAssertionException < Struct.new(
2013
+ :message)
2014
+ SENSITIVE = []
2015
+ include Aws::Structure
2016
+ end
2017
+
1826
2018
  # The web identity token that was passed could not be validated by
1827
2019
  # Amazon Web Services. Get a new identity token from the identity
1828
2020
  # provider and then retry the request.
@@ -1838,6 +2030,21 @@ module Aws::STS
1838
2030
  include Aws::Structure
1839
2031
  end
1840
2032
 
2033
+ # The request was rejected because the session used to call
2034
+ # `GetScopedCredentials` is not a valid session. The calling session's
2035
+ # credentials could not be validated or resolved.
2036
+ #
2037
+ # @!attribute [rw] message
2038
+ # @return [String]
2039
+ #
2040
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/InvalidSubjectCredentialsException AWS API Documentation
2041
+ #
2042
+ class InvalidSubjectCredentialsException < Struct.new(
2043
+ :message)
2044
+ SENSITIVE = []
2045
+ include Aws::Structure
2046
+ end
2047
+
1841
2048
  # The requested token payload size exceeds the maximum allowed size.
1842
2049
  # Reduce the number of request tags included in the
1843
2050
  # `GetWebIdentityToken` API call to reduce the token payload size.
@@ -1867,6 +2074,47 @@ module Aws::STS
1867
2074
  include Aws::Structure
1868
2075
  end
1869
2076
 
2077
+ # The session's `aws:OriginIdentity/Subject`,
2078
+ # `aws:OriginIdentity/SubjectType`, `aws:OriginIdentity/Issuer` and
2079
+ # `aws:OriginIdentity/FederatedProviderArn` keys. A member is absent
2080
+ # when the session does not have the key.
2081
+ #
2082
+ # @!attribute [rw] subject
2083
+ # The value of the `aws:OriginIdentity/Subject` key: the end user's
2084
+ # identifier, taken from the token claim that the context provider
2085
+ # maps as the subject.
2086
+ # @return [String]
2087
+ #
2088
+ # @!attribute [rw] subject_type
2089
+ # The value of the `aws:OriginIdentity/SubjectType` key, which
2090
+ # indicates whether the end user is a person (`user`) or a non-human
2091
+ # caller such as an application or service (`workload`).
2092
+ # @return [String]
2093
+ #
2094
+ # @!attribute [rw] issuer
2095
+ # The value of the `aws:OriginIdentity/Issuer` key. For
2096
+ # `AssumeRoleWithWebIdentity`, this is the `iss` claim of the token
2097
+ # without the `https://` prefix. For `AssumeRoleWithSAML`, this is a
2098
+ # hash of the key that signed the SAML assertion, not the `Issuer`
2099
+ # element of the assertion.
2100
+ # @return [String]
2101
+ #
2102
+ # @!attribute [rw] federated_provider_arn
2103
+ # The value of the `aws:OriginIdentity/FederatedProviderArn` key: the
2104
+ # ARN of the IAM identity provider that the request federated through.
2105
+ # @return [String]
2106
+ #
2107
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/OriginIdentity AWS API Documentation
2108
+ #
2109
+ class OriginIdentity < Struct.new(
2110
+ :subject,
2111
+ :subject_type,
2112
+ :issuer,
2113
+ :federated_provider_arn)
2114
+ SENSITIVE = [:subject, :subject_type, :issuer]
2115
+ include Aws::Structure
2116
+ end
2117
+
1870
2118
  # The outbound web identity federation feature is not enabled for this
1871
2119
  # account. To use this feature, you must first enable it through the
1872
2120
  # Amazon Web Services Management Console or API.
@@ -1882,18 +2130,17 @@ module Aws::STS
1882
2130
  include Aws::Structure
1883
2131
  end
1884
2132
 
1885
- # The request was rejected because the total packed size of the session
1886
- # policies and session tags combined was too large. An Amazon Web
1887
- # Services conversion compresses the session policy document, session
1888
- # policy ARNs, and session tags into a packed binary format that has a
1889
- # separate limit. The error message indicates by percentage how close
1890
- # the policies and tags are to the upper size limit. For more
1891
- # information, see [Passing Session Tags in STS][1] in the *IAM User
1892
- # Guide*.
2133
+ # The request was rejected because the session token exceeded the
2134
+ # maximum allowed size. The error message reports the session token size
2135
+ # and the maximum allowed size, both in bytes. Session policies and
2136
+ # session tags add to the session token size. For more information, see
2137
+ # [Passing Session Tags in STS][1] in the *IAM User Guide*.
1893
2138
  #
1894
- # You could receive this error even though you meet other defined
1895
- # session policy and session tag limits. For more information, see [IAM
1896
- # and STS Entity Character Limits][2] in the *IAM User Guide*.
2139
+ # You might receive this error even though you meet the individual
2140
+ # session policy and session tag limits. Monitor
2141
+ # `SessionTokenUtilization` to track how close the session token is to
2142
+ # the maximum allowed size. For more information, see [IAM and STS
2143
+ # Entity Character Limits][2] in the *IAM User Guide*.
1897
2144
  #
1898
2145
  #
1899
2146
  #
@@ -1978,6 +2225,35 @@ module Aws::STS
1978
2225
  include Aws::Structure
1979
2226
  end
1980
2227
 
2228
+ # Identifiers for the scoped session that `GetScopedCredentials`
2229
+ # returns. The underlying identity and session name do not change from
2230
+ # the caller principal.
2231
+ #
2232
+ # @!attribute [rw] scoped_session_id
2233
+ # A unique identifier for the scoped session. Because the identity is
2234
+ # preserved, this identifies the same principal as the calling
2235
+ # session.
2236
+ # @return [String]
2237
+ #
2238
+ # @!attribute [rw] arn
2239
+ # The ARN of the scoped session. For more information about ARNs and
2240
+ # how to use them in policies, see [IAM Identifiers][1] in the *IAM
2241
+ # User Guide*.
2242
+ #
2243
+ #
2244
+ #
2245
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
2246
+ # @return [String]
2247
+ #
2248
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/ScopedSession AWS API Documentation
2249
+ #
2250
+ class ScopedSession < Struct.new(
2251
+ :scoped_session_id,
2252
+ :arn)
2253
+ SENSITIVE = []
2254
+ include Aws::Structure
2255
+ end
2256
+
1981
2257
  # The requested token duration would extend the session beyond its
1982
2258
  # original expiration time. You cannot use this operation to extend the
1983
2259
  # lifetime of a session beyond what was granted when the session was
@@ -2037,6 +2313,50 @@ module Aws::STS
2037
2313
  include Aws::Structure
2038
2314
  end
2039
2315
 
2316
+ # The session's `aws:TransactionContext/IdentityProvider/*` keys.
2317
+ #
2318
+ # @!attribute [rw] identity_provider
2319
+ # The session's `aws:TransactionContext/IdentityProvider/*` keys,
2320
+ # keyed by the part of the key name after
2321
+ # `aws:TransactionContext/IdentityProvider/`. Each value is up to 128
2322
+ # characters.
2323
+ #
2324
+ # The number of entries is bounded twice. IAM limits how many keys a
2325
+ # context provider maps when you configure it on the identity
2326
+ # provider, and Amazon Web Services STS rejects a session whose
2327
+ # session token exceeds the maximum size with `PackedPolicyTooLarge`.
2328
+ # @return [Hash<String,String>]
2329
+ #
2330
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/TransactionContext AWS API Documentation
2331
+ #
2332
+ class TransactionContext < Struct.new(
2333
+ :identity_provider)
2334
+ SENSITIVE = [:identity_provider]
2335
+ include Aws::Structure
2336
+ end
2337
+
2338
+ # The trusted identity propagation context that Amazon Web Services STS
2339
+ # set in a session from the identity provider's token. A member is
2340
+ # absent when the session has none of its keys.
2341
+ #
2342
+ # @!attribute [rw] origin_identity
2343
+ # The identity of the end user on whose behalf the session acts.
2344
+ # @return [Types::OriginIdentity]
2345
+ #
2346
+ # @!attribute [rw] transaction_context
2347
+ # Additional claims about the request that the identity provider
2348
+ # asserted.
2349
+ # @return [Types::TransactionContext]
2350
+ #
2351
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/TrustedIdentityPropagationContext AWS API Documentation
2352
+ #
2353
+ class TrustedIdentityPropagationContext < Struct.new(
2354
+ :origin_identity,
2355
+ :transaction_context)
2356
+ SENSITIVE = []
2357
+ include Aws::Structure
2358
+ end
2359
+
2040
2360
  end
2041
2361
  end
2042
2362