SearchS3 Help

SearchS3 First Run

Open the Credentials Panel by clicking the Main Menu then Tools then Credentials.

1. Choose the AWS Bucket region.
2. Choose the account type.
   • AWS Credentials Guide
   • Even though the SearchS3 application is designed to only read from S3 and your credentials are encrypted locally, we highly recommend creating credentials that are limited in scope and are set to read-only permissions. see arn:aws:iam::aws:policy/AmazonS3ReadOnlyAccess for details.
   • You can also choose: SSO or Assume Role account types.
3. Enter an account name, this value can be chosen freely but must be unique locally.
4. Enter the Access Key.
5. Enter the Secret Key.
6. Click the Save button.

Filtering Results

SearchS3 allows for combining all of our filters, Such as file-type and file-size or tags and modified-date.

Search S3 bucket with wildcard or regular-expression

1. Enter your wildcard or regular-expression statement in the query text box.
   • for help with regular-expressions we suggest regex101 make sure to select C# from the left hand side-bar.
2. Ensure the Use Regular Expressions checkbox is checked on.
3. Click the Search button.

S3 search by tag(s)

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'Tags' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
5. Enter the tags you are looking for seperated by a comma ",".
6. Click the Search button.

S3 search by file size

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'Size' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
5. Enter the minimum file size in bytes.
6. Enter the maximum file size in bytes.
7. Click the Search button.

S3 search by last-modified

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'Modified Before Date' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
5. Select the 'Modified After Date' drop down menu item in the advanced search panel.
6. Click the Add Filter(s) button.
7. Change each filter to match the date and times you want to search between.
8. Click the Search button.

S3 search by bucket(s)

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'Bucket' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
   • note that depending on the amount of buckets in your account, it may take a moment for the buckets list to show in the advanced filter screen.
5. Select one or more bucket names.
6. Click the Search button.

S3 search by storage-class

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'Storage Classes' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
5. Select one or more storage-classes.
6. Click the Search button.

S3 search by file-type

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'File Type' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
5. Enter one or more file extensions seperated by a comma ",".
6. Click the Search button.

S3 search by content

1. Enter your search in the query text box.
2. Click the Advanced Search link.
3. Select the 'Content' drop down menu item in the advanced search panel.
4. Click the Add Filter(s) button.
5. Enter the content that you want to search for.
6. Click the Search button.
   note: this is a very intensive process and will take much longer than our other filters. This is due to having to read every file and why this is limited to non-binary files, that are ≤ to 10 MB (10485760 bytes).