@itentialopensource/adapter-aruba_airwave 0.1.1

package/report/creationReport.json

@@ -0,0 +1,381 @@
+{
+  "errors": [],
+  "statistics": [
+    {
+      "owner": "errorJson",
+      "description": "Standard adapter errors available for use",
+      "value": 30
+    },
+    {
+      "owner": "packageJson",
+      "description": "Number of production dependencies",
+      "value": 5
+    },
+    {
+      "owner": "packageJson",
+      "description": "Number of development dependencies",
+      "value": 12
+    },
+    {
+      "owner": "packageJson",
+      "description": "Number of npm scripts",
+      "value": 16
+    },
+    {
+      "owner": "packageJson",
+      "description": "Runtime Library dependency",
+      "value": "^4.38.0"
+    },
+    {
+      "owner": "propertiesSchemaJson",
+      "description": "Adapter properties defined in the propertiesSchema file",
+      "value": 56
+    },
+    {
+      "owner": "adapterJS",
+      "description": "Lines of code generated in adapter.js",
+      "value": 2696
+    },
+    {
+      "owner": "adapterJS",
+      "description": "Number of Functions added to adapter.js",
+      "value": 27
+    },
+    {
+      "owner": "pronghornJson",
+      "description": "Number of Methods added to pronghorn.json",
+      "value": 27
+    },
+    {
+      "owner": "readmeMd",
+      "description": "Number of lines in the README.md",
+      "value": 545
+    },
+    {
+      "owner": "unitTestJS",
+      "description": "Number of lines of code in unit tests",
+      "value": 1414
+    },
+    {
+      "owner": "unitTestJS",
+      "description": "Number of unit tests",
+      "value": 76
+    },
+    {
+      "owner": "integrationTestJS",
+      "description": "Number of lines of code in integration tests",
+      "value": 1126
+    },
+    {
+      "owner": "integrationTestJS",
+      "description": "Number of integration tests",
+      "value": 32
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for QueryAPIS entity",
+      "value": 14
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for ConfigurationAPIS entity",
+      "value": 6
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for SearchAPIS entity",
+      "value": 3
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for ReportAPIS entity",
+      "value": 1
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for BatchExecuteAPCommandsAPIS entity",
+      "value": 2
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for LOGIN entity",
+      "value": 1
+    },
+    {
+      "owner": "actionJson",
+      "description": "Total number of actions",
+      "value": 27
+    },
+    {
+      "owner": "actionJson",
+      "description": "Total number of entities",
+      "value": 6
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for QueryAPIS entity",
+      "value": 1
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for ConfigurationAPIS entity",
+      "value": 1
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for SearchAPIS entity",
+      "value": 1
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for ReportAPIS entity",
+      "value": 1
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for BatchExecuteAPCommandsAPIS entity",
+      "value": 1
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for LOGIN entity",
+      "value": 1
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Total number of schemas",
+      "value": 6
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for QueryAPIS entity",
+      "value": 0
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for ConfigurationAPIS entity",
+      "value": 0
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for SearchAPIS entity",
+      "value": 0
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for ReportAPIS entity",
+      "value": 0
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for BatchExecuteAPCommandsAPIS entity",
+      "value": 0
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for LOGIN entity",
+      "value": 0
+    },
+    {
+      "owner": "mockdata",
+      "description": "Total number of mock data files",
+      "value": 0
+    },
+    {
+      "owner": "actionJson",
+      "description": "Number of actions for .system entity",
+      "value": 2
+    },
+    {
+      "owner": "schemaJson",
+      "description": "Number of schemas for .system entity",
+      "value": 3
+    },
+    {
+      "owner": "mockdata",
+      "description": "Number of mock data files for .system entity",
+      "value": 2
+    },
+    {
+      "owner": "System",
+      "description": "System entity files",
+      "value": 6
+    },
+    {
+      "owner": "usecases",
+      "description": "Number of workflows",
+      "value": 0
+    },
+    {
+      "owner": "staticFile",
+      "description": "Number of lines of code in adapterBase.js",
+      "value": 907
+    },
+    {
+      "owner": "staticFile",
+      "description": "Number of static files added",
+      "value": 26
+    },
+    {
+      "owner": "Overall",
+      "description": "Total lines of Code",
+      "value": 6143
+    },
+    {
+      "owner": "Overall",
+      "description": "Total Tests",
+      "value": 108
+    },
+    {
+      "owner": "Overall",
+      "description": "Total Files",
+      "value": 52
+    }
+  ],
+  "apiParsingReport": {
+    "no_mockdata": [
+      {
+        "fnName": "aMPStats",
+        "method": "get",
+        "path": "/amp_stats.xml"
+      },
+      {
+        "fnName": "folderList",
+        "method": "get",
+        "path": "/folder_list.xml"
+      },
+      {
+        "fnName": "catalogRepository",
+        "method": "get",
+        "path": "/static/catalog_repository.xml"
+      },
+      {
+        "fnName": "alertList",
+        "method": "get",
+        "path": "/alerts.xml"
+      },
+      {
+        "fnName": "aPList",
+        "method": "get",
+        "path": "/ap_list.xml"
+      },
+      {
+        "fnName": "aPBSSIDList",
+        "method": "get",
+        "path": "/api/ap_bssid_list.xml"
+      },
+      {
+        "fnName": "aPDetail",
+        "method": "get",
+        "path": "/ap_detail.xml"
+      },
+      {
+        "fnName": "aPLog",
+        "method": "get",
+        "path": "/ap_log.xml"
+      },
+      {
+        "fnName": "rogueDetail",
+        "method": "get",
+        "path": "/rogue_detail.xml"
+      },
+      {
+        "fnName": "clientDetail",
+        "method": "get",
+        "path": "/client_detail.xml"
+      },
+      {
+        "fnName": "visualRFConfig",
+        "method": "get",
+        "path": "/visualrf_config.xml"
+      },
+      {
+        "fnName": "userInfo",
+        "method": "get",
+        "path": "/user_info.xml"
+      },
+      {
+        "fnName": "deviceRRDInfo",
+        "method": "get",
+        "path": "/device_rrd_info.xml"
+      },
+      {
+        "fnName": "clientRRDInfo",
+        "method": "get",
+        "path": "/user_rrd_info.xml"
+      },
+      {
+        "fnName": "changeSet",
+        "method": "post",
+        "path": "/site_changes"
+      },
+      {
+        "fnName": "guestUserCreateUser",
+        "method": "post",
+        "path": "/guest_user_api"
+      },
+      {
+        "fnName": "modifyTemplateVariables",
+        "method": "post",
+        "path": "/template_variable_api"
+      },
+      {
+        "fnName": "importAPWhitelist",
+        "method": "post",
+        "path": "/api/ap_whitelist_upload"
+      },
+      {
+        "fnName": "deauthenticateClient",
+        "method": "get",
+        "path": "/deauthenticate_user.xml"
+      },
+      {
+        "fnName": "downStatusMessage",
+        "method": "get",
+        "path": "/down_status_message.xml"
+      },
+      {
+        "fnName": "aPSearch",
+        "method": "get",
+        "path": "/ap_search.xml"
+      },
+      {
+        "fnName": "clientSearch",
+        "method": "get",
+        "path": "/client_search.xml"
+      },
+      {
+        "fnName": "vPNUserSearch",
+        "method": "get",
+        "path": "/vpn_user_search.xml"
+      },
+      {
+        "fnName": "latestReport",
+        "method": "get",
+        "path": "/latest_report.xml"
+      },
+      {
+        "fnName": "batchExecuteAPCommand",
+        "method": "post",
+        "path": "/api/batch_command_execute"
+      },
+      {
+        "fnName": "batchExecuteAPCommandResult",
+        "method": "get",
+        "path": "/api/batch_command_execute_result"
+      },
+      {
+        "fnName": "aMPLogin",
+        "method": "post",
+        "path": "/LOGIN"
+      }
+    ],
+    "errors": [],
+    "warnings": [
+      "Method post in path /guest_user_api has 2 parameters with the same name. Parameter name changed to bodyFormData to avoid errors."
+    ],
+    "callsTotal": 27,
+    "callsConverted": 27,
+    "no_mockdata_num": 27
+  }
+}

