aws-sdk-guardduty 1.107.0 → 1.109.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.
@@ -114,6 +114,30 @@ module Aws::GuardDuty
114
114
  include Aws::Structure
115
115
  end
116
116
 
117
+ # Contains information about the access keys.
118
+ #
119
+ # @!attribute [rw] principal_id
120
+ # Principal ID of the user.
121
+ # @return [String]
122
+ #
123
+ # @!attribute [rw] user_name
124
+ # Name of the user.
125
+ # @return [String]
126
+ #
127
+ # @!attribute [rw] user_type
128
+ # Type of the user.
129
+ # @return [String]
130
+ #
131
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/AccessKey AWS API Documentation
132
+ #
133
+ class AccessKey < Struct.new(
134
+ :principal_id,
135
+ :user_name,
136
+ :user_type)
137
+ SENSITIVE = []
138
+ include Aws::Structure
139
+ end
140
+
117
141
  # Contains information about the access keys.
118
142
  #
119
143
  # @!attribute [rw] access_key_id
@@ -143,6 +167,25 @@ module Aws::GuardDuty
143
167
  include Aws::Structure
144
168
  end
145
169
 
170
+ # Contains information about the account.
171
+ #
172
+ # @!attribute [rw] uid
173
+ # ID of the member's Amazon Web Services account
174
+ # @return [String]
175
+ #
176
+ # @!attribute [rw] name
177
+ # Name of the member's Amazon Web Services account.
178
+ # @return [String]
179
+ #
180
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Account AWS API Documentation
181
+ #
182
+ class Account < Struct.new(
183
+ :uid,
184
+ :name)
185
+ SENSITIVE = []
186
+ include Aws::Structure
187
+ end
188
+
146
189
  # Contains information about the account.
147
190
  #
148
191
  # @!attribute [rw] account_id
@@ -294,6 +337,32 @@ module Aws::GuardDuty
294
337
  include Aws::Structure
295
338
  end
296
339
 
340
+ # Information about the actors involved in an attack sequence.
341
+ #
342
+ # @!attribute [rw] id
343
+ # ID of the threat actor.
344
+ # @return [String]
345
+ #
346
+ # @!attribute [rw] user
347
+ # Contains information about the user credentials used by the threat
348
+ # actor.
349
+ # @return [Types::User]
350
+ #
351
+ # @!attribute [rw] session
352
+ # Contains information about the user session where the activity
353
+ # initiated.
354
+ # @return [Types::Session]
355
+ #
356
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Actor AWS API Documentation
357
+ #
358
+ class Actor < Struct.new(
359
+ :id,
360
+ :user,
361
+ :session)
362
+ SENSITIVE = []
363
+ include Aws::Structure
364
+ end
365
+
297
366
  # Information about the installed EKS add-on (GuardDuty security agent).
298
367
  #
299
368
  # @!attribute [rw] addon_version
@@ -467,6 +536,26 @@ module Aws::GuardDuty
467
536
  #
468
537
  class ArchiveFindingsResponse < Aws::EmptyStructure; end
469
538
 
539
+ # Contains information about the Autonomous System (AS) associated with
540
+ # the network endpoints involved in an attack sequence.
541
+ #
542
+ # @!attribute [rw] name
543
+ # Name associated with the Autonomous System (AS).
544
+ # @return [String]
545
+ #
546
+ # @!attribute [rw] number
547
+ # The unique number that identifies the Autonomous System (AS).
548
+ # @return [Integer]
549
+ #
550
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/AutonomousSystem AWS API Documentation
551
+ #
552
+ class AutonomousSystem < Struct.new(
553
+ :name,
554
+ :number)
555
+ SENSITIVE = []
556
+ include Aws::Structure
557
+ end
558
+
470
559
  # Contains information about the API action.
471
560
  #
472
561
  # @!attribute [rw] api
@@ -1278,9 +1367,11 @@ module Aws::GuardDuty
1278
1367
  #
1279
1368
  # * **Medium**: `["4", "5", "6"]`
1280
1369
  #
1281
- # * **High**: `["7", "8", "9"]`
1282
- # For more information, see [Severity levels for GuardDuty
1283
- # findings][2].
1370
+ # * **High**: `["7", "8"]`
1371
+ #
1372
+ # * **Critical**: `["9", "10"]`
1373
+ # For more information, see [Findings severity levels][2] in the
1374
+ # *Amazon GuardDuty User Guide*.
1284
1375
  #
1285
1376
  # * type
1286
1377
  #
@@ -1471,7 +1562,7 @@ module Aws::GuardDuty
1471
1562
  #
1472
1563
  #
1473
1564
  # [1]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_FindingCriteria.html
1474
- # [2]: https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings.html#guardduty_findings-severity
1565
+ # [2]: https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings-severity.html
1475
1566
  # @return [Types::FindingCriteria]
1476
1567
  #
1477
1568
  # @!attribute [rw] client_token
@@ -2352,7 +2443,8 @@ module Aws::GuardDuty
2352
2443
  end
2353
2444
 
2354
2445
  # @!attribute [rw] scans
