@aws-sdk/client-guardduty 3.830.0 → 3.835.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.
- package/dist-cjs/index.js +148 -79
- package/dist-es/commands/GetFindingsCommand.js +1 -1
- package/dist-es/models/models_0.js +31 -11
- package/dist-es/models/models_1.js +12 -0
- package/dist-es/protocols/Aws_restJson1.js +34 -0
- package/dist-types/commands/GetAdministratorAccountCommand.d.ts +14 -4
- package/dist-types/commands/GetFindingsCommand.d.ts +34 -5
- package/dist-types/commands/GetFindingsStatisticsCommand.d.ts +1 -1
- package/dist-types/commands/GetInvitationsCountCommand.d.ts +1 -1
- package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
- package/dist-types/models/models_0.d.ts +207 -108
- package/dist-types/models/models_1.d.ts +104 -1
- package/dist-types/ts3.4/commands/GetFindingsCommand.d.ts +2 -1
- package/dist-types/ts3.4/commands/GetFindingsStatisticsCommand.d.ts +1 -1
- package/dist-types/ts3.4/commands/GetInvitationsCountCommand.d.ts +1 -1
- package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +4 -1
- package/dist-types/ts3.4/models/models_0.d.ts +60 -30
- package/dist-types/ts3.4/models/models_1.d.ts +34 -0
- package/package.json +11 -11
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { Command as $Command } from "@smithy/smithy-client";
|
|
2
2
|
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
|
|
3
3
|
import { GuardDutyClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GuardDutyClient";
|
|
4
|
-
import { GetFindingsRequest
|
|
4
|
+
import { GetFindingsRequest } from "../models/models_0";
|
|
5
|
+
import { GetFindingsResponse } from "../models/models_1";
|
|
5
6
|
/**
|
|
6
7
|
* @public
|
|
7
8
|
*/
|
|
@@ -834,6 +835,11 @@ declare const GetFindingsCommand_base: {
|
|
|
834
835
|
* // CreatedTime: new Date("TIMESTAMP"),
|
|
835
836
|
* // Issuer: "STRING_VALUE",
|
|
836
837
|
* // },
|
|
838
|
+
* // Process: { // ActorProcess
|
|
839
|
+
* // Name: "STRING_VALUE", // required
|
|
840
|
+
* // Path: "STRING_VALUE", // required
|
|
841
|
+
* // Sha256: "STRING_VALUE",
|
|
842
|
+
* // },
|
|
837
843
|
* // },
|
|
838
844
|
* // ],
|
|
839
845
|
* // Resources: [ // Resources
|
|
@@ -841,7 +847,7 @@ declare const GetFindingsCommand_base: {
|
|
|
841
847
|
* // Uid: "STRING_VALUE", // required
|
|
842
848
|
* // Name: "STRING_VALUE",
|
|
843
849
|
* // AccountId: "STRING_VALUE",
|
|
844
|
-
* // ResourceType: "EC2_INSTANCE" || "EC2_NETWORK_INTERFACE" || "S3_BUCKET" || "S3_OBJECT" || "ACCESS_KEY", // required
|
|
850
|
+
* // ResourceType: "EC2_INSTANCE" || "EC2_NETWORK_INTERFACE" || "S3_BUCKET" || "S3_OBJECT" || "ACCESS_KEY" || "EKS_CLUSTER" || "KUBERNETES_WORKLOAD" || "CONTAINER", // required
|
|
845
851
|
* // Region: "STRING_VALUE",
|
|
846
852
|
* // Service: "STRING_VALUE",
|
|
847
853
|
* // CloudPartition: "STRING_VALUE",
|
|
@@ -917,6 +923,26 @@ declare const GetFindingsCommand_base: {
|
|
|
917
923
|
* // Key: "STRING_VALUE",
|
|
918
924
|
* // VersionId: "STRING_VALUE",
|
|
919
925
|
* // },
|
|
926
|
+
* // EksCluster: { // EksCluster
|
|
927
|
+
* // Arn: "STRING_VALUE",
|
|
928
|
+
* // CreatedAt: new Date("TIMESTAMP"),
|
|
929
|
+
* // Status: "CREATING" || "ACTIVE" || "DELETING" || "FAILED" || "UPDATING" || "PENDING",
|
|
930
|
+
* // VpcId: "STRING_VALUE",
|
|
931
|
+
* // Ec2InstanceUids: [ // Ec2InstanceUids
|
|
932
|
+
* // "STRING_VALUE",
|
|
933
|
+
* // ],
|
|
934
|
+
* // },
|
|
935
|
+
* // KubernetesWorkload: { // KubernetesWorkload
|
|
936
|
+
* // ContainerUids: [ // ContainerUids
|
|
937
|
+
* // "STRING_VALUE",
|
|
938
|
+
* // ],
|
|
939
|
+
* // Namespace: "STRING_VALUE",
|
|
940
|
+
* // KubernetesResourcesTypes: "PODS" || "JOBS" || "CRONJOBS" || "DEPLOYMENTS" || "DAEMONSETS" || "STATEFULSETS" || "REPLICASETS" || "REPLICATIONCONTROLLERS",
|
|
941
|
+
* // },
|
|
942
|
+
* // Container: { // ContainerFindingResource
|
|
943
|
+
* // Image: "STRING_VALUE", // required
|
|
944
|
+
* // ImageUid: "STRING_VALUE",
|
|
945
|
+
* // },
|
|
920
946
|
* // },
|
|
921
947
|
* // },
|
|
922
948
|
* // ],
|
|
@@ -944,7 +970,7 @@ declare const GetFindingsCommand_base: {
|
|
|
944
970
|
* // Signals: [ // Signals // required
|
|
945
971
|
* // { // Signal
|
|
946
972
|
* // Uid: "STRING_VALUE", // required
|
|
947
|
-
* // Type: "FINDING" || "CLOUD_TRAIL" || "S3_DATA_EVENTS", // required
|
|
973
|
+
* // Type: "FINDING" || "CLOUD_TRAIL" || "S3_DATA_EVENTS" || "EKS_AUDIT_LOGS" || "FLOW_LOGS" || "DNS_LOGS" || "RUNTIME_MONITORING", // required
|
|
948
974
|
* // Description: "STRING_VALUE",
|
|
949
975
|
* // Name: "STRING_VALUE", // required
|
|
950
976
|
* // CreatedAt: new Date("TIMESTAMP"), // required
|
|
@@ -964,7 +990,7 @@ declare const GetFindingsCommand_base: {
|
|
|
964
990
|
* // ],
|
|
965
991
|
* // SignalIndicators: [ // Indicators
|
|
966
992
|
* // { // Indicator
|
|
967
|
-
* // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER", // required
|
|
993
|
+
* // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER" || "SUSPICIOUS_PROCESS" || "MALICIOUS_DOMAIN" || "MALICIOUS_PROCESS" || "CRYPTOMINING_IP" || "CRYPTOMINING_DOMAIN" || "CRYPTOMINING_PROCESS", // required
|
|
968
994
|
* // Values: [ // IndicatorValues
|
|
969
995
|
* // "STRING_VALUE",
|
|
970
996
|
* // ],
|
|
@@ -975,13 +1001,16 @@ declare const GetFindingsCommand_base: {
|
|
|
975
1001
|
* // ],
|
|
976
1002
|
* // SequenceIndicators: [
|
|
977
1003
|
* // {
|
|
978
|
-
* // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER", // required
|
|
1004
|
+
* // Key: "SUSPICIOUS_USER_AGENT" || "SUSPICIOUS_NETWORK" || "MALICIOUS_IP" || "TOR_IP" || "ATTACK_TACTIC" || "HIGH_RISK_API" || "ATTACK_TECHNIQUE" || "UNUSUAL_API_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_ACCOUNT" || "UNUSUAL_ASN_FOR_USER" || "SUSPICIOUS_PROCESS" || "MALICIOUS_DOMAIN" || "MALICIOUS_PROCESS" || "CRYPTOMINING_IP" || "CRYPTOMINING_DOMAIN" || "CRYPTOMINING_PROCESS", // required
|
|
979
1005
|
* // Values: [
|
|
980
1006
|
* // "STRING_VALUE",
|
|
981
1007
|
* // ],
|
|
982
1008
|
* // Title: "STRING_VALUE",
|
|
983
1009
|
* // },
|
|
984
1010
|
* // ],
|
|
1011
|
+
* // AdditionalSequenceTypes: [ // AdditionalSequenceTypes
|
|
1012
|
+
* // "STRING_VALUE",
|
|
1013
|
+
* // ],
|
|
985
1014
|
* // },
|
|
986
1015
|
* // },
|
|
987
1016
|
* // MalwareScanDetails: { // MalwareScanDetails
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Command as $Command } from "@smithy/smithy-client";
|
|
2
2
|
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
|
|
3
3
|
import { GuardDutyClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GuardDutyClient";
|
|
4
|
-
import { GetFindingsStatisticsRequest, GetFindingsStatisticsResponse } from "../models/
|
|
4
|
+
import { GetFindingsStatisticsRequest, GetFindingsStatisticsResponse } from "../models/models_1";
|
|
5
5
|
/**
|
|
6
6
|
* @public
|
|
7
7
|
*/
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Command as $Command } from "@smithy/smithy-client";
|
|
2
2
|
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
|
|
3
3
|
import { GuardDutyClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../GuardDutyClient";
|
|
4
|
-
import { GetInvitationsCountRequest, GetInvitationsCountResponse } from "../models/
|
|
4
|
+
import { GetInvitationsCountRequest, GetInvitationsCountResponse } from "../models/models_1";
|
|
5
5
|
/**
|
|
6
6
|
* @public
|
|
7
7
|
*/
|
|
@@ -8,7 +8,7 @@ export interface ClientInputEndpointParameters {
|
|
|
8
8
|
useFipsEndpoint?: boolean | undefined | Provider<boolean | undefined>;
|
|
9
9
|
endpoint?: string | Provider<string> | Endpoint | Provider<Endpoint> | EndpointV2 | Provider<EndpointV2>;
|
|
10
10
|
}
|
|
11
|
-
export type ClientResolvedEndpointParameters = ClientInputEndpointParameters & {
|
|
11
|
+
export type ClientResolvedEndpointParameters = Omit<ClientInputEndpointParameters, "endpoint"> & {
|
|
12
12
|
defaultSigningName: string;
|
|
13
13
|
};
|
|
14
14
|
export declare const resolveClientEndpointParameters: <T>(options: T & ClientInputEndpointParameters) => T & ClientResolvedEndpointParameters;
|
|
@@ -215,6 +215,34 @@ export interface AccountDetail {
|
|
|
215
215
|
AccountId: string | undefined;
|
|
216
216
|
/**
|
|
217
217
|
* <p>The email address of the member account.</p>
|
|
218
|
+
* <p>The rules for a valid email address:</p>
|
|
219
|
+
* <ul>
|
|
220
|
+
* <li>
|
|
221
|
+
* <p>The email address must be a minimum of 6 and a maximum of 64 characters long.</p>
|
|
222
|
+
* </li>
|
|
223
|
+
* <li>
|
|
224
|
+
* <p>All characters must be 7-bit ASCII characters.</p>
|
|
225
|
+
* </li>
|
|
226
|
+
* <li>
|
|
227
|
+
* <p>There must be one and only one @ symbol, which separates the local name from the domain name.</p>
|
|
228
|
+
* </li>
|
|
229
|
+
* <li>
|
|
230
|
+
* <p>The local name can't contain any of the following characters:</p>
|
|
231
|
+
* <p>whitespace, " ' ( ) < > [ ] : ' , \ | % &</p>
|
|
232
|
+
* </li>
|
|
233
|
+
* <li>
|
|
234
|
+
* <p>The local name can't begin with a dot (.).</p>
|
|
235
|
+
* </li>
|
|
236
|
+
* <li>
|
|
237
|
+
* <p>The domain name can consist of only the characters [a-z], [A-Z], [0-9], hyphen (-), or dot (.).</p>
|
|
238
|
+
* </li>
|
|
239
|
+
* <li>
|
|
240
|
+
* <p>The domain name can't begin or end with a dot (.) or hyphen (-).</p>
|
|
241
|
+
* </li>
|
|
242
|
+
* <li>
|
|
243
|
+
* <p>The domain name must contain at least one dot. </p>
|
|
244
|
+
* </li>
|
|
245
|
+
* </ul>
|
|
218
246
|
* @public
|
|
219
247
|
*/
|
|
220
248
|
Email: string | undefined;
|
|
@@ -1006,6 +1034,29 @@ export interface Action {
|
|
|
1006
1034
|
*/
|
|
1007
1035
|
KubernetesRoleDetails?: KubernetesRoleDetails | undefined;
|
|
1008
1036
|
}
|
|
1037
|
+
/**
|
|
1038
|
+
* <p>Contains information about a process involved in a GuardDuty finding, including process identification,
|
|
1039
|
+
* execution details, and file information.</p>
|
|
1040
|
+
* @public
|
|
1041
|
+
*/
|
|
1042
|
+
export interface ActorProcess {
|
|
1043
|
+
/**
|
|
1044
|
+
* <p>The name of the process as it appears in the system.</p>
|
|
1045
|
+
* @public
|
|
1046
|
+
*/
|
|
1047
|
+
Name: string | undefined;
|
|
1048
|
+
/**
|
|
1049
|
+
* <p>The full file path to the process executable on the system.</p>
|
|
1050
|
+
* @public
|
|
1051
|
+
*/
|
|
1052
|
+
Path: string | undefined;
|
|
1053
|
+
/**
|
|
1054
|
+
* <p>The SHA256 hash of the process executable file, which can be used for identification
|
|
1055
|
+
* and verification purposes.</p>
|
|
1056
|
+
* @public
|
|
1057
|
+
*/
|
|
1058
|
+
Sha256?: string | undefined;
|
|
1059
|
+
}
|
|
1009
1060
|
/**
|
|
1010
1061
|
* @public
|
|
1011
1062
|
* @enum
|
|
@@ -1098,6 +1149,13 @@ export interface Actor {
|
|
|
1098
1149
|
* @public
|
|
1099
1150
|
*/
|
|
1100
1151
|
Session?: Session | undefined;
|
|
1152
|
+
/**
|
|
1153
|
+
* <p>Contains information about the process associated with the threat actor.
|
|
1154
|
+
* This includes details such as process name, path, execution time, and
|
|
1155
|
+
* unique identifiers that help track the actor's activities within the system.</p>
|
|
1156
|
+
* @public
|
|
1157
|
+
*/
|
|
1158
|
+
Process?: ActorProcess | undefined;
|
|
1101
1159
|
}
|
|
1102
1160
|
/**
|
|
1103
1161
|
* <p>Information about the installed EKS add-on (GuardDuty security agent).</p>
|
|
@@ -1383,6 +1441,22 @@ export interface CloudTrailConfigurationResult {
|
|
|
1383
1441
|
*/
|
|
1384
1442
|
Status: DataSourceStatus | undefined;
|
|
1385
1443
|
}
|
|
1444
|
+
/**
|
|
1445
|
+
* @public
|
|
1446
|
+
* @enum
|
|
1447
|
+
*/
|
|
1448
|
+
export declare const ClusterStatus: {
|
|
1449
|
+
readonly ACTIVE: "ACTIVE";
|
|
1450
|
+
readonly CREATING: "CREATING";
|
|
1451
|
+
readonly DELETING: "DELETING";
|
|
1452
|
+
readonly FAILED: "FAILED";
|
|
1453
|
+
readonly PENDING: "PENDING";
|
|
1454
|
+
readonly UPDATING: "UPDATING";
|
|
1455
|
+
};
|
|
1456
|
+
/**
|
|
1457
|
+
* @public
|
|
1458
|
+
*/
|
|
1459
|
+
export type ClusterStatus = (typeof ClusterStatus)[keyof typeof ClusterStatus];
|
|
1386
1460
|
/**
|
|
1387
1461
|
* <p>Contains information about the condition.</p>
|
|
1388
1462
|
* @public
|
|
@@ -1572,6 +1646,25 @@ export interface Container {
|
|
|
1572
1646
|
*/
|
|
1573
1647
|
SecurityContext?: SecurityContext | undefined;
|
|
1574
1648
|
}
|
|
1649
|
+
/**
|
|
1650
|
+
* <p>Contains information about container resources involved in a GuardDuty finding.
|
|
1651
|
+
* This structure provides details about containers that were identified as part of
|
|
1652
|
+
* suspicious or malicious activity.</p>
|
|
1653
|
+
* @public
|
|
1654
|
+
*/
|
|
1655
|
+
export interface ContainerFindingResource {
|
|
1656
|
+
/**
|
|
1657
|
+
* <p>The container image information, including the image name and tag used to run the container
|
|
1658
|
+
* that was involved in the finding.</p>
|
|
1659
|
+
* @public
|
|
1660
|
+
*/
|
|
1661
|
+
Image: string | undefined;
|
|
1662
|
+
/**
|
|
1663
|
+
* <p>The unique ID associated with the container image.</p>
|
|
1664
|
+
* @public
|
|
1665
|
+
*/
|
|
1666
|
+
ImageUid?: string | undefined;
|
|
1667
|
+
}
|
|
1575
1668
|
/**
|
|
1576
1669
|
* <p>Contains information about the Amazon EC2 instance that is running
|
|
1577
1670
|
* the Amazon ECS container.</p>
|
|
@@ -3486,10 +3579,6 @@ export interface FilterCriterion {
|
|
|
3486
3579
|
/**
|
|
3487
3580
|
* <p>An enum value representing possible scan properties to match with given scan
|
|
3488
3581
|
* entries.</p>
|
|
3489
|
-
* <note>
|
|
3490
|
-
* <p>Replace the enum value <code>CLUSTER_NAME</code> with <code>EKS_CLUSTER_NAME</code>.
|
|
3491
|
-
* <code>CLUSTER_NAME</code> has been deprecated.</p>
|
|
3492
|
-
* </note>
|
|
3493
3582
|
* @public
|
|
3494
3583
|
*/
|
|
3495
3584
|
CriterionKey?: CriterionKey | undefined;
|
|
@@ -4444,6 +4533,78 @@ export interface Ec2NetworkInterface {
|
|
|
4444
4533
|
*/
|
|
4445
4534
|
VpcId?: string | undefined;
|
|
4446
4535
|
}
|
|
4536
|
+
/**
|
|
4537
|
+
* <p>Contains information about the Amazon EKS cluster involved in a GuardDuty finding,
|
|
4538
|
+
* including cluster identification, status, and network configuration.</p>
|
|
4539
|
+
* @public
|
|
4540
|
+
*/
|
|
4541
|
+
export interface EksCluster {
|
|
4542
|
+
/**
|
|
4543
|
+
* <p>The Amazon Resource Name (ARN) that uniquely identifies the Amazon EKS cluster involved in the finding.</p>
|
|
4544
|
+
* @public
|
|
4545
|
+
*/
|
|
4546
|
+
Arn?: string | undefined;
|
|
4547
|
+
/**
|
|
4548
|
+
* <p>The timestamp indicating when the Amazon EKS cluster was created, in UTC format.</p>
|
|
4549
|
+
* @public
|
|
4550
|
+
*/
|
|
4551
|
+
CreatedAt?: Date | undefined;
|
|
4552
|
+
/**
|
|
4553
|
+
* <p>The current status of the Amazon EKS cluster.</p>
|
|
4554
|
+
* @public
|
|
4555
|
+
*/
|
|
4556
|
+
Status?: ClusterStatus | undefined;
|
|
4557
|
+
/**
|
|
4558
|
+
* <p>The ID of the Amazon Virtual Private Cloud (Amazon VPC) associated with the Amazon EKS cluster.</p>
|
|
4559
|
+
* @public
|
|
4560
|
+
*/
|
|
4561
|
+
VpcId?: string | undefined;
|
|
4562
|
+
/**
|
|
4563
|
+
* <p>A list of unique identifiers for the Amazon EC2 instances that serve as worker nodes in the Amazon EKS cluster.</p>
|
|
4564
|
+
* @public
|
|
4565
|
+
*/
|
|
4566
|
+
Ec2InstanceUids?: string[] | undefined;
|
|
4567
|
+
}
|
|
4568
|
+
/**
|
|
4569
|
+
* @public
|
|
4570
|
+
* @enum
|
|
4571
|
+
*/
|
|
4572
|
+
export declare const KubernetesResourcesTypes: {
|
|
4573
|
+
readonly CRONJOBS: "CRONJOBS";
|
|
4574
|
+
readonly DAEMONSETS: "DAEMONSETS";
|
|
4575
|
+
readonly DEPLOYMENTS: "DEPLOYMENTS";
|
|
4576
|
+
readonly JOBS: "JOBS";
|
|
4577
|
+
readonly PODS: "PODS";
|
|
4578
|
+
readonly REPLICASETS: "REPLICASETS";
|
|
4579
|
+
readonly REPLICATIONCONTROLLERS: "REPLICATIONCONTROLLERS";
|
|
4580
|
+
readonly STATEFULSETS: "STATEFULSETS";
|
|
4581
|
+
};
|
|
4582
|
+
/**
|
|
4583
|
+
* @public
|
|
4584
|
+
*/
|
|
4585
|
+
export type KubernetesResourcesTypes = (typeof KubernetesResourcesTypes)[keyof typeof KubernetesResourcesTypes];
|
|
4586
|
+
/**
|
|
4587
|
+
* <p>Contains information about Kubernetes workloads involved in a GuardDuty finding,
|
|
4588
|
+
* including pods, deployments, and other Kubernetes resources.</p>
|
|
4589
|
+
* @public
|
|
4590
|
+
*/
|
|
4591
|
+
export interface KubernetesWorkload {
|
|
4592
|
+
/**
|
|
4593
|
+
* <p>A list of unique identifiers for the containers that are part of the Kubernetes workload.</p>
|
|
4594
|
+
* @public
|
|
4595
|
+
*/
|
|
4596
|
+
ContainerUids?: string[] | undefined;
|
|
4597
|
+
/**
|
|
4598
|
+
* <p>The Kubernetes namespace in which the workload is running, providing logical isolation within the cluster.</p>
|
|
4599
|
+
* @public
|
|
4600
|
+
*/
|
|
4601
|
+
Namespace?: string | undefined;
|
|
4602
|
+
/**
|
|
4603
|
+
* <p>The types of Kubernetes resources involved in the workload.</p>
|
|
4604
|
+
* @public
|
|
4605
|
+
*/
|
|
4606
|
+
KubernetesResourcesTypes?: KubernetesResourcesTypes | undefined;
|
|
4607
|
+
}
|
|
4447
4608
|
/**
|
|
4448
4609
|
* @public
|
|
4449
4610
|
* @enum
|
|
@@ -4621,6 +4782,24 @@ export interface ResourceData {
|
|
|
4621
4782
|
* @public
|
|
4622
4783
|
*/
|
|
4623
4784
|
S3Object?: S3Object | undefined;
|
|
4785
|
+
/**
|
|
4786
|
+
* <p>Contains detailed information about the Amazon EKS cluster associated with the activity that
|
|
4787
|
+
* prompted GuardDuty to generate a finding.</p>
|
|
4788
|
+
* @public
|
|
4789
|
+
*/
|
|
4790
|
+
EksCluster?: EksCluster | undefined;
|
|
4791
|
+
/**
|
|
4792
|
+
* <p>Contains detailed information about the Kubernetes workload associated with the activity that
|
|
4793
|
+
* prompted GuardDuty to generate a finding.</p>
|
|
4794
|
+
* @public
|
|
4795
|
+
*/
|
|
4796
|
+
KubernetesWorkload?: KubernetesWorkload | undefined;
|
|
4797
|
+
/**
|
|
4798
|
+
* <p>Contains detailed information about the container associated with the activity that
|
|
4799
|
+
* prompted GuardDuty to generate a finding.</p>
|
|
4800
|
+
* @public
|
|
4801
|
+
*/
|
|
4802
|
+
Container?: ContainerFindingResource | undefined;
|
|
4624
4803
|
}
|
|
4625
4804
|
/**
|
|
4626
4805
|
* @public
|
|
@@ -4628,8 +4807,11 @@ export interface ResourceData {
|
|
|
4628
4807
|
*/
|
|
4629
4808
|
export declare const FindingResourceType: {
|
|
4630
4809
|
readonly ACCESS_KEY: "ACCESS_KEY";
|
|
4810
|
+
readonly CONTAINER: "CONTAINER";
|
|
4631
4811
|
readonly EC2_INSTANCE: "EC2_INSTANCE";
|
|
4632
4812
|
readonly EC2_NETWORK_INTERFACE: "EC2_NETWORK_INTERFACE";
|
|
4813
|
+
readonly EKS_CLUSTER: "EKS_CLUSTER";
|
|
4814
|
+
readonly KUBERNETES_WORKLOAD: "KUBERNETES_WORKLOAD";
|
|
4633
4815
|
readonly S3_BUCKET: "S3_BUCKET";
|
|
4634
4816
|
readonly S3_OBJECT: "S3_OBJECT";
|
|
4635
4817
|
};
|
|
@@ -4712,9 +4894,15 @@ export interface ResourceV2 {
|
|
|
4712
4894
|
export declare const IndicatorType: {
|
|
4713
4895
|
readonly ATTACK_TACTIC: "ATTACK_TACTIC";
|
|
4714
4896
|
readonly ATTACK_TECHNIQUE: "ATTACK_TECHNIQUE";
|
|
4897
|
+
readonly CRYPTOMINING_DOMAIN: "CRYPTOMINING_DOMAIN";
|
|
4898
|
+
readonly CRYPTOMINING_IP: "CRYPTOMINING_IP";
|
|
4899
|
+
readonly CRYPTOMINING_PROCESS: "CRYPTOMINING_PROCESS";
|
|
4715
4900
|
readonly HIGH_RISK_API: "HIGH_RISK_API";
|
|
4901
|
+
readonly MALICIOUS_DOMAIN: "MALICIOUS_DOMAIN";
|
|
4716
4902
|
readonly MALICIOUS_IP: "MALICIOUS_IP";
|
|
4903
|
+
readonly MALICIOUS_PROCESS: "MALICIOUS_PROCESS";
|
|
4717
4904
|
readonly SUSPICIOUS_NETWORK: "SUSPICIOUS_NETWORK";
|
|
4905
|
+
readonly SUSPICIOUS_PROCESS: "SUSPICIOUS_PROCESS";
|
|
4718
4906
|
readonly SUSPICIOUS_USER_AGENT: "SUSPICIOUS_USER_AGENT";
|
|
4719
4907
|
readonly TOR_IP: "TOR_IP";
|
|
4720
4908
|
readonly UNUSUAL_API_FOR_ACCOUNT: "UNUSUAL_API_FOR_ACCOUNT";
|
|
@@ -4756,7 +4944,11 @@ export interface Indicator {
|
|
|
4756
4944
|
*/
|
|
4757
4945
|
export declare const SignalType: {
|
|
4758
4946
|
readonly CLOUD_TRAIL: "CLOUD_TRAIL";
|
|
4947
|
+
readonly DNS_LOGS: "DNS_LOGS";
|
|
4948
|
+
readonly EKS_AUDIT_LOGS: "EKS_AUDIT_LOGS";
|
|
4759
4949
|
readonly FINDING: "FINDING";
|
|
4950
|
+
readonly FLOW_LOGS: "FLOW_LOGS";
|
|
4951
|
+
readonly RUNTIME_MONITORING: "RUNTIME_MONITORING";
|
|
4760
4952
|
readonly S3_DATA_EVENTS: "S3_DATA_EVENTS";
|
|
4761
4953
|
};
|
|
4762
4954
|
/**
|
|
@@ -4905,6 +5097,12 @@ export interface Sequence {
|
|
|
4905
5097
|
* @public
|
|
4906
5098
|
*/
|
|
4907
5099
|
SequenceIndicators?: Indicator[] | undefined;
|
|
5100
|
+
/**
|
|
5101
|
+
* <p>Additional types of sequences that may be associated with the attack sequence finding,
|
|
5102
|
+
* providing further context about the nature of the detected threat.</p>
|
|
5103
|
+
* @public
|
|
5104
|
+
*/
|
|
5105
|
+
AdditionalSequenceTypes?: string[] | undefined;
|
|
4908
5106
|
}
|
|
4909
5107
|
/**
|
|
4910
5108
|
* <p>Contains information about the detected behavior.</p>
|
|
@@ -6667,7 +6865,11 @@ export interface Finding {
|
|
|
6667
6865
|
*/
|
|
6668
6866
|
Partition?: string | undefined;
|
|
6669
6867
|
/**
|
|
6670
|
-
* <p>The Region where the finding was generated
|
|
6868
|
+
* <p>The Region where the finding was generated. For findings generated
|
|
6869
|
+
* from <a href="https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-global-service-events">Global Service Events</a>, the Region value in the finding might differ from the Region where
|
|
6870
|
+
* GuardDuty identifies the potential threat. For more information,
|
|
6871
|
+
* see <a href="https://docs.aws.amazon.com/guardduty/latest/ug/guardduty_data-sources.html#cloudtrail_global">How GuardDuty
|
|
6872
|
+
* handles Amazon Web Services CloudTrail global events</a> in the <i>Amazon GuardDuty User Guide</i>.</p>
|
|
6671
6873
|
* @public
|
|
6672
6874
|
*/
|
|
6673
6875
|
Region: string | undefined;
|
|
@@ -7076,105 +7278,6 @@ export interface GetFindingsRequest {
|
|
|
7076
7278
|
*/
|
|
7077
7279
|
SortCriteria?: SortCriteria | undefined;
|
|
7078
7280
|
}
|
|
7079
|
-
/**
|
|
7080
|
-
* @public
|
|
7081
|
-
*/
|
|
7082
|
-
export interface GetFindingsResponse {
|
|
7083
|
-
/**
|
|
7084
|
-
* <p>A list of findings.</p>
|
|
7085
|
-
* @public
|
|
7086
|
-
*/
|
|
7087
|
-
Findings: Finding[] | undefined;
|
|
7088
|
-
}
|
|
7089
|
-
/**
|
|
7090
|
-
* @public
|
|
7091
|
-
* @enum
|
|
7092
|
-
*/
|
|
7093
|
-
export declare const GroupByType: {
|
|
7094
|
-
readonly ACCOUNT: "ACCOUNT";
|
|
7095
|
-
readonly DATE: "DATE";
|
|
7096
|
-
readonly FINDING_TYPE: "FINDING_TYPE";
|
|
7097
|
-
readonly RESOURCE: "RESOURCE";
|
|
7098
|
-
readonly SEVERITY: "SEVERITY";
|
|
7099
|
-
};
|
|
7100
|
-
/**
|
|
7101
|
-
* @public
|
|
7102
|
-
*/
|
|
7103
|
-
export type GroupByType = (typeof GroupByType)[keyof typeof GroupByType];
|
|
7104
|
-
/**
|
|
7105
|
-
* @public
|
|
7106
|
-
*/
|
|
7107
|
-
export interface GetFindingsStatisticsRequest {
|
|
7108
|
-
/**
|
|
7109
|
-
* <p>The ID of the detector whose findings statistics you
|
|
7110
|
-
* want to retrieve.</p>
|
|
7111
|
-
* <p>To find the <code>detectorId</code> in the current Region, see the
|
|
7112
|
-
* Settings page in the GuardDuty console, or run the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html">ListDetectors</a> API.</p>
|
|
7113
|
-
* @public
|
|
7114
|
-
*/
|
|
7115
|
-
DetectorId: string | undefined;
|
|
7116
|
-
/**
|
|
7117
|
-
* <p>The types of finding statistics to retrieve.</p>
|
|
7118
|
-
*
|
|
7119
|
-
* @deprecated
|
|
7120
|
-
* @public
|
|
7121
|
-
*/
|
|
7122
|
-
FindingStatisticTypes?: FindingStatisticType[] | undefined;
|
|
7123
|
-
/**
|
|
7124
|
-
* <p>Represents the criteria that is used for querying findings.</p>
|
|
7125
|
-
* @public
|
|
7126
|
-
*/
|
|
7127
|
-
FindingCriteria?: FindingCriteria | undefined;
|
|
7128
|
-
/**
|
|
7129
|
-
* <p>Displays the findings statistics grouped by one of the listed valid values.</p>
|
|
7130
|
-
* @public
|
|
7131
|
-
*/
|
|
7132
|
-
GroupBy?: GroupByType | undefined;
|
|
7133
|
-
/**
|
|
7134
|
-
* <p>Displays the sorted findings in the requested order. The default
|
|
7135
|
-
* value of <code>orderBy</code> is <code>DESC</code>.</p>
|
|
7136
|
-
* <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
|
|
7137
|
-
* @public
|
|
7138
|
-
*/
|
|
7139
|
-
OrderBy?: OrderBy | undefined;
|
|
7140
|
-
/**
|
|
7141
|
-
* <p>The maximum number of results to be returned in the response. The default value is 25.</p>
|
|
7142
|
-
* <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
|
|
7143
|
-
* @public
|
|
7144
|
-
*/
|
|
7145
|
-
MaxResults?: number | undefined;
|
|
7146
|
-
}
|
|
7147
|
-
/**
|
|
7148
|
-
* @public
|
|
7149
|
-
*/
|
|
7150
|
-
export interface GetFindingsStatisticsResponse {
|
|
7151
|
-
/**
|
|
7152
|
-
* <p>The finding statistics object.</p>
|
|
7153
|
-
* @public
|
|
7154
|
-
*/
|
|
7155
|
-
FindingStatistics: FindingStatistics | undefined;
|
|
7156
|
-
/**
|
|
7157
|
-
* <p>The pagination parameter to be used on the next list operation to retrieve more items.</p>
|
|
7158
|
-
* <p>This parameter is currently not supported.</p>
|
|
7159
|
-
* @public
|
|
7160
|
-
*/
|
|
7161
|
-
NextToken?: string | undefined;
|
|
7162
|
-
}
|
|
7163
|
-
/**
|
|
7164
|
-
* @public
|
|
7165
|
-
*/
|
|
7166
|
-
export interface GetInvitationsCountRequest {
|
|
7167
|
-
}
|
|
7168
|
-
/**
|
|
7169
|
-
* @public
|
|
7170
|
-
*/
|
|
7171
|
-
export interface GetInvitationsCountResponse {
|
|
7172
|
-
/**
|
|
7173
|
-
* <p>The number of received invitations.</p>
|
|
7174
|
-
* @public
|
|
7175
|
-
*/
|
|
7176
|
-
InvitationsCount?: number | undefined;
|
|
7177
|
-
}
|
|
7178
7281
|
/**
|
|
7179
7282
|
* @internal
|
|
7180
7283
|
*/
|
|
@@ -7263,7 +7366,3 @@ export declare const ServiceFilterSensitiveLog: (obj: Service) => any;
|
|
|
7263
7366
|
* @internal
|
|
7264
7367
|
*/
|
|
7265
7368
|
export declare const FindingFilterSensitiveLog: (obj: Finding) => any;
|
|
7266
|
-
/**
|
|
7267
|
-
* @internal
|
|
7268
|
-
*/
|
|
7269
|
-
export declare const GetFindingsResponseFilterSensitiveLog: (obj: GetFindingsResponse) => any;
|
|
@@ -1,4 +1,103 @@
|
|
|
1
|
-
import { AccountFreeTrialInfo, AdminAccount, AutoEnableMembers, CoverageFilterCriteria, CoverageResource, CoverageSortCriteria, CreateProtectedResource, DataSource, DataSourceConfigurations, DataSourceConfigurationsResult, Destination, DestinationProperties, DetectorFeatureConfiguration, EbsSnapshotPreservation, FeatureStatus, Feedback, FilterAction, FindingCriteria, FindingPublishingFrequency, IpSetFormat, MalwareProtectionPlanActions, OrgFeature, OrgFeatureAdditionalConfiguration, OrgFeatureStatus, SortCriteria, ThreatIntelSetFormat, UnprocessedAccount } from "./models_0";
|
|
1
|
+
import { AccountFreeTrialInfo, AdminAccount, AutoEnableMembers, CoverageFilterCriteria, CoverageResource, CoverageSortCriteria, CreateProtectedResource, DataSource, DataSourceConfigurations, DataSourceConfigurationsResult, Destination, DestinationProperties, DetectorFeatureConfiguration, EbsSnapshotPreservation, FeatureStatus, Feedback, FilterAction, Finding, FindingCriteria, FindingPublishingFrequency, FindingStatistics, FindingStatisticType, IpSetFormat, MalwareProtectionPlanActions, OrderBy, OrgFeature, OrgFeatureAdditionalConfiguration, OrgFeatureStatus, SortCriteria, ThreatIntelSetFormat, UnprocessedAccount } from "./models_0";
|
|
2
|
+
/**
|
|
3
|
+
* @public
|
|
4
|
+
*/
|
|
5
|
+
export interface GetFindingsResponse {
|
|
6
|
+
/**
|
|
7
|
+
* <p>A list of findings.</p>
|
|
8
|
+
* @public
|
|
9
|
+
*/
|
|
10
|
+
Findings: Finding[] | undefined;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* @public
|
|
14
|
+
* @enum
|
|
15
|
+
*/
|
|
16
|
+
export declare const GroupByType: {
|
|
17
|
+
readonly ACCOUNT: "ACCOUNT";
|
|
18
|
+
readonly DATE: "DATE";
|
|
19
|
+
readonly FINDING_TYPE: "FINDING_TYPE";
|
|
20
|
+
readonly RESOURCE: "RESOURCE";
|
|
21
|
+
readonly SEVERITY: "SEVERITY";
|
|
22
|
+
};
|
|
23
|
+
/**
|
|
24
|
+
* @public
|
|
25
|
+
*/
|
|
26
|
+
export type GroupByType = (typeof GroupByType)[keyof typeof GroupByType];
|
|
27
|
+
/**
|
|
28
|
+
* @public
|
|
29
|
+
*/
|
|
30
|
+
export interface GetFindingsStatisticsRequest {
|
|
31
|
+
/**
|
|
32
|
+
* <p>The ID of the detector whose findings statistics you
|
|
33
|
+
* want to retrieve.</p>
|
|
34
|
+
* <p>To find the <code>detectorId</code> in the current Region, see the
|
|
35
|
+
* Settings page in the GuardDuty console, or run the <a href="https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html">ListDetectors</a> API.</p>
|
|
36
|
+
* @public
|
|
37
|
+
*/
|
|
38
|
+
DetectorId: string | undefined;
|
|
39
|
+
/**
|
|
40
|
+
* <p>The types of finding statistics to retrieve.</p>
|
|
41
|
+
*
|
|
42
|
+
* @deprecated
|
|
43
|
+
* @public
|
|
44
|
+
*/
|
|
45
|
+
FindingStatisticTypes?: FindingStatisticType[] | undefined;
|
|
46
|
+
/**
|
|
47
|
+
* <p>Represents the criteria that is used for querying findings.</p>
|
|
48
|
+
* @public
|
|
49
|
+
*/
|
|
50
|
+
FindingCriteria?: FindingCriteria | undefined;
|
|
51
|
+
/**
|
|
52
|
+
* <p>Displays the findings statistics grouped by one of the listed valid values.</p>
|
|
53
|
+
* @public
|
|
54
|
+
*/
|
|
55
|
+
GroupBy?: GroupByType | undefined;
|
|
56
|
+
/**
|
|
57
|
+
* <p>Displays the sorted findings in the requested order. The default
|
|
58
|
+
* value of <code>orderBy</code> is <code>DESC</code>.</p>
|
|
59
|
+
* <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
|
|
60
|
+
* @public
|
|
61
|
+
*/
|
|
62
|
+
OrderBy?: OrderBy | undefined;
|
|
63
|
+
/**
|
|
64
|
+
* <p>The maximum number of results to be returned in the response. The default value is 25.</p>
|
|
65
|
+
* <p>You can use this parameter only with the <code>groupBy</code> parameter.</p>
|
|
66
|
+
* @public
|
|
67
|
+
*/
|
|
68
|
+
MaxResults?: number | undefined;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* @public
|
|
72
|
+
*/
|
|
73
|
+
export interface GetFindingsStatisticsResponse {
|
|
74
|
+
/**
|
|
75
|
+
* <p>The finding statistics object.</p>
|
|
76
|
+
* @public
|
|
77
|
+
*/
|
|
78
|
+
FindingStatistics: FindingStatistics | undefined;
|
|
79
|
+
/**
|
|
80
|
+
* <p>The pagination parameter to be used on the next list operation to retrieve more items.</p>
|
|
81
|
+
* <p>This parameter is currently not supported.</p>
|
|
82
|
+
* @public
|
|
83
|
+
*/
|
|
84
|
+
NextToken?: string | undefined;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* @public
|
|
88
|
+
*/
|
|
89
|
+
export interface GetInvitationsCountRequest {
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* @public
|
|
93
|
+
*/
|
|
94
|
+
export interface GetInvitationsCountResponse {
|
|
95
|
+
/**
|
|
96
|
+
* <p>The number of received invitations.</p>
|
|
97
|
+
* @public
|
|
98
|
+
*/
|
|
99
|
+
InvitationsCount?: number | undefined;
|
|
100
|
+
}
|
|
2
101
|
/**
|
|
3
102
|
* @public
|
|
4
103
|
*/
|
|
@@ -2484,6 +2583,10 @@ export interface UpdateThreatIntelSetRequest {
|
|
|
2484
2583
|
*/
|
|
2485
2584
|
export interface UpdateThreatIntelSetResponse {
|
|
2486
2585
|
}
|
|
2586
|
+
/**
|
|
2587
|
+
* @internal
|
|
2588
|
+
*/
|
|
2589
|
+
export declare const GetFindingsResponseFilterSensitiveLog: (obj: GetFindingsResponse) => any;
|
|
2487
2590
|
/**
|
|
2488
2591
|
* @internal
|
|
2489
2592
|
*/
|
|
@@ -5,7 +5,8 @@ import {
|
|
|
5
5
|
ServiceInputTypes,
|
|
6
6
|
ServiceOutputTypes,
|
|
7
7
|
} from "../GuardDutyClient";
|
|
8
|
-
import { GetFindingsRequest
|
|
8
|
+
import { GetFindingsRequest } from "../models/models_0";
|
|
9
|
+
import { GetFindingsResponse } from "../models/models_1";
|
|
9
10
|
export { __MetadataBearer };
|
|
10
11
|
export { $Command };
|
|
11
12
|
export interface GetFindingsCommandInput extends GetFindingsRequest {}
|