Using the New Auth Component for Angular 2 With DreamFactory

i’ve been working on dreamfactory's angular sdk, sample app, and documentation. it's now available on github with some good examples and details. there are some important things to consider when using dreamfactory authentication with a custom angular 2 component.

background

angular2-auth-component handles login, register, and logged in user profile management. this component can be installed in any angular 2 project using npm, and, with some additional lines of code, you can have a running dreamfactory auth system in your dreamfactory app. typescript has been chosen to write angular2-auth-component. this should not affect any project written in es6. angular2-auth-component can still be included and used in any other project.

to get started with angular 2, check out the getting started guide from angular.io. it has simple and useful examples for organizing code and creating components in angular 2.

using the component

in order to communicate with dreamfactory console, you need to embed the following configuration values in your index.html in a script tag.

window.instanceurl = '';
window.appkey = ''

these config values will be used by angular2-auth-component to communicate with dreamfactory console. then a simple npm install should download the module inside your node_modules folder after which you can include and use all the components inside angular2-auth-component.

npm install angular2-auth-component --save

services and components available for use:

logincmp - dreamfactory login widget
registercmp - dreamfactory register widget
profilecmp - dreamfactory logged in user profile widget
profileservice - http service with methods to get and set profile
basehttpservice - a wrapper around angular 2 http service. this service should be used by the application to make any api call.

let's say for example you want to use login component. first thing to do is to import the login component and necessary services. let's call your root component appcmp.

import {logincmp, basehttpservice} from 'angular2-auth-component/index';

then, in your main component, inject services and use the component on `/login` route.

@component({
  selector: 'app',
  templateurl: './components/app/app.html',
  styleurls: ['./components/app/app.css'],
  encapsulation: viewencapsulation.none,
  directives: [router_directives],
  providers: [basehttpservice]
})

@routeconfig([
  { path: '/login', component: logincmp, as: 'login' },
])

alternatively, you can also have your own login route and use the widget in your html.

 <df-login></df-login>

make sure you mention logincmp in directives list like this:

@component({
  selector: 'app',
  templateurl: './components/app/app.html',
  styleurls: ['./components/app/app.css'],
  encapsulation: viewencapsulation.none,
  directives: [router_directives, logincmp],
  providers: [basehttpservice]
})

in a similar way, you can also use registercmp, profilecmp, etc.

there is a separate service called profileservice which handles all the http operations for currently logged in user profiles with the following methods:

get: get profile. returns object of profile class.
save: save profile. requires object of profile class.
resetpassword: reset password.

you can either have you own profile widget and use profileservice methods or you can use profilecmp either in a route or html widget as shown in above `logincmp` example.

there is also a sample repository which uses these components using npm install.