@itentialopensource/adapter-nokia_altiplano 0.5.1 → 0.6.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 (44) hide show
  1. package/BROKER.md +6 -2
  2. package/CALLS.md +144 -0
  3. package/CHANGELOG.md +24 -8
  4. package/CONTRIBUTING.md +1 -160
  5. package/ENHANCE.md +2 -2
  6. package/README.md +32 -23
  7. package/adapter.js +159 -330
  8. package/adapterBase.js +555 -852
  9. package/changelogs/changelog.md +72 -0
  10. package/metadata.json +47 -0
  11. package/package.json +25 -25
  12. package/pronghorn.json +485 -146
  13. package/propertiesSchema.json +478 -37
  14. package/refs?service=git-upload-pack +0 -0
  15. package/report/adapter-openapi.json +1546 -0
  16. package/report/adapter-openapi.yaml +1392 -0
  17. package/report/adapterInfo.json +10 -0
  18. package/report/updateReport1652620670443.json +120 -0
  19. package/report/updateReport1691507619656.json +120 -0
  20. package/report/updateReport1692202622632.json +120 -0
  21. package/report/updateReport1694462147618.json +120 -0
  22. package/report/updateReport1698421046815.json +120 -0
  23. package/sampleProperties.json +77 -9
  24. package/test/integration/adapterTestBasicGet.js +3 -5
  25. package/test/integration/adapterTestConnectivity.js +91 -42
  26. package/test/integration/adapterTestIntegration.js +154 -110
  27. package/test/unit/adapterBaseTestUnit.js +388 -313
  28. package/test/unit/adapterTestUnit.js +366 -224
  29. package/utils/adapterInfo.js +1 -1
  30. package/utils/addAuth.js +1 -1
  31. package/utils/artifactize.js +1 -1
  32. package/utils/checkMigrate.js +1 -1
  33. package/utils/entitiesToDB.js +12 -57
  34. package/utils/findPath.js +1 -1
  35. package/utils/methodDocumentor.js +273 -0
  36. package/utils/modify.js +13 -15
  37. package/utils/packModificationScript.js +1 -1
  38. package/utils/pre-commit.sh +2 -0
  39. package/utils/taskMover.js +309 -0
  40. package/utils/tbScript.js +123 -53
  41. package/utils/tbUtils.js +84 -59
  42. package/utils/testRunner.js +17 -17
  43. package/utils/troubleshootingAdapter.js +9 -6
  44. package/workflows/README.md +0 -3
@@ -4,12 +4,13 @@
4
4
  "properties": {
5
5
  "host": "localhost",
6
6
  "port": 443,
7
+ "choosepath": "",
7
8
  "base_path": "/rest",
8
9
  "version": "",
9
10
  "cache_location": "none",
10
11
  "encode_pathvars": false,
11
12
  "encode_queryvars": false,
12
- "save_metric": true,
13
+ "save_metric": false,
13
14
  "stub": true,
14
15
  "protocol": "https",
15
16
  "authentication": {
@@ -25,12 +26,27 @@
25
26
  "auth_logging": false,
26
27
  "client_id": "",
27
28
  "client_secret": "",
28
- "grant_type": ""
29
+ "grant_type": "",
30
+ "sensitive": [],
31
+ "sso": {
32
+ "protocol": "",
33
+ "host": "",
34
+ "port": 0
35
+ },
36
+ "multiStepAuthCalls": [
37
+ {
38
+ "name": "",
39
+ "requestFields": {},
40
+ "responseFields": {},
41
+ "successfullResponseCode": 200
42
+ }
43
+ ]
29
44
  },
30
45
  "healthcheck": {
31
46
  "type": "none",
32
47
  "frequency": 60000,
33
- "query_object": {}
48
+ "query_object": {},
49
+ "addlHeaders": {}
34
50
  },
35
51
  "throttle": {
36
52
  "throttle_enabled": false,
@@ -99,7 +115,7 @@
99
115
  "cert_file": ""
100
116
  }
101
117
  },
