aws-sdk-guardduty 1.107.0 → 1.108.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
@@ -2590,10 +2679,15 @@ module Aws::GuardDuty
2590
2679
  # generate the finding.
2591
2680
  # @return [Types::Anomaly]
2592
2681
  #
2682
+ # @!attribute [rw] sequence
2683
+ # The details about the attack sequence.
2684
+ # @return [Types::Sequence]
2685
+ #
2593
2686
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Detection AWS API Documentation
2594
2687
  #
2595
2688
  class Detection < Struct.new(
2596
- :anomaly)
2689
+ :anomaly,
2690
+ :sequence)
2597
2691
  SENSITIVE = []
2598
2692
  include Aws::Structure
2599
2693
  end
@@ -2933,6 +3027,113 @@ module Aws::GuardDuty
2933
3027
  include Aws::Structure
2934
3028
  end
2935
3029
 
3030
+ # Details about the potentially impacted Amazon EC2 instance resource.
3031
+ #
3032
+ # @!attribute [rw] availability_zone
3033
+ # The availability zone of the Amazon EC2 instance. For more
3034
+ # information, see [Availability zones][1] in the *Amazon EC2 User
3035
+ # Guide*.
3036
+ #
3037
+ #
3038
+ #
3039
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones
3040
+ # @return [String]
3041
+ #
3042
+ # @!attribute [rw] image_description
3043
+ # The image description of the Amazon EC2 instance.
3044
+ # @return [String]
3045
+ #
3046
+ # @!attribute [rw] instance_state
3047
+ # The state of the Amazon EC2 instance. For more information, see
3048
+ # [Amazon EC2 instance state changes][1] in the *Amazon EC2 User
3049
+ # Guide*.
3050
+ #
3051
+ #
3052
+ #
3053
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html
3054
+ # @return [String]
3055
+ #
3056
+ # @!attribute [rw] iam_instance_profile
3057
+ # Contains information about the EC2 instance profile.
3058
+ # @return [Types::IamInstanceProfile]
3059
+ #
3060
+ # @!attribute [rw] instance_type
3061
+ # Type of the Amazon EC2 instance.
3062
+ # @return [String]
3063
+ #
3064
+ # @!attribute [rw] outpost_arn
3065
+ # The Amazon Resource Name (ARN) of the Amazon Web Services Outpost.
3066
+ # This shows applicable Amazon Web Services Outposts instances.
3067
+ # @return [String]
3068
+ #
3069
+ # @!attribute [rw] platform
3070
+ # The platform of the Amazon EC2 instance.
3071
+ # @return [String]
3072
+ #
3073
+ # @!attribute [rw] product_codes
3074
+ # The product code of the Amazon EC2 instance.
3075
+ # @return [Array<Types::ProductCode>]
3076
+ #
3077
+ # @!attribute [rw] ec2_network_interface_uids
3078
+ # The ID of the network interface.
3079
+ # @return [Array<String>]
3080
+ #
3081
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Ec2Instance AWS API Documentation
3082
+ #
3083
+ class Ec2Instance < Struct.new(
3084
+ :availability_zone,
3085
+ :image_description,
3086
+ :instance_state,
3087
+ :iam_instance_profile,
3088
+ :instance_type,
3089
+ :outpost_arn,
3090
+ :platform,
3091
+ :product_codes,
3092
+ :ec2_network_interface_uids)
3093
+ SENSITIVE = []
3094
+ include Aws::Structure
3095
+ end
3096
+
3097
+ # Contains information about the elastic network interface of the Amazon
3098
+ # EC2 instance.
3099
+ #
3100
+ # @!attribute [rw] ipv_6_addresses
3101
+ # A list of IPv6 addresses for the Amazon EC2 instance.
3102
+ # @return [Array<String>]
3103
+ #
3104
+ # @!attribute [rw] private_ip_addresses
3105
+ # Other private IP address information of the Amazon EC2 instance.
3106
+ # @return [Array<Types::PrivateIpAddressDetails>]
3107
+ #
3108
+ # @!attribute [rw] public_ip
3109
+ # The public IP address of the Amazon EC2 instance.
3110
+ # @return [String]
3111
+ #
3112
+ # @!attribute [rw] security_groups
3113
+ # The security groups associated with the Amazon EC2 instance.
3114
+ # @return [Array<Types::SecurityGroup>]
3115
+ #
3116
+ # @!attribute [rw] sub_net_id
3117
+ # The subnet ID of the Amazon EC2 instance.
3118
+ # @return [String]
3119
+ #
3120
+ # @!attribute [rw] vpc_id
3121
+ # The VPC ID of the Amazon EC2 instance.
3122
+ # @return [String]
3123
+ #
3124
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Ec2NetworkInterface AWS API Documentation
3125
+ #
3126
+ class Ec2NetworkInterface < Struct.new(
3127
+ :ipv_6_addresses,
3128
+ :private_ip_addresses,
3129
+ :public_ip,
3130
+ :security_groups,
3131
+ :sub_net_id,
3132
+ :vpc_id)
3133
+ SENSITIVE = []
3134
+ include Aws::Structure
3135
+ end
3136
+
2936
3137
  # Contains information about the details of the ECS Cluster.
