Amazon S3 configuration example - See an example of configuring an Amazon S3 cloud storage solution in order to retrieve information necessary for configuring backup or export of incidentsCortex XSOAR. - Administrator Guide - 8.13 - Cortex XSOAR - Cortex - Security Operations

Cortex XSOAR On-prem Documentation

Product
Cortex XSOAR
Version
8.13
Creation date
2026-02-12
Last date published
2026-05-27
Category
Administrator Guide
Solution
On-prem
Abstract

See an example of configuring an Amazon S3 cloud storage solution in order to retrieve information necessary for configuring backup or export of incidentsCortex XSOAR.

This example demonstrates how to configure an Amazon S3 external cloud storage solution before backing up or exporting incidents. You can adapt these steps for other S3-compatible buckets.

For complete Amazon configuration instructions, see:

Prerequisite

Before you begin, make sure you have:

  • An AWS account

  • Access to AWS Management Console

  • Permission to create a stack and its resources in AWS CloudFormation

  1. Configure an Amazon S3 bucket:

    1. Log into the AWS Management Console and navigate to the S3 service.

    2. Using the S3 console, create or configure a general purpose bucket.

    3. Record the bucket name and region for later.

  2. Generate an access key and a secret key for the bucket:

    1. Open the AWS Identity and Access Management (IAM) service. 

    2. Create a user. XSOAR uses this user to connect with the bucket you just created.

    3. In the Security credentials tab, create an access key using the Third-party service use case. The secret key is automatically generated.

    4. Record both keys for later.

  3. Create a role, and its permissions policy, for the bucket:

    1. In AWS Identity and Access Management (IAM), create a role and follow the wizard. 

    2. In Step 1, select AWS service as the trusted entity and S3 as the use case. Click Next.

    3. In Step 2, select PermissionsSet permissions boundary - optionalCreate role without a permissions boundaryto create a role. Click Next.

    4. Enter a role name and description. Then define a custom policy with the following JSON:

      {
         "Version": "2012-10-17",
         "Statement": 
         [ 
            { 
               "Effect": "Allow",         
               "Action": [
                  "s3:PutObject",
                  "s3:GetObject",
                  "s3:DeleteObject"
               ],
               "Resource": "arn:aws:s3:::YourBucketName/*"
            },
            {
               "Effect": "Allow","Action": "s3:ListBucket",
               "Resource": "arn:aws:s3:::YourBucketName"
            }
         ]}

      In the above JSON, replace YourBucketName with your actual bucket name in two places. This automatically associates the policy with the bucket via the Amazon Resource Name (ARN).

      Save the role and policy.

You can now configure Cortex XSOAR to back up and/or export incidents to Amazon S3 external cloud storage.