102
- "deviceBroker": {
118
+ "devicebroker": {
103
119
  "getDevice": [
104
120
  {
105
121
  "path": "/get/devices/{id}",
@@ -111,12 +127,13 @@
111
127
  "requestFields": {
112
128
  "id": "name"
113
129
  },
130
+ "responseDatakey": "",
114
131
  "responseFields": {
115
132
  "name": "host",
116
133
  "ostype": "os",
117
134
  "ostypePrefix": "system-",
118
135
  "ipaddress": "attributes.ipaddr",
119
- "port": 443
136
+ "port": "443"
120
137
  }
121
138
  }
122
139
  ],
@@ -124,17 +141,24 @@
124
141
  {
125
142
  "path": "/get/devices",
126
143
  "method": "GET",
144
+ "pagination": {
145
+ "offsetVar": "",
146
+ "limitVar": "",
147
+ "incrementBy": "limit",
148
+ "requestLocation": "query"
149
+ },
127
150
  "query": {},
128
151
  "body": {},
129
152
  "headers": {},
130
153
  "handleFailure": "ignore",
131
154
  "requestFields": {},
155
+ "responseDatakey": "",
132
156
  "responseFields": {
133
157
  "name": "host",
134
158
  "ostype": "os",
135
159
  "ostypePrefix": "system-",
136
160
  "ipaddress": "attributes.ipaddr",
137
- "port": 443
161
+ "port": "443"
138
162
  }
139
163
  }
140
164
  ],
@@ -146,12 +170,13 @@
146
170
  "body": {},
147
171
  "headers": {},
148
172
  "handleFailure": "ignore",
149
- "statusValue": "online",
150
173
  "requestFields": {
151
174
  "id": "name"
152
175
  },
176
+ "responseDatakey": "",
153
177
  "responseFields": {
154
- "status": "status"
178
+ "status": "status",
179
+ "statusValue": "online"
155
180
  }
156
181
  }
157
182
  ],
@@ -166,6 +191,7 @@
166
191
  "requestFields": {
167
192
  "id": "name"
168
193
  },
194
+ "responseDatakey": "",
169
195
  "responseFields": {}
170
196
  }
171
197
  ],
@@ -176,7 +202,49 @@
176
202
  "query": {},
177
203
  "body": {},
178
204
  "headers": {},
179
- "handleFailure": "ignore"
205
+ "handleFailure": "ignore",
206
+ "requestFields": {},
207
+ "responseDatakey": "",
208
+ "responseFields": {}
209
+ }
210
+ ]
211
+ },
212
+ "cache": {
213
+ "enabled": false,
214
+ "entities": [
215
+ {
216
+ "entityType": "",
217
+ "frequency": 1440,
218
+ "flushOnFail": false,
219
+ "limit": 1000,
220
+ "retryAttempts": 5,
221
+ "sort": true,
222
+ "populate": [
223
+ {
224
+ "path": "",
225
+ "method": "GET",
226
+ "pagination": {
227
+ "offsetVar": "",
228
+ "limitVar": "",
229
+ "incrementBy": "limit",
230
+ "requestLocation": "query"
231
+ },
232
+ "query": {},
233
+ "body": {},
234
+ "headers": {},
235
+ "handleFailure": "ignore",
236
+ "requestFields": {},
237
+ "responseDatakey": "",
238
+ "responseFields": {}
239
+ }
240
+ ],
241
+ "cachedTasks": [
242
+ {
243
+ "name": "",
244
+ "filterField": "",
245
+ "filterLoc": ""
246
+ }
247
+ ]
180
248
  }
181
249
  ]
182
250
  }
@@ -7,9 +7,9 @@
7
7
  /* eslint import/no-dynamic-require: warn */
8
8
  /* eslint import/no-unresolved: warn */
9
9
 
10
- const mocha = require('mocha');
11
10
  const path = require('path');
12
11
  const assert = require('assert');
12
+ const mocha = require('mocha');
13
13
  const itParam = require('mocha-param');
14
14
 
15
15
  const utils = require('../../utils/tbUtils');
@@ -18,12 +18,10 @@ const { name } = require('../../package.json');
18
18
  const { methods } = require('../../pronghorn.json');
19
19
 