2937
3138
  #
2938
3139
  # @!attribute [rw] name
@@ -3288,6 +3489,11 @@ module Aws::GuardDuty
3288
3489
  # The time and date when the finding was last updated.
3289
3490
  # @return [String]
3290
3491
  #
3492
+ # @!attribute [rw] associated_attack_sequence_arn
3493
+ # Amazon Resource Name (ARN) associated with the attack sequence
3494
+ # finding.
3495
+ # @return [String]
3496
+ #
3291
3497
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Finding AWS API Documentation
3292
3498
  #
3293
3499
  class Finding < Struct.new(
@@ -3305,7 +3511,8 @@ module Aws::GuardDuty
3305
3511
  :severity,
3306
3512
  :title,
3307
3513
  :type,
3308
- :updated_at)
3514
+ :updated_at,
3515
+ :associated_attack_sequence_arn)
3309
3516
  SENSITIVE = []
3310
3517
  include Aws::Structure
3311
3518
  end
@@ -4325,6 +4532,37 @@ module Aws::GuardDuty
4325
4532
  include Aws::Structure
4326
4533
  end
4327
4534
 
4535
+ # Contains information about the indicators that include a set of
4536
+ # signals observed in an attack sequence.
4537
+ #
4538
+ # @!attribute [rw] key
4539
+ # Specific indicator keys observed in the attack sequence.
4540
+ # @return [String]
4541
+ #
4542
+ # @!attribute [rw] values
4543
+ # Values associated with each indicator key. For example, if the
4544
+ # indicator key is `SUSPICIOUS_NETWORK`, then the value will be the
4545
+ # name of the network. If the indicator key is `ATTACK_TACTIC`, then
4546
+ # the value will be one of the MITRE tactics.
4547
+ #
4548
+ # For more information about the values associated with the key, see
4549
+ # GuardDuty Extended Threat Detection in the *GuardDuty User Guide.*
4550
+ # @return [Array<String>]
4551
+ #
4552
+ # @!attribute [rw] title
4553
+ # Title describing the indicator.
4554
+ # @return [String]
4555
+ #
4556
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Indicator AWS API Documentation
4557
+ #
4558
+ class Indicator < Struct.new(
4559
+ :key,
4560
+ :values,
4561
+ :title)
4562
+ SENSITIVE = []
4563
+ include Aws::Structure
4564
+ end
4565
+
4328
4566
  # Contains information about the details of an instance.
4329
4567
  #
4330
4568
  # @!attribute [rw] availability_zone
@@ -6109,6 +6347,20 @@ module Aws::GuardDuty
6109
6347
  include Aws::Structure
6110
6348
  end
6111
6349
 
6350
+ # Contains information about the network connection.
6351
+ #
6352
+ # @!attribute [rw] direction
6353
+ # The direction in which the network traffic is flowing.
6354
+ # @return [String]
6355
+ #
6356
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/NetworkConnection AWS API Documentation
6357
+ #
6358
+ class NetworkConnection < Struct.new(
6359
+ :direction)
6360
+ SENSITIVE = []
6361
+ include Aws::Structure
6362
+ end
6363
+
6112
6364
  # Contains information about the NETWORK\_CONNECTION action described in
