@itentialopensource/adapter-winston_syslog 1.0.1 → 1.1.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 (47) hide show
  1. package/BROKER.md +199 -0
  2. package/CALLS.md +162 -0
  3. package/CHANGELOG.md +8 -1
  4. package/CODE_OF_CONDUCT.md +43 -0
  5. package/CONTRIBUTING.md +13 -0
  6. package/ENHANCE.md +69 -0
  7. package/LICENSE +1 -1
  8. package/PROPERTIES.md +641 -0
  9. package/README.md +89 -28
  10. package/SUMMARY.md +9 -0
  11. package/TROUBLESHOOT.md +47 -0
  12. package/adapter.js +566 -0
  13. package/adapterBase.js +549 -879
  14. package/changelogs/CHANGELOG.md +9 -0
  15. package/metadata.json +49 -0
  16. package/package.json +26 -25
  17. package/pronghorn.json +981 -0
  18. package/propertiesSchema.json +506 -51
  19. package/refs?service=git-upload-pack +0 -0
  20. package/report/adapterInfo.json +8 -8
  21. package/report/updateReport1691508888201.json +120 -0
  22. package/report/updateReport1692202203193.json +120 -0
  23. package/report/updateReport1692203305042.json +120 -0
  24. package/report/updateReport1694469210573.json +120 -0
  25. package/report/updateReport1698422912292.json +120 -0
  26. package/sampleProperties.json +210 -12
  27. package/test/integration/adapterTestBasicGet.js +83 -0
  28. package/test/integration/adapterTestConnectivity.js +142 -0
  29. package/test/integration/adapterTestIntegration.js +180 -15
  30. package/test/unit/adapterBaseTestUnit.js +388 -313
  31. package/test/unit/adapterTestUnit.js +465 -106
  32. package/utils/adapterInfo.js +1 -1
  33. package/utils/addAuth.js +1 -1
  34. package/utils/artifactize.js +1 -1
  35. package/utils/checkMigrate.js +1 -1
  36. package/utils/entitiesToDB.js +2 -2
  37. package/utils/findPath.js +1 -1
  38. package/utils/methodDocumentor.js +273 -0
  39. package/utils/modify.js +13 -15
  40. package/utils/packModificationScript.js +1 -1
  41. package/utils/pre-commit.sh +2 -0
  42. package/utils/taskMover.js +309 -0
  43. package/utils/tbScript.js +89 -34
  44. package/utils/tbUtils.js +41 -21
  45. package/utils/testRunner.js +1 -1
  46. package/utils/troubleshootingAdapter.js +9 -6
  47. package/workflows/README.md +0 -3