20
20
  const getPronghornProps = (iapDir) => {
21
- const { Discovery } = require('@itential/itential-utils');
22
21
  console.log('Retrieving properties.json file...');
23
22
  const rawProps = require(path.join(iapDir, 'properties.json'));
24
23
  console.log('Decrypting properties...');
25
- const discovery = new Discovery();
26
- const pronghornProps = utils.decryptProperties(rawProps, path.join(__dirname, '..'), discovery);
24
+ const pronghornProps = utils.decryptProperties(rawProps, iapDir);
27
25
  console.log('Found properties.\n');
28
26
  return pronghornProps;
29
27
  };
@@ -34,7 +32,7 @@ describe('[integration] Adapter BasicGET Test', () => {
34
32
  context('Testing GET calls without query parameters', () => {
35
33
  before(async () => {
36
34
  const iapDir = path.join(__dirname, '../../../../../');
37
- if (!utils.withinIAP(iapDir)) {
35
+ if (!utils.areWeUnderIAPinstallationDirectory()) {
38
36
  const sampleProperties = require('../../sampleProperties.json');
39
37
  const adapter = { properties: sampleProperties };
40
38
  a = basicGet.getAdapterInstance(adapter);
@@ -3,9 +3,12 @@
3
3
  /* global describe it context before after */
4
4
  /* eslint no-unused-vars: warn */
5
5
 
6
- const mocha = require('mocha');
7
6
  const assert = require('assert');
8
- const diagnostics = require('network-diagnostics');
7
+ const http = require('http');
8
+ const https = require('https');
9
+ const mocha = require('mocha');
10
+ const ping = require('ping');
11
+ const dnsLookup = require('dns-lookup-promise');
9
12
 
10
13
  let host;
11
14
  process.argv.forEach((val) => {
@@ -16,78 +19,124 @@ process.argv.forEach((val) => {
16
19
 
17
20
  describe('[integration] Adapter Test', () => {
18
21
  context(`Testing network connection on ${host}`, () => {
19
- before(() => {
20
- diagnostics.setTestURL(host);
21
- });
22
-
23
22
  after((done) => {
24
23
  done();
25
24
  });
26
25
 
27
26
  it('DNS resolve', (done) => {
28
- diagnostics.haveDNS((result) => {
29
- try {
30
- assert.equal(result, true);
31
- done();
32
- } catch (error) {
33
- done(error);
34
- }
35
- });
27
+ dnsLookup(host)
28
+ .then((addresses) => {
29
+ try {
30
+ assert.ok(addresses.length > 0);
31
+ done();
32
+ } catch (error) {
33
+ done(error);
34
+ }
35
+ })
36
+ .catch((err) => {
37
+ done(err);
38
+ });
36
39
  });
37
40
 
38
41
  it('Responds to ping', (done) => {
39
- diagnostics.havePing((result) => {
40
- try {
41
- assert.equal(result, true);
42
- done();
43
- } catch (error) {
44
- done(error);
45
- }
46
- });
42
+ ping.promise.probe(host)
43
+ .then((result) => {
44
+ try {
45
+ assert.ok(result.alive);
46
+ done();
47
+ } catch (error) {
48
+ done(error);
49
+ }
50
+ })
51
+ .catch((err) => {
52
+ done(err);
53
+ });
47
54
  });
48
55
 
49
56
  it('Support HTTP on port 80', (done) => {
50
- diagnostics.haveHTTP((result) => {
57
+ const requestOptions = {
58
+ host,
59
+ port: 80,
60
+ method: 'HEAD'
61
+ };
62
+
63
+ const req = http.request(requestOptions, (res) => {
51
64
  try {
52
- assert.equal(result, true);
65
+ assert.ok(res.statusCode >= 200 && res.statusCode < 400);
53
66
  done();
54
67
  } catch (error) {
55
68
  done(error);
56
69
  }
57
70
  });
71
+
72
+ req.on('error', (err) => {
73
+ done(err);
74
+ });
75
+
76
+ req.end();
58
77
  });
59
78
 
60
79
  it('Support HTTPS on port 443', (done) => {
61
- diagnostics.haveHTTPS((result) => {
80
+ const requestOptions = {
81
+ host,
82
+ port: 443,
83
+ method: 'HEAD'
84
+ };
85
+
86
+ const req = https.request(requestOptions, (res) => {
62
87
  try {
63
- assert.equal(result, true);
88
+ assert.ok(res.statusCode >= 200 && res.statusCode < 400);
64
89
  done();
65
90
  } catch (error) {
66
91
  done(error);
67
92
  }
68
93
  });
94
+
95
+ req.on('error', (err) => {
96
+ done(err);
97
+ });
98
+
99
+ req.end();
69
100
  });
70
101
 
71
102
  it('Support IPv4', (done) => {
72
- diagnostics.haveIPv4Async((result) => {
73
- try {
74
- assert.equal(result, true);
75
- done();
76
- } catch (error) {
77
- done(error);
78
- }
79
- });
103
+ const options = {
104
+ family: 4,
105
+ hints: dnsLookup.ADDRCONFIG
106
+ };
107
+
108
+ dnsLookup.lookup(host, options)
109
+ .then((address, family) => {
110
+ try {
111
+ assert.ok(address !== null && family === 4);
112
+ done();
113
+ } catch (error) {
114
+ done(error);
115
+ }
116
+ })
117
+ .catch((err) => {
118
+ done(err);
119
+ });
80
120
  });
81
121
 
82
122
  it('Support IPv6', (done) => {
83
- diagnostics.haveIPv6Async((result) => {
84
- try {
85
- assert.equal(result, true);
86
- done();
87
- } catch (error) {
88
- done(error);
89
- }
90
- });
123
+ const options = {
124
+ family: 6,
125
+ hints: dnsLookup.ADDRCONFIG
126
+ };
127
+
128
+ dnsLookup.lookup(host, options)
129
+ .then((address, family) => {
130
+ try {
131
+ assert.ok(address !== null && family === 6);
132
+ done();
133
+ } catch (error) {
134
+ done(error);
135
+ }
136
+ })
137
+ .catch((err) => {
138
+ done(err);
139
+ });
91
140
  });
92
141
  });
93
142
  });
@@ -4,38 +4,50 @@
4
4
  /* global describe it log pronghornProps */
5
5
  /* eslint no-unused-vars: warn */
6
6
  /* eslint no-underscore-dangle: warn */
7
+ /* eslint import/no-dynamic-require:warn */
7
8
 
8
9
  // include required items for testing & logging
9
10
  const assert = require('assert');
10
11
  const fs = require('fs');
11
- const mocha = require('mocha');
12
12
  const path = require('path');
13
+ const util = require('util');
14
+ const mocha = require('mocha');
13
15
  const winston = require('winston');
14
16
  const { expect } = require('chai');
15
17
  const { use } = require('chai');
16
18
  const td = require('testdouble');
17
- const util = require('util');
18
- const pronghorn = require('../../pronghorn.json');
19
19
 
20
- pronghorn.methodsByName = pronghorn.methods.reduce((result, meth) => ({ ...result, [meth.name]: meth }), {});
21
20
  const anything = td.matchers.anything();
22
21
 
23
22
  // stub and attemptTimeout are used throughout the code so set them here
24
23
  let logLevel = 'none';
25
- const stub = true;
26
24
  const isRapidFail = false;
27
25
  const isSaveMockData = false;
28
- const attemptTimeout = 5000;
26
+
27
+ // read in the properties from the sampleProperties files
28
+ let adaptdir = __dirname;
29
+ if (adaptdir.endsWith('/test/integration')) {
30
+ adaptdir = adaptdir.substring(0, adaptdir.length - 17);
31
+ } else if (adaptdir.endsWith('/test/unit')) {
32
+ adaptdir = adaptdir.substring(0, adaptdir.length - 10);
33
+ }
34
+ const samProps = require(`${adaptdir}/sampleProperties.json`).properties;
29
35
 
30
36
  // these variables can be changed to run in integrated mode so easier to set them here
31
37
  // always check these in with bogus data!!!
32
- const host = 'replace.hostorip.here';
33
- const username = 'username';
34
- const password = 'password';
35
- const protocol = 'http';
36
- const port = 80;
37
- const sslenable = false;
38
- const sslinvalid = false;
38
+ samProps.stub = true;
39
+ samProps.host = 'replace.hostorip.here';
40
+ samProps.authentication.username = 'username';
41
+ samProps.authentication.password = 'password';
42
+ samProps.protocol = 'http';
43
+ samProps.port = 80;
44
+ samProps.ssl.enabled = false;
45
+ samProps.ssl.accept_invalid_cert = false;
46
+ if (samProps.request.attempt_timeout < 30000) {
47
+ samProps.request.attempt_timeout = 30000;
48
+ }
49
+ const attemptTimeout = samProps.request.attempt_timeout;
50
+ const { stub } = samProps;
39
51
 
40
52
  // these are the adapter properties. You generally should not need to alter
41
53
  // any of these after they are initially set up
@@ -47,103 +59,7 @@ global.pronghornProps = {
47
59
  adapters: [{
48
60
  id: 'Test-nokia_altiplano',
49
61
  type: 'NokiaAltiplano',
50
- properties: {
51
- host,
52
- port,
53
- base_path: '/rest',
54
- version: '',
55
- cache_location: 'none',
56
- encode_pathvars: true,
57
- encode_queryvars: true,
58
- save_metric: false,
59
- stub,
60
- protocol,
61
- authentication: {
62
- auth_method: 'request_token',
63
- username,
64
- password,
65
- token: '',
66
- invalid_token_error: 401,
67
- token_timeout: 1800000,
68
- token_cache: 'local',
69
- auth_field: 'header.headers.Authorization',
70
- auth_field_format: '{token}',
71
- auth_logging: false,
72
- client_id: '',
73
- client_secret: '',
74
- grant_type: ''
75
- },
76
- healthcheck: {
77
- type: 'none',
78
- frequency: 60000,
79
- query_object: {}
80
- },
81
- throttle: {
82
- throttle_enabled: false,
83
- number_pronghorns: 1,
84
- sync_async: 'sync',
85
- max_in_queue: 1000,
86
- concurrent_max: 1,
87
- expire_timeout: 0,
88
- avg_runtime: 200,
89
- priorities: [
90
- {
91
- value: 0,
92
- percent: 100
93
- }
94
- ]
95
- },
96
- request: {
97
- number_redirects: 0,
98
- number_retries: 3,
99
- limit_retry_error: [0],
100
- failover_codes: [],
101
- attempt_timeout: attemptTimeout,
102
- global_request: {
103
- payload: {},
104
- uriOptions: {},
105
- addlHeaders: {},
106
- authData: {}
107
- },
108
- healthcheck_on_timeout: true,
109
- return_raw: true,
110
- archiving: false,
111
- return_request: false
112
- },
113
- proxy: {
114
- enabled: false,
115
- host: '',
116
- port: 1,
117
- protocol: 'http',
118
- username: '',
119
- password: ''
120
- },
121
- ssl: {
122
- ecdhCurve: '',
123
- enabled: sslenable,
124
- accept_invalid_cert: sslinvalid,
125
- ca_file: '',
126
- key_file: '',
127
- cert_file: '',
128
- secure_protocol: '',
129
- ciphers: ''
130
- },
131
- mongo: {
132
- host: '',
133
- port: 0,
134
- database: '',
135
- username: '',
136
- password: '',
137
- replSet: '',
138
- db_ssl: {
139
- enabled: false,
140
- accept_invalid_cert: false,
141
- ca_file: '',
142
- key_file: '',
143
- cert_file: ''
144
- }
145
- }
146
- }
62
+ properties: samProps
147
63
  }]
148
64
  }
149
65
  };
@@ -419,6 +335,134 @@ describe('[integration] Nokia_altiplano Adapter Test', () => {
419
335
  }).timeout(attemptTimeout);
420
336
  });
421
337
 
338
+ // broker tests
339
+ describe('#getDevicesFiltered - errors', () => {
340
+ it('should work if integrated but since no mockdata should error when run standalone', (done) => {
341
+ try {
342
+ const opts = {
343
+ filter: {
344
+ name: 'deviceName'
345
+ }
346
+ };
347
+ a.getDevicesFiltered(opts, (data, error) => {
348
+ try {
349
+ if (stub) {
350
+ if (samProps.devicebroker.getDevicesFiltered[0].handleFailure === 'ignore') {
351
+ assert.equal(null, error);
352
+ assert.notEqual(undefined, data);
353
+ assert.notEqual(null, data);
354
+ assert.equal(0, data.total);
355
+ assert.equal(0, data.list.length);
356
+ } else {
357
+ const displayE = 'Error 400 received on request';
358
+ runErrorAsserts(data, error, 'AD.500', 'Test-nokia_altiplano-connectorRest-handleEndResponse', displayE);
359
+ }
360
+ } else {
361
+ runCommonAsserts(data, error);
362
+ }
363
+ done();
364
+ } catch (err) {
365
+ log.error(`Test Failure: ${err}`);
366
+ done(err);
367
+ }
368
+ });
369
+ } catch (error) {
370
+ log.error(`Adapter Exception: ${error}`);
371
+ done(error);
372
+ }
373
+ }).timeout(attemptTimeout);
374
+ });
375
+
376
+ describe('#iapGetDeviceCount - errors', () => {
377
+ it('should work if integrated but since no mockdata should error when run standalone', (done) => {
378
+ try {
379
+ const opts = {
380
+ filter: {
381
+ name: 'deviceName'
382
+ }
383
+ };
384
+ a.iapGetDeviceCount((data, error) => {
385
+ try {
386
+ if (stub) {
387
+ if (samProps.devicebroker.getDevicesFiltered[0].handleFailure === 'ignore') {
388
+ assert.equal(null, error);
389
+ assert.notEqual(undefined, data);
390
+ assert.notEqual(null, data);
391
+ assert.equal(0, data.count);
392
+ } else {
393
+ const displayE = 'Error 400 received on request';
394
+ runErrorAsserts(data, error, 'AD.500', 'Test-nokia_altiplano-connectorRest-handleEndResponse', displayE);
395
+ }
396
+ } else {
397
+ runCommonAsserts(data, error);
398
+ }
399
+ done();
400
+ } catch (err) {
401
+ log.error(`Test Failure: ${err}`);
402
+ done(err);
403
+ }
404
+ });
405
+ } catch (error) {
406
+ log.error(`Adapter Exception: ${error}`);
407
+ done(error);
408
+ }
409
+ }).timeout(attemptTimeout);
410
+ });
411
+
412
+ // exposed cache tests
413
+ describe('#iapPopulateEntityCache - errors', () => {
414
+ it('should work if integrated but since no mockdata should error when run standalone', (done) => {
415
+ try {
416
+ a.iapPopulateEntityCache('Device', (data, error) => {
417
+ try {
418
+ if (stub) {
419
+ assert.equal(null, data);
420
+ assert.notEqual(undefined, error);
421
+ assert.notEqual(null, error);
422
+ done();
423
+ } else {
424
+ assert.equal(undefined, error);
425
+ assert.equal('success', data[0]);
426
+ done();
427
+ }
428
+ } catch (err) {
429
+ log.error(`Test Failure: ${err}`);
430
+ done(err);
431
+ }
432
+ });
433
+ } catch (error) {
434
+ log.error(`Adapter Exception: ${error}`);
435
+ done(error);
436
+ }
437
+ }).timeout(attemptTimeout);
438
+ });
439
+
440
+ describe('#iapRetrieveEntitiesCache - errors', () => {
441
+ it('should work if integrated but since no mockdata should error when run standalone', (done) => {
442
+ try {
443
+ a.iapRetrieveEntitiesCache('Device', {}, (data, error) => {
444
+ try {
445
+ if (stub) {
446
+ assert.equal(null, data);
447
+ assert.notEqual(null, error);
448
+ assert.notEqual(undefined, error);
449
+ } else {
450
+ assert.equal(undefined, error);
451
+ assert.notEqual(null, data);
452
+ assert.notEqual(undefined, data);
453
+ }
454
+ done();
455
+ } catch (err) {
456
+ log.error(`Test Failure: ${err}`);
457
+ done(err);
458
+ }
459
+ });
460
+ } catch (error) {
461
+ log.error(`Adapter Exception: ${error}`);
462
+ done(error);
463
+ }
464
+ }).timeout(attemptTimeout);
465
+ });
422
466
  /*
423
467
  -----------------------------------------------------------------------
424
468
  -----------------------------------------------------------------------