package/sampleProperties.json

@@ -0,0 +1,97 @@
+{
+  "id": "Adapter-aruba_airwave",
+  "type": "ArubaAirwave",
+  "properties": {
+    "host": "localhost",
+    "port": 443,
+    "base_path": "/",
+    "version": "",
+    "cache_location": "none",
+    "save_metric": true,
+    "stub": true,
+    "protocol": "https",
+    "authentication": {
+      "auth_method": "no_authentication",
+      "username": "username",
+      "password": "password",
+      "token": "token",
+      "token_timeout": 600000,
+      "token_cache": "local",
+      "invalid_token_error": 401,
+      "auth_field": "header.headers.Authorization",
+      "auth_field_format": "Basic {b64}{username}:{password}{/b64}"
+    },
+    "healthcheck": {
+      "type": "none",
+      "frequency": 60000
+    },
+    "throttle": {
+      "throttle_enabled": false,
+      "number_pronghorns": 1,
+      "sync_async": "sync",
+      "max_in_queue": 1000,
+      "concurrent_max": 1,
+      "expire_timeout": 0,
+      "avg_runtime": 200,
+      "priorities": [
+        {
+          "value": 0,
+          "percent": 100
+        }
+      ]
+    },
+    "request": {
+      "number_redirects": 0,
+      "number_retries": 3,
+      "limit_retry_error": [
+        0
+      ],
+      "failover_codes": [],
+      "attempt_timeout": 5000,
+      "global_request": {
+        "payload": {},
+        "uriOptions": {},
+        "addlHeaders": {},
+        "authData": {}
+      },
+      "healthcheck_on_timeout": true,
+      "return_raw": false,
+      "archiving": false
+    },
+    "proxy": {
+      "enabled": false,
+      "host": "",
+      "port": 1,
+      "protocol": "http"
+    },
+    "ssl": {
+      "ecdhCurve": "",
+      "enabled": false,
+      "accept_invalid_cert": false,
+      "ca_file": "",
+      "key_file": "",
+      "cert_file": "",
+      "secure_protocol": "",
+      "ciphers": ""
+    },
+    "mongo": {
+      "host": "",
+      "port": 0,
+      "database": "",
+      "username": "",
+      "password": "",
+      "replSet": "",
+      "db_ssl": {
+        "enabled": false,
+        "accept_invalid_cert": false,
+        "ca_file": "",
+        "key_file": "",
+        "cert_file": ""
+      }
+    }
+  },
+  "groups": [],
+  "brokers": [],
+  "logLevel": "none",
+  "timeout": 120000
+}

