- Latest version: v2.0.0
- Compatible with Fusion version: 5.9.0 and later

If you are using Fusion 5.18.0 or later, you must upgrade to Amazon AWS S3 Pro v2.0.0.
Prerequisites
Perform these prerequisites to ensure the connector can reliably access, crawl, and index your data. Proper setup helps avoid configuration or permission errors, so use the following guidelines to keep your content available for discovery and search in Fusion.Connector installation
The AWS S3 Pro connector in Fusion is named ‘S3 Pro’ and is not preceded by ‘Amazon’ or ‘AWS.’ When creating an S3 datasource using the UI, Fusion automatically verifies that the user information supplied has access to the bucket defined in the URL property. If the bucket is not in the list returned by S3, datasource creation may fail. At crawl time, if the bucket is not in the list returned by S3, the crawl will fail. Permission errors when trying to create or crawl the datasource may be caused by incorrect username or password, or they may be due to user account permissions. The user account must have List Bucket permissions for the account which owns the bucket that the crawler is trying to access.AWS Permissions
The connector requires access to the following S3 operations:s3:ListBucketlists objects in the specified bucket or that use a desired prefix.s3:GetObjectfetches the content and metadata of each object.
BUCKET_NAME with the value used in your implementation.
Remote mode (optional)
To run the connector remotely, you need the following:- A Fusion user with the
remote-connectorsoradminrole for gRPC authentication. - The
connector-plugin-standalone.jaralongside the plugin ZIP on the remote host. - A configured connector backend gRPC endpoint (
hostname:port) in your YAML. - If the remote host doesn’t trust Fusion’s TLS cert, point to a truststore file path in your config.
Authentication
Setting up the correct authentication according to your organization’s data governance policies helps keep sensitive data secure while allowing authorized indexing. The AWS S3 Pro connector supports multiple authentication methods to access your Amazon S3 bucket. Choose one of the following based on your environment and security model:- Basic authentication using an access key and secret access key
- AWS session authentication using temporary credentials provided by AWS Security Token Service (STS)
- AWS instance credentials for role-based authentication if Fusion is running inside AWS
Basic authentication
Enable AWS Basic Authentication Settings and enter your AWS access key and AWS secret key.Session authentication
Session authentication uses temporary security credentials obtained from AWS STS. Enable AWS Basic Authentication Settings and enter your AWS access key, AWS secret key, and session token. These credentials must be unexpired at runtime.IAM Role for Fusion running in AWS
If Fusion or the remote connector is running on an EC2 instance or ECS task with an attached IAM role, do not enter credentials in the connector configuration as the connector will automatically use the role assigned to the host. Enable AWS Instance Credentials Authentication Settings and Use Instance Credentials. Make sure the IAM role has permissions to read objects from the S3 bucket and access any required prefixes or object paths.Retry logic
TheretryCount field sets the number of times the S3 client connection should retry when a document fails to index. Issues with AWS connectivity might result in the S3 connector being unable to crawl all of the data. The default for this field is retrying three times. If you are having trouble with AWS connectivity, try setting this field to a higher value, for example, 10 retries.
Remote connectors
V2 connectors support running remotely in Fusion versions 5.7.1 and later. For more information, see Configure remote V2 connectors. Below is an example configuration showing how to specify the file system to index under theconnector-plugins entry in your values.yaml file: