From 0579d3fa93e5566cb68efb23b17d601271c1022f Mon Sep 17 00:00:00 2001
From: Jon Penwood <jonp@polarity.io>
Date: Mon, 17 Feb 2020 14:47:51 -0600
Subject: [PATCH 01/10] Bumped package version, and replaced async with
 bottleneck.

---
 integration.js | 176 +++++++++++++++++++++++++------------------------
 package.json   |   6 +-
 2 files changed, 94 insertions(+), 88 deletions(-)

diff --git a/integration.js b/integration.js
index 16bd198..6d4165e 100644
--- a/integration.js
+++ b/integration.js
@@ -1,16 +1,20 @@
-'use strict';
+"use strict";
 
-const request = require('request');
-const config = require('./config/config');
-const async = require('async');
-const fs = require('fs');
+const request = require("request");
+const config = require("./config/config");
+const fs = require("fs");
+const Bottleneck = require("bottleneck");
+
+const limiter = new Bottleneck({
+  maxConcurrent: 1,
+  minTime: 1050
+});
 
 let Logger;
 let requestWithDefaults;
 
-const MAX_PARALLEL_LOOKUPS = 10;
 
-const IGNORED_IPS = new Set(['127.0.0.1', '255.255.255.255', '0.0.0.0']);
+const IGNORED_IPS = new Set(["127.0.0.1", "255.255.255.255", "0.0.0.0"]);
 
 /**
  *
@@ -19,110 +23,111 @@ const IGNORED_IPS = new Set(['127.0.0.1', '255.255.255.255', '0.0.0.0']);
  * @param cb
  */
 function doLookup(entities, options, cb) {
-  let lookupResults = [];
-  let tasks = [];
+  let requestResults = [];
 
-  Logger.trace({ entities: entities }, 'doLookup');
+  Logger.trace({ entities }, "doLookup");
 
   entities.forEach((entity) => {
     if (!entity.isPrivateIP && !IGNORED_IPS.has(entity.value)) {
-      //do the lookup
       let requestOptions = {
-        uri: 'https://api.shodan.io/shodan/host/' + entity.value + '?key=' + options.apiKey,
-        method: 'GET',
+        uri:
+          "https://api.shodan.io/shodan/host/" + entity.value + "?key=" + options.apiKey,
+        method: "GET",
         json: true
       };
 
-      tasks.push(function(done) {
-        requestWithDefaults(requestOptions, function(error, res, body) {
-          if (error || typeof res === 'undefined') {
-            Logger.error({ err: error }, 'HTTP Request Failed');
-            done({
-              detail: 'HTTP Request Failed',
-              err: error
-            });
-            return;
-          }
-
-          Logger.trace({ body: body }, 'Result of Lookup');
-
-          if (res.statusCode === 200) {
-            // we got data!
-            return done(null, {
-              entity: entity,
-              body: body
-            });
-          } else if (res.statusCode === 404) {
-            // no result found
-            return done(null, {
-              entity: entity,
-              body: null
-            });
-          } else if (res.statusCode === 503) {
-            // reached request limit
-            return done({
-              detail: 'Request Limit Reached'
-            });
-          } else {
-            return done({
-              detail: 'Unexpected HTTP Status Received',
-              httpStatus: res.statusCode,
-              body: body
-            });
-          }
-        });
+      limiter.submit(requestEntity, requestOptions, (err, result) => {
+        requestResults.push([err, result]);
+        if (requestResults.length === entities.length) {
+          const [errs, results] = rotateResults(results);
+          if (errs.length) return cb(errs[0]);
+
+          const lookupResults = results.map(({ entity, body }) => ({
+            entity,
+            data: body && {
+              summary: [],
+              details: body
+            }
+          }));
+
+          cb(null, lookupResults);
+        }
       });
     }
   });
+}
 
-  async.parallelLimit(tasks, MAX_PARALLEL_LOOKUPS, (err, results) => {
-    if (err) {
-      cb(err);
-      return;
+const requestEntity = (requestOptions, callback) =>
+  requestWithDefaults(requestOptions, (err, res, body) => {
+    if (err || typeof res === "undefined") {
+      Logger.error({ err }, "HTTP Request Failed");
+      return callback({
+        detail: "HTTP Request Failed",
+        err
+      });
     }
 
-    results.forEach((result) => {
-      if (result.body === null) {
-        lookupResults.push({
-          entity: result.entity,
-          data: null
-        });
-      } else {
-        lookupResults.push({
-          entity: result.entity,
-          data: {
-            summary: [],
-            details: result.body
-          }
-        });
-      }
-    });
+    Logger.trace({ body }, "Result of Lookup");
 
-    cb(null, lookupResults);
+    if (res.statusCode === 200) {
+      // we got data!
+      return callback(null, {
+        entity,
+        body
+      });
+    } else if (res.statusCode === 404) {
+      // no result found
+      return callback(null, {
+        entity,
+        body: null
+      });
+    } else if (res.statusCode === 503) {
+      // reached request limit
+      return callback({
+        detail: "Request Limit Reached"
+      });
+    } else {
+      return callback({
+        detail: "Unexpected HTTP Status Received",
+        httpStatus: res.statusCode,
+        body
+      });
+    }
   });
-}
+
+const rotateResults = (results) =>
+  results.reduce(
+    (agg, [err, result]) => [
+      [...agg[0], err],
+      [...agg[1], result]
+    ],
+    [[], []]
+  );
 
 function startup(logger) {
   Logger = logger;
   let defaults = {};
 
-  if (typeof config.request.cert === 'string' && config.request.cert.length > 0) {
+  if (typeof config.request.cert === "string" && config.request.cert.length > 0) {
     defaults.cert = fs.readFileSync(config.request.cert);
   }
 
-  if (typeof config.request.key === 'string' && config.request.key.length > 0) {
+  if (typeof config.request.key === "string" && config.request.key.length > 0) {
     defaults.key = fs.readFileSync(config.request.key);
   }
 
-  if (typeof config.request.passphrase === 'string' && config.request.passphrase.length > 0) {
+  if (
+    typeof config.request.passphrase === "string" &&
+    config.request.passphrase.length > 0
+  ) {
     defaults.passphrase = config.request.passphrase;
   }
 
-  if (typeof config.request.ca === 'string' && config.request.ca.length > 0) {
+  if (typeof config.request.ca === "string" && config.request.ca.length > 0) {
     defaults.ca = fs.readFileSync(config.request.ca);
   }
 
-  if (typeof config.request.proxy === 'string' && config.request.proxy.length > 0) {
+  if (typeof config.request.proxy === "string" && config.request.proxy.length > 0) {
     defaults.proxy = config.request.proxy;
   }
 
@@ -132,12 +137,13 @@ function startup(logger) {
 function validateOptions(userOptions, cb) {
   let errors = [];
   if (
-    typeof userOptions.apiKey.value !== 'string' ||
-    (typeof userOptions.apiKey.value === 'string' && userOptions.apiKey.value.length === 0)
+    typeof userOptions.apiKey.value !== "string" ||
+    (typeof userOptions.apiKey.value === "string" &&
+      userOptions.apiKey.value.length === 0)
   ) {
     errors.push({
-      key: 'apiKey',
-      message: 'You must provide a Shodan API key'
+      key: "apiKey",
+      message: "You must provide a Shodan API key"
     });
   }
 
@@ -145,7 +151,7 @@ function validateOptions(userOptions, cb) {
 }
 
 module.exports = {
-  doLookup: doLookup,
-  startup: startup,
-  validateOptions: validateOptions
+  doLookup,
+  startup,
+  validateOptions
 };
diff --git a/package.json b/package.json
index b50e791..55eafa6 100644
--- a/package.json
+++ b/package.json
@@ -1,10 +1,10 @@
 {
   "main": "./integration.js",
   "name": "shodan",
-  "version": "3.0.1",
+  "version": "3.0.2-beta",
   "private": true,
   "dependencies": {
-    "request": "^2.88",
-    "async": "^2.6"
+    "bottleneck": "^2.19.5",
+    "request": "^2.88"
   }
 }

From 6ae92ec4e8360aac1bf0713573c6ff27d8e17090 Mon Sep 17 00:00:00 2001
From: Jon Penwood <jonp@polarity.io>
Date: Mon, 24 Feb 2020 15:47:20 -0600
Subject: [PATCH 02/10] Updated config for the API key option to be a password
 type and added onDemandOnly, as well as improved error handling.

---
 config/config.js | 190 +++++++++++++++++++++++------------------------
 integration.js   |  15 ++--
 2 files changed, 105 insertions(+), 100 deletions(-)

diff --git a/config/config.js b/config/config.js
index aad4d6b..8698010 100644
--- a/config/config.js
+++ b/config/config.js
@@ -1,99 +1,99 @@
 module.exports = {
-    /**
-     * Name of the integration which is displayed in the Polarity integrations user interface
-     *
-     * @type String
-     * @required
-     */
-    name: "Shodan",
-    /**
-     * The acronym that appears in the notification window when information from this integration
-     * is displayed.  Note that the acronym is included as part of each "tag" in the summary information
-     * for the integration.  As a result, it is best to keep it to 4 or less characters.  The casing used
-     * here will be carried forward into the notification window.
-     *
-     * @type String
-     * @required
-     */
-    acronym: "SHO",
-    /**
-     * Description for this integration which is displayed in the Polarity integrations user interface
-     *
-     * @type String
-     * @optional
-     */
-    description: "IP Lookup Integration for Shodan",
-    entityTypes: ['IPv4', 'IPv6'],
-    /**
-     * An array of style files (css or less) that will be included for your integration. Any styles specified in
-     * the below files can be used in your custom template.
-     *
-     * @type Array
-     * @optional
-     */
-    "styles": [
-        "./styles/shodan.less"
-    ],
-    /**
-     * Provide custom component logic and template for rendering the integration details block.  If you do not
-     * provide a custom template and/or component then the integration will display data as a table of key value
-     * pairs.
-     *
-     * @type Object
-     * @optional
-     */
-    block: {
-        component: {
-            file: "./components/shodan-block.js"
-        },
-        template: {
-            file: "./templates/shodan-block.hbs"
-        }
+  /**
+   * Name of the integration which is displayed in the Polarity integrations user interface
+   *
+   * @type String
+   * @required
+   */
+  name: "Shodan",
+  /**
+   * The acronym that appears in the notification window when information from this integration
+   * is displayed.  Note that the acronym is included as part of each "tag" in the summary information
+   * for the integration.  As a result, it is best to keep it to 4 or less characters.  The casing used
+   * here will be carried forward into the notification window.
+   *
+   * @type String
+   * @required
+   */
+  acronym: "SHO",
+  /**
+   * Description for this integration which is displayed in the Polarity integrations user interface
+   *
+   * @type String
+   * @optional
+   */
+  description: "IP Lookup Integration for Shodan",
+  entityTypes: ["IPv4", "IPv6"],
+  /**
+   * An array of style files (css or less) that will be included for your integration. Any styles specified in
+   * the below files can be used in your custom template.
+   *
+   * @type Array
+   * @optional
+   */
+  styles: ["./styles/shodan.less"],
+  /**
+   * Provide custom component logic and template for rendering the integration details block.  If you do not
+   * provide a custom template and/or component then the integration will display data as a table of key value
+   * pairs.
+   *
+   * @type Object
+   * @optional
+   */
+  block: {
+    component: {
+      file: "./components/shodan-block.js"
     },
-    summary: {
-        component: {
-            file: './components/shodan-summary.js'
-        },
-        template: {
-            file: './templates/shodan-summary.hbs'
-        }
+    template: {
+      file: "./templates/shodan-block.hbs"
+    }
+  },
+  summary: {
+    component: {
+      file: "./components/shodan-summary.js"
     },
-    request: {
-        // Provide the path to your certFile. Leave an empty string to ignore this option.
-        // Relative paths are relative to the VT integration's root directory
-        cert: '',
-        // Provide the path to your private key. Leave an empty string to ignore this option.
-        // Relative paths are relative to the VT integration's root directory
-        key: '',
-        // Provide the key passphrase if required.  Leave an empty string to ignore this option.
-        // Relative paths are relative to the VT integration's root directory
-        passphrase: '',
-        // Provide the Certificate Authority. Leave an empty string to ignore this option.
-        // Relative paths are relative to the VT integration's root directory
-        ca: '',
-        // An HTTP proxy to be used. Supports proxy Auth with Basic Auth, identical to support for
-        // the url parameter (by embedding the auth info in the uri)
-        proxy: ''
-    },
-    logging: {
-        level: 'info',  //trace, debug, info, warn, error, fatal
-    },
-    /**
-     * Options that are displayed to the user/admin in the Polarity integration user-interface.  Should be structured
-     * as an array of option objects.
-     *
-     * @type Array
-     * @optional
-     */
-    "options": [
-        {
-            "key": "apiKey",
-            "name": "Shodan API Key",
-            "description": "Your Shodan API Key.",
-            "default": "",
-            "type": "text",
-            "userCanEdit": true,
-            "adminOnly": false
-        }
-    ]
+    template: {
+      file: "./templates/shodan-summary.hbs"
+    }
+  },
+  request: {
+    // Provide the path to your certFile. Leave an empty string to ignore this option.
+    // Relative paths are relative to the VT integration's root directory
+    cert: "",
+    // Provide the path to your private key. Leave an empty string to ignore this option.
+    // Relative paths are relative to the VT integration's root directory
+    key: "",
+    // Provide the key passphrase if required.  Leave an empty string to ignore this option.
+    // Relative paths are relative to the VT integration's root directory
+    passphrase: "",
+    // Provide the Certificate Authority. Leave an empty string to ignore this option.
+    // Relative paths are relative to the VT integration's root directory
+    ca: "",
+    // An HTTP proxy to be used. Supports proxy Auth with Basic Auth, identical to support for
+    // the url parameter (by embedding the auth info in the uri)
+    proxy: "",
+    rejectUnauthorized: true
+  },
+  logging: {
+    level: "info" //trace, debug, info, warn, error, fatal
+  },
+  onDemandOnly: true,
+  /**
+   * Options that are displayed to the user/admin in the Polarity integration user-interface.  Should be structured
+   * as an array of option objects.
+   *
+   * @type Array
+   * @optional
+   */
+  options: [
+    {
+      key: "apiKey",
+      name: "Shodan API Key",
+      description: "Your Shodan API Key.",
+      default: "",
+      type: "password",
+      userCanEdit: true,
+      adminOnly: false
+    }
+  ]
 };
diff --git a/integration.js b/integration.js
index 6d4165e..c9f4d2f 100644
--- a/integration.js
+++ b/integration.js
@@ -13,7 +13,6 @@ const limiter = new Bottleneck({
 let Logger;
 let requestWithDefaults;
 
-
 const IGNORED_IPS = new Set(["127.0.0.1", "255.255.255.255", "0.0.0.0"]);
 
 /**
@@ -36,11 +35,17 @@ function doLookup(entities, options, cb) {
         json: true
       };
 
-      limiter.submit(requestEntity, requestOptions, (err, result) => {
+      limiter.submit(requestEntity, entity, requestOptions, (err, result) => {
         requestResults.push([err, result]);
         if (requestResults.length === entities.length) {
-          const [errs, results] = rotateResults(results);
-          if (errs.length) return cb(errs[0]);
+          const [errs, results] = rotateResults(requestResults);
+          const errors = errs.filter((i) => i);
+
+          if (errors.length)
+            return cb({
+              err: errors[0],
+              detail: errors[0].detail || "Error: Something with the Request Failed"
+            });
 
           const lookupResults = results.map(({ entity, body }) => ({
             entity,
@@ -57,7 +62,7 @@ function doLookup(entities, options, cb) {
   });
 }
 
-const requestEntity = (requestOptions, callback) =>
+const requestEntity = (entity, requestOptions, callback) =>
   requestWithDefaults(requestOptions, (err, res, body) => {
     if (err || typeof res === "undefined") {
       Logger.error({ err }, "HTTP Request Failed");

From 204dd7b832b41ff9e83c76b7b317aad9e3cbdce5 Mon Sep 17 00:00:00 2001
From: Jon Penwood <jonp@polarity.io>
Date: Wed, 1 Apr 2020 17:26:48 -0500
Subject: [PATCH 03/10] Added Highwater request queue limit and overflow
 strategy along with error handling.

---
 integration.js    |  81 ++++++-----
 package-lock.json | 356 ++++++++++++++++++++++++++++++++++++++++++++++
 package.json      |   1 +
 3 files changed, 404 insertions(+), 34 deletions(-)
 create mode 100644 package-lock.json

diff --git a/integration.js b/integration.js
index c9f4d2f..68203a5 100644
--- a/integration.js
+++ b/integration.js
@@ -1,19 +1,22 @@
-"use strict";
+'use strict';
 
-const request = require("request");
-const config = require("./config/config");
-const fs = require("fs");
-const Bottleneck = require("bottleneck");
+const request = require('request');
+const config = require('./config/config');
+const fs = require('fs');
+const Bottleneck = require('bottleneck');
+const _ = require('lodash');
 
 const limiter = new Bottleneck({
   maxConcurrent: 1,
+  highWater: 15,
+  strategy: Bottleneck.strategy.OVERFLOW,
   minTime: 1050
 });
 
 let Logger;
 let requestWithDefaults;
 
-const IGNORED_IPS = new Set(["127.0.0.1", "255.255.255.255", "0.0.0.0"]);
+const IGNORED_IPS = new Set(['127.0.0.1', '255.255.255.255', '0.0.0.0']);
 
 /**
  *
@@ -23,29 +26,43 @@ const IGNORED_IPS = new Set(["127.0.0.1", "255.255.255.255", "0.0.0.0"]);
  */
 function doLookup(entities, options, cb) {
   let requestResults = [];
-
-  Logger.trace({ entities }, "doLookup");
+  let maxRequestQueueLimitHit = false;
+  Logger.trace({ entities }, 'doLookup');
 
   entities.forEach((entity) => {
     if (!entity.isPrivateIP && !IGNORED_IPS.has(entity.value)) {
       let requestOptions = {
-        uri:
-          "https://api.shodan.io/shodan/host/" + entity.value + "?key=" + options.apiKey,
-        method: "GET",
+        uri: 'https://api.shodan.io/shodan/host/' + entity.value + '?key=' + options.apiKey,
+        method: 'GET',
         json: true
       };
 
       limiter.submit(requestEntity, entity, requestOptions, (err, result) => {
+        if (maxRequestQueueLimitHit) return;
         requestResults.push([err, result]);
-        if (requestResults.length === entities.length) {
+        if (_.isEmpty(err) && _.isEmpty(result)) {
+          maxRequestQueueLimitHit = true;
+          cb({
+            err: {
+              message:
+                `Entities: ${entities.map(({ value }) => value).join(', ')} ` +
+                'were not able to be searched.'
+            },
+            detail: 'Hit API request Limit. Try again Later'
+          });
+        }
+
+        if (!maxRequestQueueLimitHit && requestResults.length === entities.length) {
           const [errs, results] = rotateResults(requestResults);
-          const errors = errs.filter((i) => i);
+          const errors = errs.filter((err) => !_.isEmpty(err));
 
-          if (errors.length)
+          if (errors.length) {
+            Logger.trace({ errors }, 'Something went wrong');
             return cb({
               err: errors[0],
-              detail: errors[0].detail || "Error: Something with the Request Failed"
+              detail: errors[0].detail || 'Error: Something with the Request Failed'
             });
+          }
 
           const lookupResults = results.map(({ entity, body }) => ({
             entity,
@@ -64,15 +81,15 @@ function doLookup(entities, options, cb) {
 
 const requestEntity = (entity, requestOptions, callback) =>
   requestWithDefaults(requestOptions, (err, res, body) => {
-    if (err || typeof res === "undefined") {
-      Logger.error({ err }, "HTTP Request Failed");
+    if (err || typeof res === 'undefined') {
+      Logger.error({ err }, 'HTTP Request Failed');
       return callback({
-        detail: "HTTP Request Failed",
+        detail: 'HTTP Request Failed',
         err
       });
     }
 
-    Logger.trace({ body }, "Result of Lookup");
+    Logger.trace({ body }, 'Result of Lookup');
 
     if (res.statusCode === 200) {
       // we got data!
@@ -89,11 +106,11 @@ const requestEntity = (entity, requestOptions, callback) =>
     } else if (res.statusCode === 503) {
       // reached request limit
       return callback({
-        detail: "Request Limit Reached"
+        detail: 'Request Limit Reached'
       });
     } else {
       return callback({
-        detail: "Unexpected HTTP Status Received",
+        detail: 'Unexpected HTTP Status Received',
         httpStatus: res.statusCode,
         body
       });
@@ -113,26 +130,23 @@ function startup(logger) {
   Logger = logger;
   let defaults = {};
 
-  if (typeof config.request.cert === "string" && config.request.cert.length > 0) {
+  if (typeof config.request.cert === 'string' && config.request.cert.length > 0) {
     defaults.cert = fs.readFileSync(config.request.cert);
   }
 
-  if (typeof config.request.key === "string" && config.request.key.length > 0) {
+  if (typeof config.request.key === 'string' && config.request.key.length > 0) {
     defaults.key = fs.readFileSync(config.request.key);
   }
 
-  if (
-    typeof config.request.passphrase === "string" &&
-    config.request.passphrase.length > 0
-  ) {
+  if (typeof config.request.passphrase === 'string' && config.request.passphrase.length > 0) {
     defaults.passphrase = config.request.passphrase;
   }
 
-  if (typeof config.request.ca === "string" && config.request.ca.length > 0) {
+  if (typeof config.request.ca === 'string' && config.request.ca.length > 0) {
     defaults.ca = fs.readFileSync(config.request.ca);
   }
 
-  if (typeof config.request.proxy === "string" && config.request.proxy.length > 0) {
+  if (typeof config.request.proxy === 'string' && config.request.proxy.length > 0) {
     defaults.proxy = config.request.proxy;
   }
 
@@ -142,13 +156,12 @@ function startup(logger) {
 function validateOptions(userOptions, cb) {
   let errors = [];
   if (
-    typeof userOptions.apiKey.value !== "string" ||
-    (typeof userOptions.apiKey.value === "string" &&
-      userOptions.apiKey.value.length === 0)
+    typeof userOptions.apiKey.value !== 'string' ||
+    (typeof userOptions.apiKey.value === 'string' && userOptions.apiKey.value.length === 0)
   ) {
     errors.push({
-      key: "apiKey",
-      message: "You must provide a Shodan API key"
+      key: 'apiKey',
+      message: 'You must provide a Shodan API key'
     });
   }
 
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..c82b016
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,356 @@
+{
+  "name": "shodan",
+  "version": "3.0.2-beta",
+  "lockfileVersion": 1,
+  "requires": true,
+  "dependencies": {
+    "ajv": {
+      "version": "6.10.2",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.10.2.tgz",
+      "integrity": "sha512-TXtUUEYHuaTEbLZWIKUr5pmBuhDLy+8KYtPYdcV8qC+pOZL+NKqYwvWSRrVXHn+ZmRRAu8vJTAznH7Oag6RVRw==",
+      "requires": {
+        "fast-deep-equal": "^2.0.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.2"
+      }
+    },
+    "asn1": {
+      "version": "0.2.4",
+      "resolved": "https://registry.npmjs.org/asn1/-/asn1-0.2.4.tgz",
+      "integrity": "sha512-jxwzQpLQjSmWXgwaCZE9Nz+glAG01yF1QnWgbhGwHI5A6FRIEY6IVqtHhIepHqI7/kyEyQEagBC5mBEFlIYvdg==",
+      "requires": {
+        "safer-buffer": "~2.1.0"
+      }
+    },
+    "assert-plus": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/assert-plus/-/assert-plus-1.0.0.tgz",
+      "integrity": "sha1-8S4PPF13sLHN2RRpQuTpbB5N1SU="
+    },
+    "asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha1-x57Zf380y48robyXkLzDZkdLS3k="
+    },
+    "aws-sign2": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/aws-sign2/-/aws-sign2-0.7.0.tgz",
+      "integrity": "sha1-tG6JCTSpWR8tL2+G1+ap8bP+dqg="
+    },
+    "aws4": {
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/aws4/-/aws4-1.9.0.tgz",
+      "integrity": "sha512-Uvq6hVe90D0B2WEnUqtdgY1bATGz3mw33nH9Y+dmA+w5DHvUmBgkr5rM/KCHpCsiFNRUfokW/szpPPgMK2hm4A=="
+    },
+    "bcrypt-pbkdf": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/bcrypt-pbkdf/-/bcrypt-pbkdf-1.0.2.tgz",
+      "integrity": "sha1-pDAdOJtqQ/m2f/PKEaP2Y342Dp4=",
+      "requires": {
+        "tweetnacl": "^0.14.3"
+      }
+    },
+    "bottleneck": {
+      "version": "2.19.5",
+      "resolved": "https://registry.npmjs.org/bottleneck/-/bottleneck-2.19.5.tgz",
+      "integrity": "sha512-VHiNCbI1lKdl44tGrhNfU3lup0Tj/ZBMJB5/2ZbNXRCPuRCO7ed2mgcK4r17y+KB2EfuYuRaVlwNbAeaWGSpbw=="
+    },
+    "caseless": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz",
+      "integrity": "sha1-G2gcIf+EAzyCZUMJBolCDRhxUdw="
+    },
+    "combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "requires": {
+        "delayed-stream": "~1.0.0"
+      }
+    },
+    "core-util-is": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
+      "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac="
+    },
+    "dashdash": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/dashdash/-/dashdash-1.14.1.tgz",
+      "integrity": "sha1-hTz6D3y+L+1d4gMmuN1YEDX24vA=",
+      "requires": {
+        "assert-plus": "^1.0.0"
+      }
+    },
+    "delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha1-3zrhmayt+31ECqrgsp4icrJOxhk="
+    },
+    "ecc-jsbn": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/ecc-jsbn/-/ecc-jsbn-0.1.2.tgz",
+      "integrity": "sha1-OoOpBOVDUyh4dMVkt1SThoSamMk=",
+      "requires": {
+        "jsbn": "~0.1.0",
+        "safer-buffer": "^2.1.0"
+      }
+    },
+    "extend": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
+      "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="
+    },
+    "extsprintf": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/extsprintf/-/extsprintf-1.3.0.tgz",
+      "integrity": "sha1-lpGEQOMEGnpBT4xS48V06zw+HgU="
+    },
+    "fast-deep-equal": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-2.0.1.tgz",
+      "integrity": "sha1-ewUhjd+WZ79/Nwv3/bLLFf3Qqkk="
+    },
+    "fast-json-stable-stringify": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw=="
+    },
+    "forever-agent": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/forever-agent/-/forever-agent-0.6.1.tgz",
+      "integrity": "sha1-+8cfDEGt6zf5bFd60e1C2P2sypE="
+    },
+    "form-data": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.3.tgz",
+      "integrity": "sha512-1lLKB2Mu3aGP1Q/2eCOx0fNbRMe7XdwktwOruhfqqd0rIJWwN4Dh+E3hrPSlDCXnSR7UtZ1N38rVXm+6+MEhJQ==",
+      "requires": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.6",
+        "mime-types": "^2.1.12"
+      }
+    },
+    "getpass": {
+      "version": "0.1.7",
+      "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz",
+      "integrity": "sha1-Xv+OPmhNVprkyysSgmBOi6YhSfo=",
+      "requires": {
+        "assert-plus": "^1.0.0"
+      }
+    },
+    "har-schema": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/har-schema/-/har-schema-2.0.0.tgz",
+      "integrity": "sha1-qUwiJOvKwEeCoNkDVSHyRzW37JI="
+    },
+    "har-validator": {
+      "version": "5.1.3",
+      "resolved": "https://registry.npmjs.org/har-validator/-/har-validator-5.1.3.tgz",
+      "integrity": "sha512-sNvOCzEQNr/qrvJgc3UG/kD4QtlHycrzwS+6mfTrrSq97BvaYcPZZI1ZSqGSPR73Cxn4LKTD4PttRwfU7jWq5g==",
+      "requires": {
+        "ajv": "^6.5.5",
+        "har-schema": "^2.0.0"
+      }
+    },
+    "http-signature": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/http-signature/-/http-signature-1.2.0.tgz",
+      "integrity": "sha1-muzZJRFHcvPZW2WmCruPfBj7rOE=",
+      "requires": {
+        "assert-plus": "^1.0.0",
+        "jsprim": "^1.2.2",
+        "sshpk": "^1.7.0"
+      }
+    },
+    "is-typedarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-typedarray/-/is-typedarray-1.0.0.tgz",
+      "integrity": "sha1-5HnICFjfDBsR3dppQPlgEfzaSpo="
+    },
+    "isstream": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/isstream/-/isstream-0.1.2.tgz",
+      "integrity": "sha1-R+Y/evVa+m+S4VAOaQ64uFKcCZo="
+    },
+    "jsbn": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/jsbn/-/jsbn-0.1.1.tgz",
+      "integrity": "sha1-peZUwuWi3rXyAdls77yoDA7y9RM="
+    },
+    "json-schema": {
+      "version": "0.2.3",
+      "resolved": "https://registry.npmjs.org/json-schema/-/json-schema-0.2.3.tgz",
+      "integrity": "sha1-tIDIkuWaLwWVTOcnvT8qTogvnhM="
+    },
+    "json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg=="
+    },
+    "json-stringify-safe": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
+      "integrity": "sha1-Epai1Y/UXxmg9s4B1lcB4sc1tus="
+    },
+    "jsprim": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/jsprim/-/jsprim-1.4.1.tgz",
+      "integrity": "sha1-MT5mvB5cwG5Di8G3SZwuXFastqI=",
+      "requires": {
+        "assert-plus": "1.0.0",
+        "extsprintf": "1.3.0",
+        "json-schema": "0.2.3",
+        "verror": "1.10.0"
+      }
+    },
+    "lodash": {
+      "version": "4.17.15",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.15.tgz",
+      "integrity": "sha512-8xOcRHvCjnocdS5cpwXQXVzmmh5e5+saE2QGoeQmbKmRS6J3VQppPOIt0MnmE+4xlZoumy0GPG0D0MVIQbNA1A=="
+    },
+    "mime-db": {
+      "version": "1.43.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.43.0.tgz",
+      "integrity": "sha512-+5dsGEEovYbT8UY9yD7eE4XTc4UwJ1jBYlgaQQF38ENsKR3wj/8q8RFZrF9WIZpB2V1ArTVFUva8sAul1NzRzQ=="
+    },
+    "mime-types": {
+      "version": "2.1.26",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.26.tgz",
+      "integrity": "sha512-01paPWYgLrkqAyrlDorC1uDwl2p3qZT7yl806vW7DvDoxwXi46jsjFbg+WdwotBIk6/MbEhO/dh5aZ5sNj/dWQ==",
+      "requires": {
+        "mime-db": "1.43.0"
+      }
+    },
+    "oauth-sign": {
+      "version": "0.9.0",
+      "resolved": "https://registry.npmjs.org/oauth-sign/-/oauth-sign-0.9.0.tgz",
+      "integrity": "sha512-fexhUFFPTGV8ybAtSIGbV6gOkSv8UtRbDBnAyLQw4QPKkgNlsH2ByPGtMUqdWkos6YCRmAqViwgZrJc/mRDzZQ=="
+    },
+    "performance-now": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/performance-now/-/performance-now-2.1.0.tgz",
+      "integrity": "sha1-Ywn04OX6kT7BxpMHrjZLSzd8nns="
+    },
+    "psl": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/psl/-/psl-1.7.0.tgz",
+      "integrity": "sha512-5NsSEDv8zY70ScRnOTn7bK7eanl2MvFrOrS/R6x+dBt5g1ghnj9Zv90kO8GwT8gxcu2ANyFprnFYB85IogIJOQ=="
+    },
+    "punycode": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz",
+      "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A=="
+    },
+    "qs": {
+      "version": "6.5.2",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.5.2.tgz",
+      "integrity": "sha512-N5ZAX4/LxJmF+7wN74pUD6qAh9/wnvdQcjq9TZjevvXzSUo7bfmw91saqMjzGS2xq91/odN2dW/WOl7qQHNDGA=="
+    },
+    "request": {
+      "version": "2.88.0",
+      "resolved": "https://registry.npmjs.org/request/-/request-2.88.0.tgz",
+      "integrity": "sha512-NAqBSrijGLZdM0WZNsInLJpkJokL72XYjUpnB0iwsRgxh7dB6COrHnTBNwN0E+lHDAJzu7kLAkDeY08z2/A0hg==",
+      "requires": {
+        "aws-sign2": "~0.7.0",
+        "aws4": "^1.8.0",
+        "caseless": "~0.12.0",
+        "combined-stream": "~1.0.6",
+        "extend": "~3.0.2",
+        "forever-agent": "~0.6.1",
+        "form-data": "~2.3.2",
+        "har-validator": "~5.1.0",
+        "http-signature": "~1.2.0",
+        "is-typedarray": "~1.0.0",
+        "isstream": "~0.1.2",
+        "json-stringify-safe": "~5.0.1",
+        "mime-types": "~2.1.19",
+        "oauth-sign": "~0.9.0",
+        "performance-now": "^2.1.0",
+        "qs": "~6.5.2",
+        "safe-buffer": "^5.1.2",
+        "tough-cookie": "~2.4.3",
+        "tunnel-agent": "^0.6.0",
+        "uuid": "^3.3.2"
+      }
+    },
+    "safe-buffer": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.0.tgz",
+      "integrity": "sha512-fZEwUGbVl7kouZs1jCdMLdt95hdIv0ZeHg6L7qPeciMZhZ+/gdesW4wgTARkrFWEpspjEATAzUGPG8N2jJiwbg=="
+    },
+    "safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="
+    },
+    "sshpk": {
+      "version": "1.16.1",
+      "resolved": "https://registry.npmjs.org/sshpk/-/sshpk-1.16.1.tgz",
+      "integrity": "sha512-HXXqVUq7+pcKeLqqZj6mHFUMvXtOJt1uoUx09pFW6011inTMxqI8BA8PM95myrIyyKwdnzjdFjLiE6KBPVtJIg==",
+      "requires": {
+        "asn1": "~0.2.3",
+        "assert-plus": "^1.0.0",
+        "bcrypt-pbkdf": "^1.0.0",
+        "dashdash": "^1.12.0",
+        "ecc-jsbn": "~0.1.1",
+        "getpass": "^0.1.1",
+        "jsbn": "~0.1.0",
+        "safer-buffer": "^2.0.2",
+        "tweetnacl": "~0.14.0"
+      }
+    },
+    "tough-cookie": {
+      "version": "2.4.3",
+      "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.4.3.tgz",
+      "integrity": "sha512-Q5srk/4vDM54WJsJio3XNn6K2sCG+CQ8G5Wz6bZhRZoAe/+TxjWB/GlFAnYEbkYVlON9FMk/fE3h2RLpPXo4lQ==",
+      "requires": {
+        "psl": "^1.1.24",
+        "punycode": "^1.4.1"
+      },
+      "dependencies": {
+        "punycode": {
+          "version": "1.4.1",
+          "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz",
+          "integrity": "sha1-wNWmOycYgArY4esPpSachN1BhF4="
+        }
+      }
+    },
+    "tunnel-agent": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz",
+      "integrity": "sha1-J6XeoGs2sEoKmWZ3SykIaPD8QP0=",
+      "requires": {
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "tweetnacl": {
+      "version": "0.14.5",
+      "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz",
+      "integrity": "sha1-WuaBd/GS1EViadEIr6k/+HQ/T2Q="
+    },
+    "uri-js": {
+      "version": "4.2.2",
+      "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.2.2.tgz",
+      "integrity": "sha512-KY9Frmirql91X2Qgjry0Wd4Y+YTdrdZheS8TFwvkbLWf/G5KNJDCh6pKL5OZctEW4+0Baa5idK2ZQuELRwPznQ==",
+      "requires": {
+        "punycode": "^2.1.0"
+      }
+    },
+    "uuid": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.3.3.tgz",
+      "integrity": "sha512-pW0No1RGHgzlpHJO1nsVrHKpOEIxkGg1xB+v0ZmdNH5OAeAwzAVrCnI2/6Mtx+Uys6iaylxa+D3g4j63IKKjSQ=="
+    },
+    "verror": {
+      "version": "1.10.0",
+      "resolved": "https://registry.npmjs.org/verror/-/verror-1.10.0.tgz",
+      "integrity": "sha1-OhBcoXBTr1XW4nDB+CiGguGNpAA=",
+      "requires": {
+        "assert-plus": "^1.0.0",
+        "core-util-is": "1.0.2",
+        "extsprintf": "^1.2.0"
+      }
+    }
+  }
+}
diff --git a/package.json b/package.json
index 55eafa6..34e5884 100644
--- a/package.json
+++ b/package.json
@@ -5,6 +5,7 @@
   "private": true,
   "dependencies": {
     "bottleneck": "^2.19.5",
+    "lodash": "^4.17.15",
     "request": "^2.88"
   }
 }

From 50f146908492c1ba38c146fc0fe14f94ec618351 Mon Sep 17 00:00:00 2001
From: Jon Penwood <jonp@polarity.io>
Date: Thu, 2 Apr 2020 12:50:27 -0500
Subject: [PATCH 04/10] Added caching for bottleneck instances by api keys, and
 added rejectedUnauthorized to startup function.

---
 integration.js    | 43 ++++++++++++++++++++++++++-----------------
 package-lock.json |  5 +++++
 package.json      |  1 +
 3 files changed, 32 insertions(+), 17 deletions(-)

diff --git a/integration.js b/integration.js
index 68203a5..f92a761 100644
--- a/integration.js
+++ b/integration.js
@@ -1,30 +1,34 @@
 'use strict';
 
 const request = require('request');
-const config = require('./config/config');
 const fs = require('fs');
 const Bottleneck = require('bottleneck');
 const _ = require('lodash');
+var cache = require('memory-cache');
+
+const config = require('./config/config');
 
-const limiter = new Bottleneck({
-  maxConcurrent: 1,
-  highWater: 15,
-  strategy: Bottleneck.strategy.OVERFLOW,
-  minTime: 1050
-});
+let bottlneckApiKeyCache = new cache.Cache();
 
 let Logger;
 let requestWithDefaults;
 
 const IGNORED_IPS = new Set(['127.0.0.1', '255.255.255.255', '0.0.0.0']);
 
-/**
- *
- * @param entities
- * @param options
- * @param cb
- */
 function doLookup(entities, options, cb) {
+  let limiter = bottlneckApiKeyCache.get(options.apiKey);
+
+  if (!limiter) {
+    limiter = new Bottleneck({
+      id: options.apiKey,
+      maxConcurrent: 1,
+      highWater: 15,
+      strategy: Bottleneck.strategy.OVERFLOW,
+      minTime: 1050
+    });
+    bottlneckApiKeyCache.put(options.apiKey, limiter);
+  }
+
   let requestResults = [];
   let maxRequestQueueLimitHit = false;
   Logger.trace({ entities }, 'doLookup');
@@ -42,7 +46,7 @@ function doLookup(entities, options, cb) {
         requestResults.push([err, result]);
         if (_.isEmpty(err) && _.isEmpty(result)) {
           maxRequestQueueLimitHit = true;
-          cb({
+          return cb({
             err: {
               message:
                 `Entities: ${entities.map(({ value }) => value).join(', ')} ` +
@@ -52,8 +56,8 @@ function doLookup(entities, options, cb) {
           });
         }
 
-        if (!maxRequestQueueLimitHit && requestResults.length === entities.length) {
-          const [errs, results] = rotateResults(requestResults);
+        if (requestResults.length === entities.length) {
+          const [errs, results] = transpose2DArray(requestResults);
           const errors = errs.filter((err) => !_.isEmpty(err));
 
           if (errors.length) {
@@ -117,7 +121,8 @@ const requestEntity = (entity, requestOptions, callback) =>
     }
   });
 
-const rotateResults = (results) =>
+const transpose2DArray = (results) =>
+  // [[a,b],[a,b],[a,b]] -> [[a,a,a],[b,b,b]]
   results.reduce(
     (agg, [err, result]) => [
       [...agg[0], err],
@@ -150,6 +155,10 @@ function startup(logger) {
     defaults.proxy = config.request.proxy;
   }
 
+  if (typeof config.request.rejectUnauthorized === 'boolean') {
+    requestOptions.rejectUnauthorized = config.request.rejectUnauthorized;
+  }
+
   requestWithDefaults = request.defaults(defaults);
 }
 
diff --git a/package-lock.json b/package-lock.json
index c82b016..b89fa23 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -209,6 +209,11 @@
       "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.15.tgz",
       "integrity": "sha512-8xOcRHvCjnocdS5cpwXQXVzmmh5e5+saE2QGoeQmbKmRS6J3VQppPOIt0MnmE+4xlZoumy0GPG0D0MVIQbNA1A=="
     },
+    "memory-cache": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/memory-cache/-/memory-cache-0.2.0.tgz",
+      "integrity": "sha1-eJCwHVLADI68nVM+H46xfjA0hxo="
+    },
     "mime-db": {
       "version": "1.43.0",
       "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.43.0.tgz",
diff --git a/package.json b/package.json
index 34e5884..c2ed208 100644
--- a/package.json
+++ b/package.json
@@ -6,6 +6,7 @@
   "dependencies": {
     "bottleneck": "^2.19.5",
     "lodash": "^4.17.15",
+    "memory-cache": "^0.2.0",
     "request": "^2.88"
   }
 }

From 235cd8a6ad534eb2a088c45afeda32d2fbe4a4fb Mon Sep 17 00:00:00 2001
From: Jon Penwood <jonp@polarity.io>
Date: Thu, 2 Apr 2020 17:13:45 -0500
Subject: [PATCH 05/10] Fixed small typo wit rejectUnauthorized fix.

---
 integration.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/integration.js b/integration.js
index f92a761..5e6cff5 100644
--- a/integration.js
+++ b/integration.js
@@ -156,7 +156,7 @@ function startup(logger) {
   }
 
   if (typeof config.request.rejectUnauthorized === 'boolean') {
-    requestOptions.rejectUnauthorized = config.request.rejectUnauthorized;
+    defaults.rejectUnauthorized = config.request.rejectUnauthorized;
   }
 
   requestWithDefaults = request.defaults(defaults);

From f07d584130433b2474c9fdc8b75d3455bf02a636 Mon Sep 17 00:00:00 2001
From: Ed <ed@polarity.io>
Date: Tue, 7 Apr 2020 23:23:26 -0400
Subject: [PATCH 06/10] remove `var` for `const`

---
 integration.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/integration.js b/integration.js
index 5e6cff5..fee3604 100644
--- a/integration.js
+++ b/integration.js
@@ -4,7 +4,7 @@ const request = require('request');
 const fs = require('fs');
 const Bottleneck = require('bottleneck');
 const _ = require('lodash');
-var cache = require('memory-cache');
+const cache = require('memory-cache');
 
 const config = require('./config/config');
 

From f60661c54642c2a0f29b71a14baeb1d51d7e16fe Mon Sep 17 00:00:00 2001
From: Ed <ed@polarity.io>
Date: Tue, 7 Apr 2020 23:23:41 -0400
Subject: [PATCH 07/10] Update template to focus on most useful information

---
 components/shodan-block.js   |  13 +-
 components/shodan-summary.js |  77 ++++----
 styles/shodan.less           |  99 +++++++---
 templates/shodan-block.hbs   | 342 ++++++++++++++++++++---------------
 4 files changed, 326 insertions(+), 205 deletions(-)

diff --git a/components/shodan-block.js b/components/shodan-block.js
index d095095..e6dfb20 100644
--- a/components/shodan-block.js
+++ b/components/shodan-block.js
@@ -1,4 +1,9 @@
-polarity.export = PolarityComponent.extend({
-    details: Ember.computed.alias('block.data.details'),
-
-});
+polarity.export = PolarityComponent.extend({
+    details: Ember.computed.alias('block.data.details'),
+    showDetails: false,
+    actions: {
+        toggleDetails: function(){
+            this.toggleProperty('showDetails');
+        }
+    }
+});
diff --git a/components/shodan-summary.js b/components/shodan-summary.js
index b2f2270..f2efb23 100644
--- a/components/shodan-summary.js
+++ b/components/shodan-summary.js
@@ -1,35 +1,42 @@
-'use strict';
-
-polarity.export = PolarityComponent.extend({
-    details: Ember.computed.alias('block.data.details'),
-    summaryTags: Ember.computed('details.tags', function(){
-        let summaryTags = [];
-
-        if(this.get('details.city')){
-            summaryTags.push(this.get('details.city'));
-        }
-
-        if(this.get('details.isp')){
-            summaryTags.push(this.get('details.isp'));
-        }
-
-        if(this.get('details.country_name')){
-            summaryTags.push(this.get('details.country_name'));
-        }
-
-        if(this.get('details.org')){
-            summaryTags.push(this.get('details.org'));
-        }
-
-        let tags = this.get('details.tags');
-        if(Array.isArray(tags)){
-            summaryTags = summaryTags.concat(tags);
-        }
-
-        if(summaryTags.length === 0){
-            summaryTags.push('No Tags');
-        }
-        return summaryTags;
-    })
-});
-
+'use strict';
+
+polarity.export = PolarityComponent.extend({
+  details: Ember.computed.alias('block.data.details'),
+  summaryTags: Ember.computed('details.tags', function() {
+    let summaryTags = [];
+
+    let location = '';
+    const country = this.get('details.country_name');
+    const city = this.get('details.city');
+
+    if (city && country) {
+      location = `${city}, ${country}`;
+    } else if (city) {
+      location = city;
+    } else if (country) {
+      location = country;
+    }
+
+    if (location) {
+      summaryTags.push(location);
+    }
+
+    if (this.get('details.isp')) {
+      summaryTags.push(`ISP: ${this.get('details.isp')}`);
+    }
+
+    if (this.get('details.org')) {
+      summaryTags.push(`Org: ${this.get('details.org')}`);
+    }
+
+    let tags = this.get('details.tags');
+    if (Array.isArray(tags)) {
+      summaryTags = summaryTags.concat(tags);
+    }
+
+    if (summaryTags.length === 0) {
+      summaryTags.push('No Tags');
+    }
+    return summaryTags;
+  })
+});
diff --git a/styles/shodan.less b/styles/shodan.less
index 3bd8d61..e2d9738 100644
--- a/styles/shodan.less
+++ b/styles/shodan.less
@@ -1,22 +1,77 @@
-.section-tag {
-  background-color: #dedede;
-  border-radius: 4px;
-  margin-bottom: 2px;
-  padding: 3px 3px 2px 3px;
-  display: inline-block;
-}
-
-pre {
-  overflow-y: scroll;
-  overflow-x: hidden;
-  height: 100px;
-  padding: 5px;
-  margin-top: 5px;
-  resize: vertical;
-}
-
-.p-title{
-  a{
-    margin-left: 3px;
-  }
-}
+.section-tag {
+  background-color: #dedede;
+  border-radius: 4px;
+  margin-bottom: 2px;
+  padding: 3px 3px 2px 3px;
+  display: inline-block;
+}
+
+.external-icon{
+  font-size: 8px;
+  margin: 0px 0px 1px 3px;
+}
+
+.data-block{
+  border-left: 1px solid #eee;
+  padding-left: 5px;
+  margin-left: 0px;
+}
+div.service-pill{
+  display: inline-block;
+  line-height: 2em;
+
+  span.port{
+    border-top-left-radius: 4px;
+    border-bottom-left-radius: 4px;
+    border-left: 1px solid gray;
+    border-top: 1px solid gray;
+    border-bottom: 1px solid gray;
+    padding: 1px 3px;
+    background-color: #fff;
+    margin: 0px;
+  }
+
+  span.transport{
+    border-top: 1px solid gray;
+    border-bottom: 1px solid gray;
+    border-left: 1px solid gray;
+    border-right: 1px solid gray;
+    padding: 1px 3px;
+    margin: 0px;
+    background-color: lighten(#ff915f, 20%);
+  }
+
+  span.service{
+    padding: 1px 3px;
+    border-top-right-radius: 4px;
+    border-bottom-right-radius: 4px;
+    border-right: 1px solid gray;
+    border-top: 1px solid gray;
+    border-bottom: 1px solid gray;
+    margin: 0px;
+    background-color: #ddd;
+  }
+}
+
+
+pre {
+  overflow-y: scroll;
+  overflow-x: auto;
+  height: 100px;
+  padding: 5px;
+  margin-top: 5px;
+  resize: vertical;
+  background-color: #eee;
+}
+
+.p-title{
+  a{
+    margin-left: 3px;
+  }
+}
+
+::-webkit-scrollbar {
+  width: 5px;
+  height: 5px;
+  background-color: rgba(0, 0, 0, 0);
+}
\ No newline at end of file
diff --git a/templates/shodan-block.hbs b/templates/shodan-block.hbs
index 93e81f7..e1ff168 100644
--- a/templates/shodan-block.hbs
+++ b/templates/shodan-block.hbs
@@ -1,144 +1,198 @@
-{{#if details.asn}}
-    <div>
-        <span class="p-key">ASN: </span>
-        <span class="p-value">{{details.asn}}</span>
-    </div>
-{{/if}}
-
-{{#if details.ports}}
-    <span class="p-key">Ports: </span>
-    {{#each details.ports as |data|}}
-        <span class="section-tag">{{data}}</span>
-    {{/each}}
-{{/if}}
-
-{{#each details.data as |item index|}}
-    {{#if item.ip_str}}
-        <h1 class="p-title">
-            {{fa-icon "info-circle"}} {{item.ip_str}}
-            <a class="p-link" href="https://www.shodan.io/host/{{item.ip_str}}"> (View in Shodan)</a>
-        </h1>
-    {{/if}}
-
-    {{#if item.product}}
-        <div>
-            <span class="p-key">Product: </span>
-            <span class="p-value">{{item.product}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.isp}}
-        <div>
-            <span class="p-key">ISP: </span>
-            <span class="p-value">{{item.isp}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.org}}
-        <div>
-            <span class="p-key">Org: </span>
-            <span class="p-value">{{item.org}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.devicetype}}
-        <div>
-            <span class="p-key">Device Type: </span>
-            <span class="p-value">{{item.devicetype}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.hash}}
-        <div>
-            <span class="p-key">Hash: </span>
-            <span class="p-value">{{item.hash}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.version}}
-        <div>
-            <span class="p-key">Version: </span>
-            <span class="p-value">{{item.version}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.os}}
-        <div>
-            <span class="p-key">OS: </span>
-            <span class="p-value">{{item.os}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.ssh.fingerprint}}
-        <div>
-            <span class="p-key">SSH Fingerprint: </span>
-            <span class="p-value">{{item.ssh.fingerprint}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.ssh.mac}}
-        <div>
-            <span class="p-key">SSH MAC: </span>
-            <span class="p-value">{{item.ssh.mac}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.ssh.cipher}}
-        <div>
-            <span class="p-key">SSH Cipher: </span>
-            <span class="p-value">{{item.ssh.cipher}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.http.robots}}
-        <div>
-            <span class="p-key">HTTP Robots: </span>
-            <pre>{{item.http.robots}}</pre>
-        </div>
-    {{/if}}
-
-    {{#if item.http.servers}}
-        <div>
-            <span class="p-key">HTTP Servers: </span>
-            <span class="p-value">{{item.http.servers}}</span>
-        </div>
-    {{/if}}
-
-    {{#if item.hostnames}}
-        <h1 class="p-title">
-            {{fa-icon "globe"}} Hostnames
-        </h1>
-        <div class = "tags">
-            {{#each item.hostnames as |data|}}
-                <span class="section-tag">{{data}}</span>
-            {{/each}}
-        </div>
-    {{/if}}
-
-    {{#if item.domains}}
-        <h1 class="p-title">
-            {{fa-icon "globe"}} Domains
-        </h1>
-        <div class = "tags">
-            {{#each item.domains as |data|}}
-                <span class="section-tag">{{data}}</span>
-            {{/each}}
-        </div>
-    {{/if}}
-
-    {{#if item.http.redirects}}
-        <h1 class="p-title">
-            {{fa-icon "globe"}} HTTP Redirects
-        </h1>
-        <div class="tags">
-            {{#each item.http.redirects as |data|}}
-                <span class="section-tag">{{data}}</span>
-            {{/each}}
-        </div>
-    {{/if}}
-    {{#if (not-eq item details.data.lastObject)}}
-        <hr>
-    {{/if}}
-{{/each}}
-
-
+{{#if details.ip_str}}
+    <a class="p-link" href="https://www.shodan.io/host/{{details.ip_str}}"> View in Shodan {{fa-icon "external-link-square" fixedWidth=true class="external-icon"}}</a>
+{{/if}}
+
+<h1 class="p-title">{{fa-icon "globe"}} Summary</h1>
+
+{{#if details.city}}
+  <div>
+    <span class="p-key">City: </span>
+    <span class="p-value">{{details.city}}</span>
+  </div>
+{{/if}}
+
+{{#if details.country_name}}
+  <div>
+    <span class="p-key">Country: </span>
+    <span class="p-value">{{details.country_name}}</span>
+  </div>
+{{/if}}
+
+{{#if details.org}}
+  <div>
+    <span class="p-key">Org: </span>
+    <span class="p-value">{{details.org}}</span>
+  </div>
+{{/if}}
+
+{{#if details.isp}}
+  <div>
+    <span class="p-key">ISP: </span>
+    <span class="p-value">{{details.isp}}</span>
+  </div>
+{{/if}}
+
+{{#if details.last_update}}
+    <div>
+        <span class="p-key">Last Update: </span>
+        <span class="p-value">{{details.last_update}}</span>
+    </div>
+{{/if}}
+
+{{#if details.hostnames}}
+  <div>
+    <span class="p-key">Hostnames: </span>
+    <span class="p-value">{{join ', ' details.hostnames}}</span>
+  </div>
+{{/if}}
+
+{{#if details.asn}}
+  <div>
+    <span class="p-key">ASN: </span>
+    <span class="p-value">{{details.asn}}</span>
+  </div>
+{{/if}}
+
+{{#if details.ports}}
+  <h1 class="p-title">{{fa-icon "th-large" fixedWidth=true}} Ports </h1>
+  {{#each details.ports as |data|}}
+    <span class="section-tag">{{data}}</span>
+  {{/each}}
+{{/if}}
+
+<h1 class="p-title">{{fa-icon "th-list" fixedWidth=true}} Services</h1>
+
+
+{{#each details.data as |item index|}}
+  <div class="service-pill">
+    <span class="port">{{item.port}}</span><span class="transport">{{item.transport}}</span><span class="service">{{item._shodan.module}}</span>
+  </div>
+{{/each}}
+
+<div class="p-action mt-2" {{action "toggleDetails"}}>
+  {{#if showDetails}}
+    {{fa-icon "caret-down" fixedWidth=true}} Hide Details
+  {{else}}
+    {{fa-icon "caret-up" fixedWidth=true}} View Details
+  {{/if}}
+</div>
+
+
+{{#if showDetails}}
+  {{#each details.data as |item index|}}
+    <div class="data-block">
+      {{#if item.product}}
+        <h1 class="p-title">{{fa-icon "box" fixedWidth=true}} {{item.product}}</h1>
+      {{else}}
+        <h1 class="p-title">{{fa-icon "box" fixedWidth=true}} {{item._shodan.module}}</h1>
+      {{/if}}
+      <div class="service-pill">
+        <span class="port">{{item.port}}</span><span class="transport">{{item.transport}}</span><span class="service">{{item._shodan.module}}</span>
+      </div>
+      {{#if item.isp}}
+        <div>
+          <span class="p-key">ISP: </span>
+          <span class="p-value">{{item.isp}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.org}}
+        <div>
+          <span class="p-key">Org: </span>
+          <span class="p-value">{{item.org}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.devicetype}}
+        <div>
+          <span class="p-key">Device Type: </span>
+          <span class="p-value">{{item.devicetype}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.hash}}
+        <div>
+          <span class="p-key">Hash: </span>
+          <span class="p-value">{{item.hash}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.version}}
+        <div>
+          <span class="p-key">Version: </span>
+          <span class="p-value">{{item.version}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.os}}
+        <div>
+          <span class="p-key">OS: </span>
+          <span class="p-value">{{item.os}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.ssh.fingerprint}}
+        <div>
+          <span class="p-key">SSH Fingerprint: </span>
+          <span class="p-value">{{item.ssh.fingerprint}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.ssh.mac}}
+        <div>
+          <span class="p-key">SSH MAC: </span>
+          <span class="p-value">{{item.ssh.mac}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.ssh.cipher}}
+        <div>
+          <span class="p-key">SSH Cipher: </span>
+          <span class="p-value">{{item.ssh.cipher}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.http.servers}}
+        <div>
+          <span class="p-key">HTTP Servers: </span>
+          <span class="p-value">{{item.http.servers}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.hostnames}}
+        <div>
+          <span class="p-key">Hostnames: </span>
+          <span class="p-value">{{join ', ' item.hostnames}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.domains}}
+        <div>
+          <span class="p-key">Domains: </span>
+          <span class="p-value">{{join ', ' item.domains}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.http.redirects}}
+        <div>
+          <span class="p-key">Redirects: </span>
+          <span class="p-value">{{join ', ' item.http.redirects}}</span>
+        </div>
+      {{/if}}
+
+      {{#if item.http.robots}}
+        <div>
+          <span class="p-key">HTTP Robots: </span>
+          <pre>{{item.http.robots}}</pre>
+        </div>
+      {{/if}}
+
+      {{#if item.data}}
+        <div>
+          <span class="p-key">Data: </span>
+          <pre>{{item.data}}</pre>
+        </div>
+      {{/if}}
+    </div>
+  {{/each}}
+{{/if}}
\ No newline at end of file

From d76a767eb83f14e3d3159460dbe2fb5b1f5a0925 Mon Sep 17 00:00:00 2001
From: Jon Penwood <jonp@polarity.io>
Date: Tue, 21 Apr 2020 12:20:45 -0500
Subject: [PATCH 08/10] Added try again functionality.

---
 components/shodan-block.js |  41 +++-
 integration.js             | 117 +++++++-----
 templates/shodan-block.hbs | 378 ++++++++++++++++++++-----------------
 3 files changed, 316 insertions(+), 220 deletions(-)

diff --git a/components/shodan-block.js b/components/shodan-block.js
index e6dfb20..eff835b 100644
--- a/components/shodan-block.js
+++ b/components/shodan-block.js
@@ -1,9 +1,38 @@
 polarity.export = PolarityComponent.extend({
-    details: Ember.computed.alias('block.data.details'),
-    showDetails: false,
-    actions: {
-        toggleDetails: function(){
-            this.toggleProperty('showDetails');
-        }
+  data: Ember.computed.alias('block.data'),
+  details: Ember.computed.alias('block.data.details'),
+  showDetails: false,
+  entity: Ember.computed.alias('block.entity'),
+  message: '',
+  errorMessage: null,
+  isRunning: false,
+  actions: {
+    toggleDetails: function () {
+      this.toggleProperty('showDetails');
+    },
+    tryAgain: function () {
+      const outerThis = this;
+
+      this.set('message', '');
+      this.set('errorMessage', '');
+      this.set('isRunning', true);
+      this.get('block').notifyPropertyChange('data');
+
+      this.sendIntegrationMessage({ data: { entity: this.entity } })
+        .then((newDetails) => {
+          outerThis.set('message', 'Success!');
+          outerThis.set('details', newDetails);
+        })
+        .catch((err) => {
+          outerThis.set(
+            'errorMessage',
+            `Failed on Retry: ${err.message || err.title || err.description || 'Unknown Reason'}`
+          );
+        })
+        .finally(() => {
+          this.set('isRunning', false);
+          outerThis.get('block').notifyPropertyChange('data');
+        });
     }
+  }
 });
diff --git a/integration.js b/integration.js
index fee3604..7fe5072 100644
--- a/integration.js
+++ b/integration.js
@@ -30,56 +30,65 @@ function doLookup(entities, options, cb) {
   }
 
   let requestResults = [];
-  let maxRequestQueueLimitHit = false;
   Logger.trace({ entities }, 'doLookup');
 
-  entities.forEach((entity) => {
-    if (!entity.isPrivateIP && !IGNORED_IPS.has(entity.value)) {
-      let requestOptions = {
-        uri: 'https://api.shodan.io/shodan/host/' + entity.value + '?key=' + options.apiKey,
-        method: 'GET',
-        json: true
-      };
-
-      limiter.submit(requestEntity, entity, requestOptions, (err, result) => {
-        if (maxRequestQueueLimitHit) return;
-        requestResults.push([err, result]);
-        if (_.isEmpty(err) && _.isEmpty(result)) {
-          maxRequestQueueLimitHit = true;
+  const validEntities = entities.filter(
+    (entity) => !entity.isPrivateIP && !IGNORED_IPS.has(entity.value)
+  );
+
+  validEntities.forEach((entity) => {
+    let requestOptions = {
+      uri: 'https://api.shodan.io/shodan/host/' + entity.value + '?key=' + options.apiKey,
+      method: 'GET',
+      json: true
+    };
+
+    limiter.submit(requestEntity, entity, requestOptions, (err, result) => {
+      const maxRequestQueueLimitHit =
+        (_.isEmpty(err) && _.isEmpty(result)) ||
+        (err && err.message === 'This job has been dropped by Bottleneck');
+
+      requestResults.push([
+        err,
+        maxRequestQueueLimitHit ? { ...result, entity, limitReached: true } : result
+      ]);
+
+      if (requestResults.length === validEntities.length) {
+        const [errs, results] = transpose2DArray(requestResults);
+        const errors = errs.filter(
+          (err) =>
+            !_.isEmpty(err) && err && err.message === 'This job has been dropped by Bottleneck'
+        );
+
+        if (errors.length) {
+          Logger.trace({ errors }, 'Something went wrong');
           return cb({
-            err: {
-              message:
-                `Entities: ${entities.map(({ value }) => value).join(', ')} ` +
-                'were not able to be searched.'
-            },
-            detail: 'Hit API request Limit. Try again Later'
+            err: errors[0],
+            detail: errors[0].detail || 'Error: Something with the Request Failed'
           });
         }
 
-        if (requestResults.length === entities.length) {
-          const [errs, results] = transpose2DArray(requestResults);
-          const errors = errs.filter((err) => !_.isEmpty(err));
-
-          if (errors.length) {
-            Logger.trace({ errors }, 'Something went wrong');
-            return cb({
-              err: errors[0],
-              detail: errors[0].detail || 'Error: Something with the Request Failed'
-            });
-          }
-
-          const lookupResults = results.map(({ entity, body }) => ({
-            entity,
-            data: body && {
-              summary: [],
-              details: body
-            }
-          }));
-
-          cb(null, lookupResults);
-        }
-      });
-    }
+        const lookupResults = results
+          .filter((result) => !_.isEmpty(result))
+          .map(({ entity, body, limitReached }) =>
+            limitReached
+              ? {
+                  entity,
+                  isVolatile: true,
+                  data: { details: { limitReached, tags: ['Query Limit Hit'] } }
+                }
+              : {
+                  entity,
+                  data: body && {
+                    summary: [],
+                    details: body
+                  }
+                }
+          );
+
+        cb(null, lookupResults);
+      }
+    });
   });
 }
 
@@ -131,6 +140,23 @@ const transpose2DArray = (results) =>
     [[], []]
   );
 
+const retryEntity = ({ data: { entity } }, options, callback) => 
+  doLookup([entity], options, (err, lookupResults) => {
+    if(err) return callback(err);
+
+    const lookupResult = lookupResults[0];
+
+    if (lookupResult && lookupResult.data && lookupResult.data.details) {
+      if (details.limitReached) {
+        callback({ title: 'Hit Query Limit', message: 'Query Limit Still in Effect' });
+      } else {
+        callback(null, details);
+      }
+    } else {
+      callback(null, { noResultsFound: true, tags: ['No Results Found'] });
+    }
+  });
+
 function startup(logger) {
   Logger = logger;
   let defaults = {};
@@ -180,5 +206,6 @@ function validateOptions(userOptions, cb) {
 module.exports = {
   doLookup,
   startup,
-  validateOptions
+  validateOptions,
+  onMessage: retryEntity
 };
diff --git a/templates/shodan-block.hbs b/templates/shodan-block.hbs
index e1ff168..858b3d7 100644
--- a/templates/shodan-block.hbs
+++ b/templates/shodan-block.hbs
@@ -1,198 +1,238 @@
-{{#if details.ip_str}}
-    <a class="p-link" href="https://www.shodan.io/host/{{details.ip_str}}"> View in Shodan {{fa-icon "external-link-square" fixedWidth=true class="external-icon"}}</a>
-{{/if}}
-
-<h1 class="p-title">{{fa-icon "globe"}} Summary</h1>
-
-{{#if details.city}}
-  <div>
-    <span class="p-key">City: </span>
-    <span class="p-value">{{details.city}}</span>
-  </div>
-{{/if}}
-
-{{#if details.country_name}}
-  <div>
-    <span class="p-key">Country: </span>
-    <span class="p-value">{{details.country_name}}</span>
-  </div>
-{{/if}}
-
-{{#if details.org}}
-  <div>
-    <span class="p-key">Org: </span>
-    <span class="p-value">{{details.org}}</span>
-  </div>
-{{/if}}
-
-{{#if details.isp}}
-  <div>
-    <span class="p-key">ISP: </span>
-    <span class="p-value">{{details.isp}}</span>
-  </div>
-{{/if}}
-
-{{#if details.last_update}}
-    <div>
-        <span class="p-key">Last Update: </span>
-        <span class="p-value">{{details.last_update}}</span>
-    </div>
-{{/if}}
-
-{{#if details.hostnames}}
-  <div>
-    <span class="p-key">Hostnames: </span>
-    <span class="p-value">{{join ', ' details.hostnames}}</span>
-  </div>
-{{/if}}
-
-{{#if details.asn}}
-  <div>
-    <span class="p-key">ASN: </span>
-    <span class="p-value">{{details.asn}}</span>
-  </div>
-{{/if}}
-
-{{#if details.ports}}
-  <h1 class="p-title">{{fa-icon "th-large" fixedWidth=true}} Ports </h1>
-  {{#each details.ports as |data|}}
-    <span class="section-tag">{{data}}</span>
-  {{/each}}
-{{/if}}
-
-<h1 class="p-title">{{fa-icon "th-list" fixedWidth=true}} Services</h1>
-
-
-{{#each details.data as |item index|}}
-  <div class="service-pill">
-    <span class="port">{{item.port}}</span><span class="transport">{{item.transport}}</span><span class="service">{{item._shodan.module}}</span>
-  </div>
-{{/each}}
-
-<div class="p-action mt-2" {{action "toggleDetails"}}>
-  {{#if showDetails}}
-    {{fa-icon "caret-down" fixedWidth=true}} Hide Details
-  {{else}}
-    {{fa-icon "caret-up" fixedWidth=true}} View Details
-  {{/if}}
-</div>
-
-
-{{#if showDetails}}
-  {{#each details.data as |item index|}}
-    <div class="data-block">
-      {{#if item.product}}
-        <h1 class="p-title">{{fa-icon "box" fixedWidth=true}} {{item.product}}</h1>
-      {{else}}
-        <h1 class="p-title">{{fa-icon "box" fixedWidth=true}} {{item._shodan.module}}</h1>
-      {{/if}}
-      <div class="service-pill">
-        <span class="port">{{item.port}}</span><span class="transport">{{item.transport}}</span><span class="service">{{item._shodan.module}}</span>
-      </div>
-      {{#if item.isp}}
+{{#if details.limitReached}}
+    <h1 class="p-title">{{fa-icon "info-circle"}} Query Limit Reached</h1>
+    <p>
+        The query for this entity in Shodan did not go through due to the API Query Limit.
+    </p>
+    <div class="d-flex flex-row justify-content-between align-items-center">
         <div>
-          <span class="p-key">ISP: </span>
-          <span class="p-value">{{item.isp}}</span>
+            {{#if isRunning}}
+                {{fa-icon "spinner-third" fixedWidth=true spin=true}} Running
+            {{/if}}
         </div>
-      {{/if}}
-
-      {{#if item.org}}
-        <div>
-          <span class="p-key">Org: </span>
-          <span class="p-value">{{item.org}}</span>
+        <button
+            {{action "tryAgain"}}
+            class="p-btn btn btn-light mt-1"class="p-btn btn btn-light mt-1"
+            disabled={{isRunning}}
+        >
+            Try Again?
+        </button>
+    </div>
+    {{#if message}}
+        <div class="alert alert-info mt-1">
+            {{message}}
         </div>
-      {{/if}}
-
-      {{#if item.devicetype}}
-        <div>
-          <span class="p-key">Device Type: </span>
-          <span class="p-value">{{item.devicetype}}</span>
+    {{/if}}
+    {{#if errorMessage}}
+        <div class="alert alert-danger mt-1">
+            {{errorMessage}}
         </div>
-      {{/if}}
-
-      {{#if item.hash}}
+    {{/if}}
+{{else}}
+    {{#if details.noResultsFound}}
+        <h1 class="p-title">{{fa-icon "info-circle"}} No Results Found</h1>
+        <p>
+            This Entity does not exist in Shodan.
+        </p>
+    {{else}}
+        {{#if details.ip_str}}
+            <a class="p-link" href="https://www.shodan.io/host/{{details.ip_str}}"> 
+                View in Shodan {{fa-icon "external-link-square" fixedWidth=true class="external-icon"}}
+            </a>
+        {{/if}}
+
+        <h1 class="p-title">{{fa-icon "globe"}} Summary</h1>
+
+        {{#if details.city}}
         <div>
-          <span class="p-key">Hash: </span>
-          <span class="p-value">{{item.hash}}</span>
+            <span class="p-key">City: </span>
+            <span class="p-value">{{details.city}}</span>
         </div>
-      {{/if}}
+        {{/if}}
 
-      {{#if item.version}}
+        {{#if details.country_name}}
         <div>
-          <span class="p-key">Version: </span>
-          <span class="p-value">{{item.version}}</span>
+            <span class="p-key">Country: </span>
+            <span class="p-value">{{details.country_name}}</span>
         </div>
-      {{/if}}
+        {{/if}}
 
-      {{#if item.os}}
+        {{#if details.org}}
         <div>
-          <span class="p-key">OS: </span>
-          <span class="p-value">{{item.os}}</span>
+            <span class="p-key">Org: </span>
+            <span class="p-value">{{details.org}}</span>
         </div>
-      {{/if}}
+        {{/if}}
 
-      {{#if item.ssh.fingerprint}}
+        {{#if details.isp}}
         <div>
-          <span class="p-key">SSH Fingerprint: </span>
-          <span class="p-value">{{item.ssh.fingerprint}}</span>
+            <span class="p-key">ISP: </span>
+            <span class="p-value">{{details.isp}}</span>
         </div>
-      {{/if}}
+        {{/if}}
 
-      {{#if item.ssh.mac}}
-        <div>
-          <span class="p-key">SSH MAC: </span>
-          <span class="p-value">{{item.ssh.mac}}</span>
-        </div>
-      {{/if}}
+        {{#if details.last_update}}
+            <div>
+                <span class="p-key">Last Update: </span>
+                <span class="p-value">{{details.last_update}}</span>
+            </div>
+        {{/if}}
 
-      {{#if item.ssh.cipher}}
+        {{#if details.hostnames}}
         <div>
-          <span class="p-key">SSH Cipher: </span>
-          <span class="p-value">{{item.ssh.cipher}}</span>
+            <span class="p-key">Hostnames: </span>
+            <span class="p-value">{{join ', ' details.hostnames}}</span>
         </div>
-      {{/if}}
+        {{/if}}
 
-      {{#if item.http.servers}}
+        {{#if details.asn}}
         <div>
-          <span class="p-key">HTTP Servers: </span>
-          <span class="p-value">{{item.http.servers}}</span>
+            <span class="p-key">ASN: </span>
+            <span class="p-value">{{details.asn}}</span>
         </div>
-      {{/if}}
+        {{/if}}
 
-      {{#if item.hostnames}}
-        <div>
-          <span class="p-key">Hostnames: </span>
-          <span class="p-value">{{join ', ' item.hostnames}}</span>
-        </div>
-      {{/if}}
+        {{#if details.ports}}
+        <h1 class="p-title">{{fa-icon "th-large" fixedWidth=true}} Ports </h1>
+        {{#each details.ports as |data|}}
+            <span class="section-tag">{{data}}</span>
+        {{/each}}
+        {{/if}}
 
-      {{#if item.domains}}
-        <div>
-          <span class="p-key">Domains: </span>
-          <span class="p-value">{{join ', ' item.domains}}</span>
-        </div>
-      {{/if}}
+        <h1 class="p-title">{{fa-icon "th-list" fixedWidth=true}} Services</h1>
 
-      {{#if item.http.redirects}}
-        <div>
-          <span class="p-key">Redirects: </span>
-          <span class="p-value">{{join ', ' item.http.redirects}}</span>
-        </div>
-      {{/if}}
 
-      {{#if item.http.robots}}
-        <div>
-          <span class="p-key">HTTP Robots: </span>
-          <pre>{{item.http.robots}}</pre>
+        {{#each details.data as |item index|}}
+        <div class="service-pill">
+            <span class="port">{{item.port}}</span><span class="transport">{{item.transport}}</span><span class="service">{{item._shodan.module}}</span>
         </div>
-      {{/if}}
-
-      {{#if item.data}}
-        <div>
-          <span class="p-key">Data: </span>
-          <pre>{{item.data}}</pre>
+        {{/each}}
+
+        <div class="p-action mt-2" {{action "toggleDetails"}}>
+        {{#if showDetails}}
+            {{fa-icon "caret-down" fixedWidth=true}} Hide Details
+        {{else}}
+            {{fa-icon "caret-up" fixedWidth=true}} View Details
+        {{/if}}
         </div>
-      {{/if}}
-    </div>
-  {{/each}}
+
+
+        {{#if showDetails}}
+        {{#each details.data as |item index|}}
+            <div class="data-block">
+            {{#if item.product}}
+                <h1 class="p-title">{{fa-icon "box" fixedWidth=true}} {{item.product}}</h1>
+            {{else}}
+                <h1 class="p-title">{{fa-icon "box" fixedWidth=true}} {{item._shodan.module}}</h1>
+            {{/if}}
+            <div class="service-pill">
+                <span class="port">{{item.port}}</span><span class="transport">{{item.transport}}</span><span class="service">{{item._shodan.module}}</span>
+            </div>
+            {{#if item.isp}}
+                <div>
+                <span class="p-key">ISP: </span>
+                <span class="p-value">{{item.isp}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.org}}
+                <div>
+                <span class="p-key">Org: </span>
+                <span class="p-value">{{item.org}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.devicetype}}
+                <div>
+                <span class="p-key">Device Type: </span>
+                <span class="p-value">{{item.devicetype}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.hash}}
+                <div>
+                <span class="p-key">Hash: </span>
+                <span class="p-value">{{item.hash}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.version}}
+                <div>
+                <span class="p-key">Version: </span>
+                <span class="p-value">{{item.version}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.os}}
+                <div>
+                <span class="p-key">OS: </span>
+                <span class="p-value">{{item.os}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.ssh.fingerprint}}
+                <div>
+                <span class="p-key">SSH Fingerprint: </span>
+                <span class="p-value">{{item.ssh.fingerprint}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.ssh.mac}}
+                <div>
+                <span class="p-key">SSH MAC: </span>
+                <span class="p-value">{{item.ssh.mac}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.ssh.cipher}}
+                <div>
+                <span class="p-key">SSH Cipher: </span>
+                <span class="p-value">{{item.ssh.cipher}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.http.servers}}
+                <div>
+                <span class="p-key">HTTP Servers: </span>
+                <span class="p-value">{{item.http.servers}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.hostnames}}
+                <div>
+                <span class="p-key">Hostnames: </span>
+                <span class="p-value">{{join ', ' item.hostnames}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.domains}}
+                <div>
+                <span class="p-key">Domains: </span>
+                <span class="p-value">{{join ', ' item.domains}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.http.redirects}}
+                <div>
+                <span class="p-key">Redirects: </span>
+                <span class="p-value">{{join ', ' item.http.redirects}}</span>
+                </div>
+            {{/if}}
+
+            {{#if item.http.robots}}
+                <div>
+                <span class="p-key">HTTP Robots: </span>
+                <pre>{{item.http.robots}}</pre>
+                </div>
+            {{/if}}
+
+            {{#if item.data}}
+                <div>
+                <span class="p-key">Data: </span>
+                <pre>{{item.data}}</pre>
+                </div>
+            {{/if}}
+            </div>
+        {{/each}}
+        {{/if}}
+    {{/if}}
 {{/if}}
\ No newline at end of file

From 7d8d9d645edc23e3192aa6267a122cb286b76318 Mon Sep 17 00:00:00 2001
From: Ed <ed@polarity.io>
Date: Thu, 30 Apr 2020 13:19:05 -0400
Subject: [PATCH 09/10] Fix retry search, add button to summary tag.

---
 components/shodan-block.js   |  1 -
 components/shodan-summary.js | 28 +++++++++++++++++++++++++++-
 integration.js               | 12 ++++++------
 package.json                 |  2 +-
 styles/shodan.less           | 13 +++++++++++++
 templates/shodan-block.hbs   |  8 ++++----
 templates/shodan-summary.hbs | 30 +++++++++++++++++-------------
 7 files changed, 68 insertions(+), 26 deletions(-)

diff --git a/components/shodan-block.js b/components/shodan-block.js
index eff835b..358c6c0 100644
--- a/components/shodan-block.js
+++ b/components/shodan-block.js
@@ -16,7 +16,6 @@ polarity.export = PolarityComponent.extend({
       this.set('message', '');
       this.set('errorMessage', '');
       this.set('isRunning', true);
-      this.get('block').notifyPropertyChange('data');
 
       this.sendIntegrationMessage({ data: { entity: this.entity } })
         .then((newDetails) => {
diff --git a/components/shodan-summary.js b/components/shodan-summary.js
index f2efb23..c4cda6b 100644
--- a/components/shodan-summary.js
+++ b/components/shodan-summary.js
@@ -2,6 +2,7 @@
 
 polarity.export = PolarityComponent.extend({
   details: Ember.computed.alias('block.data.details'),
+  entity: Ember.computed.alias('block.entity'),
   summaryTags: Ember.computed('details.tags', function() {
     let summaryTags = [];
 
@@ -38,5 +39,30 @@ polarity.export = PolarityComponent.extend({
       summaryTags.push('No Tags');
     }
     return summaryTags;
-  })
+  }),
+  actions: {
+    tryAgain: function() {
+      const outerThis = this;
+
+      this.set('message', '');
+      this.set('errorMessage', '');
+      this.set('isRunning', true);
+
+      this.sendIntegrationMessage({ data: { entity: this.entity } })
+        .then((newDetails) => {
+          outerThis.set('message', 'Success!');
+          outerThis.set('details', newDetails);
+        })
+        .catch((err) => {
+          outerThis.set(
+            'errorMessage',
+            `Failed on Retry: ${err.message || err.title || err.description || 'Unknown Reason'}`
+          );
+        })
+        .finally(() => {
+          this.set('isRunning', false);
+          outerThis.get('block').notifyPropertyChange('data');
+        });
+    }
+  }
 });
diff --git a/integration.js b/integration.js
index 7fe5072..01ab675 100644
--- a/integration.js
+++ b/integration.js
@@ -75,7 +75,7 @@ function doLookup(entities, options, cb) {
               ? {
                   entity,
                   isVolatile: true,
-                  data: { details: { limitReached, tags: ['Query Limit Hit'] } }
+                  data: { details: { limitReached, tags: ['Search Limit Reached'] } }
                 }
               : {
                   entity,
@@ -119,7 +119,7 @@ const requestEntity = (entity, requestOptions, callback) =>
     } else if (res.statusCode === 503) {
       // reached request limit
       return callback({
-        detail: 'Request Limit Reached'
+        detail: 'Search Limit Reached'
       });
     } else {
       return callback({
@@ -140,17 +140,17 @@ const transpose2DArray = (results) =>
     [[], []]
   );
 
-const retryEntity = ({ data: { entity } }, options, callback) => 
+const retryEntity = ({ data: { entity } }, options, callback) =>
   doLookup([entity], options, (err, lookupResults) => {
     if(err) return callback(err);
 
     const lookupResult = lookupResults[0];
 
     if (lookupResult && lookupResult.data && lookupResult.data.details) {
-      if (details.limitReached) {
-        callback({ title: 'Hit Query Limit', message: 'Query Limit Still in Effect' });
+      if (lookupResult.data.details.limitReached) {
+        callback({ title: 'Search Limit Reached', message: 'Search Limit Still in Effect' });
       } else {
-        callback(null, details);
+        callback(null, lookupResult.data.details);
       }
     } else {
       callback(null, { noResultsFound: true, tags: ['No Results Found'] });
diff --git a/package.json b/package.json
index c2ed208..ef88b4d 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "main": "./integration.js",
   "name": "shodan",
-  "version": "3.0.2-beta",
+  "version": "3.0.3-beta",
   "private": true,
   "dependencies": {
     "bottleneck": "^2.19.5",
diff --git a/styles/shodan.less b/styles/shodan.less
index e2d9738..e9b4031 100644
--- a/styles/shodan.less
+++ b/styles/shodan.less
@@ -5,6 +5,19 @@
   padding: 3px 3px 2px 3px;
   display: inline-block;
 }
+.summary-try-again-button {
+  padding: 0px 3px;
+  background-color: rgba(0,0,0,.3);
+  border: 0;
+  color: #fff;
+  text-transform: lowercase;
+  font-size: 10px;
+  border-radius: 2px;
+}
+
+.summary-try-again-button:hover{
+  background-color: rgba(0,0,0,.4);
+}
 
 .external-icon{
   font-size: 8px;
diff --git a/templates/shodan-block.hbs b/templates/shodan-block.hbs
index 858b3d7..04585bc 100644
--- a/templates/shodan-block.hbs
+++ b/templates/shodan-block.hbs
@@ -1,7 +1,7 @@
 {{#if details.limitReached}}
-    <h1 class="p-title">{{fa-icon "info-circle"}} Query Limit Reached</h1>
+    <h1 class="p-title">{{fa-icon "info-circle"}} Search Limit Reached</h1>
     <p>
-        The query for this entity in Shodan did not go through due to the API Query Limit.
+        This entity could not be searched as you've temporarily reached your Shodan Search Limit.  You can retry your search by pressing the "Try Again" button.
     </p>
     <div class="d-flex flex-row justify-content-between align-items-center">
         <div>
@@ -14,7 +14,7 @@
             class="p-btn btn btn-light mt-1"class="p-btn btn btn-light mt-1"
             disabled={{isRunning}}
         >
-            Try Again?
+            Try Again
         </button>
     </div>
     {{#if message}}
@@ -35,7 +35,7 @@
         </p>
     {{else}}
         {{#if details.ip_str}}
-            <a class="p-link" href="https://www.shodan.io/host/{{details.ip_str}}"> 
+            <a class="p-link" href="https://www.shodan.io/host/{{details.ip_str}}">
                 View in Shodan {{fa-icon "external-link-square" fixedWidth=true class="external-icon"}}
             </a>
         {{/if}}
diff --git a/templates/shodan-summary.hbs b/templates/shodan-summary.hbs
index df0f879..1ecfa26 100644
--- a/templates/shodan-summary.hbs
+++ b/templates/shodan-summary.hbs
@@ -1,13 +1,17 @@
-{{#each summaryTags as |tag|}}
-    <span class="integration-summary-tag integration-background-color integration-border-color">
-       <span class="acronym integration-text-bold-color">{{block.acronym}}</span>
-       <span class="integration-text-color">{{tag}}</span>
-    </span>
-{{/each}}
-
-
-
-
-
-
-
+{{#each summaryTags as |tag|}}
+    <span class="integration-summary-tag integration-background-color integration-border-color">
+       <span class="acronym integration-text-bold-color">{{block.acronym}}</span>
+      {{#if (eq tag "Search Limit Reached")}}
+        <span class="integration-text-color">{{fa-icon "exclamation"}} {{tag}} <button class="summary-try-again-button" {{action "tryAgain" bubbles=false}}>retry</button></span>
+      {{else}}
+        <span class="integration-text-color">{{tag}}</span>
+      {{/if}}
+    </span>
+{{/each}}
+
+
+
+
+
+
+

From 9ccea247670d0798fe51342309edc394be1452ab Mon Sep 17 00:00:00 2001
From: Ed <ed@polarity.io>
Date: Fri, 8 May 2020 11:27:58 -0400
Subject: [PATCH 10/10] Updated README

---
 README.md          |  50 ++++++++++++++++++++++++---------------------
 assets/overlay.png | Bin 0 -> 55470 bytes
 package.json       |   2 +-
 3 files changed, 28 insertions(+), 24 deletions(-)
 create mode 100644 assets/overlay.png

diff --git a/README.md b/README.md
index b12c25e..f008ef1 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,27 @@
-# Polarity Shodan Integration
-
-Polarity's Shodan integration gives users access to automated IPv4 and IPv6 lookups against the Shodan Host REST API.
-
-Please see [https://www.shodan.io/](https://www.shodan.io/) for more information.
-
-![image](https://user-images.githubusercontent.com/306319/46555899-e36b6400-c8b2-11e8-9d31-5dc3e34559bc.png)
-
-## Shodan Integration Options
-
-### Shodan API Key
-
-Your Shodan API Key.
-
-## Installation Instructions
-
-Installation instructions for integrations are provided on the [PolarityIO GitHub Page](https://polarityio.github.io/).
-
-## Polarity
-
-Polarity is a memory-augmentation platform that improves and accelerates analyst decision making.  For more information about the Polarity platform please see:
-
-https://polarity.io/
+# Polarity Shodan Integration
+
+![mode:on demand only](https://img.shields.io/badge/mode-on%20demand%20only-blue.svg)
+
+Polarity's Shodan integration gives users access to automated IPv4 and IPv6 lookups against the Shodan Host REST API.  The Shodan REST API restricts searches to 1 per second.  The integration will automatically throttle lookups to stay below this limit and will queue up to 15 search requests per API key.  If the queue is full, you will receive back a response indicating that the queue is full and will have the option to rerun the search from the Overlay Window.  
+
+Please see [https://www.shodan.io/](https://www.shodan.io/) for more information.
+
+| ![image](assets/overlay.png)  |
+|---|
+|*Shodan Example* |
+
+## Shodan Integration Options
+
+### Shodan API Key
+
+Your Shodan API Key.
+
+## Installation Instructions
+
+Installation instructions for integrations are provided on the [PolarityIO GitHub Page](https://polarityio.github.io/).
+
+## Polarity
+
+Polarity is a memory-augmentation platform that improves and accelerates analyst decision making.  For more information about the Polarity platform please see:
+
+https://polarity.io/
diff --git a/assets/overlay.png b/assets/overlay.png
new file mode 100644
index 0000000000000000000000000000000000000000..b8020c80c21e9b82190fc869eedc33804c175a9b
GIT binary patch
literal 55470
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
QZ;{RuZ9}a}h+V}001i!x!vFvP

literal 0
HcmV?d00001

diff --git a/package.json b/package.json
index ef88b4d..4e54209 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "main": "./integration.js",
   "name": "shodan",
-  "version": "3.0.3-beta",
+  "version": "3.1.0-beta",
   "private": true,
   "dependencies": {
     "bottleneck": "^2.19.5",