package/test/integration/adapterTestBasicGet.js

@@ -0,0 +1,85 @@
+/* @copyright Itential, LLC 2020 */
+
+/* global describe context before after */
+/* eslint global-require: warn */
+/* eslint no-unused-vars: warn */
+/* eslint import/no-extraneous-dependencies: warn */
+/* eslint import/no-dynamic-require: warn */
+/* eslint import/no-unresolved: warn */
+
+const mocha = require('mocha');
+const path = require('path');
+const assert = require('assert');
+const itParam = require('mocha-param');
+
+const utils = require('../../utils/tbUtils');
+const basicGet = require('../../utils/basicGet');
+const { name } = require('../../package.json');
+const { methods } = require('../../pronghorn.json');
+
+const getPronghornProps = (iapDir) => {
+  const { Discovery } = require('@itential/itential-utils');
+  console.log('Retrieving properties.json file...');
+  const rawProps = require(path.join(iapDir, 'properties.json'));
+  console.log('Decrypting properties...');
+  const discovery = new Discovery();
+  const pronghornProps = utils.decryptProperties(rawProps, path.join(__dirname, '..'), discovery);
+  console.log('Found properties.\n');
+  return pronghornProps;
+};
+
+let a;
+
+describe('[integration] Adapter BasicGET Test', () => {
+  context('Testing GET calls without query parameters', () => {
+    before(async () => {
+      const iapDir = path.join(__dirname, '../../../../../');
+      if (!utils.withinIAP(iapDir)) {
+        const sampleProperties = require('../../sampleProperties.json');
+        const adapter = { properties: sampleProperties };
+        a = basicGet.getAdapterInstance(adapter);
+      } else {
+        const pronghornProps = getPronghornProps(iapDir);
+        console.log('Connecting to Database...');
+        const database = await basicGet.connect(pronghornProps);
+        console.log('Connection established.');
+        const adapter = await database.collection(utils.SERVICE_CONFIGS_COLLECTION).findOne(
+          { model: name }
+        );
+        a = basicGet.getAdapterInstance(adapter);
+      }
+    });
+
+    after((done) => {
+      done();
+    });
+
+    const basicGets = methods.filter((method) => (method.route.verb === 'GET' && method.input.length === 0));
+    if (basicGets.length === 0) {
+      console.log('No non-parameter GET calls found.');
+      process.exit(0);
+    }
+    const functionNames = basicGets.map((g) => g.name);
+    const request = function request(f, ad) {
+      return new Promise((resolve, reject) => {
+        const getRespCode = (resp) => {
+          if (resp) {
+            if (resp.metrics.code !== 200) {
+              console.log('\x1b[31m', `Testing ${f} \nResponseCode: ${resp.metrics.code}`);
+            }
+            resolve(resp.metrics.code);
+          } else {
+            console.log('\x1b[31m', `call ${f} results in failure`);
+            reject(new Error(`${f} failed`));
+          }
+        };
+        ad[f](getRespCode, console.log);
+      });
+    };
+
+    itParam('GET call should return 200', functionNames, (fname) => {
+      console.log(`\t ${fname}`);
+      return request(fname, a).then((result) => assert.equal(result, 200));
+    });
+  });
+});