6113
6365
  # the finding.
6114
6366
  #
@@ -6161,6 +6413,80 @@ module Aws::GuardDuty
6161
6413
  include Aws::Structure
6162
6414
  end
6163
6415
 
6416
+ # Contains information about network endpoints that were observed in the
6417
+ # attack sequence.
6418
+ #
6419
+ # @!attribute [rw] id
6420
+ # The ID of the network endpoint.
6421
+ # @return [String]
6422
+ #
6423
+ # @!attribute [rw] ip
6424
+ # The IP address associated with the network endpoint.
6425
+ # @return [String]
6426
+ #
6427
+ # @!attribute [rw] domain
6428
+ # The domain information for the network endpoint.
6429
+ # @return [String]
6430
+ #
6431
+ # @!attribute [rw] port
6432
+ # The port number associated with the network endpoint.
6433
+ # @return [Integer]
6434
+ #
6435
+ # @!attribute [rw] location
6436
+ # Information about the location of the network endpoint.
6437
+ # @return [Types::NetworkGeoLocation]
6438
+ #
6439
+ # @!attribute [rw] autonomous_system
6440
+ # The Autonomous System (AS) of the network endpoint.
6441
+ # @return [Types::AutonomousSystem]
6442
+ #
6443
+ # @!attribute [rw] connection
6444
+ # Information about the network connection.
6445
+ # @return [Types::NetworkConnection]
6446
+ #
6447
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/NetworkEndpoint AWS API Documentation
6448
+ #
6449
+ class NetworkEndpoint < Struct.new(
6450
+ :id,
6451
+ :ip,
6452
+ :domain,
6453
+ :port,
6454
+ :location,
6455
+ :autonomous_system,
6456
+ :connection)
6457
+ SENSITIVE = []
6458
+ include Aws::Structure
6459
+ end
6460
+
6461
+ # Contains information about network endpoint location.
6462
+ #
6463
+ # @!attribute [rw] city
6464
+ # The name of the city.
6465
+ # @return [String]
6466
+ #
6467
+ # @!attribute [rw] country
6468
+ # The name of the country.
6469
+ # @return [String]
6470
+ #
6471
+ # @!attribute [rw] latitude
6472
+ # The latitude information of the endpoint location.
6473
+ # @return [Float]
6474
+ #
6475
+ # @!attribute [rw] longitude
6476
+ # The longitude information of the endpoint location.
6477
+ # @return [Float]
6478
+ #
6479
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/NetworkGeoLocation AWS API Documentation
6480
+ #
6481
+ class NetworkGeoLocation < Struct.new(
6482
+ :city,
6483
+ :country,
6484
+ :latitude,
6485
+ :longitude)
6486
+ SENSITIVE = []
6487
+ include Aws::Structure
6488
+ end
6489
+
6164
6490
  # Contains information about the elastic network interface of the EC2
6165
6491
  # instance.
6166
6492
  #
@@ -6999,6 +7325,48 @@ module Aws::GuardDuty
6999
7325
  include Aws::Structure
7000
7326
  end
7001
7327
 
