MongoDB Stitch Dashboard and API Builder

#MDBlocal
Today’s Pre-Reqs
For today’s workshop you’ll need the following:
● Computer
○ Preferably a Mac
○ Or a working knowledge of Windows + NodeJS
● MongoDB Atlas Cluster running 3.4+ (can be free tier)
● NodeJS 6.0+/npm
● Important:
○ Files: https://github.com/mongodb/stitch-examples
■ Under ‘Dashboard’
○ Documentation: https://docs.mongodb.com/stitch/getting-started/dashboard/

#MDBlocal
Drew DiPalma
Product Manager – Stitch

#MDBlocal
Agenda for this Workshop:
Intro to Stitch
+ Atlas
What we’ll
work on today
Creating a
simple API
Building a D3
Dashboard
Adding
Authentication
Next steps
with Stitch
01 02 03 04 05 06

#MDBlocal
Today’s Pre-Reqs
For today’s workshop you’ll need the following:
● Computer
○ Preferably a Mac
○ Or a working knowledge of Windows + NodeJS
● NodeJS/npm
● Important: Get the files/README (https://goo.gl/CU1JV1)

#MDBE17
MongoDB Query Language + Native DriversIntegrated Rules
Pipelines 3rd Party Services
Native SDKs (iOS, Android, JS)
Rest-like API
https://docs.mongodb.com/stitch/getting-started/dashboard/

#MDBE17
Stitch let’s you control the flow of data:
Integrated services and
Pipelines for complex,
multi-stage workflows
Native SDKs for Android,
JS, and iOS clients
Direct Database Access

#MDBlocal
Get Started with
Atlas

#MDBlocal
https://mongodb.com/atlas – Sign up, free.

#MDBlocal
Launch the cluster (Remember your password!)

#MDBlocal
Whitelist your IP

#MDBlocal
What we’ll work on
today

#MDBlocal
Our Data
*Point-of-sale data from a Pizza shop
(But Similar to Point-of-Sale, Log, Telemetry, etc. data you
would see elsewhere)
* Our Goal

#MDBlocal
1. Data enters through Stitch, flows into Atlas
2. Stitch can augment data loading:
a) Grabbing extra data from an external API
b) Taking an action on load (e-mail receipt)
3. Can expose data through API, Web/mobile
app, or Atlas
(Remember: You can also use Stitch with
an existing database too)
Behind the scenes, Stitch connects Everything
Dash +
Auth
MongoDB
Stitch
MongoDB
Atlas
Sales
Data
API Access

#MDBlocal
Getting Started
with Stitch

#MDBlocal
Click ‘Stitch Apps’ in Atlas

#MDBlocal
Let’s start by adding Auth

#MDBlocal
Next, let’s add the Receipts Collection

#MDBlocal
Finally, copy your App ID

#MDBlocal
In Stitch, you opt-in each namespace in your
database separately for access.
1. Go to SalesReporting.Receipts
namespace
2. Delete the default Filter under ‘Filters’
3. Delete the default rules (including Owner
Id field rules)
4. Set the Top-level Document Read/Write
rules to {}
5. This enables Public read/write to this
namespace only
Next, set-up simple Access Rules:

#MDBlocal
Now let’s load data:
1. Open the data_generator.js file
2. Add your App ID (line 10)
3. Run data_generator.js
4. Watch data load into Stitch!

#MDBlocal
Creating a Simple
Public API

#MDBlocal
In Stitch, you can add a number of predefined services
to your app.
Services have predefined actions to ease integration.
We’ll use the HTTP Service to create an API to our data
1. Click ‘Add Service’
2. Click ‘HTTP’ and name your service ‘SalesAPI’
Create a HTTP Service:

#MDBlocal
Create a Webhook:
For the HTTP service, you can create an
incoming webhook that will execute a
function in response to a request.
1. Within AggregateToppings, click ‘New
Webhook’
2. Name your new webhook ‘GetSales’
3. Switch ‘Respond with Result’ ON
4. Click ‘Require Secret as Query Param’
5. Set Secret to ‘SECRET’

