aws-sdk-guardduty 1.107.0 → 1.109.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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