7328
+ # Describes public access policies that apply to the Amazon S3 bucket.
7329
+ #
7330
+ # For information about each of the following settings, see [Blocking
7331
+ # public access to your Amazon S3 storage][1] in the *Amazon S3 User
7332
+ # Guide*.
7333
+ #
7334
+ #
7335
+ #
7336
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
7337
+ #
7338
+ # @!attribute [rw] public_acl_access
7339
+ # Indicates whether or not there is a setting that allows public
7340
+ # access to the Amazon S3 buckets through access control lists (ACLs).
7341
+ # @return [String]
7342
+ #
7343
+ # @!attribute [rw] public_policy_access
7344
+ # Indicates whether or not there is a setting that allows public
7345
+ # access to the Amazon S3 bucket policy.
7346
+ # @return [String]
7347
+ #
7348
+ # @!attribute [rw] public_acl_ignore_behavior
7349
+ # Indicates whether or not there is a setting that ignores all public
7350
+ # access control lists (ACLs) on the Amazon S3 bucket and the objects
7351
+ # that it contains.
7352
+ # @return [String]
7353
+ #
7354
+ # @!attribute [rw] public_bucket_restrict_behavior
7355
+ # Indicates whether or not there is a setting that restricts access to
7356
+ # the bucket with specified policies.
7357
+ # @return [String]
7358
+ #
7359
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/PublicAccessConfiguration AWS API Documentation
7360
+ #
7361
+ class PublicAccessConfiguration < Struct.new(
7362
+ :public_acl_access,
7363
+ :public_policy_access,
7364
+ :public_acl_ignore_behavior,
7365
+ :public_bucket_restrict_behavior)
7366
+ SENSITIVE = []
7367
+ include Aws::Structure
7368
+ end
7369
+
7002
7370
  # Contains information about the resource type `RDSDBInstance` involved
7003
7371
  # in a GuardDuty finding.
7004
7372
  #
@@ -7110,7 +7478,7 @@ module Aws::GuardDuty
7110
7478
  # @return [String]
7111
7479
  #
7112
7480
  # @!attribute [rw] tags
7113
- # Information about the tag-key value pair.
7481
+ # Information about the tag key-value pair.
7114
7482
  # @return [Array<Types::Tag>]
7115
7483
  #
7116
7484
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/RdsLimitlessDbDetails AWS API Documentation
@@ -7310,6 +7678,44 @@ module Aws::GuardDuty
7310
7678
  include Aws::Structure
7311
7679
  end
7312
7680
 
7681
+ # Contains information about the Amazon Web Services resource that is
7682
+ # associated with the activity that prompted GuardDuty to generate a
7683
+ # finding.
7684
+ #
7685
+ # @!attribute [rw] s3_bucket
7686
+ # Contains information about the Amazon S3 bucket.
7687
+ # @return [Types::S3Bucket]
7688
+ #
7689
+ # @!attribute [rw] ec2_instance
7690
+ # Contains information about the Amazon EC2 instance.
7691
+ # @return [Types::Ec2Instance]
7692
+ #
7693
+ # @!attribute [rw] access_key
7694
+ # Contains information about the IAM access key details of a user that
7695
+ # involved in the GuardDuty finding.
7696
+ # @return [Types::AccessKey]
7697
+ #
7698
+ # @!attribute [rw] ec2_network_interface
7699
+ # Contains information about the elastic network interface of the
7700
+ # Amazon EC2 instance.
7701
+ # @return [Types::Ec2NetworkInterface]
7702
+ #
7703
+ # @!attribute [rw] s3_object
7704
+ # Contains information about the Amazon S3 object.
7705
+ # @return [Types::S3Object]
7706
+ #
7707
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ResourceData AWS API Documentation
7708
+ #
7709
+ class ResourceData < Struct.new(
7710
+ :s3_bucket,
7711
+ :ec2_instance,
7712
+ :access_key,
7713
+ :ec2_network_interface,
7714
+ :s3_object)
7715
+ SENSITIVE = []
7716
+ include Aws::Structure
7717
+ end
7718
+
7313
7719
  # Represents the resources that were scanned in the scan entry.
7314
7720
  #
7315
7721
  # @!attribute [rw] instance_arn
@@ -7404,6 +7810,64 @@ module Aws::GuardDuty
7404
7810
  include Aws::Structure
7405
7811
  end
7406
7812
 
