Setup Guide (Cloudflare R2)
Get started with bucketAV in 15 minutes. Follow this Setup Guide to:
- Subscribe to and install bucketAV.
- Scan your Cloudflare R2 buckets when new files arrive (optional).
- Scan your Cloudflare R2 buckets periodically (optional).
- Configure a weekly report (optional).
Do you have any questions? Please read the documentation and frequently asked questions, or email us.
Create an EC2 key pair (#)
bucketAV requires an EC2 Key Pair. To create a key pair:
- Go to the EC2 Management Console and navigate to Key Pairs.
- Click on Create key pair.
- Set a Name (e.g.,
bucketav
). - Select the Private key file format that fits your SSH client (
.ppk
for PuTTY; otherwise,.pem
). - Click on Create key pair.
Prepare Cloudflare account (#)
bucketAV requires an R2 subscription, Workers Paid plan subscription, API token and R2 access key.
- You need a R2 subscription to use Cloudflare R2.
- You need a Workers Paid plan subscription to use Cloudflare Workers and Queues.
- Create an API token to provide read and edit access to Queues, Workers, and R2 (manage queue, manage worker, manage R2 event notifications):
- Open the Cloudflare dashboard.
- Open your Profile.
- Navigate to API Tokens and click Create Token.
- Scroll down to the bottom. Next to Create Custom Token, click on Get started.
- Set Token Name to
bucketav
. - Set Permissions to:
- Account | Queues | Read |
- Account | Queues | Edit |
- Account | Workers R2 Storage | Read |
- Account | Workers R2 Storage | Edit |
- Account | Workers Scripts | Read |
- Account | Workers Scripts | Edit |
- Click Continue to summary.
- Click Create token.
- Save the token for later.
- Create an R2 access key to provide admin access to R2 (list buckets, read & write objects):
- In the Cloudflare dashboard, navigate to R2 and click Manage R2 API Tokens.
- Click Create API token.
- Set Token name to
bucketav
. - Set Permissions to Admin Read & Write.
- Click Create API token.
- Copy Access Key ID and Secret Access Key.
- In the Cloudflare dashboard, navigate to R2 and click Manage R2 API Tokens.
Subscribe to bucketAV in AWS Marketplace (#)
bucketAV supports two engines: Sophos® and ClamAV®. The following table compares the two engines. Pick the engine, that fits your needs and click on the Go to AWS Marketplace
button.
bucketAV for Cloudflare R2 powered by Sophos® | bucketAV for Cloudflare R2 powered by ClamAV® |
---|---|
Commercial antivirus engine | Open-source antivirus engine |
Immediate zero-day protection | |
High performance | Medium performance |
Maximum file size 5 TB | Maximum file size 2 GB |
Priority support via email | Standard support via email |
$0.025 per vCPU hour $0.20 per scanned GB | $0.025 per vCPU hour |
Go to AWS Marketplace | Go to AWS Marketplace |
After you selected the engine, that fits your need by clicking one of the Go to AWS Marketplace
links, proceed with the following steps.
- Click on Continue to Subscribe.
- Click on Accept Terms.
- The subscription is now
Pending
. - Wait until the subscription is active and click on Continue to Configuration.
- We provide three Delivery Methods:
Delivery Method Description Architecture Dedicated public VPC
(recommended)The recommended and cost-efficient option where the network setup is included. Open diagram Dedicated private VPC The EC2 instances run in private subnets (additional traffic charges apply). We recommend this option only if your internal security guidelines require it. Open diagram Existing VPC Deploy bucketAV into an existing VPC. Deploying bucketAV into an existing VPC increases the setup effort and the complexity. Read the Existing VPC Network Guide to prepare your VPC configuration. Open diagram - Click on Continue to Launch.
- Choose the Action
Launch CloudFormation
and click on Launch. - You are redirected to CloudFormation.
Install bucketAV (#)
bucketAV is managed and configured via CloudFormation.
- Click on Next.
- Set a Stack name (e.g.,
bucketav
). - Under Required Parameters:
- Set the KeyName configuration parameter to an EC2 Key Pair name.
- Set the CloudflareAccountId configuration parameter to your Cloudflare account ID.
- Set the CloudflareApiToken configuration parameter to the API token created earlier.
- Set the CloudflareAccessKeyId configuration parameter to the access key ID created earlier.
- Set the CloudflareAccessKeySecret configuration parameter to the access key secret created earlier.
- Review the rest of the configuration parameters and go with the defaults (recommended).
- Scroll to the bottom of the page and click on Next.
- Scroll to the bottom of the page and click on Next.
- Scroll to the bottom of the page, enable I acknowledge that AWS CloudFormation might create IAM resources, and click on Create.
- The stack status is CREATE_IN_PROGRESS. Reload the table from time to time and …
- … wait until the CloudFormation stack status switches to CREATE_COMPLETE.
bucketAV is now up and running.
Update bucketAV regularly to keep the product secure.
Receive a monthly digest of security updates, new capabilities, and best practices.
Continue to connect your R2 buckets.
Configure your R2 buckets (#)
- Visit the AWS CloudWatch Management Console.
- Navigate to Dashboards.
- Select the dashboard starting with the name
bucketav
followed by the name of the AWS region—for example,bucketav-eu-west-1
. - Find the Buckets tile. Enable real-time file scanning for each bucket you want by clicking the Enable button.
- Enable scheduled bucket scanning for each bucket you want by clicking the Enable button.
Continue to configure reporting and open the dashboard.
Reporting & Visibility (#)
Install the Reporting Add-On to receive a daily/weekly/monthly email report.
Check out the dashboard for complete visibility into bucketAV.
Request 14-day free trial (#)
Share your use case with us and receive a 14-day free trial.
The free trial covers the bucketAV software costs. Please note that AWS infrastructure and Amzon S3 API costs are not covered.
Do you have any questions? (#)
Check out the frequently asked questions, or send us an email.