2355
- # Contains information about malware scans.
2446
+ # Contains information about malware scans associated with GuardDuty
2447
+ # Malware Protection for EC2.
2356
2448
  # @return [Array<Types::Scan>]
2357
2449
  #
2358
2450
  # @!attribute [rw] next_token
@@ -2590,10 +2682,15 @@ module Aws::GuardDuty
2590
2682
  # generate the finding.
2591
2683
  # @return [Types::Anomaly]
2592
2684
  #
2685
+ # @!attribute [rw] sequence
2686
+ # The details about the attack sequence.
2687
+ # @return [Types::Sequence]
2688
+ #
2593
2689
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Detection AWS API Documentation
2594
2690
  #
2595
2691
  class Detection < Struct.new(
2596
- :anomaly)
2692
+ :anomaly,
2693
+ :sequence)
2597
2694
  SENSITIVE = []
2598
2695
  include Aws::Structure
2599
2696
  end
@@ -2933,6 +3030,113 @@ module Aws::GuardDuty
2933
3030
  include Aws::Structure
2934
3031
  end
2935
3032
 
3033
+ # Details about the potentially impacted Amazon EC2 instance resource.
3034
+ #
3035
+ # @!attribute [rw] availability_zone
3036
+ # The availability zone of the Amazon EC2 instance. For more
3037
+ # information, see [Availability zones][1] in the *Amazon EC2 User
3038
+ # Guide*.
3039
+ #
3040
+ #
3041
+ #
3042
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones
3043
+ # @return [String]
3044
+ #
3045
+ # @!attribute [rw] image_description
3046
+ # The image description of the Amazon EC2 instance.
3047
+ # @return [String]
3048
+ #
3049
+ # @!attribute [rw] instance_state
3050
+ # The state of the Amazon EC2 instance. For more information, see
3051
+ # [Amazon EC2 instance state changes][1] in the *Amazon EC2 User
3052
+ # Guide*.
3053
+ #
3054
+ #
3055
+ #
3056
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html
3057
+ # @return [String]
3058
+ #
3059
+ # @!attribute [rw] iam_instance_profile
3060
+ # Contains information about the EC2 instance profile.
3061
+ # @return [Types::IamInstanceProfile]
3062
+ #
3063
+ # @!attribute [rw] instance_type
3064
+ # Type of the Amazon EC2 instance.
3065
+ # @return [String]
3066
+ #
3067
+ # @!attribute [rw] outpost_arn
3068
+ # The Amazon Resource Name (ARN) of the Amazon Web Services Outpost.
3069
+ # This shows applicable Amazon Web Services Outposts instances.
3070
+ # @return [String]
3071
+ #
3072
+ # @!attribute [rw] platform
3073
+ # The platform of the Amazon EC2 instance.
3074
+ # @return [String]
3075
+ #
3076
+ # @!attribute [rw] product_codes
3077
+ # The product code of the Amazon EC2 instance.
3078
+ # @return [Array<Types::ProductCode>]
3079
+ #
3080
+ # @!attribute [rw] ec2_network_interface_uids
3081
+ # The ID of the network interface.
3082
+ # @return [Array<String>]
3083
+ #
3084
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Ec2Instance AWS API Documentation
3085
+ #
3086
+ class Ec2Instance < Struct.new(
3087
+ :availability_zone,
3088
+ :image_description,
3089
+ :instance_state,
3090
+ :iam_instance_profile,
3091
+ :instance_type,
3092
+ :outpost_arn,
3093
+ :platform,
3094
+ :product_codes,
3095
+ :ec2_network_interface_uids)
3096
+ SENSITIVE = []
3097
+ include Aws::Structure
3098
+ end
3099
+
3100
+ # Contains information about the elastic network interface of the Amazon
3101
+ # EC2 instance.
3102
+ #
3103
+ # @!attribute [rw] ipv_6_addresses
3104
+ # A list of IPv6 addresses for the Amazon EC2 instance.
3105
+ # @return [Array<String>]
3106
+ #
3107
+ # @!attribute [rw] private_ip_addresses
3108
+ # Other private IP address information of the Amazon EC2 instance.
3109
+ # @return [Array<Types::PrivateIpAddressDetails>]
3110
+ #
3111
+ # @!attribute [rw] public_ip
3112
+ # The public IP address of the Amazon EC2 instance.
3113
+ # @return [String]
3114
+ #
3115
+ # @!attribute [rw] security_groups
3116
+ # The security groups associated with the Amazon EC2 instance.
3117
+ # @return [Array<Types::SecurityGroup>]
3118
+ #
3119
+ # @!attribute [rw] sub_net_id
3120
+ # The subnet ID of the Amazon EC2 instance.
3121
+ # @return [String]
3122
+ #
3123
+ # @!attribute [rw] vpc_id
3124
+ # The VPC ID of the Amazon EC2 instance.
3125
+ # @return [String]
3126
+ #
3127
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Ec2NetworkInterface AWS API Documentation
3128
+ #
3129
+ class Ec2NetworkInterface < Struct.new(
3130
+ :ipv_6_addresses,
3131
+ :private_ip_addresses,
3132
+ :public_ip,
3133
+ :security_groups,
3134
+ :sub_net_id,
3135
+ :vpc_id)
3136
+ SENSITIVE = []
3137
+ include Aws::Structure
3138
+ end
3139
+
2936
3140
  # Contains information about the details of the ECS Cluster.