7813
+ # Contains information about the Amazon Web Services resource that is
7814
+ # associated with the GuardDuty finding.
7815
+ #
7816
+ # @!attribute [rw] uid
7817
+ # The unique identifier of the resource.
7818
+ # @return [String]
7819
+ #
7820
+ # @!attribute [rw] name
7821
+ # The name of the resource.
7822
+ # @return [String]
7823
+ #
7824
+ # @!attribute [rw] account_id
7825
+ # The Amazon Web Services account ID to which the resource belongs.
7826
+ # @return [String]
7827
+ #
7828
+ # @!attribute [rw] resource_type
7829
+ # The type of the Amazon Web Services resource.
7830
+ # @return [String]
7831
+ #
7832
+ # @!attribute [rw] region
7833
+ # The Amazon Web Services Region where the resource belongs.
7834
+ # @return [String]
7835
+ #
7836
+ # @!attribute [rw] service
7837
+ # The Amazon Web Services service of the resource.
7838
+ # @return [String]
7839
+ #
7840
+ # @!attribute [rw] cloud_partition
7841
+ # The cloud partition within the Amazon Web Services Region to which
7842
+ # the resource belongs.
7843
+ # @return [String]
7844
+ #
7845
+ # @!attribute [rw] tags
7846
+ # Contains information about the tags associated with the resource.
7847
+ # @return [Array<Types::Tag>]
7848
+ #
7849
+ # @!attribute [rw] data
7850
+ # Contains information about the Amazon Web Services resource
7851
+ # associated with the activity that prompted GuardDuty to generate a
7852
+ # finding.
7853
+ # @return [Types::ResourceData]
7854
+ #
7855
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ResourceV2 AWS API Documentation
7856
+ #
7857
+ class ResourceV2 < Struct.new(
7858
+ :uid,
7859
+ :name,
7860
+ :account_id,
7861
+ :resource_type,
7862
+ :region,
7863
+ :service,
7864
+ :cloud_partition,
7865
+ :tags,
7866
+ :data)
7867
+ SENSITIVE = []
7868
+ include Aws::Structure
7869
+ end
7870
+
7407
7871
  # Additional information about the suspicious activity.
7408
7872
  #
7409
7873
  # @!attribute [rw] modifying_process
@@ -7570,6 +8034,78 @@ module Aws::GuardDuty
7570
8034
  include Aws::Structure
7571
8035
  end
7572
8036
 
8037
+ # Contains information about the Amazon S3 bucket policies and
8038
+ # encryption.
8039
+ #
8040
+ # @!attribute [rw] owner_id
8041
+ # The owner ID of the associated S3Amazon S3bucket.
8042
+ # @return [String]
8043
+ #
8044
+ # @!attribute [rw] created_at
8045
+ # The timestamp at which the Amazon S3 bucket was created.
8046
+ # @return [Time]
8047
+ #
8048
+ # @!attribute [rw] encryption_type
8049
+ # The type of encryption used for the Amazon S3 buckets and its
8050
+ # objects. For more information, see [Protecting data with server-side
8051
+ # encryption][1] in the *Amazon S3 User Guide*.
8052
+ #
8053
+ #
8054
+ #
8055
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
8056
+ # @return [String]
8057
+ #
8058
+ # @!attribute [rw] encryption_key_arn
8059
+ # The Amazon Resource Name (ARN) of the encryption key that is used to
8060
+ # encrypt the Amazon S3 bucket and its objects.
8061
+ # @return [String]
8062
+ #
8063
+ # @!attribute [rw] effective_permission
8064
+ # Describes the effective permissions on this S3 bucket, after
8065
+ # factoring all the attached policies.
8066
+ # @return [String]
8067
+ #
8068
+ # @!attribute [rw] public_read_access
8069
+ # Indicates whether or not the public read access is allowed for an
8070
+ # Amazon S3 bucket.
8071
+ # @return [String]
8072
+ #
8073
+ # @!attribute [rw] public_write_access
8074
+ # Indicates whether or not the public write access is allowed for an
8075
+ # Amazon S3 bucket.
8076
+ # @return [String]
8077
+ #
8078
+ # @!attribute [rw] account_public_access
8079
+ # Contains information about the public access policies that apply to
8080
+ # the Amazon S3 bucket at the account level.
8081
+ # @return [Types::PublicAccessConfiguration]
8082
+ #
8083
+ # @!attribute [rw] bucket_public_access
8084
+ # Contains information about public access policies that apply to the
8085
+ # Amazon S3 bucket.
8086
+ # @return [Types::PublicAccessConfiguration]
8087
+ #
8088
+ # @!attribute [rw] s3_object_uids
8089
+ # Represents a list of Amazon S3 object identifiers.
8090
+ # @return [Array<String>]
8091
+ #
8092
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/S3Bucket AWS API Documentation
8093
+ #
8094
+ class S3Bucket < Struct.new(
8095
+ :owner_id,
8096
+ :created_at,
8097
+ :encryption_type,
8098
+ :encryption_key_arn,
8099
+ :effective_permission,
8100
+ :public_read_access,
8101
+ :public_write_access,
8102
+ :account_public_access,
8103
+ :bucket_public_access,
8104
+ :s3_object_uids)
8105
+ SENSITIVE = []
8106
+ include Aws::Structure
8107
+ end
8108
+
7573
8109
  # Contains information on the S3 bucket.
