@nearform/udaru-hapi-16-plugin

Hapi plugin that allows using udaru for policy based authorization

Usage no npm install needed!

<script type="module">
  import nearformUdaruHapi16Plugin from 'https://cdn.skypack.dev/@nearform/udaru-hapi-16-plugin';
</script>

README

Udaru Hapi Plugin

npm travis coveralls snyk

Udaru is a Policy Based Access Control (PBAC) authorization module. It supports Organizations, Teams and User entities that are used to build the access model. The policies attached to these entities define the 'Actions' that can be performed by an entity on various 'Resources'.

See the Udaru website for complete documentation on Udaru.

Install

To install via npm:

npm install @nearform/udaru-hapi-16-plugin

Usage

const Hapi = require('hapi')
const UdaruPlugin = require('@nearform/udaru-hapi-16-plugin')

...

const server = new Hapi.server()
server.register({register: UdaruPlugin})

Hooks

In order to register udaru hooks, just provide a hooks key in the plugin options where keys are the names and values are handler functions (or array of functions).

const Hapi = require('hapi')
const UdaruPlugin = require('@nearform/udaru-hapi-16-plugin')

...

const server = new Hapi.server()
server.register({
  register: UdaruPlugin,
  options: {
    // Other options here
    hooks: {
      'authorize:isUserAuthorized': [
        function (error, args, result, done) {
          if (error) {
            console.error(`Authorization errored: ${error}`)
          } else {
            console.log(`Access to ${args[0]} got access: ${result[0].access}`)
          }

          done()
        }
      ]
    }
  }
})

License

Copyright nearForm Ltd 2017. Licensed under MIT.