Create AWS S3 Integration

POSTpartner-integration/product-id/integration

Create the PC integration with AWS S3.

To obtain the cipsProductId, refer to Create Product.

Input ParametersInput Parameters

Parameter Name Mandatory/Optional Data Type Description
bucketName={value} Optional, if accessPointArn is provided. String Provide the name of the AWS S3 bucket being used for integration.
bucketRegion={value} Mandatory String Provide the region where the AWS S3 bucket is located.
accessPointArn = {value} Optional, if bucketName is provided. string

Provide the Access Point ARN. Steps to obtain this value are documented in step 4 of the AWS S3 Configuration.

When both bucketName and accessPointArn are set, the bucketName value is prioritized.

roleArn={value} Mandatory String Specify the ARN of the cross-account role which you created in your AWS account.
integrationType={value}
(
Mandatory String Specify the type of integration. Provide the value “aws_s3”.

Create PC IntegrationCreate PC Integration

API Request

curl --location '<qualys_gateway_url>/partner-integration/product-id/integration' --header 'accept: application/json' --header 'Content-Type: application/json' --header 'Authorization: Bearer token'  
    

Request POST Data (integration.json)

{
"integrationType": "aws_s3",
"bucketName": "pc-findings-rc",
"bucketRegion": "us-east-2",
"roleArn": "arn:aws:iam::xxxxxxxxxxxxx:role/pc-role-rc"
}   

JSON Output

 { "productName": "pc",
"integrationValidated": false,
"integrationConfig":
{ "externalId": "p01_sjc01-xxxxxx-xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" }
}