2937
3141
  #
2938
3142
  # @!attribute [rw] name
@@ -3288,6 +3492,11 @@ module Aws::GuardDuty
3288
3492
  # The time and date when the finding was last updated.
3289
3493
  # @return [String]
3290
3494
  #
3495
+ # @!attribute [rw] associated_attack_sequence_arn
3496
+ # Amazon Resource Name (ARN) associated with the attack sequence
3497
+ # finding.
3498
+ # @return [String]
3499
+ #
3291
3500
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Finding AWS API Documentation
3292
3501
  #
3293
3502
  class Finding < Struct.new(
@@ -3305,7 +3514,8 @@ module Aws::GuardDuty
3305
3514
  :severity,
3306
3515
  :title,
3307
3516
  :type,
3308
- :updated_at)
3517
+ :updated_at,
3518
+ :associated_attack_sequence_arn)
3309
3519
  SENSITIVE = []
3310
3520
  include Aws::Structure
3311
3521
  end
@@ -4325,6 +4535,37 @@ module Aws::GuardDuty
4325
4535
  include Aws::Structure
4326
4536
  end
4327
4537
 
4538
+ # Contains information about the indicators that include a set of
4539
+ # signals observed in an attack sequence.
4540
+ #
4541
+ # @!attribute [rw] key
4542
+ # Specific indicator keys observed in the attack sequence.
4543
+ # @return [String]
4544
+ #
4545
+ # @!attribute [rw] values
4546
+ # Values associated with each indicator key. For example, if the
4547
+ # indicator key is `SUSPICIOUS_NETWORK`, then the value will be the
4548
+ # name of the network. If the indicator key is `ATTACK_TACTIC`, then
4549
+ # the value will be one of the MITRE tactics.
4550
+ #
4551
+ # For more information about the values associated with the key, see
4552
+ # GuardDuty Extended Threat Detection in the *GuardDuty User Guide.*
4553
+ # @return [Array<String>]
4554
+ #
4555
+ # @!attribute [rw] title
4556
+ # Title describing the indicator.
4557
+ # @return [String]
4558
+ #
4559
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Indicator AWS API Documentation
4560
+ #
4561
+ class Indicator < Struct.new(
4562
+ :key,
4563
+ :values,
4564
+ :title)
4565
+ SENSITIVE = []
4566
+ include Aws::Structure
4567
+ end
4568
+
4328
4569
  # Contains information about the details of an instance.
4329
4570
  #
4330
4571
  # @!attribute [rw] availability_zone
@@ -6109,6 +6350,20 @@ module Aws::GuardDuty
6109
6350
  include Aws::Structure
6110
6351
  end
6111
6352
 
6353
+ # Contains information about the network connection.
6354
+ #
6355
+ # @!attribute [rw] direction
6356
+ # The direction in which the network traffic is flowing.
6357
+ # @return [String]
6358
+ #
6359
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/NetworkConnection AWS API Documentation
6360
+ #
6361
+ class NetworkConnection < Struct.new(
6362
+ :direction)
6363
+ SENSITIVE = []
6364
+ include Aws::Structure
6365
+ end
6366
+
6112
6367
  # Contains information about the NETWORK\_CONNECTION action described in
6113
6368
  # the finding.
6114
6369
  #
@@ -6161,6 +6416,80 @@ module Aws::GuardDuty
6161
6416
  include Aws::Structure
6162
6417
  end
6163
6418
 
6419
+ # Contains information about network endpoints that were observed in the
6420
+ # attack sequence.
6421
+ #
6422
+ # @!attribute [rw] id
6423
+ # The ID of the network endpoint.
6424
+ # @return [String]
6425
+ #
6426
+ # @!attribute [rw] ip
6427
+ # The IP address associated with the network endpoint.
6428
+ # @return [String]
6429
+ #
6430
+ # @!attribute [rw] domain
6431
+ # The domain information for the network endpoint.
6432
+ # @return [String]
6433
+ #
6434
+ # @!attribute [rw] port
6435
+ # The port number associated with the network endpoint.
6436
+ # @return [Integer]
6437
+ #
6438
+ # @!attribute [rw] location
6439
+ # Information about the location of the network endpoint.
6440
+ # @return [Types::NetworkGeoLocation]
6441
+ #
6442
+ # @!attribute [rw] autonomous_system
6443
+ # The Autonomous System (AS) of the network endpoint.
6444
+ # @return [Types::AutonomousSystem]
6445
+ #
6446
+ # @!attribute [rw] connection
6447
+ # Information about the network connection.
6448
+ # @return [Types::NetworkConnection]
6449
+ #
6450
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/NetworkEndpoint AWS API Documentation
6451
+ #
6452
+ class NetworkEndpoint < Struct.new(
6453
+ :id,
6454
+ :ip,
6455
+ :domain,
6456
+ :port,
6457
+ :location,
6458
+ :autonomous_system,
6459
+ :connection)
6460
+ SENSITIVE = []
6461
+ include Aws::Structure
6462
+ end
6463
+
6464
+ # Contains information about network endpoint location.
6465
+ #
6466
+ # @!attribute [rw] city
6467
+ # The name of the city.
6468
+ # @return [String]
6469
+ #
6470
+ # @!attribute [rw] country
6471
+ # The name of the country.
6472
+ # @return [String]
6473
+ #
6474
+ # @!attribute [rw] latitude
6475
+ # The latitude information of the endpoint location.
6476
+ # @return [Float]
6477
+ #
6478
+ # @!attribute [rw] longitude
6479
+ # The longitude information of the endpoint location.
6480
+ # @return [Float]
6481
+ #
6482
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/NetworkGeoLocation AWS API Documentation
6483
+ #
6484
+ class NetworkGeoLocation < Struct.new(
6485
+ :city,
6486
+ :country,
6487
+ :latitude,
6488
+ :longitude)
6489
+ SENSITIVE = []
6490
+ include Aws::Structure
6491
+ end
6492
+
6164
6493
  # Contains information about the elastic network interface of the EC2