7574
8110
  #
7575
8111
  # @!attribute [rw] arn
@@ -7653,6 +8189,31 @@ module Aws::GuardDuty
7653
8189
  include Aws::Structure
7654
8190
  end
7655
8191
 
8192
+ # Contains information about the Amazon S3 object.
8193
+ #
8194
+ # @!attribute [rw] etag
8195
+ # The entity tag is a hash of the Amazon S3 object. The ETag reflects
8196
+ # changes only to the contents of an object, and not its metadata.
8197
+ # @return [String]
8198
+ #
8199
+ # @!attribute [rw] key
8200
+ # The key of the Amazon S3 object.
8201
+ # @return [String]
8202
+ #
8203
+ # @!attribute [rw] version_id
8204
+ # The version Id of the Amazon S3 object.
8205
+ # @return [String]
8206
+ #
8207
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/S3Object AWS API Documentation
8208
+ #
8209
+ class S3Object < Struct.new(
8210
+ :etag,
8211
+ :key,
8212
+ :version_id)
8213
+ SENSITIVE = []
8214
+ include Aws::Structure
8215
+ end
8216
+
7656
8217
  # Information about the S3 object that was scanned
7657
8218
  #
7658
8219
  # @!attribute [rw] object_arn
@@ -8046,6 +8607,55 @@ module Aws::GuardDuty
8046
8607
  include Aws::Structure
8047
8608
  end
8048
8609
 
8610
+ # Contains information about the GuardDuty attack sequence finding.
8611
+ #
8612
+ # @!attribute [rw] uid
8613
+ # Unique identifier of the attack sequence.
8614
+ # @return [String]
8615
+ #
8616
+ # @!attribute [rw] description
8617
+ # Description of the attack sequence.
8618
+ # @return [String]
8619
+ #
8620
+ # @!attribute [rw] actors
8621
+ # Contains information about the actors involved in the attack
8622
+ # sequence.
8623
+ # @return [Array<Types::Actor>]
8624
+ #
8625
+ # @!attribute [rw] resources
8626
+ # Contains information about the resources involved in the attack
8627
+ # sequence.
8628
+ # @return [Array<Types::ResourceV2>]
8629
+ #
8630
+ # @!attribute [rw] endpoints
8631
+ # Contains information about the network endpoints that were used in
8632
+ # the attack sequence.
8633
+ # @return [Array<Types::NetworkEndpoint>]
8634
+ #
8635
+ # @!attribute [rw] signals
8636
+ # Contains information about the signals involved in the attack
8637
+ # sequence.
8638
+ # @return [Array<Types::Signal>]
8639
+ #
8640
+ # @!attribute [rw] sequence_indicators
8641
+ # Contains information about the indicators observed in the attack
8642
+ # sequence.
8643
+ # @return [Array<Types::Indicator>]
8644
+ #
8645
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Sequence AWS API Documentation
8646
+ #
8647
+ class Sequence < Struct.new(
8648
+ :uid,
8649
+ :description,
8650
+ :actors,
8651
+ :resources,
8652
+ :endpoints,
8653
+ :signals,
8654
+ :sequence_indicators)
8655
+ SENSITIVE = []
8656
+ include Aws::Structure
8657
+ end
8658
+
8049
8659
  # Contains additional information about the generated finding.
