Skip to content
This repository has been archived by the owner on Jun 30, 2018. It is now read-only.

Latest commit

 

History

History
212 lines (138 loc) · 6.17 KB

install.md

File metadata and controls

212 lines (138 loc) · 6.17 KB
Raw

It is a tutorial for setting GS on local machine.

Overview

This project is basically a clone from Loopback Passport Example.

LoopBack example for loopback-passport module. It demonstrates how to use LoopBack's user/userIdentity/userCredential models and passport to interact with other auth providers.

  • Log in or sign up to LoopBack using third party providers (aka social logins)
  • Link third party accounts with a LoopBack user (for example, a LoopBack user can have associated Facebook).

Prerequisites

Before starting this tutorial, make sure you have the following installed:

Note: this project also using Raven for error handlers. So if you're cloning this repo - you must find and update the key. more info at: https://sentry.io

Client ids/secrets from third party

You can create your own app here

Tutorial - Facebook

1. Clone the application

$ git clone git@github.com:strongloop/loopback-example-passport.git
$ cd loopback-example-passport
$ npm install

2. Get your client ids/secrets from third party(social logins)

Facebook authorization on local machine

  • register a developer account on developers.facebook.com
  • Settings - Site URL - http://localhost:3000/
  • Facebook Login - Valid OAuth redirect URIs - http://localhost:3000/
  • providers.json : replace "clientID" "clientSecret" in "facebook-link" "facebook-login" with yours in settings

error: Can't Load URL: The domain of this URL isn't included in the app's domains.

Fixed: _ Facebook Developers Login _ Client OAuth Settings _ Use Strict Mode for Redirect URIs - No

or

  • To get your app info: Facebook
  • Click on My Apps, then on Add a new App
  • Pick the platform [iOS, Android, Facebook Canvas, Website]
  • Select proper category for your app.
  • Write your app name and "Site URL".
  • Skip the quick start to get your "App ID" and "App Secret", which is in "Settings"
  • Your app may not work if the settings are missing a contact email and/or "Site URL".
  • if you are testing locally, you can simply use localhost:[port#] as your "Site URL".

3. Create providers.json

  • Copy providers.json.template to providers.json

  • Update providers.json with your own values for clientID/clientSecret.

    "facebook-login": {
  "provider": "facebook",
  "module": "passport-facebook",
  "clientID": "xxxxxxxxxxxxxxx",
  "clientSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "callbackURL": "/auth/facebook/callback",
  "authPath": "/auth/facebook",
  "callbackPath": "/auth/facebook/callback",
  "successRedirect": "/auth/account",
  "failureRedirect": "/login",
  "scope": ["email"],
  "failureFlash": true
},
"facebook-link": {
  "provider": "facebook",
  "module": "passport-facebook",
  "clientID": "xxxxxxxxxxxxxxx",
  "clientSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "callbackURL": "/link/facebook/callback",
  "authPath": "/link/facebook",
  "callbackPath": "/link/facebook/callback",
  "successRedirect": "/auth/account",
  "failureRedirect": "/login",
  "scope": ["email", "user_likes"],
  "link": true,
  "failureFlash": true
}

4. Facebook profile info

In a recent update, Facebook no longer returns all fields by default (email, gender, timezone, etc). If you need more information, modify the providers template.

The current template contains:

"profileFields": ["gender", "link", "locale", "name", "timezone", "verified", "email", "updated_time"],

We recommend modifying the fields to suit your needs. For more information regarding the providers template, see http://loopback.io/doc/en/lb2/Configuring-providers.json.html.

If you got an issue error: "async function something(next) { ^^^^^^^^ SyntaxError: Unexpected token function"

reason: node version is not updated. Fixed by re-install updated node and npm.

Why

Async functions are not supported by Node versions older than version 7.6

At package.json we specified: node v.8.1.4

5. Database logic

In order to launch local version of project, you need to have your own mongo database in cloud and import data. The database we used in this task is mlab addon for heroku(it can be another mongodb provider, or your own local setup - we need only full link to mongodb with username, dbname, password)

  • Create a heroku application. Note: we don't need heroku at this time, it's just a quick way to get your own database and leave for later stage.

  • Create a mlab addon in your heroku application, then you will have a new database instance.

  • Go to settings page and find Reveal Config Vars button. Click on it and copy data of MONGODB_URI variable

  • Paste the db link into the /server/datasources.json:url and(or) /server/datasources.production.json:url

  • Open the command line(bash, shell)

  • run "npm run migrate", using ctrl+c to terminate once table is created Migrate will create an empty datatables and drop all previous data if require

  • run "npm run import", using ctrl+c to terminate Import will move sample data from json arrays to mongo documents

6. Run the application

$ node .

or

$ npm run watch
  • Open your browser to http://localhost:3000
  • Click on 'Log in' (in the header, on the rigth)

Deployment on Heroku

$ heroku login
$ heroku create %your-app-name%

Will create an empty tables in database

$ heroku run npm run migrate

Will import data like admin user, ultimate grocery template

$ heroku run npm run import

$ heroku run npm run migrate --app gs1

// recipes $ heroku run npm run import --app gs1

Finish: https://github.com/atherdon/stripe-recurring-membership/blob/master/README.md#deploying-to-heroku

More LoopBack examples

Local install

Heroku install