6165
6494
  # instance.
6166
6495
  #
@@ -6269,9 +6598,13 @@ module Aws::GuardDuty
6269
6598
  # A list of additional configurations which will be configured for the
6270
6599
  # organization.
6271
6600
  #
6601
+ # Additional configuration applies to only GuardDuty Runtime Monitoring
6602
+ # protection plan.
6603
+ #
6272
6604
  # @!attribute [rw] name
6273
6605
  # The name of the additional configuration that will be configured for
6274
- # the organization.
6606
+ # the organization. These values are applicable to only Runtime
6607
+ # Monitoring protection plan.
6275
6608
  # @return [String]
6276
6609
  #
6277
6610
  # @!attribute [rw] auto_enable
@@ -6310,7 +6643,8 @@ module Aws::GuardDuty
6310
6643
  #
6311
6644
  # @!attribute [rw] name
6312
6645
  # The name of the additional configuration that is configured for the
6313
- # member accounts within the organization.
6646
+ # member accounts within the organization. These values are applicable
6647
+ # to only Runtime Monitoring protection plan.
6314
6648
  # @return [String]
6315
6649
  #
6316
6650
  # @!attribute [rw] auto_enable
@@ -6999,6 +7333,48 @@ module Aws::GuardDuty
6999
7333
  include Aws::Structure
7000
7334
  end
7001
7335
 
7336
+ # Describes public access policies that apply to the Amazon S3 bucket.
7337
+ #
7338
+ # For information about each of the following settings, see [Blocking
7339
+ # public access to your Amazon S3 storage][1] in the *Amazon S3 User
7340
+ # Guide*.
7341
+ #
7342
+ #
7343
+ #
7344
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
7345
+ #
7346
+ # @!attribute [rw] public_acl_access
7347
+ # Indicates whether or not there is a setting that allows public
7348
+ # access to the Amazon S3 buckets through access control lists (ACLs).
7349
+ # @return [String]
7350
+ #
7351
+ # @!attribute [rw] public_policy_access
7352
+ # Indicates whether or not there is a setting that allows public
7353
+ # access to the Amazon S3 bucket policy.
7354
+ # @return [String]
7355
+ #
7356
+ # @!attribute [rw] public_acl_ignore_behavior
7357
+ # Indicates whether or not there is a setting that ignores all public
7358
+ # access control lists (ACLs) on the Amazon S3 bucket and the objects
7359
+ # that it contains.
7360
+ # @return [String]
7361
+ #
7362
+ # @!attribute [rw] public_bucket_restrict_behavior
7363
+ # Indicates whether or not there is a setting that restricts access to
7364
+ # the bucket with specified policies.
7365
+ # @return [String]
7366
+ #
7367
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/PublicAccessConfiguration AWS API Documentation
7368
+ #
7369
+ class PublicAccessConfiguration < Struct.new(
7370
+ :public_acl_access,
7371
+ :public_policy_access,
7372
+ :public_acl_ignore_behavior,
7373
+ :public_bucket_restrict_behavior)
7374
+ SENSITIVE = []
7375
+ include Aws::Structure
7376
+ end
7377
+
7002
7378
  # Contains information about the resource type `RDSDBInstance` involved
7003
7379
  # in a GuardDuty finding.
7004
7380
  #
@@ -7110,7 +7486,7 @@ module Aws::GuardDuty
7110
7486
  # @return [String]
7111
7487
  #
7112
7488
  # @!attribute [rw] tags
7113
- # Information about the tag-key value pair.
7489
+ # Information about the tag key-value pair.
7114
7490
  # @return [Array<Types::Tag>]
7115
7491
  #
7116
7492
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/RdsLimitlessDbDetails AWS API Documentation
@@ -7310,6 +7686,44 @@ module Aws::GuardDuty
7310
7686
  include Aws::Structure
7311
7687
  end
7312
7688
 