8050
8660
  #
8051
8661
  # @!attribute [rw] action
@@ -8159,6 +8769,45 @@ module Aws::GuardDuty
8159
8769
  include Aws::Structure
8160
8770
  end
8161
8771
 
8772
+ # Contains information about the authenticated session.
8773
+ #
8774
+ # @!attribute [rw] uid
8775
+ # The unique identifier of the session.
8776
+ # @return [String]
8777
+ #
8778
+ # @!attribute [rw] mfa_status
8779
+ # Indicates whether or not multi-factor authencation (MFA) was used
8780
+ # during authentication.
8781
+ #
8782
+ # In Amazon Web Services CloudTrail, you can find this value as
8783
+ # `userIdentity.sessionContext.attributes.mfaAuthenticated`.
8784
+ # @return [String]
8785
+ #
8786
+ # @!attribute [rw] created_time
8787
+ # The timestamp for when the session was created.
8788
+ #
8789
+ # In Amazon Web Services CloudTrail, you can find this value as
8790
+ # `userIdentity.sessionContext.attributes.creationDate`.
8791
+ # @return [Time]
8792
+ #
8793
+ # @!attribute [rw] issuer
8794
+ # Identifier of the session issuer.
8795
+ #
8796
+ # In Amazon Web Services CloudTrail, you can find this value as
8797
+ # `userIdentity.sessionContext.sessionIssuer.arn`.
8798
+ # @return [String]
8799
+ #
8800
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Session AWS API Documentation
8801
+ #
8802
+ class Session < Struct.new(
8803
+ :uid,
8804
+ :mfa_status,
8805
+ :created_time,
8806
+ :issuer)
8807
+ SENSITIVE = []
8808
+ include Aws::Structure
8809
+ end
8810
+
8162
8811
  # Information about severity level for each finding type.
8163
8812
  #
8164
8813
  # @!attribute [rw] last_generated_at
@@ -8184,6 +8833,121 @@ module Aws::GuardDuty
8184
8833
  include Aws::Structure
8185
8834
  end
8186
8835
 
