initial checkin

2025-12-18 20:07:44 +00:00 · 2020-01-07 10:34:03 -05:00
commit 523e2a308b
61 changed files with 7876 additions and 0 deletions
--- a/.eslintignore
+++ b/.eslintignore
@@ -0,0 +1 @@
+test/*
--- a/.eslintrc.json
+++ b/.eslintrc.json
@@ -0,0 +1,126 @@
+{
+  "env": {
+    "node": true,
+    "es6": true  
+  },
+  "parserOptions": {
+    "ecmaFeatures": {
+      "jsx": false,
+      "modules": false
+    },
+    "ecmaVersion": 2017 
+  },
+  "plugins": ["promise"],
+  "rules": {
+    "promise/always-return": "error",
+    "promise/no-return-wrap": "error",
+    "promise/param-names": "error",
+    "promise/catch-or-return": "error",
+    "promise/no-native": "off",
+    "promise/no-nesting": "warn",
+    "promise/no-promise-in-callback": "warn",
+    "promise/no-callback-in-promise": "warn",
+    "promise/no-return-in-finally": "warn",
+
+    // Possible Errors
+    // http://eslint.org/docs/rules/#possible-errors
+    "comma-dangle": [2, "only-multiline"],
+    "no-control-regex": 2,
+    "no-debugger": 2,
+    "no-dupe-args": 2,
+    "no-dupe-keys": 2,
+    "no-duplicate-case": 2,
+    "no-empty-character-class": 2,
+    "no-ex-assign": 2,
+    "no-extra-boolean-cast" : 2,
+    "no-extra-parens": [2, "functions"],
+    "no-extra-semi": 2,
+    "no-func-assign": 2,
+    "no-invalid-regexp": 2,
+    "no-irregular-whitespace": 2,
+    "no-negated-in-lhs": 2,
+    "no-obj-calls": 2,
+    "no-proto": 2,
+    "no-unexpected-multiline": 2,
+    "no-unreachable": 2,
+    "use-isnan": 2,
+    "valid-typeof": 2,
+
+    // Best Practices
+    // http://eslint.org/docs/rules/#best-practices
+    "no-fallthrough": 2,
+    "no-octal": 2,
+    "no-redeclare": 2,
+    "no-self-assign": 2,
+    "no-unused-labels": 2,
+
+    // Strict Mode
+    // http://eslint.org/docs/rules/#strict-mode
+    "strict": [2, "never"],
+
+    // Variables
+    // http://eslint.org/docs/rules/#variables
+    "no-delete-var": 2,
+    "no-undef": 2,
+    "no-unused-vars": [2, {"args": "none"}],
+
+    // Node.js and CommonJS
+    // http://eslint.org/docs/rules/#nodejs-and-commonjs
+    "no-mixed-requires": 2,
+    "no-new-require": 2,
+    "no-path-concat": 2,
+    "no-restricted-modules": [2, "sys", "_linklist"],
+
+    // Stylistic Issues
+    // http://eslint.org/docs/rules/#stylistic-issues
+    "comma-spacing": 2,
+    "eol-last": 2,
+    "indent": [2, 2, {"SwitchCase": 1}],
+    "keyword-spacing": 2,
+    "max-len": [2, 120, 2],
+    "new-parens": 2,
+    "no-mixed-spaces-and-tabs": 2,
+    "no-multiple-empty-lines": [2, {"max": 2}],
+    "no-trailing-spaces": [2, {"skipBlankLines": false }],
+    "quotes": [2, "single", "avoid-escape"],
+    "semi": 2,
+    "space-before-blocks": [2, "always"],
+    "space-before-function-paren": [2, "never"],
+    "space-in-parens": [2, "never"],
+    "space-infix-ops": 2,
+    "space-unary-ops": 2,
+
+    // ECMAScript 6
+    // http://eslint.org/docs/rules/#ecmascript-6
+    "arrow-parens": [2, "always"],
+    "arrow-spacing": [2, {"before": true, "after": true}],
+    "constructor-super": 2,
+    "no-class-assign": 2,
+    "no-confusing-arrow": 2,
+    "no-const-assign": 2,
+    "no-dupe-class-members": 2,
+    "no-new-symbol": 2,
+    "no-this-before-super": 2,
+    "prefer-const": 2
+  },
+  "globals": {
+    "DTRACE_HTTP_CLIENT_REQUEST"           : false,
+    "LTTNG_HTTP_CLIENT_REQUEST"            : false,
+    "COUNTER_HTTP_CLIENT_REQUEST"          : false,
+    "DTRACE_HTTP_CLIENT_RESPONSE"          : false,
+    "LTTNG_HTTP_CLIENT_RESPONSE"           : false,
+    "COUNTER_HTTP_CLIENT_RESPONSE"         : false,
+    "DTRACE_HTTP_SERVER_REQUEST"           : false,
+    "LTTNG_HTTP_SERVER_REQUEST"            : false,
+    "COUNTER_HTTP_SERVER_REQUEST"          : false,
+    "DTRACE_HTTP_SERVER_RESPONSE"          : false,
+    "LTTNG_HTTP_SERVER_RESPONSE"           : false,
+    "COUNTER_HTTP_SERVER_RESPONSE"         : false,
+    "DTRACE_NET_STREAM_END"                : false,
+    "LTTNG_NET_STREAM_END"                 : false,
+    "COUNTER_NET_SERVER_CONNECTION_CLOSE"  : false,
+    "DTRACE_NET_SERVER_CONNECTION"         : false,
+    "LTTNG_NET_SERVER_CONNECTION"          : false,
+    "COUNTER_NET_SERVER_CONNECTION"        : false  
+  }
+}
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,38 @@
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# github pages site
+_site
+
+#transient test cases
+examples/nosave.*.js
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+.nyc_output/
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directory
+# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
+node_modules
+
+.DS_Store
+
+examples/*
--- a/.travis.yml
+++ b/.travis.yml
@@ -0,0 +1,9 @@
+sudo: required
+language: node_js
+node_js:
+  - "lts/*"
+services:
+  - docker
+  - mysql
+script:
+  - npm test
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -0,0 +1,17 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Launch Program",
+      "program": "${workspaceFolder}/test/index.js",
+      "env": {
+        "NODE_ENV": "test"
+      }
+    }
+  ]
+}
--- a/21
+++ b/21
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 jambonz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
--- a/README.md
+++ b/README.md
@@ -0,0 +1,108 @@
+# sbc-inbound [![Build Status](https://secure.travis-ci.org/jambonz/sbc-inbound.png)](http://travis-ci.org/jambonz/sbc-inbound)
+
+This application provides a part of the SBC (Session Border Controller) functionality of jambonz.  It handles incoming INVITE requests from carrier sip trunks or from sip devices and webrtc applications. SIP INVITEs from known carriers are allowed in, while INVITEs from sip devices are challenged to authenticate.  SIP traffic that is allowed in is sent on to a jambonz application server in a private subnet.
+
+## Configuration
+
+Configuration is provided via the [npmjs config](https://www.npmjs.com/package/config) package.  The following elements make up the configuration for the application:
+##### drachtio server location
+```
+{
+  "drachtio": {
+    "port": 3001,
+    "secret": "cymru"
+  },
+```
+the `drachtio` object specifies the port to listen on for tcp connections from drachtio servers as well as the shared secret that is used to authenticate to the server.
+
+> Note: either inbound or [outbound connections](https://drachtio.org/docs#outbound-connections) may be used, depending on the configuration supplied.  In production, it is the intent to use outbound connections for easier centralization and clustering of application logic, while inbound connections are used for the automated test suite.
+
+##### rtpengine location
+```
+  "rtpengine": {
+    "host": "127.0.0.1",
+    "port": 22222
+  },
+```
+the `rtpengine` object specifies the location of the rtpengine, which will typically be running on the same server as drachtio.
+
+##### application log level
+```
+  "logging": {
+    "level": "info"
+  }
+```
+##### application server location
+The sip trunk routing to internal application servers are specified as an array of IP addresses.
+```
+  "trunks": {
+    "appserver": ["sip:10.10.120.1"]
+  }
+```
+##### transcoding options
+The transcoding options for rtpengine are found in the configuration file, however these should not need to be modified.
+```
+  "transcoding": {
+  "rtpCharacteristics" : {
+      "transport protocol": "RTP/AVP",
+      "DTLS": "off",
+      "SDES": "off",
+      "ICE": "remove",
+      "rtcp-mux": ["demux"]
+  },
+  "srtpCharacteristics": {
+      "transport-protocol": "UDP/TLS/RTP/SAVPF",
+      "ICE": "force",
+      "SDES": "off",
+      "flags": ["generate mid", "SDES-no"],
+      "rtcp-mux": ["require"]
+  } 
+}
+```
+## Authentication
+Authenticating users is the responsibility of the client by exposing an http callback.  A POST request will be sent to the configured callback (i.e. the value in the `accounts.registration_hook` column in the associated sip realm value in the REGISTER request).  The body of the POST will be a json payload including the following information:
+```
+{
+	"method": "REGISTER",
+	"expires": 3600,
+	"scheme": "digest",
+	"username": "john",
+	"realm": "jambonz.org",
+	"nonce": "157590482938000",
+	"uri": "sip:172.37.0.10:5060",
+	"response": "be641cf7951ff23ab04c57907d59f37d",
+	"qop": "auth",
+	"nc": "00000001",
+	"cnonce": "6b8b4567",
+	"algorithm": "MD5"
+}
+```
+It is the responsibility of the customer-side logic to retrieve the associated password for the given username and to then authenticate the request by calculating a response hash value (per the algorithm described in [RFC 2617](https://tools.ietf.org/html/rfc2617#section-3.2.2)) and comparing it to the response property in the http body.
+
+For example code showing how to calculate the response hash given the above inputs, [see here](https://github.com/jambonz/customer-auth-server/blob/master/lib/utils.js).
+
+For a simple, full-fledged example server doing the same, [see here](https://github.com/jambonz/customer-auth-server).
+
+The customer server SHOULD return a 200 OK response to the http request in all cases with a json body indicating whether the request was successfully authenticated.
+
+The body MUST include a `status` field with a value of either `ok` or `fail`, indicating whether the request was authenticated or not.
+```
+{"status": "ok"}
+```
+
+Additionally, in the case of failure, the body MAY include a `msg` field with a human-readable description of why the authentication failed.
+```
+{"status": "fail", "msg": "invalid username"}
+```
+
+## Forwarding behavior
+This application acts as a back-to-back user agent and media proxy.  When sending INVITEs on to the jambonz application servers, it adds the following headers onto the INVITE:
+
+- `X-Forwarded-For`: the IP address of the client that sent the INVITE
+- `X-Forwarded-Carrier`: the name of the inbound carrier, if applicable
+
+#### Running the test suite
+To run the included test suite, you will need to have a mysql server installed on your laptop/server. You will need to set the MYSQL_ROOT_PASSWORD env variable to the mysql root password before running the tests.  The test suite creates a database named 'jambones_test' in your mysql server to run the tests against, and removes it when done.
+```
+MYSQL_ROOT_PASSWORD=foobar npm test
+```
--- a/app.js
+++ b/app.js
@@ -0,0 +1,46 @@
+const Srf = require('drachtio-srf');
+const srf = new Srf();
+const config = require('config');
+const logger = require('pino')(config.get('logging'));
+const {lookupAppByPhoneNumber} = require('jambonz-db-helpers')(config.get('mysql'), logger);
+srf.locals.dbHelpers = {lookupAppByPhoneNumber};
+const {
+  initLocals,
+  normalizeNumbers,
+  retrieveApplication,
+  invokeWebCallback
+} = require('./lib/middleware')(srf, logger);
+const CallSession = require('./lib/call-session');
+
+// disable logging in test mode
+if (process.env.NODE_ENV === 'test') {
+  const noop = () => {};
+  logger.info = logger.debug = noop;
+  logger.child = () => {return {info: noop, error: noop, debug: noop};};
+}
+
+// config dictates whether to use outbound or inbound connections
+if (config.has('drachtio.host')) {
+  srf.connect(config.get('drachtio'));
+  srf.on('connect', (err, hp) => {
+    logger.info(`connected to drachtio listening on ${hp}`);
+  });
+}
+else {
+  logger.info(`listening for drachtio server traffic on ${JSON.stringify(config.get('drachtio'))}`);
+  srf.listen(config.get('drachtio'));
+}
+if (process.env.NODE_ENV === 'test') {
+  srf.on('error', (err) => {
+    logger.info(err, 'Error connecting to drachtio');
+  });
+}
+
+srf.use('invite', [initLocals, normalizeNumbers, retrieveApplication, invokeWebCallback]);
+
+srf.invite((req, res) => {
+  const session = new CallSession(req, res);
+  session.exec();
+});
+
+module.exports = {srf};
--- a/config/default.json.example
+++ b/config/default.json.example
@@ -0,0 +1,15 @@
+{
+  "drachtio": {
+    "port": 3010,
+    "secret": "cymru"
+  },
+  "logging": {
+    "level": "info"
+  },
+  "mysql": {
+    "host": "localhost",
+    "user": "jambones",
+    "password": "jambones",
+    "database": "jambones"
+  }
+}
--- a/config/local-test.json
+++ b/config/local-test.json
@@ -0,0 +1,16 @@
+{
+  "drachtio": {
+    "host": "127.0.0.1",
+    "port": 9060,
+    "secret": "cymru"
+  },
+  "logging": {
+    "level": "debug"
+  },
+  "mysql": {
+    "host": "localhost",
+    "user": "jambones_test",
+    "password": "jambones_test",
+    "database": "jambones_test"
+  }
+}
--- a/lib/call-session.js
+++ b/lib/call-session.js
@@ -0,0 +1,38 @@
+const Emitter = require('events');
+/*
+const config = require('config');
+const {forwardInDialogRequests} = require('drachtio-fn-b2b-sugar');
+const {parseUri, SipError} = require('drachtio-srf');
+const debug = require('debug')('jambonz:sbc-inbound');
+const assert = require('assert');
+*/
+class CallSession extends Emitter {
+  constructor(req, res) {
+    super();
+    this.req = req;
+    this.res = res;
+    this.srf = req.srf;
+    this.logger = req.locals.logger;
+    this.application = req.locals.application;
+  }
+
+  async exec() {
+    let idx = 0;
+    for (const task of this.application.tasks) {
+      try {
+        this.logger.debug(`CallSession: executing task #${++idx}: ${task.name}`);
+        const continueOn = await task.exec(this);
+        if (!continueOn) break;
+      } catch (err) {
+        this.logger.error({err, task}, 'Error executing task');
+      }
+      this.logger.info('finished all tasks');
+      if (!this.res.finalResponseSent) {
+        this.logger.info('auto-generating non-success response to invite');
+        this.res.send(603);
+      }
+    }
+  }
+}
+
+module.exports = CallSession;
--- a/lib/middleware.js
+++ b/lib/middleware.js
@@ -0,0 +1,112 @@
+const debug = require('debug')('jambonz:feature-server');
+const assert = require('assert');
+const request = require('request');
+//require('request-debug')(request);
+const uuidv4 = require('uuid/v4');
+const makeTask = require('./tasks/make_task');
+
+module.exports = function(srf, logger) {
+  const {lookupAppByPhoneNumber}  = srf.locals.dbHelpers;
+
+  function initLocals(req, res, next) {
+    req.locals = req.locals || {};
+    req.locals.logger = logger.child({callId: req.get('Call-ID')});
+    next();
+  }
+
+  /**
+   * Within the system, we deal with E.164 numbers _without_ the leading '+
+   */
+  function normalizeNumbers(req, res, next) {
+    const logger = req.locals.logger;
+    Object.assign(req.locals, {
+      calledNumber: req.calledNumber,
+      callingNumber: req.callingNumber
+    });
+    try {
+      const regex = /^\+(\d+)$/;
+      let arr = regex.exec(req.calledNumber);
+      if (arr) req.locals.calledNumber = arr[1];
+      arr = regex.exec(req.callingNumber);
+      if (arr) req.locals.callingNumber = arr[1];
+    } catch (err) {
+      logger.error(err, `${req.get('Call-ID')} Error performing regex`);
+    }
+    next();
+  }
+
+  /**
+   * Given the dialed DID/phone number, retrieve the application to invoke
+   */
+  async function retrieveApplication(req, res, next) {
+    const logger = req.locals.logger;
+    try {
+      const app = req.locals.application = await lookupAppByPhoneNumber(req.locals.calledNumber);
+      if (!app) {
+        logger.info(`rejecting call to DID ${req.locals.calledNumber}: no application associated`);
+        return res.send(480, {
+          headers: {
+            'X-Reason': 'no configured application'
+          }
+        });
+      }
+      logger.debug(app, `retrieved application for ${req.locals.calledNumber}`);
+      next();
+    } catch (err) {
+      logger.error(err, `${req.get('Call-ID')} Error looking up application for ${req.calledNumber}`);
+      res.send(500);
+    }
+  }
+
+  /**
+   * Invoke the application callback and get the initial set of instructions
+   */
+  async function invokeWebCallback(req, res, next) {
+    const logger = req.locals.logger;
+    const call_sid = uuidv4();
+    const account_sid = req.locals.application.account_sid;
+    const application_sid = req.locals.application.application_sid;
+    try {
+      const app = req.locals.application;
+      assert(app && app.call_hook);
+      request.post({
+        url: app.call_hook,
+        json: true,
+        body: req.msg
+      }, (err, response, body) => {
+        if (err) {
+          logger.error(err, `Error invoking callback ${app.call_hook}`);
+          return res.send(603, 'Bad webhook');
+        }
+        logger.debug(body, 'application payload');
+        const taskData = Array.isArray(body) ? body : [body];
+        app.tasks = [];
+        for (const t in taskData) {
+          try {
+            const task = makeTask(logger, taskData[t]);
+            app.tasks.push(task);
+          } catch (err) {
+            logger.info({data: taskData[t]}, `invalid web callback payload: ${err.message}`);
+            res.send(500, 'Application Error', {
+              headers: {
+                'X-Reason': err.message
+              }
+            });
+            break;
+          }
+        }
+        if (!res.finalResponseSent) next();
+      });
+    } catch (err) {
+      logger.error(err, 'Error invoking web callback');
+      res.send(500);
+    }
+  }
+
+  return {
+    initLocals,
+    normalizeNumbers,
+    retrieveApplication,
+    invokeWebCallback
+  };
+};
--- a/lib/tasks/dial.js
+++ b/lib/tasks/dial.js
@@ -0,0 +1,26 @@
+const Task = require('./task');
+const name = 'dial';
+
+class TaskDial extends Task {
+  constructor(logger, opts) {
+    super(logger, opts);
+    this.name = name;
+    this.headers = this.data.headers || {};
+  }
+
+  static get name() { return name; }
+
+  /**
+   * Reject an incoming call attempt with a provided status code and (optionally) reason
+   */
+  async exec(cs) {
+    if (!cs.res.finalResponseSent) {
+      cs.res.send(this.data.status, this.data.reason, {
+        headers: this.headers
+      });
+    }
+    return false;
+  }
+}
+
+module.exports = TaskDial;
--- a/lib/tasks/make_task.js
+++ b/lib/tasks/make_task.js
@@ -0,0 +1,22 @@
+const Task = require('./task');
+const TaskSipDecline = require('./sip_decline');
+const TaskDial = require('./dial');
+const errBadInstruction = new Error('invalid instruction payload');
+
+function makeTask(logger, opts) {
+  if (typeof opts !== 'object' || Array.isArray(opts)) throw errBadInstruction;
+  const keys = Object.keys(opts);
+  if (keys.length !== 1) throw errBadInstruction;
+  const name = keys[0];
+  const data = opts[name];
+  Task.validate(name, data);
+  switch (name) {
+    case TaskSipDecline.name: return new TaskSipDecline(logger, data);
+    case TaskDial.name: return new TaskDial(logger, data);
+  }
+
+  // should never reach
+  throw new Error(`invalid task ${name} (please update specs.json and make_task.js)`);
+}
+
+module.exports = makeTask;
--- a/lib/tasks/sip_decline.js
+++ b/lib/tasks/sip_decline.js
@@ -0,0 +1,26 @@
+const Task = require('./task');
+const name = 'sip:decline';
+
+class TaskSipDecline extends Task {
+  constructor(logger, opts) {
+    super(logger, opts);
+    this.name = name;
+    this.headers = this.data.headers || {};
+  }
+
+  static get name() { return name; }
+
+  /**
+   * Reject an incoming call attempt with a provided status code and (optionally) reason
+   */
+  async exec(cs) {
+    if (!cs.res.finalResponseSent) {
+      cs.res.send(this.data.status, this.data.reason, {
+        headers: this.headers
+      });
+    }
+    return false;
+  }
+}
+
+module.exports = TaskSipDecline;
--- a/lib/tasks/specs.json
+++ b/lib/tasks/specs.json
@@ -0,0 +1,97 @@
+{
+  "sip:decline": {
+    "properties": {
+      "status": "number",
+      "reason": "string",
+      "headers": "object"
+    },
+    "required": [
+      "status"
+    ]
+  },
+  "dial": {
+    "properties": {
+      "action": "string",
+      "answerOnBridge": "boolean",
+      "callerId": "string",
+      "dialMusic": "string",
+      "method": {
+        "type": "string",
+        "enum": ["GET", "POST"]
+      },
+      "target": ["#target"],
+      "timeLimit": "number",
+      "timeout": "number",
+      "headers": "object",
+      "strategy": {
+        "type": "string",
+        "enum": ["hunt", "simring"]
+      },
+      "transcribe": "#transcribe",
+      "listen": "#listen"
+    },
+    "required": [
+      "target"
+    ]
+  },
+  "listen": {
+    "properties": {
+      "metadata": "object",
+      "mixType": {
+        "type": "string",
+        "enum": ["mono", "stereo", "mixed"]
+      },
+      "passDtmf": "boolean",
+      "sampleRate": "number",
+      "source": {
+        "type": "string",
+        "enum": ["parent", "child", "both"]
+      },
+      "wsUrl": "string"
+    },
+    "required": [
+      "wsUrl",
+      "sampleRate"
+    ]
+  },
+  "transcribe": {
+    "properties": {
+      "action": "string",
+      "interim": "boolean",
+      "jsonKey": "string",
+      "language": "string",
+      "source": "string",
+      "vendor": "string"
+    },
+    "required": [
+      "action",
+      "jsonKey",
+      "language"
+    ]
+  },
+  "target": {
+    "properties": {
+      "type": {
+        "type": "string",
+        "enum": ["phone", "sip", "user"]
+      },
+      "number": "string",
+      "uri": "string",
+      "auth": "#auth",
+      "name": "string"
+    },
+    "required": [
+      "type"
+    ]
+  },
+  "auth": {
+    "properties": {
+      "user": "string",
+      "password": "string"
+    },
+    "required": [
+      "user",
+      "password"
+    ]
+  }
+}
--- a/lib/tasks/task.js
+++ b/lib/tasks/task.js
@@ -0,0 +1,66 @@
+const debug = require('debug')('jambonz:feature-server');
+const assert = require('assert');
+const specs = new Map();
+const _specData = require('./specs');
+for (const key in _specData) {specs.set(key, _specData[key]);}
+
+class Task {
+  constructor(logger, data) {
+    this.logger = logger;
+    this.data = data;
+  }
+
+  static validate(name, data) {
+    debug(`validating ${name} with data ${JSON.stringify(data)}`);
+    // validate the instruction is supported
+    if (!specs.has(name)) throw new Error(`invalid instruction: ${name}`);
+
+    // check type of each element and make sure required elements are present
+    const specData = specs.get(name);
+    let required = specData.required || [];
+    for (const dKey in data) {
+      if (dKey in specData.properties) {
+        const dVal = data[dKey];
+        const dSpec = specData.properties[dKey];
+
+        if (typeof dSpec === 'string' && ['number', 'string', 'object', 'boolean'].includes(dSpec)) {
+          // simple types
+          if (typeof dVal !== specData.properties[dKey]) {
+            throw new Error(`${name}: property ${dKey} has invalid data type`);
+          }
+        }
+        else if (Array.isArray(dSpec) && dSpec[0].startsWith('#')) {
+          const name = dSpec[0].slice(1);
+          for (const item of dVal) {
+            Task.validate(name, item);
+          }
+        }
+        else if (typeof dSpec === 'object') {
+          // complex types
+          const type = dSpec.type;
+          assert.ok(['number', 'string', 'object', 'boolean'].includes(type),
+            `invalid or missing type in spec ${JSON.stringify(dSpec)}`);
+          if (type === 'string' && dSpec.enum) {
+            assert.ok(Array.isArray(dSpec.enum), `enum must be an array ${JSON.stringify(dSpec.enum)}`);
+            if (!dSpec.enum.includes(dVal)) throw new Error(`invalid value ${dVal} must be one of ${dSpec.enum}`);
+          }
+        }
+        else if (typeof dSpec === 'string' && dSpec.startsWith('#')) {
+          // reference to another datatype (i.e. nested type)
+          // TODO: validate recursively
+          const name = dSpec.slice(1);
+          Task.validate(name, dVal);
+        }
+        else {
+          assert.ok(0, `invalid spec ${JSON.stringify(dSpec)}`);
+        }
+        required = required.filter((item) => item !== dKey);
+      }
+      else throw new Error(`${name}: unknown property ${dKey}`);
+    }
+    if (required.length > 0) throw new Error(`${name}: missing value for ${required}`);
+  }
+}
+
+module.exports = Task;
+
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -0,0 +1,48 @@
+{
+  "name": "jambones-feature-server",
+  "version": "0.0.1",
+  "main": "app.js",
+  "engines": {
+    "node": ">= 10.16.0"
+  },
+  "keywords": [
+    "sip",
+    "drachtio"
+  ],
+  "author": "Dave Horton",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jambonz/jambones-feature-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jambonz/jambones-feature-server/issues"
+  },
+  "scripts": {
+    "start": "node app",
+    "test": "NODE_ENV=test node test/ | ./node_modules/.bin/tap-spec",
+    "coverage": "./node_modules/.bin/nyc --reporter html --report-dir ./coverage npm run test",
+    "jslint": "eslint app.js lib"
+  },
+  "dependencies": {
+    "config": "^3.2.4",
+    "debug": "^4.1.1",
+    "drachtio-fn-b2b-sugar": "0.0.12",
+    "drachtio-srf": "^4.4.27",
+    "jambonz-db-helpers": "^0.1.6",
+    "pino": "^5.14.0",
+    "request": "^2.88.0",
+    "request-debug": "^0.2.0"
+  },
+  "devDependencies": {
+    "blue-tape": "^1.0.0",
+    "clear-module": "^4.0.0",
+    "eslint": "^6.7.2",
+    "eslint-plugin-promise": "^4.2.1",
+    "nyc": "^14.1.1",
+    "tap": "^14.10.2",
+    "tap-dot": "^2.0.0",
+    "tap-spec": "^5.0.0",
+    "tape": "^4.11.0"
+  }
+}
--- a/test/create-test-db.js
+++ b/test/create-test-db.js
@@ -0,0 +1,27 @@
+const test = require('tape').test ;
+const exec = require('child_process').exec ;
+const pwd = process.env.TRAVIS ? '' : '-p$MYSQL_ROOT_PASSWORD';
+
+test('creating jambones_test database', (t) => {
+  exec(`mysql -h localhost -u root ${pwd} < ${__dirname}/db/create_test_db.sql`, (err, stdout, stderr) => {
+    if (err) return t.end(err);
+    t.pass('database successfully created');
+    t.end();
+  });
+});
+
+test('creating schema', (t) => {
+  exec(`mysql -h localhost -u root ${pwd} -D jambones_test < ${__dirname}/db/jambones-sql.sql`, (err, stdout, stderr) => {
+    if (err) return t.end(err);
+    t.pass('schema successfully created');
+    t.end();
+  });
+});
+
+test('populating test case data', (t) => {
+  exec(`mysql -h localhost -u root ${pwd} -D jambones_test < ${__dirname}/db/populate-test-data.sql`, (err, stdout, stderr) => {
+    if (err) return t.end(err);
+    t.pass('test data set created');
+    t.end();
+  });
+});
--- a/test/data/bad/bad-enum.json
+++ b/test/data/bad/bad-enum.json
@@ -0,0 +1,16 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "foo",
+        "number": "sip:1617333456@sip.trunk1.com",
+        "auth": {
+          "user": "foo",
+          "password": "bar"
+        }
+      }
+    ]
+  }
+}
--- a/test/data/bad/bad-payload.json
+++ b/test/data/bad/bad-payload.json
@@ -0,0 +1,4 @@
+{
+  "key1": "value",
+  "key2": "value"
+}
--- a/test/data/bad/bad-payload2.json
+++ b/test/data/bad/bad-payload2.json
@@ -0,0 +1 @@
+[1, 2]
--- a/test/data/bad/invalid-type.json
+++ b/test/data/bad/invalid-type.json
@@ -0,0 +1,5 @@
+{
+  "sip:decline": {
+    "status": "hello"
+  }
+}
--- a/test/data/bad/missing-required-property.json
+++ b/test/data/bad/missing-required-property.json
@@ -0,0 +1,15 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "sip",
+        "number": "sip:1617333456@sip.trunk1.com",
+        "auth": {
+          "password": "bar"
+        }
+      }
+    ]
+  }
+}
--- a/test/data/bad/unknown-instruction.json
+++ b/test/data/bad/unknown-instruction.json
@@ -0,0 +1,3 @@
+{
+  "foo": "bar"
+}
--- a/test/data/bad/unknown-property.json
+++ b/test/data/bad/unknown-property.json
@@ -0,0 +1,6 @@
+{
+  "sip:decline": {
+    "status": 480,
+    "foo": "bar"
+  }
+}
--- a/test/data/good/dial-listen.json
+++ b/test/data/good/dial-listen.json
@@ -0,0 +1,22 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "phone",
+        "number": "+15083084809"
+      }
+    ],
+    "listen": {
+      "wsUrl": "wss://myrecorder.example.com:4433",
+      "mixType" : "stereo",
+      "sampleRate": 8000,
+      "passDtmf": true,
+      "source": "parent",
+      "metadata": {
+        "clientId": "12udih"
+      }
+    }
+  }
+}
--- a/test/data/good/dial-phone.json
+++ b/test/data/good/dial-phone.json
@@ -0,0 +1,12 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "phone",
+        "number": "+15083084809"
+      }
+    ]
+  }
+}
--- a/test/data/good/dial-sip.json
+++ b/test/data/good/dial-sip.json
@@ -0,0 +1,16 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "sip",
+        "number": "sip:1617333456@sip.trunk1.com",
+        "auth": {
+          "user": "foo",
+          "password": "bar"
+        }
+      }
+    ]
+  }
+}
--- a/test/data/good/dial-transcribe.json
+++ b/test/data/good/dial-transcribe.json
@@ -0,0 +1,20 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "phone",
+        "number": "+15083084809"
+      }
+    ],
+    "transcribe": {
+      "action": "http://example.com/transcribe",
+      "language" : "en-US",
+      "source" : "both",
+      "interim": true,
+      "vendor": "google",
+      "jsonKey": "--json service key--" 
+    }
+  }
+}
--- a/test/data/good/dial-user.json
+++ b/test/data/good/dial-user.json
@@ -0,0 +1,12 @@
+{
+  "dial": {
+    "action": "http://example.com",
+    "callerId": "+1312888899",
+    "target": [
+      {
+        "type": "user",
+        "name": "spike@sip.example.com"
+      }
+    ]
+  }
+}
--- a/test/data/good/sip-decline.json
+++ b/test/data/good/sip-decline.json
@@ -0,0 +1,9 @@
+{
+  "sip:decline": {
+    "status": 480,
+    "reason": "Gone Fishin",
+    "headers": {
+      "Retry-After": 300
+    }  
+  }
+}
--- a/test/db/create_test_db.sql
+++ b/test/db/create_test_db.sql
@@ -0,0 +1,3 @@
+create database jambones_test;
+create user jambones_test@localhost IDENTIFIED WITH mysql_native_password by 'jambones_test';
+grant all on jambones_test.* to jambones_test@localhost;
--- a/test/db/jambones-sql.sql
+++ b/test/db/jambones-sql.sql
@@ -0,0 +1,272 @@
+/* SQLEditor (MySQL (2))*/
+
+
+DROP TABLE IF EXISTS `call_routes`;
+
+DROP TABLE IF EXISTS `conference_participants`;
+
+DROP TABLE IF EXISTS `queue_members`;
+
+DROP TABLE IF EXISTS `calls`;
+
+DROP TABLE IF EXISTS `phone_numbers`;
+
+DROP TABLE IF EXISTS `applications`;
+
+DROP TABLE IF EXISTS `conferences`;
+
+DROP TABLE IF EXISTS `queues`;
+
+DROP TABLE IF EXISTS `subscriptions`;
+
+DROP TABLE IF EXISTS `registrations`;
+
+DROP TABLE IF EXISTS `api_keys`;
+
+DROP TABLE IF EXISTS `accounts`;
+
+DROP TABLE IF EXISTS `service_providers`;
+
+DROP TABLE IF EXISTS `sip_gateways`;
+
+DROP TABLE IF EXISTS `voip_carriers`;
+
+CREATE TABLE IF NOT EXISTS `applications`
+(
+`application_sid` CHAR(36) NOT NULL UNIQUE ,
+`name` VARCHAR(255) NOT NULL,
+`account_sid` CHAR(36) NOT NULL,
+`call_hook` VARCHAR(255) NOT NULL,
+`call_status_hook` VARCHAR(255) NOT NULL,
+PRIMARY KEY (`application_sid`)
+) ENGINE=InnoDB COMMENT='A defined set of behaviors to be applied to phone calls with';
+
+CREATE TABLE IF NOT EXISTS `call_routes`
+(
+`call_route_sid` CHAR(36) NOT NULL UNIQUE ,
+`order` INTEGER NOT NULL,
+`account_sid` CHAR(36) NOT NULL,
+`regex` VARCHAR(255) NOT NULL,
+`application_sid` CHAR(36) NOT NULL,
+PRIMARY KEY (`call_route_sid`)
+) ENGINE=InnoDB;
+
+CREATE TABLE IF NOT EXISTS `conferences`
+(
+`id` INTEGER(10) UNSIGNED NOT NULL AUTO_INCREMENT UNIQUE ,
+`conference_sid` CHAR(36) NOT NULL UNIQUE ,
+`name` VARCHAR(255),
+PRIMARY KEY (`id`)
+) ENGINE=InnoDB COMMENT='An audio conference';
+
+CREATE TABLE IF NOT EXISTS `conference_participants`
+(
+`conference_participant_sid` CHAR(36) NOT NULL UNIQUE ,
+`call_sid` CHAR(36),
+`conference_sid` CHAR(36) NOT NULL,
+PRIMARY KEY (`conference_participant_sid`)
+) ENGINE=InnoDB COMMENT='A relationship between a call and a conference that it is co';
+
+CREATE TABLE IF NOT EXISTS `queues`
+(
+`id` INTEGER(10) UNSIGNED NOT NULL AUTO_INCREMENT UNIQUE ,
+`queue_sid` CHAR(36) NOT NULL UNIQUE ,
+`name` VARCHAR(255),
+PRIMARY KEY (`id`)
+) ENGINE=InnoDB COMMENT='A set of behaviors to be applied to parked calls';
+
+CREATE TABLE IF NOT EXISTS `registrations`
+(
+`registration_sid` CHAR(36) NOT NULL UNIQUE ,
+`username` VARCHAR(255) NOT NULL,
+`domain` VARCHAR(255) NOT NULL,
+`sip_contact` VARCHAR(255) NOT NULL,
+`sip_user_agent` VARCHAR(255),
+PRIMARY KEY (`registration_sid`)
+) ENGINE=InnoDB COMMENT='An active sip registration';
+
+CREATE TABLE IF NOT EXISTS `queue_members`
+(
+`queue_member_sid` CHAR(36) NOT NULL UNIQUE ,
+`call_sid` CHAR(36),
+`queue_sid` CHAR(36) NOT NULL,
+`position` INTEGER,
+PRIMARY KEY (`queue_member_sid`)
+) ENGINE=InnoDB COMMENT='A relationship between a call and a queue that it is waiting';
+
+CREATE TABLE IF NOT EXISTS `calls`
+(
+`call_sid` CHAR(36) NOT NULL UNIQUE ,
+`parent_call_sid` CHAR(36),
+`application_sid` CHAR(36),
+`status_url` VARCHAR(255),
+`time_start` DATETIME NOT NULL,
+`time_alerting` DATETIME,
+`time_answered` DATETIME,
+`time_ended` DATETIME,
+`direction` ENUM('inbound','outbound'),
+`phone_number_sid` CHAR(36),
+`inbound_user_sid` CHAR(36),
+`outbound_user_sid` CHAR(36),
+`calling_number` VARCHAR(255),
+`called_number` VARCHAR(255),
+`caller_name` VARCHAR(255),
+`status` VARCHAR(255) NOT NULL COMMENT 'Possible values are queued, ringing, in-progress, completed, failed, busy and no-answer',
+`sip_uri` VARCHAR(255) NOT NULL,
+`sip_call_id` VARCHAR(255) NOT NULL,
+`sip_cseq` INTEGER NOT NULL,
+`sip_from_tag` VARCHAR(255) NOT NULL,
+`sip_via_branch` VARCHAR(255) NOT NULL,
+`sip_contact` VARCHAR(255),
+`sip_final_status` INTEGER UNSIGNED,
+`sdp_offer` VARCHAR(4096),
+`sdp_answer` VARCHAR(4096),
+`source_address` VARCHAR(255) NOT NULL,
+`source_port` INTEGER UNSIGNED NOT NULL,
+`dest_address` VARCHAR(255),
+`dest_port` INTEGER UNSIGNED,
+`url` VARCHAR(255),
+PRIMARY KEY (`call_sid`)
+) ENGINE=InnoDB COMMENT='A phone call';
+
+CREATE TABLE IF NOT EXISTS `service_providers`
+(
+`service_provider_sid` CHAR(36) NOT NULL UNIQUE ,
+`name` VARCHAR(255) NOT NULL UNIQUE ,
+`description` VARCHAR(255),
+`root_domain` VARCHAR(255) UNIQUE ,
+`registration_hook` VARCHAR(255),
+`hook_basic_auth_user` VARCHAR(255),
+`hook_basic_auth_password` VARCHAR(255),
+PRIMARY KEY (`service_provider_sid`)
+) ENGINE=InnoDB COMMENT='An organization that provides communication services to its ';
+
+CREATE TABLE IF NOT EXISTS `api_keys`
+(
+`api_key_sid` CHAR(36) NOT NULL UNIQUE ,
+`token` CHAR(36) NOT NULL UNIQUE ,
+`account_sid` CHAR(36),
+`service_provider_sid` CHAR(36),
+PRIMARY KEY (`api_key_sid`)
+) ENGINE=InnoDB COMMENT='An authorization token that is used to access the REST api';
+
+CREATE TABLE IF NOT EXISTS `accounts`
+(
+`account_sid` CHAR(36) NOT NULL UNIQUE ,
+`name` VARCHAR(255) NOT NULL,
+`sip_realm` VARCHAR(255) UNIQUE ,
+`service_provider_sid` CHAR(36) NOT NULL,
+`registration_hook` VARCHAR(255),
+`hook_basic_auth_user` VARCHAR(255),
+`hook_basic_auth_password` VARCHAR(255),
+`is_active` BOOLEAN NOT NULL DEFAULT true,
+PRIMARY KEY (`account_sid`)
+) ENGINE=InnoDB COMMENT='A single end-user of the platform';
+
+CREATE TABLE IF NOT EXISTS `subscriptions`
+(
+`id` INTEGER(10) UNSIGNED NOT NULL AUTO_INCREMENT UNIQUE ,
+`subscription_sid` CHAR(36) NOT NULL UNIQUE ,
+`registration_sid` CHAR(36) NOT NULL,
+`event` VARCHAR(255),
+PRIMARY KEY (`id`)
+) ENGINE=InnoDB COMMENT='An active sip subscription';
+
+CREATE TABLE IF NOT EXISTS `voip_carriers`
+(
+`voip_carrier_sid` CHAR(36) NOT NULL UNIQUE ,
+`name` VARCHAR(255) NOT NULL UNIQUE ,
+`description` VARCHAR(255),
+PRIMARY KEY (`voip_carrier_sid`)
+) ENGINE=InnoDB COMMENT='An external organization that can provide sip trunking and D';
+
+CREATE TABLE IF NOT EXISTS `phone_numbers`
+(
+`phone_number_sid` CHAR(36) UNIQUE ,
+`number` VARCHAR(255) NOT NULL UNIQUE ,
+`voip_carrier_sid` CHAR(36) NOT NULL,
+`account_sid` CHAR(36),
+`application_sid` CHAR(36),
+PRIMARY KEY (`phone_number_sid`)
+) ENGINE=InnoDB COMMENT='A phone number that has been assigned to an account';
+
+CREATE TABLE IF NOT EXISTS `sip_gateways`
+(
+`sip_gateway_sid` CHAR(36),
+`ipv4` VARCHAR(32) NOT NULL,
+`port` INTEGER NOT NULL DEFAULT 5060,
+`inbound` BOOLEAN NOT NULL,
+`outbound` BOOLEAN NOT NULL,
+`voip_carrier_sid` CHAR(36) NOT NULL,
+`is_active` BOOLEAN NOT NULL DEFAULT true,
+PRIMARY KEY (`sip_gateway_sid`)
+);
+
+CREATE UNIQUE INDEX `applications_idx_name` ON `applications` (`account_sid`,`name`);
+
+CREATE INDEX `applications_application_sid_idx` ON `applications` (`application_sid`);
+CREATE INDEX `applications_name_idx` ON `applications` (`name`);
+CREATE INDEX `applications_account_sid_idx` ON `applications` (`account_sid`);
+ALTER TABLE `applications` ADD FOREIGN KEY account_sid_idxfk (`account_sid`) REFERENCES `accounts` (`account_sid`);
+
+CREATE INDEX `call_routes_call_route_sid_idx` ON `call_routes` (`call_route_sid`);
+ALTER TABLE `call_routes` ADD FOREIGN KEY account_sid_idxfk_1 (`account_sid`) REFERENCES `accounts` (`account_sid`);
+
+ALTER TABLE `call_routes` ADD FOREIGN KEY application_sid_idxfk (`application_sid`) REFERENCES `applications` (`application_sid`);
+
+CREATE INDEX `conferences_conference_sid_idx` ON `conferences` (`conference_sid`);
+CREATE INDEX `conference_participants_conference_participant_sid_idx` ON `conference_participants` (`conference_participant_sid`);
+ALTER TABLE `conference_participants` ADD FOREIGN KEY call_sid_idxfk (`call_sid`) REFERENCES `calls` (`call_sid`);
+
+ALTER TABLE `conference_participants` ADD FOREIGN KEY conference_sid_idxfk (`conference_sid`) REFERENCES `conferences` (`conference_sid`);
+
+CREATE INDEX `queues_queue_sid_idx` ON `queues` (`queue_sid`);
+CREATE INDEX `registrations_registration_sid_idx` ON `registrations` (`registration_sid`);
+CREATE INDEX `queue_members_queue_member_sid_idx` ON `queue_members` (`queue_member_sid`);
+ALTER TABLE `queue_members` ADD FOREIGN KEY call_sid_idxfk_1 (`call_sid`) REFERENCES `calls` (`call_sid`);
+
+ALTER TABLE `queue_members` ADD FOREIGN KEY queue_sid_idxfk (`queue_sid`) REFERENCES `queues` (`queue_sid`);
+
+CREATE INDEX `calls_call_sid_idx` ON `calls` (`call_sid`);
+ALTER TABLE `calls` ADD FOREIGN KEY parent_call_sid_idxfk (`parent_call_sid`) REFERENCES `calls` (`call_sid`);
+
+ALTER TABLE `calls` ADD FOREIGN KEY application_sid_idxfk_1 (`application_sid`) REFERENCES `applications` (`application_sid`);
+
+CREATE INDEX `calls_phone_number_sid_idx` ON `calls` (`phone_number_sid`);
+ALTER TABLE `calls` ADD FOREIGN KEY phone_number_sid_idxfk (`phone_number_sid`) REFERENCES `phone_numbers` (`phone_number_sid`);
+
+ALTER TABLE `calls` ADD FOREIGN KEY inbound_user_sid_idxfk (`inbound_user_sid`) REFERENCES `registrations` (`registration_sid`);
+
+ALTER TABLE `calls` ADD FOREIGN KEY outbound_user_sid_idxfk (`outbound_user_sid`) REFERENCES `registrations` (`registration_sid`);
+
+CREATE INDEX `service_providers_service_provider_sid_idx` ON `service_providers` (`service_provider_sid`);
+CREATE INDEX `service_providers_name_idx` ON `service_providers` (`name`);
+CREATE INDEX `service_providers_root_domain_idx` ON `service_providers` (`root_domain`);
+CREATE INDEX `api_keys_api_key_sid_idx` ON `api_keys` (`api_key_sid`);
+CREATE INDEX `api_keys_account_sid_idx` ON `api_keys` (`account_sid`);
+ALTER TABLE `api_keys` ADD FOREIGN KEY account_sid_idxfk_2 (`account_sid`) REFERENCES `accounts` (`account_sid`);
+
+CREATE INDEX `api_keys_service_provider_sid_idx` ON `api_keys` (`service_provider_sid`);
+ALTER TABLE `api_keys` ADD FOREIGN KEY service_provider_sid_idxfk (`service_provider_sid`) REFERENCES `service_providers` (`service_provider_sid`);
+
+CREATE INDEX `accounts_account_sid_idx` ON `accounts` (`account_sid`);
+CREATE INDEX `accounts_name_idx` ON `accounts` (`name`);
+CREATE INDEX `accounts_sip_realm_idx` ON `accounts` (`sip_realm`);
+CREATE INDEX `accounts_service_provider_sid_idx` ON `accounts` (`service_provider_sid`);
+ALTER TABLE `accounts` ADD FOREIGN KEY service_provider_sid_idxfk_1 (`service_provider_sid`) REFERENCES `service_providers` (`service_provider_sid`);
+
+ALTER TABLE `subscriptions` ADD FOREIGN KEY registration_sid_idxfk (`registration_sid`) REFERENCES `registrations` (`registration_sid`);
+
+CREATE INDEX `voip_carriers_voip_carrier_sid_idx` ON `voip_carriers` (`voip_carrier_sid`);
+CREATE INDEX `voip_carriers_name_idx` ON `voip_carriers` (`name`);
+CREATE INDEX `phone_numbers_phone_number_sid_idx` ON `phone_numbers` (`phone_number_sid`);
+CREATE INDEX `phone_numbers_voip_carrier_sid_idx` ON `phone_numbers` (`voip_carrier_sid`);
+ALTER TABLE `phone_numbers` ADD FOREIGN KEY voip_carrier_sid_idxfk (`voip_carrier_sid`) REFERENCES `voip_carriers` (`voip_carrier_sid`);
+
+ALTER TABLE `phone_numbers` ADD FOREIGN KEY account_sid_idxfk_3 (`account_sid`) REFERENCES `accounts` (`account_sid`);
+
+ALTER TABLE `phone_numbers` ADD FOREIGN KEY application_sid_idxfk_2 (`application_sid`) REFERENCES `applications` (`application_sid`);
+
+CREATE UNIQUE INDEX `sip_gateways_sip_gateway_idx_hostport` ON `sip_gateways` (`ipv4`,`port`);
+
+ALTER TABLE `sip_gateways` ADD FOREIGN KEY voip_carrier_sid_idxfk_1 (`voip_carrier_sid`) REFERENCES `voip_carriers` (`voip_carrier_sid`);
--- a/test/db/populate-test-data.sql
+++ b/test/db/populate-test-data.sql
@@ -0,0 +1,10 @@
+insert into service_providers (service_provider_sid, name, root_domain, registration_hook, hook_basic_auth_user, hook_basic_auth_password) 
+values ('3f35518f-5a0d-4c2e-90a5-2407bb3b36f0', 'SP A', 'jambonz.org', 'http://127.0.0.1:4000/auth', 'foo', 'bar');
+insert into accounts(account_sid, service_provider_sid, name, sip_realm, registration_hook, hook_basic_auth_user, hook_basic_auth_password)
+values ('ed649e33-e771-403a-8c99-1780eabbc803', '3f35518f-5a0d-4c2e-90a5-2407bb3b36f0', 'test account', 'sip.example.com', 'http://127.0.0.1:4000/auth', 'foo', 'bar');
+
+insert into voip_carriers (voip_carrier_sid, name) values ('287c1452-620d-4195-9f19-c9814ef90d78', 'westco');
+insert into sip_gateways (sip_gateway_sid, voip_carrier_sid, ipv4, inbound, outbound) 
+values ('124a5339-c62c-4075-9e19-f4de70a96597', '287c1452-620d-4195-9f19-c9814ef90d78', '172.38.0.20', true, true);
+insert into sip_gateways (sip_gateway_sid, voip_carrier_sid, ipv4, port, inbound, outbound) 
+values ('efbc4830-57cd-4c78-a56f-d64fdf210fe8', '287c1452-620d-4195-9f19-c9814ef90d78', '3.3.3.3', 5062, false, true);
--- a/test/db/remove_test_db.sql
+++ b/test/db/remove_test_db.sql
@@ -0,0 +1,3 @@
+DROP DATABASE jambones_test;
+REVOKE ALL PRIVILEGES, GRANT OPTION FROM 'jambones_test'@'localhost';
+DROP USER 'jambones_test'@'localhost';
--- a/test/docker-compose-testbed.yaml
+++ b/test/docker-compose-testbed.yaml
@@ -0,0 +1,55 @@
+version: '3'
+
+networks:
+  sbc-inbound:
+    driver: bridge
+    ipam:
+      config:
+        - subnet: 172.38.0.0/16
+
+services:
+  sbc:
+    image: drachtio/drachtio-server:latest
+    command: drachtio --contact "sip:*;transport=udp" --loglevel debug --sofia-loglevel 9
+    ports:
+      - "9060:9022/tcp"
+    networks:
+      sbc-inbound:
+        ipv4_address: 172.38.0.10
+
+  appserver:
+    image: drachtio/sipp:latest
+    command: sipp -sf /tmp/uas.xml
+    volumes:
+      - ./scenarios:/tmp
+    tty: true
+    networks:
+      sbc-inbound:
+        ipv4_address: 172.38.0.11
+
+  auth-server:
+    image: jambonz/customer-auth-server:latest
+    command: npm start
+    ports:
+      - "4000:4000/tcp"
+    env_file: docker.env
+    networks:
+      sbc-inbound:
+        ipv4_address: 172.38.0.12
+
+  redis:
+    image: redis:5-alpine
+    ports:
+      - "16379:6379/tcp"
+    networks:
+      sbc-inbound:
+        ipv4_address: 172.38.0.13
+
+  rtpengine:
+    image: drachtio/rtpengine:latest
+    ports:
+      - "12222:22222/udp"
+    networks:
+      sbc-inbound:
+        ipv4_address: 172.38.0.14
+
--- a/test/docker.env
+++ b/test/docker.env
@@ -0,0 +1,2 @@
+# tip: to minify json into a single string as below, see https://codebeautify.org/jsonminifier
+NODE_CONFIG={"server":{"port":4000,"path":"/auth","auth":{"users":{"foo":"bar"}}},"credentials":{"jambonz.org":[{"username":"john","password":"1234"},{"username":"jane","password":"5678"}]}}
--- a/test/docker_start.js
+++ b/test/docker_start.js
@@ -0,0 +1,12 @@
+const test = require('tape').test ;
+const exec = require('child_process').exec ;
+const async = require('async');
+
+test('starting docker network..', (t) => {
+  exec(`docker-compose -f ${__dirname}/docker-compose-testbed.yaml up -d`, (err, stdout, stderr) => {
+    t.end(err);
+  });
+  
+});
+
+  
--- a/test/docker_stop.js
+++ b/test/docker_stop.js
@@ -0,0 +1,12 @@
+const test = require('tape').test ;
+const exec = require('child_process').exec ;
+
+test('stopping docker network..', (t) => {
+  t.timeoutAfter(10000);
+  exec(`docker-compose -f ${__dirname}/docker-compose-testbed.yaml down`, (err, stdout, stderr) => {
+    //console.log(`stderr: ${stderr}`);
+    process.exit(0);
+  });
+  t.end() ;
+});
+
--- a/test/index.js
+++ b/test/index.js
@@ -0,0 +1,8 @@
+require('./unit-tests');
+/*
+require('./docker_start');
+require('./create-test-db');
+require('./sip-tests');
+require('./remove-test-db');
+require('./docker_stop');
+*/
--- a/test/remove-test-db.js
+++ b/test/remove-test-db.js
@@ -0,0 +1,11 @@
+const test = require('tape').test ;
+const exec = require('child_process').exec ;
+const pwd = process.env.TRAVIS ? '' : '-p$MYSQL_ROOT_PASSWORD';
+
+test('dropping jambones_test database', (t) => {
+  exec(`mysql -h localhost -u root ${pwd} < ${__dirname}/db/remove_test_db.sql`, (err, stdout, stderr) => {
+    if (err) return t.end(err);
+    t.pass('database successfully dropped');
+    t.end();
+  });
+});
--- a/test/scenarios/pcap/g711a.pcap
+++ b/test/scenarios/pcap/g711a.pcap
--- a/test/scenarios/uac-device-invalid-password.xml
+++ b/test/scenarios/uac-device-invalid-password.xml
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp 'uac' scenario with pcap (rtp) play           -->
+<!--                                                                    -->
+
+<scenario name="UAC with media">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-device-unknown-user
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="401" auth="true">
+  </recv>
+
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Subject: uac-device-unknown-user
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 2 INVITE
+      [authentication username=john password=2222]
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-device-unknown-user
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="403">
+  </recv>
+
+  <!-- Packet lost can be simulated in any send/recv message by         -->
+  <!-- by adding the 'lost = "10"'. Value can be [1-100] percent.       -->
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 2 ACK
+      Subject: uac-device-unknown-user
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <!-- definition of the response time repartition table (unit is ms)   -->
+  <ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
+
+  <!-- definition of the call length repartition table (unit is ms)     -->
+  <CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
+
+</scenario>
--- a/test/scenarios/uac-device-unknown-realm.xml
+++ b/test/scenarios/uac-device-unknown-realm.xml
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp 'uac' scenario with pcap (rtp) play           -->
+<!--                                                                    -->
+
+<scenario name="UAC with media">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambones.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-device-unknown-user
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="403">
+  </recv>
+
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambones.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Subject: uac-device-unknown-user
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+
+
+</scenario>
--- a/test/scenarios/uac-device-unknown-user.xml
+++ b/test/scenarios/uac-device-unknown-user.xml
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp 'uac' scenario with pcap (rtp) play           -->
+<!--                                                                    -->
+
+<scenario name="UAC with media">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-device-unknown-user
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="401" auth="true">
+  </recv>
+
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Subject: uac-device-unknown-user
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 2 INVITE
+      [authentication username=jay password=1234]
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-device-unknown-user
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="403">
+  </recv>
+
+  <!-- Packet lost can be simulated in any send/recv message by         -->
+  <!-- by adding the 'lost = "10"'. Value can be [1-100] percent.       -->
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 2 ACK
+      Subject: uac-device-unknown-user
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <!-- definition of the response time repartition table (unit is ms)   -->
+  <ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
+
+  <!-- definition of the call length repartition table (unit is ms)     -->
+  <CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
+
+</scenario>
--- a/test/scenarios/uac-info-expect-480.xml
+++ b/test/scenarios/uac-info-expect-480.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INFO sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INFO
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="480" rtd="true"/>
+
+</scenario>
+
--- a/test/scenarios/uac-message-expect-480.xml
+++ b/test/scenarios/uac-message-expect-480.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      MESSAGE sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 MESSAGE
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="480" rtd="true"/>
+
+</scenario>
+
--- a/test/scenarios/uac-options-expect-480.xml
+++ b/test/scenarios/uac-options-expect-480.xml
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      OPTIONS sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 OPTIONS
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="480" rtd="true"/>
+
+</scenario>
+
--- a/test/scenarios/uac-pcap-carrier-success.xml
+++ b/test/scenarios/uac-pcap-carrier-success.xml
@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp 'uac' scenario with pcap (rtp) play           -->
+<!--                                                                    -->
+
+<scenario name="UAC with media">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-pcap-carrier-success
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="180" optional="true">
+  </recv>
+
+  <!-- By adding rrs="true" (Record Route Sets), the route sets         -->
+  <!-- are saved and used for following messages sent. Useful to test   -->
+  <!-- against stateful SIP proxies/B2BUAs.                             -->
+  <recv response="200" rtd="true" crlf="true">
+  </recv>
+
+  <!-- Packet lost can be simulated in any send/recv message by         -->
+  <!-- by adding the 'lost = "10"'. Value can be [1-100] percent.       -->
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Max-Forwards: 70
+      Subject: uac-pcap-carrier-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <!-- Play a pre-recorded PCAP file (RTP stream)                       -->
+  <nop>
+    <action>
+      <exec play_pcap_audio="pcap/g711a.pcap"/>
+    </action>
+  </nop>
+
+  <!-- Pause briefly      -->
+  <pause milliseconds="3000"/>
+
+  <!-- The 'crlf' option inserts a blank line in the statistics report. -->
+  <send retrans="500">
+    <![CDATA[
+
+      BYE sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 2 BYE
+      Subject: uac-pcap-carrier-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="200" crlf="true">
+  </recv>
+
+  <!-- definition of the response time repartition table (unit is ms)   -->
+  <ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
+
+  <!-- definition of the call length repartition table (unit is ms)     -->
+  <CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
+
+</scenario>
+
--- a/test/scenarios/uac-pcap-device-success-in-dialog-request.xml
+++ b/test/scenarios/uac-pcap-device-success-in-dialog-request.xml
@@ -0,0 +1,187 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp 'uac' scenario with pcap (rtp) play           -->
+<!--                                                                    -->
+
+<scenario name="UAC with media">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-pcap-device-success
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="401" auth="true">
+  </recv>
+
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Subject: uac-pcap-device-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 2 INVITE
+      [authentication username=john password=1234]
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-pcap-device-success
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="180" optional="true">
+  </recv>
+
+  <recv response="200" rtd="true" crlf="true">
+  </recv>
+
+  <!-- Packet lost can be simulated in any send/recv message by         -->
+  <!-- by adding the 'lost = "10"'. Value can be [1-100] percent.       -->
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 2 ACK
+      Subject: uac-pcap-device-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <!-- Play a pre-recorded PCAP file (RTP stream)                       -->
+  <nop>
+    <action>
+      <exec play_pcap_audio="pcap/g711a.pcap"/>
+    </action>
+  </nop>
+
+  <!-- Pause briefly      -->
+  <pause milliseconds="1000"/>
+
+  <send retrans="500">
+    <![CDATA[
+
+      INFO sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 3 INFO
+      Max-Forwards: 70
+      Event: X-custom-Event
+      Subject: uac-pcap-device-success
+      Content-Type: application/text
+      Content-Length: [len]
+
+      foobar
+
+    ]]>
+  </send>
+
+  <recv response="200" crlf="true">
+  </recv>
+
+  <send retrans="500">
+    <![CDATA[
+
+      BYE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 4 BYE
+      Max-Forwards: 70
+      Subject: uac-pcap-device-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="200" crlf="true">
+  </recv>
+
+  <!-- definition of the response time repartition table (unit is ms)   -->
+  <ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
+
+  <!-- definition of the call length repartition table (unit is ms)     -->
+  <CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
+
+</scenario>
--- a/test/scenarios/uac-pcap-device-success.xml
+++ b/test/scenarios/uac-pcap-device-success.xml
@@ -0,0 +1,165 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp 'uac' scenario with pcap (rtp) play           -->
+<!--                                                                    -->
+
+<scenario name="UAC with media">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-pcap-device-success
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="401" auth="true">
+  </recv>
+
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      [last_Via]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Subject: uac-pcap-device-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 2 INVITE
+      [authentication username=john password=1234]
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: uac-pcap-device-success
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[local_ip_type] [local_ip]
+      t=0 0
+      m=audio [auto_media_port] RTP/AVP 8 101
+      a=rtpmap:8 PCMA/8000
+      a=rtpmap:101 telephone-event/8000
+      a=fmtp:101 0-11,16
+
+    ]]>
+  </send>
+
+  <recv response="100" optional="true">
+  </recv>
+
+  <recv response="180" optional="true">
+  </recv>
+
+  <recv response="200" rtd="true" crlf="true">
+  </recv>
+
+  <!-- Packet lost can be simulated in any send/recv message by         -->
+  <!-- by adding the 'lost = "10"'. Value can be [1-100] percent.       -->
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 2 ACK
+      Subject: uac-pcap-device-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <!-- Play a pre-recorded PCAP file (RTP stream)                       -->
+  <nop>
+    <action>
+      <exec play_pcap_audio="pcap/g711a.pcap"/>
+    </action>
+  </nop>
+
+  <!-- Pause briefly      -->
+  <pause milliseconds="3000"/>
+
+  <!-- The 'crlf' option inserts a blank line in the statistics report. -->
+  <send retrans="500">
+    <![CDATA[
+
+      BYE sip:[service]@jambonz.org SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag09[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 3 BYE
+      Max-Forwards: 70
+      Subject: uac-pcap-device-success
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="200" crlf="true">
+  </recv>
+
+  <!-- definition of the response time repartition table (unit is ms)   -->
+  <ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
+
+  <!-- definition of the call length repartition table (unit is ms)     -->
+  <CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
+
+</scenario>
--- a/test/scenarios/uac-publish-expect-480.xml
+++ b/test/scenarios/uac-publish-expect-480.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      PUBLISH sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 PUBLISH
+      Contact: <sip:sipp@[local_ip]:[local_port]>;expires=3600
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="480" rtd="true"/>
+
+</scenario>
+
--- a/test/scenarios/uac-register-expect-480.xml
+++ b/test/scenarios/uac-register-expect-480.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      REGISTER sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 REGISTER
+      Contact: <sip:sipp@[local_ip]:[local_port]>;expires=3600
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="480" rtd="true"/>
+
+</scenario>
+
--- a/test/scenarios/uac-subscribe-expect-480.xml
+++ b/test/scenarios/uac-subscribe-expect-480.xml
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      SUBSCRIBE sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 SUBSCRIBE
+      Contact: <sip:sipp@[local_ip]:[local_port]>;expires=3600
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="480" rtd="true"/>
+
+</scenario>
+
--- a/test/scenarios/uac.xml
+++ b/test/scenarios/uac.xml
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uac' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic Sipstone UAC">
+  <!-- In client mode (sipp placing calls), the Call-ID MUST be         -->
+  <!-- generated by sipp. To do so, use [call_id] keyword.                -->
+  <send retrans="500">
+    <![CDATA[
+
+      INVITE sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>
+      Call-ID: [call_id]
+      CSeq: 1 INVITE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[media_ip_type] [media_ip]
+      t=0 0
+      m=audio [media_port] RTP/AVP 0
+      a=rtpmap:0 PCMU/8000
+
+    ]]>
+  </send>
+
+  <recv response="100"
+        optional="true">
+  </recv>
+
+  <recv response="180" optional="true">
+  </recv>
+
+  <recv response="183" optional="true">
+  </recv>
+
+  <!-- By adding rrs="true" (Record Route Sets), the route sets         -->
+  <!-- are saved and used for following messages sent. Useful to test   -->
+  <!-- against stateful SIP proxies/B2BUAs.                             -->
+  <recv response="200" rtd="true">
+  </recv>
+
+  <!-- Packet lost can be simulated in any send/recv message by         -->
+  <!-- by adding the 'lost = "10"'. Value can be [1-100] percent.       -->
+  <send>
+    <![CDATA[
+
+      ACK sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 1 ACK
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <!-- This delay can be customized by the -d command-line option       -->
+  <!-- or by adding a 'milliseconds = "value"' option here.             -->
+  <pause/>
+
+  <!-- The 'crlf' option inserts a blank line in the statistics report. -->
+  <send retrans="500">
+    <![CDATA[
+
+      BYE sip:[service]@[remote_ip]:[remote_port] SIP/2.0
+      Via: SIP/2.0/[transport] [local_ip]:[local_port];branch=[branch]
+      From: sipp <sip:sipp@[local_ip]:[local_port]>;tag=[pid]SIPpTag00[call_number]
+      To: [service] <sip:[service]@[remote_ip]:[remote_port]>[peer_tag_param]
+      Call-ID: [call_id]
+      CSeq: 2 BYE
+      Contact: sip:sipp@[local_ip]:[local_port]
+      Max-Forwards: 70
+      Subject: Performance Test
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <recv response="200" crlf="true">
+  </recv>
+
+  <!-- definition of the response time repartition table (unit is ms)   -->
+  <ResponseTimeRepartition value="10, 20, 30, 40, 50, 100, 150, 200"/>
+
+  <!-- definition of the call length repartition table (unit is ms)     -->
+  <CallLengthRepartition value="10, 50, 100, 500, 1000, 5000, 10000"/>
+
+</scenario>
+
--- a/test/scenarios/uas.xml
+++ b/test/scenarios/uas.xml
@@ -0,0 +1,130 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE scenario SYSTEM "sipp.dtd">
+
+<!-- This program is free software; you can redistribute it and/or      -->
+<!-- modify it under the terms of the GNU General Public License as     -->
+<!-- published by the Free Software Foundation; either version 2 of the -->
+<!-- License, or (at your option) any later version.                    -->
+<!--                                                                    -->
+<!-- This program is distributed in the hope that it will be useful,    -->
+<!-- but WITHOUT ANY WARRANTY; without even the implied warranty of     -->
+<!-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the      -->
+<!-- GNU General Public License for more details.                       -->
+<!--                                                                    -->
+<!-- You should have received a copy of the GNU General Public License  -->
+<!-- along with this program; if not, write to the                      -->
+<!-- Free Software Foundation, Inc.,                                    -->
+<!-- 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA             -->
+<!--                                                                    -->
+<!--                 Sipp default 'uas' scenario.                       -->
+<!--                                                                    -->
+
+<scenario name="Basic UAS responder">
+  <!-- By adding rrs="true" (Record Route Sets), the route sets         -->
+  <!-- are saved and used for following messages sent. Useful to test   -->
+  <!-- against stateful SIP proxies/B2BUAs.                             -->
+  <recv request="INVITE" crlf="true">
+    <action>
+      <ereg regexp=".*" search_in="hdr" header="Subject:" assign_to="1" />
+    </action>
+  </recv>
+
+  <!-- The '[last_*]' keyword is replaced automatically by the          -->
+  <!-- specified header if it was present in the last message received  -->
+  <!-- (except if it was a retransmission). If the header was not       -->
+  <!-- present or if no message has been received, the '[last_*]'       -->
+  <!-- keyword is discarded, and all bytes until the end of the line    -->
+  <!-- are also discarded.                                              -->
+  <!--                                                                  -->
+  <!-- If the specified header was present several times in the         -->
+  <!-- message, all occurrences are concatenated (CRLF separated)       -->
+  <!-- to be used in place of the '[last_*]' keyword.                   -->
+
+  <send>
+    <![CDATA[
+
+      SIP/2.0 180 Ringing
+      [last_Via:]
+      [last_From:]
+      [last_To:];tag=[pid]SIPpTag01[call_number]
+      [last_Call-ID:]
+      [last_CSeq:]
+      [last_Record-Route:]
+      Subject:[$1]
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <send>
+    <![CDATA[
+
+      SIP/2.0 200 OK
+      [last_Via:]
+      [last_From:]
+      [last_To:];tag=[pid]SIPpTag01[call_number]
+      [last_Call-ID:]
+      [last_CSeq:]
+      [last_Record-Route:]
+      Subject:[$1]
+      Contact: <sip:[local_ip]:[local_port];transport=[transport]>
+      Content-Type: application/sdp
+      Content-Length: [len]
+
+      v=0
+      o=user1 53655765 2353687637 IN IP[local_ip_type] [local_ip]
+      s=-
+      c=IN IP[media_ip_type] [media_ip]
+      t=0 0
+      m=audio [media_port] RTP/AVP 0
+      a=rtpmap:0 PCMU/8000
+
+    ]]>
+  </send>
+
+  <recv request="ACK"
+        rtd="true"
+        crlf="true">
+  </recv>
+
+  <recv request="INFO" optional="true" next="1">
+  </recv>
+
+  <recv request="BYE">
+  </recv>
+
+  <send next="2">
+    <![CDATA[
+
+      SIP/2.0 200 OK
+      [last_Via:]
+      [last_From:]
+      [last_To:]
+      [last_Call-ID:]
+      [last_CSeq:]
+      Contact: <sip:[local_ip]:[local_port];transport=[transport]>
+      Content-Length: 0
+
+    ]]>
+  </send>
+
+  <label id="1"/>
+  <send>
+  <![CDATA[
+
+    SIP/2.0 200 OK
+    [last_Via:]
+    [last_From:]
+    [last_To:]
+    [last_Call-ID:]
+    [last_CSeq:]
+    Contact: <sip:[local_ip]:[local_port];transport=[transport]>
+    Content-Length: 0
+
+  ]]>
+</send>
+
+<label id="2"/>
+
+</scenario>
+
--- a/test/sip-tests.js
+++ b/test/sip-tests.js
@@ -0,0 +1,68 @@
+const test = require('blue-tape');
+const { output, sippUac } = require('./sipp')('test_sbc-inbound');
+const debug = require('debug')('drachtio:sbc-inbound');
+const clearModule = require('clear-module');
+
+process.on('unhandledRejection', (reason, p) => {
+  console.log('Unhandled Rejection at: Promise', p, 'reason:', reason);
+});
+
+function connect(connectable) {
+  return new Promise((resolve, reject) => {
+    connectable.on('connect', () => {
+      return resolve();
+    });
+  });
+}
+
+test('incoming call tests', (t) => {
+  const {srf} = require('../app');
+
+  connect(srf)
+    .then(() => {
+      return sippUac('uac-pcap-carrier-success.xml', '172.38.0.20');
+    })
+    .then(() => {
+      return t.pass('incoming call from carrier completed successfully');
+    })
+    .then(() => {
+      return sippUac('uac-pcap-device-success.xml', '172.38.0.30');
+    })
+    .then(() => {
+      return t.pass('incoming call from authenticated device completed successfully');
+    })
+    .then(() => {
+      return sippUac('uac-device-unknown-user.xml', '172.38.0.30');
+    })
+    .then(() => {
+      return t.pass('unknown user is rejected with a 403');
+    })
+    .then(() => {
+      return sippUac('uac-device-unknown-realm.xml', '172.38.0.30');
+    })
+    .then(() => {
+      return t.pass('unknown realm is rejected with a 403');
+    })
+    .then(() => {
+      return sippUac('uac-device-invalid-password.xml', '172.38.0.30');
+    })
+    .then(() => {
+      return t.pass('invalid password for valid user is rejected with a 403');
+    })
+    .then(() => {
+      return sippUac('uac-pcap-device-success-in-dialog-request.xml', '172.38.0.30');
+    })
+    .then(() => {
+      return t.pass('handles in-dialog requests');
+    })
+    .then(() => {
+      srf.disconnect();
+      t.end();
+      return;
+    })
+    .catch((err) => {
+      console.log(`error received: ${err}`);
+      if (srf) srf.disconnect();
+      t.error(err);
+    });
+});
--- a/test/sipp.js
+++ b/test/sipp.js
@@ -0,0 +1,68 @@
+const { spawn } = require('child_process');
+const debug = require('debug')('test:sipp');
+let network;
+const obj = {};
+let output = '';
+let idx = 1;
+
+function clearOutput() {
+  output = '';
+}
+
+function addOutput(str) {
+  for (let i = 0; i < str.length; i++) {
+    if (str.charCodeAt(i) < 128) output += str.charAt(i);
+  }
+}
+
+module.exports = (networkName) => {
+  network = networkName ;
+  return obj;
+};
+
+obj.output = () => {
+  return output;
+};
+
+obj.sippUac = (file, bindAddress) => {
+  const cmd = 'docker';
+  const args = [
+    'run', '-ti', '--rm', '--net', `${network}`,
+    '-v', `${__dirname}/scenarios:/tmp/scenarios`,
+    'drachtio/sipp', 'sipp', '-sf', `/tmp/scenarios/${file}`,
+    '-m', '1',
+    '-sleep', '250ms',
+    '-nostdin',
+    '-cid_str', `%u-%p@%s-${idx++}`,
+    'sbc'
+  ];
+
+  if (bindAddress) args.splice(5, 0, '--ip', bindAddress);
+
+  //console.log(args.join(' '));
+  clearOutput();
+
+  return new Promise((resolve, reject) => {
+    const child_process = spawn(cmd, args, {stdio: ['inherit', 'pipe', 'pipe']});
+
+    child_process.on('exit', (code, signal) => {
+      if (code === 0) {
+        return resolve();
+      }
+      console.log(`sipp exited with non-zero code ${code} signal ${signal}`);
+      reject(code);
+    });
+    child_process.on('error', (error) => {
+      console.log(`error spawing child process for docker: ${args}`);
+    });
+
+    child_process.stdout.on('data', (data) => {
+      //debug(`stdout: ${data}`);
+      addOutput(data.toString());
+    });
+    child_process.stdout.on('data', (data) => {
+      //debug(`stdout: ${data}`);
+      addOutput(data.toString());
+    });
+  });
+};
--- a/test/unit-tests.js
+++ b/test/unit-tests.js
@@ -0,0 +1,49 @@
+const test = require('tape');
+const debug = require('debug')('drachtio:jambonz:test');
+const makeTask = require('../lib/tasks/make_task');
+const noop = () => {};
+const logger = {error: noop, info: noop, debug: noop};
+
+
+process.on('unhandledRejection', (reason, p) => {
+  console.log('Unhandled Rejection at: Promise', p, 'reason:', reason);
+});
+
+test('app payload parsing tests', (t) => {
+  let task = makeTask(logger, require('./data/good/sip-decline'));
+  t.ok(task.name === 'sip:decline', 'parsed sip:decline');
+
+  t.throws(errInvalidInstruction, /invalid instruction/, 'throws error for invalid instruction');
+  t.throws(errUnknownProperty, /unknown property/, 'throws error for invalid instruction');
+  t.throws(errMissingProperty, /missing value/, 'throws error for missing required property');
+  t.throws(errInvalidType, /invalid data type/, 'throws error for invalid data type');
+  t.throws(errBadEnum, /must be one of/, 'throws error for invalid enum');
+  t.throws(errBadPayload, /invalid instruction payload/, 'throws error for invalid payload with multiple keys');
+  t.throws(errBadPayload2, /invalid instruction payload/, 'throws error for invalid payload that is not an object');
+
+  task = makeTask(logger, require('./data/good/dial-phone'));
+  t.ok(task.name === 'dial', 'parsed dial phone');
+
+  task = makeTask(logger, require('./data/good/dial-sip'));
+  t.ok(task.name === 'dial', 'parsed dial sip');
+
+  task = makeTask(logger, require('./data/good/dial-user'));
+  t.ok(task.name === 'dial', 'parsed dial user');
+
+  task = makeTask(logger, require('./data/good/dial-transcribe'));
+  t.ok(task.name === 'dial', 'parsed dial w/ transcribe');
+
+  task = makeTask(logger, require('./data/good/dial-listen'));
+  t.ok(task.name === 'dial', 'parsed dial w/ listen');
+
+  t.end();
+});
+
+
+const errInvalidInstruction = () => makeTask(logger, require('./data/bad/unknown-instruction'));
+const errUnknownProperty = () => makeTask(logger, require('./data/bad/unknown-property'));
+const errMissingProperty = () => makeTask(logger, require('./data/bad/missing-required-property'));
+const errInvalidType = () => makeTask(logger, require('./data/bad/invalid-type'));
+const errBadEnum = () => makeTask(logger, require('./data/bad/bad-enum'));
+const errBadPayload = () => makeTask(logger, require('./data/bad/bad-payload'));
+const errBadPayload2 = () => makeTask(logger, require('./data/bad/bad-payload2'));