7689
+ # Contains information about the Amazon Web Services resource that is
7690
+ # associated with the activity that prompted GuardDuty to generate a
7691
+ # finding.
7692
+ #
7693
+ # @!attribute [rw] s3_bucket
7694
+ # Contains information about the Amazon S3 bucket.
7695
+ # @return [Types::S3Bucket]
7696
+ #
7697
+ # @!attribute [rw] ec2_instance
7698
+ # Contains information about the Amazon EC2 instance.
7699
+ # @return [Types::Ec2Instance]
7700
+ #
7701
+ # @!attribute [rw] access_key
7702
+ # Contains information about the IAM access key details of a user that
7703
+ # involved in the GuardDuty finding.
7704
+ # @return [Types::AccessKey]
7705
+ #
7706
+ # @!attribute [rw] ec2_network_interface
7707
+ # Contains information about the elastic network interface of the
7708
+ # Amazon EC2 instance.
7709
+ # @return [Types::Ec2NetworkInterface]
7710
+ #
7711
+ # @!attribute [rw] s3_object
7712
+ # Contains information about the Amazon S3 object.
7713
+ # @return [Types::S3Object]
7714
+ #
7715
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ResourceData AWS API Documentation
7716
+ #
7717
+ class ResourceData < Struct.new(
7718
+ :s3_bucket,
7719
+ :ec2_instance,
7720
+ :access_key,
7721
+ :ec2_network_interface,
7722
+ :s3_object)
7723
+ SENSITIVE = []
7724
+ include Aws::Structure
7725
+ end
7726
+
7313
7727
  # Represents the resources that were scanned in the scan entry.
7314
7728
  #
7315
7729
  # @!attribute [rw] instance_arn
@@ -7404,6 +7818,64 @@ module Aws::GuardDuty
7404
7818
  include Aws::Structure
7405
7819
  end
7406
7820
 
7821
+ # Contains information about the Amazon Web Services resource that is
7822
+ # associated with the GuardDuty finding.
7823
+ #
7824
+ # @!attribute [rw] uid
7825
+ # The unique identifier of the resource.
7826
+ # @return [String]
7827
+ #
7828
+ # @!attribute [rw] name
7829
+ # The name of the resource.
7830
+ # @return [String]
7831
+ #
7832
+ # @!attribute [rw] account_id
7833
+ # The Amazon Web Services account ID to which the resource belongs.
7834
+ # @return [String]
7835
+ #
7836
+ # @!attribute [rw] resource_type
7837
+ # The type of the Amazon Web Services resource.
7838
+ # @return [String]
7839
+ #
7840
+ # @!attribute [rw] region
7841
+ # The Amazon Web Services Region where the resource belongs.
7842
+ # @return [String]
7843
+ #
7844
+ # @!attribute [rw] service
7845
+ # The Amazon Web Services service of the resource.
7846
+ # @return [String]
7847
+ #
7848
+ # @!attribute [rw] cloud_partition
7849
+ # The cloud partition within the Amazon Web Services Region to which
7850
+ # the resource belongs.
7851
+ # @return [String]
7852
+ #
7853
+ # @!attribute [rw] tags
7854
+ # Contains information about the tags associated with the resource.
7855
+ # @return [Array<Types::Tag>]
7856
+ #
7857
+ # @!attribute [rw] data
7858
+ # Contains information about the Amazon Web Services resource
7859
+ # associated with the activity that prompted GuardDuty to generate a
7860
+ # finding.
7861
+ # @return [Types::ResourceData]
7862
+ #
7863
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ResourceV2 AWS API Documentation
7864
+ #
7865
+ class ResourceV2 < Struct.new(
7866
+ :uid,
7867
+ :name,
7868
+ :account_id,
7869
+ :resource_type,
7870
+ :region,
7871
+ :service,
7872
+ :cloud_partition,
7873
+ :tags,
7874
+ :data)
7875
+ SENSITIVE = []
7876
+ include Aws::Structure
7877
+ end
7878
+
7407
7879
  # Additional information about the suspicious activity.
7408
7880
  #
7409
7881
  # @!attribute [rw] modifying_process
@@ -7570,6 +8042,78 @@ module Aws::GuardDuty
7570
8042
  include Aws::Structure
7571
8043
  end
7572
8044
 
