1 Notify_ses
Chris Caron edited this page 2021-12-09 18:56:54 -05:00

Amazon Web Service (AWS) - Simple Email Service (SES)

Account Setup

You'll need to create an account with Amazon Web Service (AWS) first to use this. If you don't have one, you'll need your credit card (even though the first 12 months are free). Alternatively, if you already have one (or are using it through your company), you're good to go to the next step.

The next thing you'll need to do is generate an Access Key ID and Secret Access Key.:

  1. From the AWS Management Console search for IAM under the AWS services section or simply click here.
  2. Expand the section reading Access keys (access key ID and secret access key)
  3. Click on Create New Access Key
  4. It will present the information to you on screen and let you download a file containing the same information. I suggest you do so since there is no way to retrieve this key again later on (unless you delete it and create a new one).

So at this point, it is presumed you're set up, and you got your Access Key ID and Secret Access Key on hand.

You now have all the tools you need to send SES (Email) messages.

If you want to take advantage of sending your notifications to topics: from the AWS Management Console search for Simple Notification Service under the AWS services section and configure as many topics as you want. You'll be able to reference them as well using this notification service.

Syntax

The syntax is as follows:

  • ses://{from}/{aws_access_key}/{aws_secret_key}/{region}/
  • ses://{from}/{aws_access_key}/{aws_secret_key}/{region}/{ToEmail1}/{ToEmail2}/{ToEmailN}/

Parameter Breakdown

Variable Required Description
from Yes The originating source of the Email Address AWS is sending on behalf. AWS will validate this against your account (when paired with your aws_access_key and aws_secret_key)
access Yes The generated Access Key ID from the AWS Management Console
secret Yes The generated Access Key Secret from the AWS Management Console
region Yes The region code might look like us-east-1, us-west-2, cn-north-1, etc
target_emails Yes On ore more emails separated by a slash to deliver your notification to. If no email is specified then the from email is notified.
reply No If you want the email address ReplyTo address to be something other then your own email address, then you can specify it here.
to No This will enforce (or set the address the email is sent To). This is only required in special circumstances. The notification script is usually clever enough to figure this out for you.
name No With respect to {from_email}, this allows you to provide a name with your ReplyTo address.
cc No Carbon Copy email address(es). More than one can be separated with a space and/or comma.
bcc No Blind Carbon Copy email address(es). More than one can be separated with a space and/or comma.

Example

Send a AWS SES notification (Email):

# Assuming our {AccessKeyID} is AHIAJGNT76XIMXDBIJYA
# Assuming our {AccessKeySecret} is bu1dHSdO22pfaaVy/wmNsdljF4C07D3bndi9PQJ9
# Assuming our {Region} is us-east-2
# Assuming our {Email} - test@test.com
apprise -vv -t "Test Message Title" -b "Test Message Body" \
   ses://test@test.com/AHIAJGNT76XIMXDBIJYA/bu1dHSdO22pfaaVy/wmNsdljF4C07D3bndi9PQJ9/us-east-2/