apx-roles

Initializer for node-roles for APX API server

Usage no npm install needed!

<script type="module">
  import apxRoles from 'https://cdn.skypack.dev/apx-roles';
</script>

README

APX Roles

Kado

STOP AND READ THIS

APX or Apex is no longer maintained and is superseded by Kado.

A new package is available to handle all your JavaScript needs. See kado.org for details.

Summary

Implementation of node-roles through an APX intitializer. Provides apx.roles which can be used to test permissions.

The initializer sets up configuration options to build the definitions used in the role object. Also, apx-helper-crud implements the roles initializer if it is loaded at startup.

Configuration

Apps

  • Variable roles.apps
  • Required yes
  • Default null

This is an array of of apps and their respective roles.

Example

module.exports = {
  apps: [
    {name: 'myapp', roles: ['find','list','save','remove']}
  ]
}

Profiles

  • Variable roles.profiles
  • Required yes
  • Default null

Profiles are used to check roles against the currently logged in user. They are required and should list the available roles to the profile these are called permissions.

Example

module.exports = {
  apps: [
    {name: 'myapp', roles: ['find','list','save','remove']}
  ],
  profiles: [
    {name: 'manager', roles: ['myapp.find','myapp.list','myapp.save']},
    {name: 'admin', roles: ['myapp.*']}
  ]
}

Changelog

0.1.0

  • Initial release