8045
+ # Contains information about the Amazon S3 bucket policies and
8046
+ # encryption.
8047
+ #
8048
+ # @!attribute [rw] owner_id
8049
+ # The owner ID of the associated S3Amazon S3bucket.
8050
+ # @return [String]
8051
+ #
8052
+ # @!attribute [rw] created_at
8053
+ # The timestamp at which the Amazon S3 bucket was created.
8054
+ # @return [Time]
8055
+ #
8056
+ # @!attribute [rw] encryption_type
8057
+ # The type of encryption used for the Amazon S3 buckets and its
8058
+ # objects. For more information, see [Protecting data with server-side
8059
+ # encryption][1] in the *Amazon S3 User Guide*.
8060
+ #
8061
+ #
8062
+ #
8063
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
8064
+ # @return [String]
8065
+ #
8066
+ # @!attribute [rw] encryption_key_arn
8067
+ # The Amazon Resource Name (ARN) of the encryption key that is used to
8068
+ # encrypt the Amazon S3 bucket and its objects.
8069
+ # @return [String]
8070
+ #
8071
+ # @!attribute [rw] effective_permission
8072
+ # Describes the effective permissions on this S3 bucket, after
8073
+ # factoring all the attached policies.
8074
+ # @return [String]
8075
+ #
8076
+ # @!attribute [rw] public_read_access
8077
+ # Indicates whether or not the public read access is allowed for an
8078
+ # Amazon S3 bucket.
8079
+ # @return [String]
8080
+ #
8081
+ # @!attribute [rw] public_write_access
8082
+ # Indicates whether or not the public write access is allowed for an
8083
+ # Amazon S3 bucket.
8084
+ # @return [String]
8085
+ #
8086
+ # @!attribute [rw] account_public_access
8087
+ # Contains information about the public access policies that apply to
8088
+ # the Amazon S3 bucket at the account level.
8089
+ # @return [Types::PublicAccessConfiguration]
8090
+ #
8091
+ # @!attribute [rw] bucket_public_access
8092
+ # Contains information about public access policies that apply to the
8093
+ # Amazon S3 bucket.
8094
+ # @return [Types::PublicAccessConfiguration]
8095
+ #
8096
+ # @!attribute [rw] s3_object_uids
8097
+ # Represents a list of Amazon S3 object identifiers.
8098
+ # @return [Array<String>]
8099
+ #
8100
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/S3Bucket AWS API Documentation
8101
+ #
8102
+ class S3Bucket < Struct.new(
8103
+ :owner_id,
8104
+ :created_at,
8105
+ :encryption_type,
8106
+ :encryption_key_arn,
8107
+ :effective_permission,
8108
+ :public_read_access,
8109
+ :public_write_access,
8110
+ :account_public_access,
8111
+ :bucket_public_access,
8112
+ :s3_object_uids)
8113
+ SENSITIVE = []
8114
+ include Aws::Structure
8115
+ end
8116
+
7573
8117
  # Contains information on the S3 bucket.
7574
8118
  #
7575
8119
  # @!attribute [rw] arn
@@ -7653,6 +8197,31 @@ module Aws::GuardDuty
7653
8197
  include Aws::Structure
7654
8198
  end
7655
8199
 
8200
+ # Contains information about the Amazon S3 object.
8201
+ #
8202
+ # @!attribute [rw] etag
8203
+ # The entity tag is a hash of the Amazon S3 object. The ETag reflects
8204
+ # changes only to the contents of an object, and not its metadata.
8205
+ # @return [String]
8206
+ #
8207
+ # @!attribute [rw] key
8208
+ # The key of the Amazon S3 object.
8209
+ # @return [String]
8210
+ #
8211
+ # @!attribute [rw] version_id
8212
+ # The version Id of the Amazon S3 object.
8213
+ # @return [String]
8214
+ #
8215
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/S3Object AWS API Documentation
8216
+ #
8217
+ class S3Object < Struct.new(
8218
+ :etag,
8219
+ :key,
8220
+ :version_id)
8221
+ SENSITIVE = []
8222
+ include Aws::Structure
8223
+ end
8224
+
7656
8225
  # Information about the S3 object that was scanned
7657
8226
  #
7658
8227
  # @!attribute [rw] object_arn
@@ -7688,10 +8257,11 @@ module Aws::GuardDuty
7688
8257
  include Aws::Structure
7689
8258
  end
7690
8259
 
7691
- # Contains information about a malware scan.
8260
+ # Contains information about malware scans associated with GuardDuty
8261
+ # Malware Protection for EC2.
7692
8262
  #
7693
8263
  # @!attribute [rw] detector_id
7694
- # The unique ID of the detector that the request is associated with.
8264
+ # The unique ID of the detector that is associated with the request.
7695
8265
  #
7696
8266
  # To find the `detectorId` in the current Region, see the Settings
7697
8267
  # page in the GuardDuty console, or run the [ListDetectors][1] API.
@@ -7723,7 +8293,7 @@ module Aws::GuardDuty
7723
8293
  # @return [String]
7724
8294
  #
7725
8295
  # @!attribute [rw] failure_reason
7726
- # Represents the reason for FAILED scan status.
8296
+ # Represents the reason for `FAILED` scan status.
7727
8297
  # @return [String]
7728
8298
  #
7729
8299
  # @!attribute [rw] scan_start_time
@@ -8046,6 +8616,55 @@ module Aws::GuardDuty
8046
8616
  include Aws::Structure
8047
8617
  end
8048
8618
 
