aws-sdk-guardduty 1.106.0 → 1.108.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-guardduty/client.rb +113 -2
- data/lib/aws-sdk-guardduty/client_api.rb +205 -0
- data/lib/aws-sdk-guardduty/types.rb +801 -4
- 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
|
@@ -1279,7 +1368,6 @@ module Aws::GuardDuty
|
|
1279
1368
|
# * **Medium**: `["4", "5", "6"]`
|
1280
1369
|
#
|
1281
1370
|
# * **High**: `["7", "8", "9"]`
|
1282
|
-
#
|
1283
1371
|
# For more information, see [Severity levels for GuardDuty
|
1284
1372
|
# findings][2].
|
1285
1373
|
#
|
@@ -2591,10 +2679,15 @@ module Aws::GuardDuty
|
|
2591
2679
|
# generate the finding.
|
2592
2680
|
# @return [Types::Anomaly]
|
2593
2681
|
#
|
2682
|
+
# @!attribute [rw] sequence
|
2683
|
+
# The details about the attack sequence.
|
2684
|
+
# @return [Types::Sequence]
|
2685
|
+
#
|
2594
2686
|
# @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Detection AWS API Documentation
|
2595
2687
|
#
|
2596
2688
|
class Detection < Struct.new(
|
2597
|
-
:anomaly
|
2689
|
+
:anomaly,
|
2690
|
+
:sequence)
|
2598
2691
|
SENSITIVE = []
|
2599
2692
|
include Aws::Structure
|
2600
2693
|
end
|
@@ -2934,6 +3027,113 @@ module Aws::GuardDuty
|
|
2934
3027
|
include Aws::Structure
|
2935
3028
|
end
|
2936
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
|
+
|
2937
3137
|
# Contains information about the details of the ECS Cluster.
|
2938
3138
|
#
|
2939
3139
|
# @!attribute [rw] name
|
@@ -3289,6 +3489,11 @@ module Aws::GuardDuty
|
|
3289
3489
|
# The time and date when the finding was last updated.
|
3290
3490
|
# @return [String]
|
3291
3491
|
#
|
3492
|
+
# @!attribute [rw] associated_attack_sequence_arn
|
3493
|
+
# Amazon Resource Name (ARN) associated with the attack sequence
|
3494
|
+
# finding.
|
3495
|
+
# @return [String]
|
3496
|
+
#
|
3292
3497
|
# @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Finding AWS API Documentation
|
3293
3498
|
#
|
3294
3499
|
class Finding < Struct.new(
|
@@ -3306,7 +3511,8 @@ module Aws::GuardDuty
|
|
3306
3511
|
:severity,
|
3307
3512
|
:title,
|
3308
3513
|
:type,
|
3309
|
-
:updated_at
|
3514
|
+
:updated_at,
|
3515
|
+
:associated_attack_sequence_arn)
|
3310
3516
|
SENSITIVE = []
|
3311
3517
|
include Aws::Structure
|
3312
3518
|
end
|
@@ -4326,6 +4532,37 @@ module Aws::GuardDuty
|
|
4326
4532
|
include Aws::Structure
|
4327
4533
|
end
|
4328
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
|
+
|
4329
4566
|
# Contains information about the details of an instance.
|
4330
4567
|
#
|
4331
4568
|
# @!attribute [rw] availability_zone
|
@@ -6110,6 +6347,20 @@ module Aws::GuardDuty
|
|
6110
6347
|
include Aws::Structure
|
6111
6348
|
end
|
6112
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
|
+
|
6113
6364
|
# Contains information about the NETWORK\_CONNECTION action described in
|
6114
6365
|
# the finding.
|
6115
6366
|
#
|
@@ -6162,6 +6413,80 @@ module Aws::GuardDuty
|
|
6162
6413
|
include Aws::Structure
|
6163
6414
|
end
|
6164
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
|
+
|
6165
6490
|
# Contains information about the elastic network interface of the EC2
|
6166
6491
|
# instance.
|
6167
6492
|
#
|
@@ -7000,6 +7325,48 @@ module Aws::GuardDuty
|
|
7000
7325
|
include Aws::Structure
|
7001
7326
|
end
|
7002
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
|
+
|
7003
7370
|
# Contains information about the resource type `RDSDBInstance` involved
|
7004
7371
|
# in a GuardDuty finding.
|
7005
7372
|
#
|
@@ -7111,7 +7478,7 @@ module Aws::GuardDuty
|
|
7111
7478
|
# @return [String]
|
7112
7479
|
#
|
7113
7480
|
# @!attribute [rw] tags
|
7114
|
-
# Information about the tag-
|
7481
|
+
# Information about the tag key-value pair.
|
7115
7482
|
# @return [Array<Types::Tag>]
|
7116
7483
|
#
|
7117
7484
|
# @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/RdsLimitlessDbDetails AWS API Documentation
|
@@ -7311,6 +7678,44 @@ module Aws::GuardDuty
|
|
7311
7678
|
include Aws::Structure
|
7312
7679
|
end
|
7313
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
|
+
|
7314
7719
|
# Represents the resources that were scanned in the scan entry.
|
7315
7720
|
#
|
7316
7721
|
# @!attribute [rw] instance_arn
|
@@ -7405,6 +7810,64 @@ module Aws::GuardDuty
|
|
7405
7810
|
include Aws::Structure
|
7406
7811
|
end
|
7407
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
|
+
|
7408
7871
|
# Additional information about the suspicious activity.
|
7409
7872
|
#
|
7410
7873
|
# @!attribute [rw] modifying_process
|
@@ -7571,6 +8034,78 @@ module Aws::GuardDuty
|
|
7571
8034
|
include Aws::Structure
|
7572
8035
|
end
|
7573
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
|
+
|
7574
8109
|
# Contains information on the S3 bucket.
|
7575
8110
|
#
|
7576
8111
|
# @!attribute [rw] arn
|
@@ -7654,6 +8189,31 @@ module Aws::GuardDuty
|
|
7654
8189
|
include Aws::Structure
|
7655
8190
|
end
|
7656
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
|
+
|
7657
8217
|
# Information about the S3 object that was scanned
|
7658
8218
|
#
|
7659
8219
|
# @!attribute [rw] object_arn
|
@@ -8047,6 +8607,55 @@ module Aws::GuardDuty
|
|
8047
8607
|
include Aws::Structure
|
8048
8608
|
end
|
8049
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
|
+
|
8050
8659
|
# Contains additional information about the generated finding.
|
8051
8660
|
#
|
8052
8661
|
# @!attribute [rw] action
|
@@ -8160,6 +8769,45 @@ module Aws::GuardDuty
|
|
8160
8769
|
include Aws::Structure
|
8161
8770
|
end
|
8162
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
|
+
|
8163
8811
|
# Information about severity level for each finding type.
|
8164
8812
|
#
|
8165
8813
|
# @!attribute [rw] last_generated_at
|
@@ -8185,6 +8833,121 @@ module Aws::GuardDuty
|
|
8185
8833
|
include Aws::Structure
|
8186
8834
|
end
|
8187
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
|
+
|
8188
8951
|
# Contains information about the criteria used for sorting findings.
|
8189
8952
|
#
|
8190
8953
|
# @!attribute [rw] attribute_name
|
@@ -9276,6 +10039,40 @@ module Aws::GuardDuty
|
|
9276
10039
|
include Aws::Structure
|
9277
10040
|
end
|
9278
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
|
+
|
9279
10076
|
# Volume used by the Kubernetes workload.
|
9280
10077
|
#
|
9281
10078
|
# @!attribute [rw] name
|