package/test/integration/adapterTestConnectivity.js

@@ -0,0 +1,93 @@
+/* @copyright Itential, LLC 2020 */
+
+/* global describe it context before after */
+/* eslint no-unused-vars: warn */
+
+const mocha = require('mocha');
+const assert = require('assert');
+const diagnostics = require('network-diagnostics');
+
+let host;
+process.argv.forEach((val) => {
+  if (val.indexOf('--HOST') === 0) {
+    [, host] = val.split('=');
+  }
+});
+
+describe('[integration] Adapter Test', () => {
+  context(`Testing network connection on ${host}`, () => {
+    before(() => {
+      diagnostics.setTestURL(host);
+    });
+
+    after((done) => {
+      done();
+    });
+
+    it('DNS resolve', (done) => {
+      diagnostics.haveDNS((result) => {
+        try {
+          assert.equal(result, true);
+          done();
+        } catch (error) {
+          done(error);
+        }
+      });
+    });
+
+    it('Responds to ping', (done) => {
+      diagnostics.havePing((result) => {
+        try {
+          assert.equal(result, true);
+          done();
+        } catch (error) {
+          done(error);
+        }
+      });
+    });
+
+    it('Support HTTP on port 80', (done) => {
+      diagnostics.haveHTTP((result) => {
+        try {
+          assert.equal(result, true);
+          done();
+        } catch (error) {
+          done(error);
+        }
+      });
+    });
+
+    it('Support HTTPS on port 443', (done) => {
+      diagnostics.haveHTTPS((result) => {
+        try {
+          assert.equal(result, true);
+          done();
+        } catch (error) {
+          done(error);
+        }
+      });
+    });
+
+    it('Support IPv4', (done) => {
+      diagnostics.haveIPv4Async((result) => {
+        try {
+          assert.equal(result, true);
+          done();
+        } catch (error) {
+          done(error);
+        }
+      });
+    });
+
+    it('Support IPv6', (done) => {
+      diagnostics.haveIPv6Async((result) => {
+        try {
+          assert.equal(result, true);
+          done();
+        } catch (error) {
+          done(error);
+        }
+      });
+    });
+  });
+});