8619
+ # Contains information about the GuardDuty attack sequence finding.
8620
+ #
8621
+ # @!attribute [rw] uid
8622
+ # Unique identifier of the attack sequence.
8623
+ # @return [String]
8624
+ #
8625
+ # @!attribute [rw] description
8626
+ # Description of the attack sequence.
8627
+ # @return [String]
8628
+ #
8629
+ # @!attribute [rw] actors
8630
+ # Contains information about the actors involved in the attack
8631
+ # sequence.
8632
+ # @return [Array<Types::Actor>]
8633
+ #
8634
+ # @!attribute [rw] resources
8635
+ # Contains information about the resources involved in the attack
8636
+ # sequence.
8637
+ # @return [Array<Types::ResourceV2>]
8638
+ #
8639
+ # @!attribute [rw] endpoints
8640
+ # Contains information about the network endpoints that were used in
8641
+ # the attack sequence.
8642
+ # @return [Array<Types::NetworkEndpoint>]
8643
+ #
8644
+ # @!attribute [rw] signals
8645
+ # Contains information about the signals involved in the attack
8646
+ # sequence.
8647
+ # @return [Array<Types::Signal>]
8648
+ #
8649
+ # @!attribute [rw] sequence_indicators
8650
+ # Contains information about the indicators observed in the attack
8651
+ # sequence.
8652
+ # @return [Array<Types::Indicator>]
8653
+ #
8654
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Sequence AWS API Documentation
8655
+ #
8656
+ class Sequence < Struct.new(
8657
+ :uid,
8658
+ :description,
8659
+ :actors,
8660
+ :resources,
8661
+ :endpoints,
8662
+ :signals,
8663
+ :sequence_indicators)
8664
+ SENSITIVE = []
8665
+ include Aws::Structure
8666
+ end
8667
+
8049
8668
  # Contains additional information about the generated finding.
8050
8669
  #
8051
8670
  # @!attribute [rw] action
@@ -8159,6 +8778,45 @@ module Aws::GuardDuty
8159
8778
  include Aws::Structure
8160
8779
  end
8161
8780
 
8781
+ # Contains information about the authenticated session.
8782
+ #
8783
+ # @!attribute [rw] uid
8784
+ # The unique identifier of the session.
8785
+ # @return [String]
8786
+ #
8787
+ # @!attribute [rw] mfa_status
8788
+ # Indicates whether or not multi-factor authencation (MFA) was used
8789
+ # during authentication.
8790
+ #
8791
+ # In Amazon Web Services CloudTrail, you can find this value as
8792
+ # `userIdentity.sessionContext.attributes.mfaAuthenticated`.
8793
+ # @return [String]
8794
+ #
8795
+ # @!attribute [rw] created_time
8796
+ # The timestamp for when the session was created.
8797
+ #
8798
+ # In Amazon Web Services CloudTrail, you can find this value as
8799
+ # `userIdentity.sessionContext.attributes.creationDate`.
8800
+ # @return [Time]
8801
+ #
8802
+ # @!attribute [rw] issuer
8803
+ # Identifier of the session issuer.
8804
+ #
8805
+ # In Amazon Web Services CloudTrail, you can find this value as
8806
+ # `userIdentity.sessionContext.sessionIssuer.arn`.
8807
+ # @return [String]
8808
+ #
8809
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Session AWS API Documentation
8810
+ #
8811
+ class Session < Struct.new(
8812
+ :uid,
8813
+ :mfa_status,
8814
+ :created_time,
8815
+ :issuer)
8816
+ SENSITIVE = []
8817
+ include Aws::Structure
8818
+ end
8819
+
8162
8820
  # Information about severity level for each finding type.
8163
8821
  #
8164
8822
  # @!attribute [rw] last_generated_at
@@ -8184,6 +8842,121 @@ module Aws::GuardDuty
8184
8842
  include Aws::Structure
8185
8843
  end
8186
8844
 