#MDBlocal
Get the distribution of toppings for the last 100
pizzas.
1. Function that uses aggregation to:
a) Sort the orders in descending time order
b) Limit the number of orders to 100
c) Group the orders by topping
Add a Function to the Webhook:

#MDBlocal
Now you can access your data via HTTP!
curl -X POST -H [WEBHOOK_URL]?secret=[SECRET] | python -m json.tool

#MDBlocal
Building a
Dashboard

#MDBlocal
Add a Function:
SalesTimeline – Get the sales for a given time
interval
1. Find all the sales in a certain timeframe
a) Projects fields down to just timestamp/total
b) Sorts by timestamp
c) Limits to 100 documents
2. Make sure function is named ‘SalesTimeline’
3. Set ‘Can Evaluate’ to {}

#MDBlocal
Again, copy your App ID

#MDBlocal
1. Open the index.html file
2. Add your App ID (line 8)
3. Go to your app directory
4. Run your app with ‘http-server &’
a) Note: You may need to install http-
server via npm (install with –g flag)
b) You can also use any other method of
opening the dashboard
Now let’s start the Dashboard:

#MDBlocal
Check out your Dashboard!

#MDBlocal
Adding
Authentication

#MDBlocal
1. Go to ‘Authentication’ in the Stitch UI
2. Edit Email/Password configuration
a) Click the slider to enable
b) Set Email Confirmation URL and
Email Reset URL
c) Click ‘Save’
3. Add our first e-mail/password user
a) Click the ‘Users’ tab
b) Click ‘+ Add User’
c) Enter an email address and
password of your choosing and
click ‘Create’
Add E-mail Auth:

#MDBlocal
1. Next go back to ‘Providers’, find ‘API
Key’ authentication and click ‘edit’
a) Click the slider to enable e-
mail/password authentication
b) Click ‘Create API Key,’ assign your
API Key a name, and click ‘Save’
2. Click ‘Show Key...’ and then copy key
Add an API Key:

#MDBlocal
1. Open the data_generator.js file
2. Comment out line 38, Uncomment line 41
3. Add your API Key (line 41)
4. Re-run data_generator.js
Add Auth to the Loader:

#MDBlocal
CheckAuth – Check the authentication type of a
user for a security rule
1. Take an auth type and see if the given suer
matches it.
2. Name function ‘CheckAuth’
3. Set ‘Can Evalutate’ to {}
Add a Function:

#MDBlocal
1. Go to rules under the rules tab of
‘mongodb-atlas’ in Stitch UI
2. In the ‘SalesReporting.Receipts’, edit the
Top-level Document Read and Write rules
(see README)
3. Add the timestamp/total fields into the
namespace
4. In both of these fields, add a read rule to
check a user’s authentication (see
README)
Set-up secure Access
Rules:

#MDBlocal
1. Open the index.html file
2. Comment out line 15, uncomment line 16
3. Re-run data_generator.js
Add Auth to the Dashboard:

#MDBlocal
Check out your Dashboard (Again)!

#MDBlocal
• Build out a more robust public API to access your data by adding
more pipelines and webhooks
• Add pipelines and using the data to create more graphs in your
realtime dashboard
• Use one of our integrations to build extra features like e-mail receipts
for customers or a slackbot for placing an order.
• Take the ideas here and building an API or dashboard with your own
data
Have more time?

#MDBlocal
xx
Everywhere
Expand Regional footprint
Available on-premise
Bring any MongoDB
Realtime
Change Streams driven
Event-based pipelines
Dev Tools
App Import/Export Tools
User/Log Management
What’s Next?

#MDBlocal
• Get more info about Stitch at
• Try out Stitch – stitch.mongodb.com
• Check out SDKs and examples
• Code at github.com/MongodbStitch
• Docs at docs.mongodb.com/stitch
• Build the Dashboard or Weather IoT apps in our Tutorials section
• Ask Questions or let us know what you’re building through Intercom
What Now?

MongoDB Stitch Dashboard and API Builder

Recommended

Recommended

More Related Content

Similar to MongoDB Stitch Dashboard and API Builder

Similar to MongoDB Stitch Dashboard and API Builder (20)

More from MongoDB

More from MongoDB (20)

MongoDB Stitch Dashboard and API Builder