Virtual-Smart-Home - Backend

This repository contains the source code of the virtual-smart-home backend. It is published for users to inspect what happens behind the scenes.

Setting up your own backend

Follow these steps in order to set up the virtual-smart-home backend in your own AWS account:

Download the source code of the vsh backend
1. git clone git@github.com:csuermann/virtual-smart-home.git
2. Switch to the 'sandbox' branch
  
  git checkout --track origin/sandbox
Create a new AWS Account (or use your existing one)
1. Create a user for programatic access as described in the first 1 minute and 13 seconds of this video
2. export your newly created user credentials and default region as environment variables
  
  export AWS_ACCESS_KEY_ID=XXXXXXXXXXXXXXXXXXXX
  
  export AWS_SECRET_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  
  export AWS_DEFAULT_REGION=eu-west-1
Create an Amazon Developer Account (or use your existing one)
Create a new Alexa skill
1. Name it 'my private vsh'
2. Chose an appropriate 'Default Language' for you
3. Chose the 'Smart Home' model
4. Click next
5. Take note of 'Your Skill ID' and export it as an environment variable called 'SKILL_ID'
  
  export SKILL_ID=amzn1.ask.skill.xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
6. Click on 'Account Linking' in the side menu
7. Fill out the form fields
  - Your Web Authorization URI: https://www.amazon.com/ap/oa
  - Access Token URI: https://api.amazon.com/auth/o2/token
  - Your Client ID: put in xxx for now, you'll get the needed info in a later step
  - Your Secret: put in xxx for now, you'll get the needed info in a later step
  - Your Authentication Scheme: HTTP Basic
  - Scope: profile
8. Note down all 'Alexa Redirect URLs'
9. Click Save
Open a new browser tab / window
Create a new Security Profile
1. Security Profile Name: virtual smart home
2. Security Profile Description: security profile for virtual-smart-home skill
3. Click Save
4. Click on the tab 'Web Settings'
5. Copy 'Client ID' and 'Client Secret' into the respective fields on the Account Linking section (of your other browser tab)
6. Click Edit
7. Allowed Origins: leave empty
8. Allowed Return URLs: paste all 'Alexa Redirect URLs' you noted down earlier
9. Click Save
10. Click on the tab 'TV and other Device Settings'
11. Create a new "Device Client" called "node-red-contrib-virtual-smart-home"
12. Note down the 'Client Id'. You'll later need that Client Id to customize your installation of Node-RED-contrib-virtual-smart-home
In the Alexa Developer Console click on 'Permissions' in the side menu
Make sure that the 'Send Alexa Events' switch is toggled on
Take note of 'Alexa Client Id' and 'Alexa Client Secret' and export both as an environment variables

export ALEXA_CLIENT_ID=amzn1.application-oa2-client.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

export ALEXA_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Download and install the AWS CLI on your computer
Run the following command and note down the 'endpointAddress' for your AWS account

aws iot describe-endpoint --endpoint-type iot:Data-ATS
Export the value of 'endpointAddress' as an environment variable called 'IOT_ENDPOINT'

export IOT_ENDPOINT=xxxxxxxxxxxxxx-ats.iot.eu-west-1.amazonaws.com
Create an IoT Thing Type called 'virtual-smart-home-type'

aws iot create-thing-type --thing-type-name "virtual-smart-home-type"
Create an IoT Thing Group called 'virtual-smart-home-things'

aws iot create-thing-group --thing-group-name "virtual-smart-home-things"
Create an IoT Billing Group called 'virtual-smart-home-billing-group'

aws iot create-billing-group --billing-group-name virtual-smart-home-billing-group
Update the IoT index configuration

aws iot update-indexing-configuration --thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW, thingConnectivityIndexingMode=STATUS"

NOTE: See AWS pricing for IoT Device Management. Performing this step is not strictly needed to get VSH up and running. If you do not want to enable thing indexing, consider commenting out the metrics endpoint in serverless.yml to prevent your CloudWatch logs from being flooded with error messages.
Register for an Momento account and export the provided token as an environment variable called 'MOMENTO_TOKEN'

export MOMENTO_TOKEN=xxxxxxxxxx
Create 2 environment variable called 'HASH_SECRET' and 'VSH_ADMIN_API_KEY' containing random strings

export HASH_SECRET=foobar28429789

export VSH_ADMIN_API_KEY=unguessable8823472893472
Create additional environment variables used by the serverless deploy process

export IS_PROD=false

export LOG_LEVEL=debug

export STRIPE_API_KEY=abc

export STRIPE_WEBHOOK_SECRET=xyz
run npm install
install the serverless framework by running npm install -g serverless
run serverless deploy
Note down the POST endpoint printed as part of the serverless deploy output
- e.g. https://xxxxxxxxxx.execute-api.eu-west-1.amazonaws.com/dev/provision
Run the following command and note down the 'FunctionArn'

aws lambda get-function --function-name virtual-smart-home-dev-skill
In the Alexa Developer Console click on 'Smart Home' in the side menu
Paste the value of the FunctionArn (from step 23) as 'Default Endpoint' as well as for 'Europe / India'
Click Save
Your own backend should now be set up! Congratulations!

Configuring Node-RED

Now you need to configure your Node-RED vsh-connection node to use your backend instead of the official one.

Open the settings.js file of your Node-RED installation and add the following just before the closing "}"
```
vshConnectionShowSettings: true,
```
Restart Node-RED
Create a new vsh node and chose 'add new vsh-connection' from the connection dropdown
Replace the 'Backend URL' with the value you noted down in step 23, BUT WITHOUT THE trailing '/provision' !!!
Replace 'LWA Client ID' with the value you noted down as 'Client Id' in step 6.12
Click 'Add'
Come back to the previous page by clicking the pen-icon
Follow the account linking instructions, which should now go against your own backend

Testing that everything works

Activate your skill in the Alexa app and complete the Account Linking process (your skill should show up under 'Your skills > Developer')
In your AWS account, check the CloudWatch log group '/aws/lambda/virtual-smart-home-dev-skill'. It should contain an "AcceptGrant" request from Alexa and a corresponding response.
Open your Node-RED frontend
Add a new 'virtual device' to your flow and name it 'foo bar'
Open the Developer Tools' network tab
Double click on your virtual 'foo bar' device to open the editor
Follow the instructions above to configure the vsh-connection to interact with your own backend
Observe the activity on the DevTools network tab
- the call to 'check_version' should go out to your own backend URL
- the request payload to 'https://api.amazon.com/auth/o2/create/codepair' should include the 'client_id' of the security profile you configured earlier
Complete the code pairing process
Activate the 'Debug' option of the vsh-connection node
Deploy your Node-RED flow
Your virtual 'foo bar' device should now get discovered by Alexa.
Check the MQTT traffic being logged to stdout of Node-RED
Go to the IoT section in your AWS account and click on 'Manage > Things' in the side menu
- The list should contain one 'Thing' representing your configured vsh-connection
Click on the thing and inspect its shadow document that hold the configurations of your devices
Click on the 'Activity' menu item and observe shadow changes when you connect / disconnect your connection (e.g. by restarting Node-RED)

Enable PRO features

Navigate to your DynamoDB
Find and edit the item with SK 'TOKEN'
Add a new attribute 'plan' of type 'string' with the value 'pro'
Save the changes
Restart Node-RED so that the changes get picked up.

WhiteLionATX/virtual-smart-home

Virtual-Smart-Home - Backend

Setting up your own backend

Configuring Node-RED

Testing that everything works

Enable PRO features