Human Trafficking Index

This AWS Serverless Application views of the people at risk of Human Trafficking listed here and stores it in an Amazon DynamoDB Table.

This application was created as part of a demo for the "Build on Serverless | Alexa and Serverless Apps - How to Hack for Good"

NOTE: Per the license this code is meant as an example and carries no warranty. Please learn from it!

The subject of this code is based nodejs and python files have been converted but remain unused and untested and there for dependency purposes. This was built on a used account and AWS IAM Policies will need to added to the current non-root user account.

Do not be tempted to publish AWS Serverless using your root credentials make a new user in AWS IAM and add only those policys needed my attaching policy if you make a json inline policy begin the policy with AWS_IAM_*, like * is CreateRole

NOTE: Per the license this code is meant as an example and carries no warranty. No responsibilty for security breach of doing an AWS configure using root credentials is accepted!!!

Please learn from it!

How does it work?

This code makes use of the claudiia package to digest the HTML content of a website and make it available as an object that can be parsed in JSON. The code then looks for all records from the index table processed and creates a JSON structure that can be inserted into DynamoDB.

The code is executed as part of an AWS Lambda function ( which can be triggered manually probably via and Alexa SDK Endpoint if so desired. The Lambda function can be deployed via AWS Serverless Application Model (AWS SAM) templates JSON package.json (see template.yml for python) have been created.

External dependencies

This application makes use of a few 3rd party external dependencies:

To install the dependencies, run the following command in the root directory of the code for python:

pip install -r requirements.txt -t ./

Creating the Human Trafficking Index table

Open AWS-cli ''' $ aws dynamodb create-table --table-name humantraffic --attribute-definitions AttributeName=humantrafficid,AttributeType=S --key-schema AttributeName=humantrafficid,KeyType=HASH --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1 --region us-east-1 --query TableDescription.TableArn --output text'''

resulting dynamodb arn


Deploying the Application

There are three primary ways to deploy this application:

  1. Use claudia to Deploy Node.js projects to AWS Lambda and API Gateway easily using claudia.js which will make AWS IAM policy and AWS Lambda Function. Create claudia.js in AWS-cli.

$ claudia create --region us-east-1 --api-module index --policies policy

  1. Use the AWS SAM CLI - via python pip

$ aws cloudformation package --template template.yml --s3-bucket humantraffic --output-template template-export.yml

  1. Deploy via the AWS Serverless Application repository:

Creating and deploying

$ claudia create --region us-east-1 --api-module index --policies policy

The resulting output is the api is below remember to add all AWS IAM Api policy to your user account or this will fail

apigateway.createDeployment restApiId=3qt51ctp55
{ "lambda": { "role": "human-Trafficking-executor", "name": "human-Trafficking", "region": "us-east-1" }, "api": { "id": "3qt51ctp55", "module": "index", "url": "" } }

Cloud Formation State

{ "StackId": "arn:aws:cloudformation:us-east-1:549511673151:stack/aws-serverless-repository-alexa-skills-kit-nodejs-factskillhumantrafic/1f6c5910-cc04-11e8-8258-500c2893c036",

"StackName": "aws-serverless-repository-alexa-skills-kit-nodejs-factskillhumantrafic",

"TemplateDescription": "Demonstrate human traffic Index built with the ASK NodeJS SDK",

"CreationTime": "2018-10-09T20:44:31.505Z",

"LastUpdatedTime": "2018-10-09T20:44:39.011Z GMT `15:44:39.0112 EST" ,

"StackStatus": "CREATE_COMPLETE" }

In this case we use the curl package so we can log the output

List all people

output all items in the tracking data in human-Trafficking table

curl ""

Add a person

curl -H "Content-Type: application/json" -X POST -d '{"humantrafficId":"123", "name":"Rene Gujan"}'

Testing deployment in a browser

This is really very simmple open the browser and list all the people output all items in the tracking data in human-Trafficking table

curl ""

Open a new tab in the browser paste the url, inside quotes.

The initial output with one entry is [{"name":"Fernando","humantrafficid":"258"}]

When taking advantage of dynamoDB add an extra record to list any extra infomation we get, this is becomes humantraffic index table has been fully populated an item being shown below is the largest entry

[{"name":"Fernando","humantrafficid":"258"},{"humantrafficid":"128","name":"Rene","Street":"Spilsby Road","lastName":"Gujaran","town":"Boston","Country birth":"Mexico","building":"The Mill Apartments","zip code":"MA1 234","state":"MA"}]

Now anyone through out the world can read this in a browser, but only you can update this table with curl command above from the AWS-cli. The generated code is protected by using a non-root credentials.

Add a person

curl -H "Content-Type: application/json" -X POST -d '{"humantrafficId":"123", "name":"Rene Gujan"}'

Alexa connection

The files to deploy the alexa Lambda have been added, but the linking to the Alexa Lambda is incomplete due to the lack of time


Copyright 2018, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: MIT-0

Built With

Share this project: