@itentialopensource/adapter-zscaler 0.6.5 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/AUTH.md +39 -0
  2. package/BROKER.md +199 -0
  3. package/CALLS.md +169 -0
  4. package/CHANGELOG.md +59 -25
  5. package/CODE_OF_CONDUCT.md +12 -17
  6. package/CONTRIBUTING.md +88 -74
  7. package/ENHANCE.md +69 -0
  8. package/PROPERTIES.md +641 -0
  9. package/README.md +221 -571
  10. package/SUMMARY.md +9 -0
  11. package/SYSTEMINFO.md +11 -0
  12. package/TROUBLESHOOT.md +47 -0
  13. package/adapter.js +433 -143
  14. package/adapterBase.js +1007 -253
  15. package/entities/.generic/action.json +105 -0
  16. package/entities/.generic/schema.json +6 -1
  17. package/entities/.system/action.json +2 -2
  18. package/error.json +6 -0
  19. package/package.json +5 -3
  20. package/pronghorn.json +762 -498
  21. package/propertiesDecorators.json +14 -0
  22. package/propertiesSchema.json +421 -0
  23. package/refs?service=git-upload-pack +0 -0
  24. package/report/adapterInfo.json +10 -0
  25. package/report/updateReport1642619799800.json +95 -0
  26. package/report/updateReport1653331963274.json +120 -0
  27. package/sampleProperties.json +90 -1
  28. package/test/integration/adapterTestBasicGet.js +1 -1
  29. package/test/integration/adapterTestIntegration.js +26 -102
  30. package/test/unit/adapterBaseTestUnit.js +30 -25
  31. package/test/unit/adapterTestUnit.js +168 -156
  32. package/utils/adapterInfo.js +206 -0
  33. package/utils/basicGet.js +0 -17
  34. package/utils/entitiesToDB.js +12 -57
  35. package/utils/modify.js +1 -1
  36. package/utils/patches2bundledDeps.js +90 -0
  37. package/utils/pre-commit.sh +3 -0
  38. package/utils/tbScript.js +38 -23
  39. package/utils/tbUtils.js +91 -28
  40. package/utils/testRunner.js +16 -16
  41. package/utils/troubleshootingAdapter.js +2 -26
package/utils/tbUtils.js CHANGED
@@ -3,6 +3,7 @@
3
3
  /* eslint import/no-extraneous-dependencies: warn */
4
4
  /* eslint global-require: warn */
5
5
  /* eslint import/no-dynamic-require: warn */
6
+ /* eslint-disable no-console */
6
7
 
7
8
  const path = require('path');
8
9
  const fs = require('fs-extra');