@@ -1,5 +1,5 @@
1
1
  {
2
- "id": "syslog",
2
+ "id": "Adapter-winston_syslog",
3
3
  "type": "WinstonSyslog",
4
4
  "properties": {
5
5
  "host": "rsyslog",
@@ -16,22 +16,54 @@
16
16
  "minLogLevel": "debug",
17
17
  "type": "BSD",
18
18
  "authentication": {
19
- "auth_method": "no_authentication"
19
+ "auth_method": "no_authentication",
20
+ "username": "",
21
+ "password": "",
22
+ "token": "",
23
+ "token_timeout": 600000,
24
+ "token_cache": "local",
25
+ "invalid_token_error": 401,
26
+ "auth_field": "",
27
+ "auth_field_format": "",
28
+ "auth_logging": false,
29
+ "client_id": "",
30
+ "client_secret": "",
31
+ "grant_type": "",
32
+ "sensitive": [],
33
+ "sso": {
34
+ "protocol": "",
35
+ "host": "",
36
+ "port": 0
37
+ },
38
+ "multiStepAuthCalls": [
39
+ {
40
+ "name": "",
41
+ "requestFields": {},
42
+ "responseFields": {},
43
+ "successfullResponseCode": 200
44
+ }
45
+ ]
20
46
  },
21
47
  "healthcheck": {
22
48
  "type": "none",
23
49
  "frequency": 60000,
24
- "query_object": {}
50
+ "query_object": {},
51
+ "addlHeaders": {}
25
52
  },
26
- "ssl": {
27
- "ecdhCurve": "",
28
- "enabled": false,
29
- "accept_invalid_cert": false,
30
- "ca_file": "",
31
- "key_file": "",
32
- "cert_file": "",
33
- "secure_protocol": "",
34
- "ciphers": ""
53
+ "throttle": {
54
+ "throttle_enabled": false,
55
+ "number_pronghorns": 1,
56
+ "sync_async": "sync",
57
+ "max_in_queue": 1000,
58
+ "concurrent_max": 1,
59
+ "expire_timeout": 0,
60
+ "avg_runtime": 200,
61
+ "priorities": [
62
+ {
63
+ "value": 0,
64
+ "percent": 100
65
+ }
66
+ ]
35
67
  },
36
68
  "request": {
37
69
  "number_redirects": 0,
@@ -51,6 +83,172 @@
51
83
  "return_raw": false,
52
84
  "archiving": false,
53
85
  "return_request": false
86
+ },
87
+ "proxy": {
88
+ "enabled": false,
89
+ "host": "",
90
+ "port": 1,
91
+ "protocol": "http",
92
+ "username": "",
93
+ "password": ""
94
+ },
95
+ "ssl": {
96
+ "ecdhCurve": "",
97
+ "enabled": false,
98
+ "accept_invalid_cert": false,
99
+ "ca_file": "",
100
+ "key_file": "",
101
+ "cert_file": "",
102
+ "secure_protocol": "",
103
+ "ciphers": ""
104
+ },
105
+ "mongo": {
106
+ "host": "",
107
+ "port": 0,
108
+ "database": "",
109
+ "username": "",
110
+ "password": "",
111
+ "replSet": "",
112
+ "db_ssl": {
113
+ "enabled": false,
114
+ "accept_invalid_cert": false,
115
+ "ca_file": "",
116
+ "key_file": "",
117
+ "cert_file": ""
118
+ }
119
+ },
120
+ "devicebroker": {
121
+ "getDevice": [
122
+ {
123
+ "path": "/get/devices/{id}",
124
+ "method": "GET",
125
+ "query": {},
126
+ "body": {},
127
+ "headers": {},
128
+ "handleFailure": "ignore",
129
+ "requestFields": {
130
+ "id": "name"
131
+ },
132
+ "responseDatakey": "",
133
+ "responseFields": {
134
+ "name": "host",
135
+ "ostype": "os",
136
+ "ostypePrefix": "system-",
137
+ "ipaddress": "attributes.ipaddr",
138
+ "port": "443"
139
+ }
140
+ }
141
+ ],
142
+ "getDevicesFiltered": [
143
+ {
144
+ "path": "/get/devices",
145
+ "method": "GET",
146
+ "pagination": {
147
+ "offsetVar": "",
148
+ "limitVar": "",
149
+ "incrementBy": "limit",
150
+ "requestLocation": "query"
151
+ },
152
+ "query": {},
153
+ "body": {},
154
+ "headers": {},
155
+ "handleFailure": "ignore",
156
+ "requestFields": {},
157
+ "responseDatakey": "",
158
+ "responseFields": {
159
+ "name": "host",
160
+ "ostype": "os",
161
+ "ostypePrefix": "system-",
162
+ "ipaddress": "attributes.ipaddr",
163
+ "port": "443"
164
+ }
165
+ }
166
+ ],
167
+ "isAlive": [
168
+ {
169
+ "path": "/get/devices/{id}/status",
170
+ "method": "GET",
171
+ "query": {},
172
+ "body": {},
173
+ "headers": {},
174
+ "handleFailure": "ignore",
175
+ "requestFields": {
176
+ "id": "name"
177
+ },
178
+ "responseDatakey": "",
179
+ "responseFields": {
180
+ "status": "status",
181
+ "statusValue": "online"
182
+ }
183
+ }
184
+ ],
185
+ "getConfig": [
186
+ {
187
+ "path": "/get/devices/{id}/configPart1",
188
+ "method": "GET",
189
+ "query": {},
190
+ "body": {},
191
+ "headers": {},
192
+ "handleFailure": "ignore",
193
+ "requestFields": {
194
+ "id": "name"
195
+ },
196
+ "responseDatakey": "",
197
+ "responseFields": {}
198
+ }
199
+ ],
200
+ "getCount": [
201
+ {
202
+ "path": "/get/devices",
203
+ "method": "GET",
204
+ "query": {},
205
+ "body": {},
206
+ "headers": {},
207
+ "handleFailure": "ignore",
208
+ "requestFields": {},
209
+ "responseDatakey": "",
210
+ "responseFields": {}
211
+ }
212
+ ]
213
+ },
214
+ "cache": {
215
+ "enabled": false,
216
+ "entities": [
217
+ {
218
+ "entityType": "",
219
+ "frequency": 1440,
220
+ "flushOnFail": false,
221
+ "limit": 1000,
222
+ "retryAttempts": 5,
223
+ "sort": true,
224
+ "populate": [
225
+ {
226
+ "path": "",
227
+ "method": "GET",
228
+ "pagination": {
229
+ "offsetVar": "",
230
+ "limitVar": "",
231
+ "incrementBy": "limit",
232
+ "requestLocation": "query"
233
+ },
234
+ "query": {},
235
+ "body": {},
236
+ "headers": {},
237
+ "handleFailure": "ignore",
238
+ "requestFields": {},
239
+ "responseDatakey": "",
240
+ "responseFields": {}
241
+ }
242
+ ],
243
+ "cachedTasks": [
244
+ {
245
+ "name": "",
246
+ "filterField": "",
247
+ "filterLoc": ""
248
+ }
249
+ ]
250
+ }
251
+ ]
54
252
  }
55
253
  },
56
254
  "groups": [],
@@ -0,0 +1,83 @@
1
+ /* @copyright Itential, LLC 2020 */
2
+
3
+ /* global describe context before after */
4
+ /* eslint global-require: warn */
5
+ /* eslint no-unused-vars: warn */
6
+ /* eslint import/no-extraneous-dependencies: warn */
7
+ /* eslint import/no-dynamic-require: warn */
8
+ /* eslint import/no-unresolved: warn */
9
+
10
+ const path = require('path');
11
+ const assert = require('assert');
12
+ const mocha = require('mocha');
13
+ const itParam = require('mocha-param');
14
+
15
+ const utils = require('../../utils/tbUtils');
16
+ const basicGet = require('../../utils/basicGet');
17
+ const { name } = require('../../package.json');
18
+ const { methods } = require('../../pronghorn.json');
19
+
20
+ const getPronghornProps = (iapDir) => {
21
+ console.log('Retrieving properties.json file...');
22
+ const rawProps = require(path.join(iapDir, 'properties.json'));
23
+ console.log('Decrypting properties...');
24
+ const pronghornProps = utils.decryptProperties(rawProps, iapDir);
25
+ console.log('Found properties.\n');
26
+ return pronghornProps;
27
+ };
28
+
29
+ let a;
30
+
31
+ describe('[integration] Adapter BasicGET Test', () => {
32
+ context('Testing GET calls without query parameters', () => {
33
+ before(async () => {
34
+ const iapDir = path.join(__dirname, '../../../../../');
35
+ if (!utils.areWeUnderIAPinstallationDirectory()) {
36
+ const sampleProperties = require('../../sampleProperties.json');
37
+ const adapter = { properties: sampleProperties };
38
+ a = basicGet.getAdapterInstance(adapter);
39
+ } else {
40
+ const pronghornProps = getPronghornProps(iapDir);
41
+ console.log('Connecting to Database...');
42
+ const database = await basicGet.connect(pronghornProps);
43
+ console.log('Connection established.');
44
+ const adapter = await database.collection(utils.SERVICE_CONFIGS_COLLECTION).findOne(
45
+ { model: name }
46
+ );
47
+ a = basicGet.getAdapterInstance(adapter);
48
+ }
49
+ });
50
+
51
+ after((done) => {
52
+ done();
53
+ });
54
+
55
+ const basicGets = methods.filter((method) => (method.route.verb === 'GET' && method.input.length === 0));
56
+ if (basicGets.length === 0) {
57
+ console.log('No non-parameter GET calls found.');
58
+ process.exit(0);
59
+ }
60
+ const functionNames = basicGets.map((g) => g.name);
61
+ const request = function request(f, ad) {
62
+ return new Promise((resolve, reject) => {
63
+ const getRespCode = (resp) => {
64
+ if (resp) {
65
+ if (resp.metrics.code !== 200) {
66
+ console.log('\x1b[31m', `Testing ${f} \nResponseCode: ${resp.metrics.code}`);
67
+ }
68
+ resolve(resp.metrics.code);
69
+ } else {
70
+ console.log('\x1b[31m', `call ${f} results in failure`);
71
+ reject(new Error(`${f} failed`));
72
+ }
73
+ };
74
+ ad[f](getRespCode, console.log);
75
+ });
76
+ };
77
+
78
+ itParam('GET call should return 200', functionNames, (fname) => {
79
+ console.log(`\t ${fname}`);
80
+ return request(fname, a).then((result) => assert.equal(result, 200));
81
+ });
82
+ });
83
+ });
@@ -0,0 +1,142 @@
1
+ /* @copyright Itential, LLC 2020 */
2
+
3
+ /* global describe it context before after */
4
+ /* eslint no-unused-vars: warn */
5
+
6
+ const assert = require('assert');
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');
12
+
13
+ let host;
14
+ process.argv.forEach((val) => {
15
+ if (val.indexOf('--HOST') === 0) {
16
+ [, host] = val.split('=');
17
+ }
18
+ });
19
+
20
+ describe('[integration] Adapter Test', () => {
21
+ context(`Testing network connection on ${host}`, () => {
22
+ after((done) => {
23
+ done();
24
+ });
25
+
26
+ it('DNS resolve', (done) => {
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
+ });
39
+ });
40
+
41
+ it('Responds to ping', (done) => {
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
+ });
54
+ });
55
+
56
+ it('Support HTTP on port 80', (done) => {
57
+ const requestOptions = {
58
+ host,
59
+ port: 80,
60
+ method: 'HEAD'
61
+ };
62
+
63
+ const req = http.request(requestOptions, (res) => {
64
+ try {
65
+ assert.ok(res.statusCode >= 200 && res.statusCode < 400);
66
+ done();
67
+ } catch (error) {
68
+ done(error);
69
+ }
70
+ });
71
+
72
+ req.on('error', (err) => {
73
+ done(err);
74
+ });
75
+
76
+ req.end();
77
+ });
78
+
79
+ it('Support HTTPS on port 443', (done) => {
80
+ const requestOptions = {
81
+ host,
82
+ port: 443,
83
+ method: 'HEAD'
84
+ };
85
+
86
+ const req = https.request(requestOptions, (res) => {
87
+ try {
88
+ assert.ok(res.statusCode >= 200 && res.statusCode < 400);
89
+ done();
90
+ } catch (error) {
91
+ done(error);
92
+ }
93
+ });
94
+
95
+ req.on('error', (err) => {
96
+ done(err);
97
+ });
98
+
99
+ req.end();
100
+ });
101
+
102
+ it('Support IPv4', (done) => {
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
+ });
120
+ });
121
+
122
+ it('Support IPv6', (done) => {
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
+ });
140
+ });
141
+ });
142
+ });