AWS S3 Integration

First, create an IAM policy that grants the necessary permissions for Mixpeek to list and read objects from your S3 bucket.

1. Navigate to the IAM service in your AWS Console.

2. Go to Policies and click Create policy.

3. Switch to the JSON tab and paste the following policy document. Remember to replace YOUR_BUCKET_NAME with the actual name of your S3 bucket.

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

4. Click Next: Tags, then Next: Review.

5. Give the policy a descriptive name (e.g., MixpeekS3ReadAccessPolicy) and click Create policy.

Choose one of the following authentication methods:

Option A: IAM User (Simpler Setup)

1. In the IAM service, go to Users and click Add users.
2. Enter a user name (e.g., mixpeek-s3-user).
3. Select Access key - Programmatic access as the AWS credential type.
4. Click Next: Permissions.
5. Choose Attach existing policies directly.
6. Search for and select the policy you created in the previous step (e.g., MixpeekS3ReadAccessPolicy).
7. Click Next: Tags, then Next: Review, then Create user.
8. Important: Copy the Access key ID and Secret access key. You will need these to configure the connection in Mixpeek. Store them securely.

Option B: IAM Role (Recommended for Security)

• Follow AWS best practices to create an IAM role that Mixpeek can assume. This typically involves setting up a trust policy allowing Mixpeek’s AWS account (or a specific identifier provided by Mixpeek) to assume the role.
• Attach the MixpeekS3ReadAccessPolicy created in the previous step to this role.
• You will use the Role ARN when configuring the connection in Mixpeek instead of access keys. (Consult Mixpeek’s specific requirements for Role ARN setup if available).

1. Navigate to the Integrations or Data Sources section in your Mixpeek dashboard (or Mixpeek Studio).
2. Click Add Connection or New Source and select AWS S3.
3. Enter the required details:
   • Bucket Name: The name of your S3 bucket (e.g., YOUR_BUCKET_NAME).
   • Region: The AWS region where your bucket is located (e.g., us-east-1).
   • Authentication:
     • If using an IAM User: Provide the Access Key ID and Secret Access Key obtained previously.
     • If using an IAM Role: Provide the Role ARN obtained previously.
   • Optionally, specify a Prefix if you only want Mixpeek to process files within a specific folder in your bucket.
4. Click Test Connection (if available) to verify the credentials and permissions.
5. Click Save or Connect.