@@ -100,8 +101,8 @@ module.exports = {
100
101
  *
101
102
  * @function decryptProperties
102
103
  */
103
- decryptProperties: (props, dirname, discovery) => {
104
- const propertyEncryptionClassPath = path.join(dirname, '../../../@itential/pronghorn-core/core/PropertyEncryption.js');
104
+ decryptProperties: (props, iapDir, discovery) => {
105
+ const propertyEncryptionClassPath = path.join(iapDir, 'node_modules/@itential/pronghorn-core/core/PropertyEncryption.js');
105
106
  const isEncrypted = props.pathProps.encrypted;
106
107
  const PropertyEncryption = discovery.require(propertyEncryptionClassPath, isEncrypted);
107
108
  const propertyEncryption = new PropertyEncryption({
@@ -177,12 +178,12 @@ module.exports = {
177
178
  verifyInstallationDir: (dirname, name) => {
178
179
  const pathArray = dirname.split(path.sep);
179
180
  const expectedPath = `node_modules/${name}`;
180
- const currentPath = pathArray.slice(pathArray.length - 4, pathArray.length - 1).join('/');
181
+ const currentPath = pathArray.slice(pathArray.length - 3, pathArray.length).join('/');
181
182
  if (currentPath.trim() !== expectedPath.trim()) {
182
- throw new Error(`adapter should be installed under ${expectedPath}`);
183
+ throw new Error(`adapter should be installed under ${expectedPath} but is installed under ${currentPath}`);
183
184
  }
184
185
 
185
- const serverFile = path.join(dirname, '../../../..', 'server.js');
186
+ const serverFile = path.join(dirname, '../../../', 'server.js');
186
187
  if (!fs.existsSync(serverFile)) {
187
188
  throw new Error(`adapter should be installed under IAP/${expectedPath}`);
188
189
  }
@@ -305,9 +306,9 @@ module.exports = {
305
306
  * @param {Object} sampleProperties - './sampleProperties.json' in adapter dir
306
307
  */
307
308
  createAdapter: function createAdapter(pronghornProps, profileItem, sampleProperties, adapterPronghorn) {
308
- const dirname = this.getDirname();
309
- const packagePath = `${dirname.split('node_modules')[0]}package.json`;
310
- const info = JSON.parse(fs.readFileSync(packagePath));
309
+ const iapDir = this.getIAPHome();
310
+ const packageFile = path.join(iapDir, 'package.json');
311
+ const info = JSON.parse(fs.readFileSync(packageFile));
311
312
  const version = parseInt(info.version.split('.')[0], 10);
312
313
 
313
314
  let adapter = {};
@@ -339,6 +340,31 @@ module.exports = {
339
340
  return adapter;
340
341
  },
341
342
 
343
+ getPronghornProps: function getPronghornProps(iapDir) {
344
+ console.log('Retrieving properties.json file...');
345
+ const rawProps = require(path.join(iapDir, 'properties.json'));
346
+ console.log('Decrypting properties...');
347
+ const { Discovery } = require(path.join(iapDir, 'node_modules/@itential/itential-utils'));
348
+ const discovery = new Discovery();
349
+ const pronghornProps = this.decryptProperties(rawProps, iapDir, discovery);
350
+ console.log('Found properties.\n');
351
+ return pronghornProps;
352
+ },
353
+
354
+ // get database connection and existing adapter config
355
+ getAdapterConfig: async function getAdapterConfig() {
356
+ const iapDir = this.getIAPHome();
357
+ const pronghornProps = this.getPronghornProps(iapDir);
358
+ console.log('Connecting to Database...');
359
+ const database = await this.connect(iapDir, pronghornProps);
360
+ console.log('Connection established.');
361
+ const { name } = require(path.join(__dirname, '..', 'package.json'));
362
+ const serviceItem = await database.collection(this.SERVICE_CONFIGS_COLLECTION).findOne(
363
+ { model: name }
364
+ );
365
+ return { database, serviceItem, pronghornProps };
366
+ },
367
+
342
368
  /**
343
369
  * @summary return async healthcheck result as a Promise
344
370
  *
@@ -374,33 +400,70 @@ module.exports = {
374
400
  },
375
401
 
376
402
  /**
377
- * @summary Check whether adapter is located within IAP node_modules
378
- * by loading properties.json. If not, return false.
379
- * @function withinIAP
380
- * @param {String} iapDir root directory of IAP
403
+ * @summary Obtain the IAP installation directory depending on how adapter is used:
404
+ * by IAP, or by npm run CLI interface
405
+ * @returns IAP installation directory or null if adapter running without IAP
406
+ * @function getIAPHome
381
407
  */
382
- withinIAP: (iapDir) => {
383
- try {
384
- const rawProps = require(path.join(iapDir, 'properties.json'));
385
- return rawProps;
386
- } catch (error) {
387
- return false;
408
+ getIAPHome: function getIAPHome() {
409
+ let IAPHomePath = null;
410
+ // check if adapter started via IAP, use path injected by core
411
+ if (process.env.iap_home) IAPHomePath = process.env.iap_home;
412
+ // check if adapter started via CLI `npm run <command>` so we have to be located under
413
+ // <IAP_HOME>/node_modules/@itentialopensource/<adapter_name>/ directory
414
+ const currentExecutionPath = this.getCurrentExecutionPath();
415
+ if (currentExecutionPath.indexOf('/node_modules') >= 0) {
416
+ [IAPHomePath] = currentExecutionPath.split('/node_modules');
388
417
  }
418
+ return IAPHomePath;
389
419
  },
390
420
 
391
421
  /**
392
- * @summary Used to determine the proper dirname to return in case adapter reference is
393
- * symlinked withink IAP
394
- * @returns the symlinked path (using pwd command) of the adapter in case properties.json
395
- * is not found in the original path
396
- * @function getDirname
422
+ * @summary get current execution path without resolving symbolic links,
423
+ * use `pwd` command wihout '-P' option (resolving symlinks) https://linux.die.net/man/1/pwd
424
+ * @returns
425
+ * @function getCurrentExecutionPAth
397
426
  */
398
- getDirname: function getDirname() {
399
- if (this.withinIAP(path.join(__dirname, '../../../../'))) {
400
- return __dirname;
401
- }
427
+ getCurrentExecutionPath: function getCurrentExecutionPAth() {
402
428
  const { stdout } = this.systemSync('pwd', true);
403
- return path.join(stdout, 'utils');
429
+ return stdout.trim();
430
+ },
431
+
432
+ /**
433
+ * @summary checks if command executed from <IAP_HOME>/node_modules/@itentialopensource/<adapter_name>/ location
434
+ * @returns true if command executed under <IAP_HOME>/node_modules/@itentialopensource/<adapter_name>/ path
435
+ * @function areWeUnderIAPinstallationDirectory
436
+ */
437
+ areWeUnderIAPinstallationDirectory: function areWeUnderIAPinstallationDirectory() {
438
+ return path.join(this.getCurrentExecutionPath(), '../../..') === this.getIAPHome();
439
+ },
440
+
441
+ /**
442
+ * @summary connect to mongodb
443
+ *
444
+ * @function connect
445
+ * @param {Object} properties - pronghornProps
446
+ */
447
+ connect: async function connect(iapDir, properties) {
448
+ let dbConnectionProperties = {};
449
+ if (properties.mongoProps) {
450
+ dbConnectionProperties = properties.mongoProps;
451
+ } else if (properties.mongo) {
452
+ if (properties.mongo.url) {
453
+ dbConnectionProperties.url = properties.mongo.url;
454
+ } else {
455
+ dbConnectionProperties.url = `mongodb://${properties.mongo.host}:${properties.mongo.port}`;
456
+ }
457
+ dbConnectionProperties.db = properties.mongo.database;
458
+ }
459
+ if (!dbConnectionProperties.url || !dbConnectionProperties.db) {
460
+ throw new Error('Mongo properties are not specified in IAP configuration!');
461
+ }
462
+
463
+ const { MongoDBConnection } = require(path.join(iapDir, 'node_modules/@itential/database'));
464
+ const connection = new MongoDBConnection(dbConnectionProperties);
465
+ const database = await connection.connect(true);
466
+ return database;
404
467
  }
405
468
 
406
469
  };
@@ -47,11 +47,11 @@ function replaceTestVars(test) {
47
47
  let intTest = fs.readFileSync(test, 'utf8');
48
48
 
49
49
  // replace stub variable but check if it exists first
50
- let sindex = intTest.indexOf('const stub');
50
+ let sindex = intTest.indexOf('samProps.stub');
51
51
  let eindex = intTest.indexOf(';', sindex);
52
52
  let replStr = intTest.substring(sindex, eindex + 1);
53
53
  if (sindex > -1) {
54
- intTest = intTest.replace(replStr, `const stub = ${stub};`);
54
+ intTest = intTest.replace(replStr, `samProps.stub = ${stub};`);
55
55
  }
56
56
 
57
57
  // replace isRapidFail variable but check if it exists first
@@ -71,46 +71,46 @@ function replaceTestVars(test) {
71
71
  }
72
72
 
73
73
  // replace host variable
74
- sindex = intTest.indexOf('const host');
74
+ sindex = intTest.indexOf('samProps.host');
75
75
  eindex = intTest.indexOf(';', sindex);
76
76
  replStr = intTest.substring(sindex, eindex + 1);
77
- intTest = intTest.replace(replStr, `const host = '${host}';`);
77
+ intTest = intTest.replace(replStr, `samProps.host = '${host}';`);
78
78
 
79
79
  // replace username variable
80
- sindex = intTest.indexOf('const username');
80
+ sindex = intTest.indexOf('samProps.authentication.username');
81
81
  eindex = intTest.indexOf(';', sindex);
82
82
  replStr = intTest.substring(sindex, eindex + 1);
83
- intTest = intTest.replace(replStr, `const username = '${username}';`);
83
+ intTest = intTest.replace(replStr, `samProps.authentication.username = '${username}';`);
84
84
 
85
85
  // replace password variable
86
- sindex = intTest.indexOf('const password');
86
+ sindex = intTest.indexOf('samProps.authentication.password');
87
87
  eindex = intTest.indexOf(';', sindex);
88
88
  replStr = intTest.substring(sindex, eindex + 1);
89
- intTest = intTest.replace(replStr, `const password = '${password}';`);
89
+ intTest = intTest.replace(replStr, `samProps.authentication.password = '${password}';`);
90
90
 
91
91
  // replace protocol variable
92
- sindex = intTest.indexOf('const protocol');
92
+ sindex = intTest.indexOf('samProps.protocol');
93
93
  eindex = intTest.indexOf(';', sindex);
94
94
  replStr = intTest.substring(sindex, eindex + 1);
95
- intTest = intTest.replace(replStr, `const protocol = '${protocol}';`);
95
+ intTest = intTest.replace(replStr, `samProps.protocol = '${protocol}';`);
96
96
 
97
97
  // replace port variable
98
- sindex = intTest.indexOf('const port');
98
+ sindex = intTest.indexOf('samProps.port');
99
99
  eindex = intTest.indexOf(';', sindex);
100
100
  replStr = intTest.substring(sindex, eindex + 1);
101
- intTest = intTest.replace(replStr, `const port = ${port};`);
101
+ intTest = intTest.replace(replStr, `samProps.port = ${port};`);
102
102
 
103
103
  // replace sslenable variable
104
- sindex = intTest.indexOf('const sslenable');
104
+ sindex = intTest.indexOf('samProps.ssl.enabled');
105
105
  eindex = intTest.indexOf(';', sindex);
106
106
  replStr = intTest.substring(sindex, eindex + 1);
107
- intTest = intTest.replace(replStr, `const sslenable = ${sslenable};`);
107
+ intTest = intTest.replace(replStr, `samProps.ssl.enabled = ${sslenable};`);
108
108
 
109
109
  // replace sslinvalid variable
110
- sindex = intTest.indexOf('const sslinvalid');
110
+ sindex = intTest.indexOf('samProps.ssl.accept_invalid_cert');
111
111
  eindex = intTest.indexOf(';', sindex);
112
112
  replStr = intTest.substring(sindex, eindex + 1);
113
- intTest = intTest.replace(replStr, `const sslinvalid = ${sslinvalid};`);
113
+ intTest = intTest.replace(replStr, `samProps.ssl.accept_invalid_cert = ${sslinvalid};`);
114
114
 
115
115
  console.log(`Updates to ${test} complete`);
116
116
  fs.writeFileSync(test, intTest);
@@ -117,30 +117,6 @@ const VerifyHealthCheckEndpoint = (serviceItem, props, scriptFlag) => {
117
117
  return { result, updatedAdapter };
118
118
  };
119
119
 
120
- const getPronghornProps = (iapDir) => {
121
- console.log('Retrieving properties.json file...');
122
- const rawProps = require(path.join(iapDir, 'properties.json'));
123
- console.log('Decrypting properties...');
124
- const { Discovery } = require(path.join(iapDir, 'node_modules/@itential/itential-utils'));
125
- const discovery = new Discovery();
126
- const pronghornProps = utils.decryptProperties(rawProps, utils.getDirname(), discovery);
127
- console.log('Found properties.\n');
128
- return pronghornProps;
129
- };
130
-
131
- // get database connection and existing adapter config
132
- const getAdapterConfig = async () => {
133
- const iapDir = path.join(utils.getDirname(), '../../../../');
134
- const pronghornProps = getPronghornProps(iapDir);
135
- console.log('Connecting to Database...');
136
- const database = await basicGet.connect(pronghornProps);
137
- console.log('Connection established.');
138
- const serviceItem = await database.collection(utils.SERVICE_CONFIGS_COLLECTION).findOne(
139
- { model: name }
140
- );
141
- return { database, serviceItem, pronghornProps };
142
- };
143
-
144
120
  const offline = async () => {
145
121
  console.log('Start offline troubleshooting');
146
122
  const { updatedAdapter } = VerifyHealthCheckEndpoint({ properties: sampleProperties }, {}, true);
@@ -159,7 +135,7 @@ const offline = async () => {
159
135
 
160
136
  const troubleshoot = async (props, scriptFlag, persistFlag, adapter) => {
161
137
  // get database connection and existing adapter config
162
- const { database, serviceItem } = await getAdapterConfig();
138
+ const { database, serviceItem } = await utils.getAdapterConfig();
163
139
  // where troubleshoot should start
164
140
  if (serviceItem) {
165
141
  if (!scriptFlag || rls.keyInYN(`Start verifying the connection and authentication properties for ${name}?`)) {
@@ -211,4 +187,4 @@ const troubleshoot = async (props, scriptFlag, persistFlag, adapter) => {
211
187
  return null;
212
188
  };
213
189
 
214
- module.exports = { troubleshoot, getAdapterConfig, offline };
190
+ module.exports = { troubleshoot, offline };