Upgrading Soapbox Mailer to Support AWS Signature Version 4

Starting October 1, 2020, Amazon Web Services requires all integrated services to use their AWS Signature Version 4 for connecting to AWS.  Starting with Soapbox Mailer v1.12, Soapbox Mailer supports the use of AWS Signature Version 4.

IMPORTANT:  If your organization installed Soapbox Mailer prior to version 1.11 (prior to September 20, 2020), in order to continue sending email via Soapbox Mailer after September 30, 2020, you must do the following.

1. Prepare for the upgrade by collecting your AWS information
2. Create a new Named Credential in your Salesforce org
3. Upgrade to at least Soapbox Mailer v1.12

Prepare for the upgrade by collecting your AWS information

1. Collect the following Amazon Web Services information for your account
   1. AWS Access Key ID = (your AWS Access Key ID)
   2. AWS Secret Access Key = (your AWS Secret Access Key)
   3. AWS Region = (your region, likely "us-east-1" if you're in the US, otherwise review Amazon's regions)

Create a new Named Credential in your Salesforce org

1. Login to Salesforce
2. Go to Setup > Quick Find search for "Named Credentials"
3. Click the "New Named Credential" button
4. Enter the following data on the "New Named Credential" page
   1. Label = "AWS SES for Soapbox Mailer"
   2. Name = "sbm_AWSSES"
   3. URL = "https://email.us-east-1.amazonaws.com/"
      1. IMPORTANT: make sure the final forward-slash is included in the URL.
      2. If you're using AWS in a region other than us-east-1, replace "us-east-1" with the appropriate region from the list of regions supplied by Amazon
   4. Certificate = (leave blank)
   5. Identity Type = "Named Principal"
   6. Authentication Protocol = "AWS Signature Version 4"
   7. AWS Access Key ID = (your AWS Access Key ID)
   8. AWS Secret Access Key = (your AWS Secret Access Key))
   9. AWS Region = (your region, likely "us-east-1")
   10. AWS Service = "email"
   11. Generate Authorization Header = (checked)
   12. Allow Merge Fields in HTTP Header = (unchecked)
   13. Allow Merge Fields in HTTP Body = (unchecked)
   14. Outbound Network Connection = (blank)
5. Click the Save button

Upgrade to at least Soapbox Mailer v1.12

1. Install the latest version of Soapbox Mailer from the AppExchange listing

If you run into any issues, please open a ticket with our support team at https://support.picnet.net.