8836
+ # Contains information about the signals involved in the attack
8837
+ # sequence.
8838
+ #
8839
+ # @!attribute [rw] uid
8840
+ # The unique identifier of the signal.
8841
+ # @return [String]
8842
+ #
8843
+ # @!attribute [rw] type
8844
+ # The type of the signal used to identify an attack sequence.
8845
+ #
8846
+ # Signals can be GuardDuty findings or activities observed in data
8847
+ # sources that GuardDuty monitors. For more information, see
8848
+ # [Foundational data sources][1] in the *GuardDuty User Guide*.
8849
+ #
8850
+ # A signal type can be one of the valid values listed in this API.
8851
+ # Here are the related descriptions:
8852
+ #
8853
+ # * `FINDING` - Individually generated GuardDuty finding.
8854
+ #
8855
+ # * `CLOUD_TRAIL` - Activity observed from CloudTrail logs
8856
+ #
8857
+ # * `S3_DATA_EVENTS` - Activity observed from CloudTrail data events
8858
+ # for S3. Activities associated with this type will show up only
8859
+ # when you have enabled GuardDuty S3 Protection feature in your
8860
+ # account. For more information about S3 Protection and steps to
8861
+ # enable it, see [S3 Protection][2] in the *GuardDuty User Guide*.
8862
+ #
8863
+ #
8864
+ #
8865
+ # [1]: https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_data-sources.html
8866
+ # [2]: https://docs.aws.amazon.com/guardduty/latest/ug/s3-protection.html
8867
+ # @return [String]
8868
+ #
8869
+ # @!attribute [rw] description
8870
+ # The description of the signal.
8871
+ # @return [String]
8872
+ #
8873
+ # @!attribute [rw] name
8874
+ # The name of the signal. For example, when signal type is `FINDING`,
8875
+ # the signal name is the name of the finding.
8876
+ # @return [String]
8877
+ #
8878
+ # @!attribute [rw] created_at
8879
+ # The timestamp when the first finding or activity related to this
8880
+ # signal was observed.
8881
+ # @return [Time]
8882
+ #
8883
+ # @!attribute [rw] updated_at
8884
+ # The timestamp when this signal was last observed.
8885
+ # @return [Time]
8886
+ #
8887
+ # @!attribute [rw] first_seen_at
8888
+ # The timestamp when the first finding or activity related to this
8889
+ # signal was observed.
8890
+ # @return [Time]
8891
+ #
8892
+ # @!attribute [rw] last_seen_at
8893
+ # The timestamp when the last finding or activity related to this
8894
+ # signal was observed.
8895
+ # @return [Time]
8896
+ #
8897
+ # @!attribute [rw] severity
8898
+ # The severity associated with the signal. For more information about
8899
+ # severity, see [Findings severity levels][1] in the *GuardDuty User
8900
+ # Guide*.
8901
+ #
8902
+ #
8903
+ #
8904
+ # [1]: https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_findings-severity.html
8905
+ # @return [Float]
8906
+ #
8907
+ # @!attribute [rw] count
8908
+ # The number of times this signal was observed.
8909
+ # @return [Integer]
8910
+ #
8911
+ # @!attribute [rw] resource_uids
8912
+ # Information about the unique identifiers of the resources involved
8913
+ # in the signal.
8914
+ # @return [Array<String>]
8915
+ #
8916
+ # @!attribute [rw] actor_ids
8917
+ # Information about the IDs of the threat actors involved in the
8918
+ # signal.
8919
+ # @return [Array<String>]
8920
+ #
8921
+ # @!attribute [rw] endpoint_ids
8922
+ # Information about the endpoint IDs associated with this signal.
8923
+ # @return [Array<String>]
8924
+ #
8925
+ # @!attribute [rw] signal_indicators
8926
+ # Contains information about the indicators associated with the
8927
+ # signals.
8928
+ # @return [Array<Types::Indicator>]
8929
+ #
8930
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Signal AWS API Documentation
8931
+ #
8932
+ class Signal < Struct.new(
8933
+ :uid,
8934
+ :type,
8935
+ :description,
8936
+ :name,
8937
+ :created_at,
8938
+ :updated_at,
8939
+ :first_seen_at,
8940
+ :last_seen_at,
8941
+ :severity,
8942
+ :count,
8943
+ :resource_uids,
8944
+ :actor_ids,
8945
+ :endpoint_ids,
8946
+ :signal_indicators)
8947
+ SENSITIVE = []
8948
+ include Aws::Structure
8949
+ end
8950
+
8187
8951
  # Contains information about the criteria used for sorting findings.
8188
8952
  #
8189
8953
  # @!attribute [rw] attribute_name
@@ -9275,6 +10039,40 @@ module Aws::GuardDuty
9275
10039
  include Aws::Structure
9276
10040
  end
9277
10041
 
10042
+ # Contains information about the user involved in the attack sequence.
10043
+ #
10044
+ # @!attribute [rw] name
10045
+ # The name of the user.
10046
+ # @return [String]
10047
+ #
10048
+ # @!attribute [rw] uid
10049
+ # The unique identifier of the user.
10050
+ # @return [String]
10051
+ #
10052
+ # @!attribute [rw] type
10053
+ # The type of the user.
10054
+ # @return [String]
10055
+ #
10056
+ # @!attribute [rw] credential_uid
10057
+ # The credentials of the user ID.
10058
+ # @return [String]
10059
+ #
10060
+ # @!attribute [rw] account
10061
+ # Contains information about the Amazon Web Services account.
10062
+ # @return [Types::Account]
10063
+ #
10064
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/User AWS API Documentation
10065
+ #
10066
+ class User < Struct.new(
10067
+ :name,
10068
+ :uid,
10069
+ :type,
10070
+ :credential_uid,
10071
+ :account)
10072
+ SENSITIVE = []
10073
+ include Aws::Structure
10074
+ end
10075
+
9278
10076
  # Volume used by the Kubernetes workload.
9279
10077
  #
9280
10078
  # @!attribute [rw] name