Auth0 Extensions CLI

Command-line tool allowing you to build a Node.js backend as an Auth0 Extension

npm install --save-dev auth0-extensions-cli

Usage

Building the backend

In order to compile your Node.js backend into an Auth0 Extension you can add a script similar to this one to your package.json file

{
  "name": "my-extension",
  ...
  "scripts": {
    "extension:build": "a0-ext build:server ./webtask.js ./dist",
    ...
  }
}

Then simply run npm run extension:build to compile the extension. This will then take the webtask.js file as the entrypoint and place the output in the ./dist folder.

Additional Configuration

You can add an auth0-extension node to your package.json file to specify specific versions of Node.js modules which are available on the Webtask platform (as a result these modules will not be bundled in the extension itself). And it's also possible to define settings which will be available in the extension under process.env.

{
  "name": "my-extension",
  ...
  "scripts": {
    "extension:build": "a0-ext build:server ./webtask.js ./dist",
    ...
  },
  "auth0-extension": {
    "externals": [
      "async@2.1.2",
      "auth0@2.4.0",
      "bluebird@3.4.6",
      "body-parser@1.12.4",
      "ejs@2.3.1",
      "express@4.14.0",
      "iconv-lite@0.4.10",
      "jsonwebtoken@7.1.9",
      "jwks-rsa@1.1.1",
      "lodash@3.10.1",
      "lru-memoizer@1.10.0",
      "node-uuid@1.4.3",
      "morgan@1.5.3",
      "request@2.67.0",
      "superagent@1.2.0",
      "tough-cookie@2.2.2",
      "webtask-tools",
      "winston@1.0.0"
    ],
    "nodeTarget": "8.9.0",
    "bundleModules": false,
    "useBabel": true,
    "settings": {
      "WARN_DB_SIZE": 409600,
      "MAX_MULTISELECT_USERS": 5,
      "MULTISELECT_DEBOUNCE_MS": 250,
      "PER_PAGE": 10
    }
  }
}

Command Topics

a0-ext validate - Check extension`s package.json to contain all necessary information.
a0-ext build:client - Compile your React Frontend into an Auth0 Extension Client.
a0-ext build:server - Compile your Node.js Backend into an Auth0 Extension.
a0-ext package - Package assets for extension deployment.
a0-ext deploy - Deploy the extension to Auth0.

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.

For auth0 related questions/support please use the Support Center.

Author

Auth0

License

This project is licensed under the MIT license. See the LICENSE file for more info.