Ember Practical OIDC

Installation

Like most ember addons, simply run ember install ember-practical-oidc and you should be all set as far as installation goes.

Configuration

Mandatory Configuration

environment.js

Here's the mandatory information you'll have to supply the addon using the config/environment.js file of your application. Without these four properties, it's impossible to construct a valid authentication payload.

ENV.OIDC = {
  applicationName: '<YOUR APP NAME>',
  applicationURL: '<YOUR APP URL>',
  authenticationURL: '<YOUR AUTHENTICATION ENDPOINT>',
  requestedScopes: '<THE REQUESTED SCOPES>'
};

Optional Configuration

Here are the additional configuration parameters that are available.

| Property Key | Default Value | Type | |---|:-------------:|:------:| | popupRedirectURL | "popup" | string | | silentRedirectURL | "renew" | string | | responseType | "id_token token" | string | | postLogoutRedirectURL | "" | string | | checkSessionInterval | 30000 | int | | automaticSilentRenew | false | boolean | | filterProtocolClaims | true | boolean | | loadUserInfo | true | boolean | | transitionToRedirect | null | string | | usePopup | true | boolean | | useInPlaceRedirect | true | boolean | | transitionExceptionList | true | string[] |

to use the redirection logic instead of the default popup

set usePopup to false and give the post login transition to execute to transitionToRedirect

optionally set useInPlaceRedirect to return to the same route after login, by default the root "/" will be ignored from this redirection and redirect to transitionToRedirect instead.

this behaviour can be controlled by an exception list. every route found in transitionExceptionList will transition back to transitionToRedirect.

Route Initialization Configuration

The addon is able to automatically create the renew and popup routes for you. If that's what you want, simply set the ENV.OIDC.initializeRoutes environmnet variable to true in your config/environment.js file.

Debug Configuration

It's possible to view logging information by setting the ENV.OIDC.enableLogging environment variable to true.