import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { CreatePentestInput, CreatePentestOutput } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; /** * @public * * The input for {@link CreatePentestCommand}. */ export interface CreatePentestCommandInput extends CreatePentestInput { } /** * @public * * The output of {@link CreatePentestCommand}. */ export interface CreatePentestCommandOutput extends CreatePentestOutput, __MetadataBearer { } declare const CreatePentestCommand_base: { new (input: CreatePentestCommandInput): import("@smithy/core/client").CommandImpl; new (input: CreatePentestCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions; }; /** *

Creates a new pentest configuration in an agent space. A pentest defines the security test parameters, including target assets, risk type exclusions, and logging configuration.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { SecurityAgentClient, CreatePentestCommand } from "@aws-sdk/client-securityagent"; // ES Modules import * // const { SecurityAgentClient, CreatePentestCommand } = require("@aws-sdk/client-securityagent"); // CommonJS import * // import type { SecurityAgentClientConfig } from "@aws-sdk/client-securityagent"; * const config = {}; // type is SecurityAgentClientConfig * const client = new SecurityAgentClient(config); * const input = { // CreatePentestInput * title: "STRING_VALUE", // required * agentSpaceId: "STRING_VALUE", // required * assets: { // Assets * endpoints: [ // EndpointList * { // Endpoint * uri: "STRING_VALUE", * }, * ], * actors: [ // ActorList * { // Actor * identifier: "STRING_VALUE", * uris: [ // UriList * "STRING_VALUE", * ], * authentication: { // Authentication * providerType: "SECRETS_MANAGER" || "AWS_LAMBDA" || "AWS_IAM_ROLE" || "AWS_INTERNAL", * value: "STRING_VALUE", * }, * description: "STRING_VALUE", * enableEmailMfa: true || false, * mfaForwardingAddress: "STRING_VALUE", * }, * ], * documents: [ // DocumentList * { // DocumentInfo * s3Location: "STRING_VALUE", * artifactId: "STRING_VALUE", * integratedDocument: { // IntegratedDocument * integrationId: "STRING_VALUE", // required * resourceId: "STRING_VALUE", // required * }, * }, * ], * sourceCode: [ // SourceCodeRepositoryList * { // SourceCodeRepository * s3Location: "STRING_VALUE", * }, * ], * integratedRepositories: [ // IntegratedRepositoryList * { // IntegratedRepository * integrationId: "STRING_VALUE", // required * providerResourceId: "STRING_VALUE", // required * branch: "STRING_VALUE", * }, * ], * trustedCaCertificates: [ // TrustedCaCertificateList * { // TrustedCaCertificate * source: { // CaCertificateSource Union: only one key present * inlinePem: "STRING_VALUE", * artifactId: "STRING_VALUE", * s3Location: "STRING_VALUE", * }, * }, * ], * }, * excludeRiskTypes: [ // RiskTypeList * "CROSS_SITE_SCRIPTING" || "DEFAULT_CREDENTIALS" || "INSECURE_DIRECT_OBJECT_REFERENCE" || "PRIVILEGE_ESCALATION" || "SERVER_SIDE_TEMPLATE_INJECTION" || "COMMAND_INJECTION" || "CODE_INJECTION" || "SQL_INJECTION" || "ARBITRARY_FILE_UPLOAD" || "INSECURE_DESERIALIZATION" || "LOCAL_FILE_INCLUSION" || "INFORMATION_DISCLOSURE" || "PATH_TRAVERSAL" || "SERVER_SIDE_REQUEST_FORGERY" || "JSON_WEB_TOKEN_VULNERABILITIES" || "XML_EXTERNAL_ENTITY" || "FILE_DELETION" || "OTHER" || "GRAPHQL_VULNERABILITIES" || "BUSINESS_LOGIC_VULNERABILITIES" || "CRYPTOGRAPHIC_VULNERABILITIES" || "DENIAL_OF_SERVICE" || "FILE_ACCESS" || "FILE_CREATION" || "DATABASE_MODIFICATION" || "DATABASE_ACCESS" || "OUTBOUND_SERVICE_REQUEST" || "UNKNOWN", * ], * serviceRole: "STRING_VALUE", * logConfig: { // CloudWatchLog * logGroup: "STRING_VALUE", * logStream: "STRING_VALUE", * }, * vpcConfig: { // VpcConfig * vpcArn: "STRING_VALUE", * securityGroupArns: [ // SecurityGroupArns * "STRING_VALUE", * ], * subnetArns: [ // SubnetArns * "STRING_VALUE", * ], * }, * networkTrafficConfig: { // NetworkTrafficConfig * rules: [ // NetworkTrafficRuleList * { // NetworkTrafficRule * effect: "ALLOW" || "DENY", * pattern: "STRING_VALUE", * networkTrafficRuleType: "URL", * }, * ], * customHeaders: [ // CustomHeaderList * { // CustomHeader * name: "STRING_VALUE", * value: "STRING_VALUE", * }, * ], * }, * codeRemediationStrategy: "AUTOMATIC" || "DISABLED", * disableManagedSkills: [ // SkillTypeList * "FINDING_PERSONALIZATION" || "LOGIN_OPTIMIZATION", * ], * maxTaskHours: Number("double"), * }; * const command = new CreatePentestCommand(input); * const response = await client.send(command); * // { // CreatePentestOutput * // pentestId: "STRING_VALUE", * // title: "STRING_VALUE", * // createdAt: new Date("TIMESTAMP"), * // updatedAt: new Date("TIMESTAMP"), * // assets: { // Assets * // endpoints: [ // EndpointList * // { // Endpoint * // uri: "STRING_VALUE", * // }, * // ], * // actors: [ // ActorList * // { // Actor * // identifier: "STRING_VALUE", * // uris: [ // UriList * // "STRING_VALUE", * // ], * // authentication: { // Authentication * // providerType: "SECRETS_MANAGER" || "AWS_LAMBDA" || "AWS_IAM_ROLE" || "AWS_INTERNAL", * // value: "STRING_VALUE", * // }, * // description: "STRING_VALUE", * // enableEmailMfa: true || false, * // mfaForwardingAddress: "STRING_VALUE", * // }, * // ], * // documents: [ // DocumentList * // { // DocumentInfo * // s3Location: "STRING_VALUE", * // artifactId: "STRING_VALUE", * // integratedDocument: { // IntegratedDocument * // integrationId: "STRING_VALUE", // required * // resourceId: "STRING_VALUE", // required * // }, * // }, * // ], * // sourceCode: [ // SourceCodeRepositoryList * // { // SourceCodeRepository * // s3Location: "STRING_VALUE", * // }, * // ], * // integratedRepositories: [ // IntegratedRepositoryList * // { // IntegratedRepository * // integrationId: "STRING_VALUE", // required * // providerResourceId: "STRING_VALUE", // required * // branch: "STRING_VALUE", * // }, * // ], * // trustedCaCertificates: [ // TrustedCaCertificateList * // { // TrustedCaCertificate * // source: { // CaCertificateSource Union: only one key present * // inlinePem: "STRING_VALUE", * // artifactId: "STRING_VALUE", * // s3Location: "STRING_VALUE", * // }, * // }, * // ], * // }, * // excludeRiskTypes: [ // RiskTypeList * // "CROSS_SITE_SCRIPTING" || "DEFAULT_CREDENTIALS" || "INSECURE_DIRECT_OBJECT_REFERENCE" || "PRIVILEGE_ESCALATION" || "SERVER_SIDE_TEMPLATE_INJECTION" || "COMMAND_INJECTION" || "CODE_INJECTION" || "SQL_INJECTION" || "ARBITRARY_FILE_UPLOAD" || "INSECURE_DESERIALIZATION" || "LOCAL_FILE_INCLUSION" || "INFORMATION_DISCLOSURE" || "PATH_TRAVERSAL" || "SERVER_SIDE_REQUEST_FORGERY" || "JSON_WEB_TOKEN_VULNERABILITIES" || "XML_EXTERNAL_ENTITY" || "FILE_DELETION" || "OTHER" || "GRAPHQL_VULNERABILITIES" || "BUSINESS_LOGIC_VULNERABILITIES" || "CRYPTOGRAPHIC_VULNERABILITIES" || "DENIAL_OF_SERVICE" || "FILE_ACCESS" || "FILE_CREATION" || "DATABASE_MODIFICATION" || "DATABASE_ACCESS" || "OUTBOUND_SERVICE_REQUEST" || "UNKNOWN", * // ], * // serviceRole: "STRING_VALUE", * // logConfig: { // CloudWatchLog * // logGroup: "STRING_VALUE", * // logStream: "STRING_VALUE", * // }, * // agentSpaceId: "STRING_VALUE", * // }; * * ``` * * @param CreatePentestCommandInput - {@link CreatePentestCommandInput} * @returns {@link CreatePentestCommandOutput} * @see {@link CreatePentestCommandInput} for command's `input` shape. * @see {@link CreatePentestCommandOutput} for command's `response` shape. * @see {@link SecurityAgentClientResolvedConfig | config} for SecurityAgentClient's `config` shape. * * @throws {@link SecurityAgentServiceException} *

Base exception class for all service exceptions from SecurityAgent service.

* * * @public */ export declare class CreatePentestCommand extends CreatePentestCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: CreatePentestInput; output: CreatePentestOutput; }; sdk: { input: CreatePentestCommandInput; output: CreatePentestCommandOutput; }; }; }