phone-home's Introduction

phone-home

This serverless application provides a phone home endpoint for recording contacts from another deployed application.

It provides a demo integration of API Gateway + AWS Lambda + Node.js + Amazon DynamoDB

Deploy with CloudFormation

Prerequisites: Node.js and AWS CLI installed

Create an AWS Account and IAM User with the AdministratorAccess AWS Managed Policy
Run aws configure to put store that user's credentials in ~/.aws/credentials
Create an S3 bucket for storing the Lambda code and store its name in a shell variable with:
- export CODE_BUCKET=<bucket name>
Npm install:
- npm install
Build:
- npm run build
Upload package to S3, transform the CloudFormation template:
- npm run package
Deploy to CloudFormation:
- npm run deploy

Deploy from the AWS Serverless Application Repository

Hit "Deploy" from the application page

Usage

Find Invocation URL

In the API Gateway Console, navigate to APIs / your API / Dashboard
Find the Invocation url, something like https://xxxxxxxxx.execute-api.region.amazonaws.com/Prod/
- (Alternately, you can set up a custom domain name)

Command line

Post data:

curl -d '{"username":"you", "host":"localhost"}' https://xxxxxxxxx.execute-api.region.amazonaws.com/Prod/

Get data:

curl https://xxxxxxxxx.execute-api.region.amazonaws.com/

JavaScript

Post data for logged in user (Take care to comply with any applicable Do Not Track legislation):

// Phone home if we're not on localhost
function phoneHome(username) {
  if (!window.location.host.includes('localhost')) {
    fetch('https://xxxxxxxxx.execute-api.region.amazonaws.com/',
      {
        method: 'POST',
        body: JSON.stringify({
          username: username,
          host: window.location.host
        })
      });
  }
}