8845
+ # Contains information about the signals involved in the attack
8846
+ # sequence.
8847
+ #
8848
+ # @!attribute [rw] uid
8849
+ # The unique identifier of the signal.
8850
+ # @return [String]
8851
+ #
8852
+ # @!attribute [rw] type
8853
+ # The type of the signal used to identify an attack sequence.
8854
+ #
8855
+ # Signals can be GuardDuty findings or activities observed in data
8856
+ # sources that GuardDuty monitors. For more information, see
8857
+ # [Foundational data sources][1] in the *GuardDuty User Guide*.
8858
+ #
8859
+ # A signal type can be one of the valid values listed in this API.
8860
+ # Here are the related descriptions:
8861
+ #
8862
+ # * `FINDING` - Individually generated GuardDuty finding.
8863
+ #
8864
+ # * `CLOUD_TRAIL` - Activity observed from CloudTrail logs
8865
+ #
8866
+ # * `S3_DATA_EVENTS` - Activity observed from CloudTrail data events
8867
+ # for S3. Activities associated with this type will show up only
8868
+ # when you have enabled GuardDuty S3 Protection feature in your
8869
+ # account. For more information about S3 Protection and steps to
8870
+ # enable it, see [S3 Protection][2] in the *GuardDuty User Guide*.
8871
+ #
8872
+ #
8873
+ #
8874
+ # [1]: https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_data-sources.html
8875
+ # [2]: https://docs.aws.amazon.com/guardduty/latest/ug/s3-protection.html
8876
+ # @return [String]
8877
+ #
8878
+ # @!attribute [rw] description
8879
+ # The description of the signal.
8880
+ # @return [String]
8881
+ #
8882
+ # @!attribute [rw] name
8883
+ # The name of the signal. For example, when signal type is `FINDING`,
8884
+ # the signal name is the name of the finding.
8885
+ # @return [String]
8886
+ #
8887
+ # @!attribute [rw] created_at
8888
+ # The timestamp when the first finding or activity related to this
8889
+ # signal was observed.
8890
+ # @return [Time]
8891
+ #
8892
+ # @!attribute [rw] updated_at
8893
+ # The timestamp when this signal was last observed.
8894
+ # @return [Time]
8895
+ #
8896
+ # @!attribute [rw] first_seen_at
8897
+ # The timestamp when the first finding or activity related to this
8898
+ # signal was observed.
8899
+ # @return [Time]
8900
+ #
8901
+ # @!attribute [rw] last_seen_at
8902
+ # The timestamp when the last finding or activity related to this
8903
+ # signal was observed.
8904
+ # @return [Time]
8905
+ #
8906
+ # @!attribute [rw] severity
8907
+ # The severity associated with the signal. For more information about
8908
+ # severity, see [Findings severity levels][1] in the *GuardDuty User
8909
+ # Guide*.
8910
+ #
8911
+ #
8912
+ #
8913
+ # [1]: https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings-severity.html
8914
+ # @return [Float]
8915
+ #
8916
+ # @!attribute [rw] count
8917
+ # The number of times this signal was observed.
8918
+ # @return [Integer]
8919
+ #
8920
+ # @!attribute [rw] resource_uids
8921
+ # Information about the unique identifiers of the resources involved
8922
+ # in the signal.
8923
+ # @return [Array<String>]
8924
+ #
8925
+ # @!attribute [rw] actor_ids
8926
+ # Information about the IDs of the threat actors involved in the
8927
+ # signal.
8928
+ # @return [Array<String>]
8929
+ #
8930
+ # @!attribute [rw] endpoint_ids
8931
+ # Information about the endpoint IDs associated with this signal.
8932
+ # @return [Array<String>]
8933
+ #
8934
+ # @!attribute [rw] signal_indicators
8935
+ # Contains information about the indicators associated with the
8936
+ # signals.
8937
+ # @return [Array<Types::Indicator>]
8938
+ #
8939
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Signal AWS API Documentation
8940
+ #
8941
+ class Signal < Struct.new(
8942
+ :uid,
8943
+ :type,
8944
+ :description,
8945
+ :name,
8946
+ :created_at,
8947
+ :updated_at,
8948
+ :first_seen_at,
8949
+ :last_seen_at,
8950
+ :severity,
8951
+ :count,
8952
+ :resource_uids,
8953
+ :actor_ids,
8954
+ :endpoint_ids,
8955
+ :signal_indicators)
8956
+ SENSITIVE = []
8957
+ include Aws::Structure
8958
+ end
8959
+
8187
8960
  # Contains information about the criteria used for sorting findings.
8188
8961
  #
8189
8962
  # @!attribute [rw] attribute_name
@@ -8899,8 +9672,10 @@ module Aws::GuardDuty
8899
9672
  # @return [String]
8900
9673
  #
8901
9674
  # @!attribute [rw] auto_enable
8902
- # Represents whether or not to automatically enable member accounts in
8903
- # the organization.
9675
+ # Represents whether to automatically enable member accounts in the
9676
+ # organization. This applies to only new member accounts, not the
9677
+ # existing member accounts. When a new account joins the organization,
9678
+ # the chosen features will be enabled for them by default.
8904
9679
  #
8905
9680
  # Even though this is still supported, we recommend using
8906
9681
  # `AutoEnableOrganizationMembers` to achieve the similar results. You
@@ -9275,6 +10050,40 @@ module Aws::GuardDuty
9275
10050
  include Aws::Structure
9276
10051
  end
9277
10052
 
10053
+ # Contains information about the user involved in the attack sequence.
10054
+ #
10055
+ # @!attribute [rw] name
10056
+ # The name of the user.
10057
+ # @return [String]
10058
+ #
10059
+ # @!attribute [rw] uid
10060
+ # The unique identifier of the user.
10061
+ # @return [String]
10062
+ #
10063
+ # @!attribute [rw] type
10064
+ # The type of the user.
10065
+ # @return [String]
10066
+ #
10067
+ # @!attribute [rw] credential_uid
10068
+ # The credentials of the user ID.
10069
+ # @return [String]
10070
+ #
10071
+ # @!attribute [rw] account
10072
+ # Contains information about the Amazon Web Services account.
10073
+ # @return [Types::Account]
10074
+ #
10075
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/User AWS API Documentation
10076
+ #
10077
+ class User < Struct.new(
10078
+ :name,
10079
+ :uid,
10080
+ :type,
10081
+ :credential_uid,
10082
+ :account)
10083
+ SENSITIVE = []
10084
+ include Aws::Structure
10085
+ end
10086
+
9278
10087
  # Volume used by the Kubernetes workload.
9279
10088
  #
9280
10089
  # @!attribute [rw] name