README

authmaker-ember-simple-auth

This addon allows you to get started very quickly with Authmaker and ember-simple-auth. This Readme has some basic information about how to use the addon but if you want a more in-depth description on how to use it you can check the Authmaker Guides

Compatibility

Ember.js v3.12 or above
Ember CLI v3.12 or above
Node.js v12 or above

Installation

ember install authmaker-ember-simple-auth

this will setup a few defaults in your application and add a basic configuration to your environment config that you will need to update with the real config from the Authmaker Dashboard. Read the official documentation for more information.

Usage

When you install this addon it will automatically generate a login route for you, along with a few other useful files. If you are starting an Ember app from scratch this should all be ok, but if you are adding Authmaker to an existing Ember app you might need to have a look at the diffs and see how to integrate your code into the provided files.

This addon ultimately uses ember-simple-auth to provide the login functionality and you can follow their documentation to find out more.

Here is an example of a controller that is providing a login action that makes use of Ember Simple Auth's session.authenticate() functionality:

import Controller from '@ember/controller';
import { inject as service } from '@ember/service'

export default Controller.extend({
  session: service(),
  actions: {
    login() {
      this.get('session').authenticate('authenticator:authmaker');
    },
    logout() {
      this.get('session').invalidate();
    }
  }
});

with this in place you can make use of these actions in the template as follows:

{{#if session.isAuthenticated}}
  <button {{action 'logout'}}>logout</button>
{{else}}
  <button {{action 'login'}}>login</button>
{{/if}}

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

Usage no npm install needed!