Add instructions on how to configure SNS in AWS (#689)

This commit is contained in:
John Lindley 2016-07-27 13:02:58 -04:00 committed by Fabian Affolter
parent e79370dcdd
commit 95ee0f7839

View File

@ -40,3 +40,18 @@ Configuration variables:
AWS SNS is a notify platform and thus can be controlled by calling the notify service [as described here](/components/notify/). It will publish a message to all targets given in the notification payload. A target must be a SNS topic or endpoint ARN ([Amazon Resource Name](http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)). For more information, please see the [boto3 docs](http://boto3.readthedocs.io/en/latest/reference/services/sns.html#SNS.Client.publish).
If one exists, the SNS Subject will be set to the title. All attributes from the payload except message will be sent as stringified message attributes.
Setting up SNS within AWS:
- Log into your AWS console and under "Security and Identity", select "Identity & Access Management".
- On the left hand side, select "Users" then click “Create New Users”. Enter a name here and then click "Create".
- You can either download the credentials or click the arrow to display them one time.
**Caution** If you do not download them youll lose them and will have to recreate a new user.
- Copy/Paste the two Keys that youre provided here in your configuration.yaml respectively.
- On the left hand side of the screen go back to “Users” and select the user you just created. On the “Permissions” tab click the “Attach Policy” icon. Search for “SNS” and attach the policy “AmazonSNSFUullAccess”
- Back to the AWS Console you now need to find “SNS” and click in to that service. It is under the Mobile Services group.
- On the left hand side, select “Topics” then “Create new topic”
- Choose a Topic Name and Display Name.
- Now check the box next to the Topic you just created and under Actions, select “Subscribe to topic”
- In the box that pops up, select the Protocol = SMS and enter in the phone number next to "Endpoint" you wish to SMS. Now click "Create".
- Repeat for additional numbers
- Back in the "Users" section youll see a long alphanumeric line that starts with "arn:" and ends with the Topic Name you chose previously. This is what your “target” in Home Assistant will be.