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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-guardduty/client.rb +113 -1
- data/lib/aws-sdk-guardduty/client_api.rb +205 -0
- data/lib/aws-sdk-guardduty/types.rb +801 -3
- data/lib/aws-sdk-guardduty.rb +1 -1
- data/sig/types.rbs +179 -0
- metadata +2 -2
@@ -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-
|
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
|