SMS Service

Configuring SMS Service will allow you to send pipeline notifications and 2FA messages to your mobile devices.

Overview

Buddy uses one of two AWS services to send SMS, Amazon SNS and Pinpoint. Each has its own pros and cons:

SNS

  • ✅ Supports Sender ID, i.e. name of the person sending the message
  • ❌ It's not possible to send message to U.S. numbers

Pinpoint

  • ✅ You can send messages to any country, including U.S. phone numbers
  • ❌ You need to be verified by AWS and receive a permission to use this service
  • ❌ Pricier than SNS

Below we describe how to set up each service to run on Buddy on-premises.

SNS configuration

Configure user in AWS

  1. Log in to your AWS account.
  2. Go to the Services tab and choose IAM.
  3. Then, head to UsersAdd user.
  4. Enter a username and choose Programmatic access in the access type.
  5. Click Attach existing policies directly and select AmazonSNSFullAccess
  6. When ready, click Next: ReviewCreate user (keep this tab open, you will need it in the next step).

You can also create your own Policy in which you have to allow sns:Publish.

Configure SNS app in Buddy

  1. Go to On-Premises Admin from the dashboard view.
  2. Switch to the 3-rd Party Apps tab and click Amazon SNS/Pinpoint.
  3. Set the sending service to Amazon SNS and paste the user data from your Amazon IAM.

Amazon SNS configurationAmazon SNS configuration

Pinpoint configuration

Create Pinpoint project

Log in to your AWS account and configure your Pinpoint service with these instructions.

Configure user in AWS

  1. Log in to your AWS account.
  2. Go to the Services tab and choose IAM.
  3. Then, head to UsersAdd user.
  4. Enter a username and choose Programmatic access in the access type.
  5. Create a new policy and select mobiletargeting:SendMessages
  6. When ready, click Next: ReviewCreate user (keep this tab open, you will need it in the next step).

Configure Pinpoint app in Buddy

  1. Go to On-Premises Admin from the dashboard view.
  2. Switch to the 3-rd Party Apps tab and click Amazon SNS/Pinpoint.
  3. Set the sending service to Amazon SNS and paste the user data from your Amazon IAM.
  4. Save changes and restart the machine to apply the new settings.

Amazon Pinpoint configurationAmazon Pinpoint configuration

Sign up for Buddy Digest

Best practices on CI/CD and fresh changelogs delivered weekly to your inbox.