> ## Documentation Index
> Fetch the complete documentation index at: https://infisical.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Store Agent Vault session logs externally

> Store session logs in an Amazon S3 bucket that you own.

To keep session logs longer than 30 days, or in your own AWS account, store them in an Amazon S3 bucket you own.

> [!NOTE]
>
> External storage is a paid feature.
>
> If you're using Infisical Cloud, it's available under the **Enterprise Tier**. If you're self-hosting Infisical, contact [sales@infisical.com](mailto:sales@infisical.com) to purchase an enterprise license to use it.

Infisical reaches your bucket through an [AWS app connection](https://infisical.com/docs/integrations/app-connections/aws.md), which signs in to AWS by assuming an IAM role you create.

You'll switch between Infisical and AWS during setup: Infisical generates the AWS policy for your bucket, you set up the bucket and role in AWS, and then you create the connection in Infisical with the role's ARN.

## Prerequisites

* The [Admin role](https://infisical.com/docs/documentation/platform/agent-vault/access-control#product-membership) in your Agent Vault project
* An [Amazon S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) to store the records in
* Permission in AWS to edit the bucket's CORS configuration, create IAM roles, and attach policies to them

## Step 1: Start in Infisical

**Step 1**

In your Agent Vault project, go to **Administration** > **Settings** > **Session Logs** and select **Configure** or **Set Up Session Logs**.

![The Session Logs settings page of the project, showing session logs enabled in default storage, and its Configure button](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/agent-vault/settings-session-logs.png)

**Step 2**

Turn on **Enable**, then under **Storage**, select **External storage**.

**Step 3**

Enter the **Region** and **Bucket** of your S3 bucket.

**Step 4**

Optionally, enter a **Key Prefix** to store session logs under one path in a bucket you also use for other data.

![The Session Logs dialog with Enable turned on, External storage selected, no AWS connection yet, and a region, bucket, and key prefix filled in](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/agent-vault/session-logs-start.png)

**Step 5**

Select **View AWS Setup**. Infisical shows an **IAM policy** with your bucket and key prefix already filled in, so you can paste it into AWS as it is.

![The AWS Setup dialog on the IAM Policy tab, showing a policy that allows s3:PutObject and s3:GetObject under the agent-vault prefix and s3:ListBucket on the bucket](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/agent-vault/session-logs-aws-setup.png)

Leave the **Session Logs** dialog open. You'll fill in **AWS Connection** in [Step 3](#step-3-finish-in-infisical), after you create the role it uses. Open AWS in another browser tab.

## Step 2: Set up in AWS

### Add a CORS rule to the bucket

Your browser downloads session logs directly from your bucket, so the bucket has to accept requests from Infisical. Add a CORS rule for Infisical to the bucket.

**Step 1**

In the Amazon S3 console, open the session logs bucket, go to **Permissions**, and select **Edit** under **Cross-origin resource sharing (CORS)**.

**Step 2**

Paste this rule, then select **Save changes**. If the bucket already has CORS rules, add this rule's object to the existing array instead of replacing it, so other applications that use the bucket keep working:

```json Infisical Cloud (US) theme={"dark"}
[
    {
        "AllowedHeaders": ["*"],
        "AllowedMethods": ["GET"],
        "AllowedOrigins": ["https://app.infisical.com"],
        "MaxAgeSeconds": 3000
    }
]
```

```json Infisical Cloud (EU) theme={"dark"}
[
    {
        "AllowedHeaders": ["*"],
        "AllowedMethods": ["GET"],
        "AllowedOrigins": ["https://eu.infisical.com"],
        "MaxAgeSeconds": 3000
    }
]
```

If you self-host Infisical or use a dedicated instance, replace `AllowedOrigins` with your instance's URL.

### Create an IAM role for Infisical

> [!NOTE]
>
> If you already have an AWS app connection you want to use, skip to [Attach the IAM policy](#attach-the-iam-policy).

Infisical assumes this role to write session logs to the bucket.

> [accordion] If you self-host Infisical
>
> To assume a role, your Infisical instance needs AWS credentials of its own.
>
> If your instance runs on AWS (for example on EC2, ECS, or EKS), leave `INF_APP_CONNECTION_AWS_ACCESS_KEY_ID` and `INF_APP_CONNECTION_AWS_SECRET_ACCESS_KEY` unset. Infisical then uses the credentials of the instance profile, task role, or IAM role for service accounts (IRSA), and that role needs the `sts:AssumeRole` policy below.
>
> If your instance doesn't run on AWS, give it an IAM user:
>
> **Step 1**
>
> In the IAM console, [create an IAM user](https://console.aws.amazon.com/iam/home#/users/create) for your Infisical instance.
>
> **Step 2**
>
> Attach this inline policy to the user, so it can assume the roles your connections use:
>
> ```json theme={"dark"}
> {
>     "Version": "2012-10-17",
>     "Statement": [
>         {
>             "Sid": "AllowAssumeAnyRole",
>             "Effect": "Allow",
>             "Action": "sts:AssumeRole",
>             "Resource": "arn:aws:iam::*:role/*"
>         }
>     ]
> }
> ```
>
> **Step 3**
>
> Open the user's **Security credentials** tab and create an access key.
>
> ![Access Key Step 1](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/integrations/aws/integrations-aws-access-key-1.png)
>
> ![Access Key Step 2](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/integrations/aws/integrations-aws-access-key-2.png)
>
> ![Access Key Step 3](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/integrations/aws/integrations-aws-access-key-3.png)
>
> **Step 4**
>
> Set the access key ID as `INF_APP_CONNECTION_AWS_ACCESS_KEY_ID` and the secret access key as `INF_APP_CONNECTION_AWS_SECRET_ACCESS_KEY` in your instance's environment, then restart the instance.
>
> When you create the role's trust policy, enter the AWS account ID of this IAM user or instance role, not an Infisical Cloud account ID.

**Step 1**

In the IAM console, go to [Create role](https://console.aws.amazon.com/iam/home#/roles/create?step=selectEntities). Under **Trusted entity type**, select **AWS account**.

![IAM Role Creation](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/integrations/aws/integration-aws-iam-assume-role.png)

**Step 2**

Select **Another AWS account**, and enter the AWS account ID that Infisical assumes the role from:

* Infisical Cloud (US): `381492033652`
* Infisical Cloud (EU): `345594589636`
* Dedicated instance: contact Infisical support for your account ID
* Self-hosted: the account ID of your instance's credentials (see [If you self-host Infisical](#if-you-self-host-infisical))

Enable **Require external ID** and enter the ID of your Agent Vault project. It's shown under **Project ID** in the project's **Administration** > **Settings**.

Infisical sends this ID every time it assumes the role, so the role only works for connections in this project.

**Step 3**

Select **Next** to go to the **Add permissions** page. Then, select **Next** again without choosing a policy. You'll add the permissions as an inline policy after the role exists.

**Step 4**

Enter a **Role name** that includes Infisical and what the connection is for, such as `infisical-payments-prod`, then select **Create role**. CloudTrail logs every action Infisical takes under this role's name, so a descriptive name shows anyone reading the logs where those actions came from.

### Attach the IAM policy

Attach the **IAM policy** from [Step 1](#step-1-start-in-infisical) to the IAM role, or to the role or user your existing connection signs in as.

**Step 1**

In the IAM console, open the role or user. On the **Permissions** tab, select **Add permissions** > **Create inline policy**, switch to the **JSON** editor, and paste the policy.

**Step 2**

Select **Next**, enter a **Policy name**, then select **Create policy**.

**Step 3**

If you created a new role, copy its **ARN** from the **Summary** section.

![Copy IAM Role ARN](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/integrations/aws/integration-aws-iam-assume-arn.png)

## Step 3: Finish in Infisical

Go back to the **Session Logs** dialog.

**Step 1**

Under **AWS Connection**, select **Create New Connection**.

> [!NOTE]
>
> If you already have an AWS app connection you want to use, select it here instead. Then, select **Save** and skip the remaining steps.

**Step 2**

Enter a **Name**, keep the **Assume Role (Recommended)** method, paste the role's ARN into **Role ARN**, and select **Connect to AWS**. Infisical creates the connection in your Agent Vault project and selects it.

**Step 3**

Select **Save**.

![The Session Logs dialog with Enable turned on, External storage selected, and the acme-session-logs AWS connection, us-east-1 region, acme-agent-vault bucket, and agent-vault key prefix filled in](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/agent-vault/session-logs-setup.png)

When you save, Infisical checks that the bucket exists and that the IAM user or role can write to it. If either check fails, Infisical shows the error and doesn't save the settings. If your browser can't read from the bucket, the **Session Logs** card shows a warning after you save.

> [!TIP]
>
> You've successfully set up external storage for session logs.

## Connections

If you use external storage, session logs use one AWS connection at a time, which you select in the **Session Logs** dialog.

To update the connection's AWS credentials, open the menu next to **Configure** on the **Session Logs** card and select **Edit AWS Credentials**. If the connection belongs to your organization, update its credentials under **Integrations** in your organization instead.

To add or delete the project's AWS connections, select **Manage Connections** from the same menu:

![The Manage Connections sheet listing the project's two Assume Role AWS connections, with acme-session-logs marked In Use](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/platform/agent-vault/session-logs-connections.png)

You can't delete a connection while session logs use it. To delete the connection, first turn session logs off, select a different connection, or switch to default storage in the **Session Logs** dialog.

## Troubleshooting

If the AWS connection returns an error, a red alert icon appears next to **Settings** in the project's sidebar, and **Settings** > **Session Logs** shows the error.

If you set up external storage before your organization had Agent Vault projects, the IAM role's trust policy may require your Organization ID as the External ID. Infisical now sends the ID of the Agent Vault project instead, so it can't assume the role. In AWS, change the `sts:ExternalId` value in the role's trust policy to the project's ID (see [Find the project ID](https://infisical.com/docs/documentation/platform/agent-vault/projects.md#find-the-project-id)).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.