tenable-ruby 0.3.1 → 0.3.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (3) hide show
  1. checksums.yaml +4 -4
  2. data/lib/tenable-ruby.rb +45 -46
  3. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: f85505c10cdfc20f73c9c3206b6f98bb542be031
4
- data.tar.gz: aa55193ae8ec7bd0093e920c964a9de427f9a7db
3
+ metadata.gz: 5f2e3e353e286812317bb2f0d1837d1b1ac363ff
4
+ data.tar.gz: 336caa8a143f5e107c180d4ebc92632c2b037988
5
5
  SHA512:
6
- metadata.gz: b0cb391e04eba5f1bc14ef2d008dc56782371204373134479f5b4557f80569bcfcd10d7afe7495f23be1cc92132ae1f902e9ad197adfbb7c637ac42a43dd8a3d
7
- data.tar.gz: aa21fee4bc24e24dcc3a86cb07c98b74dc7fd6576e1cd1a32adf75e5f36cf8045a47130d412e91a61e44e894587228917dcaca12eafadec66b17f349a8a012f5
6
+ metadata.gz: 0d266ca215327a5c9b11fb2ad0d677455813f0e415af909306d5fae9640b4f2d480380b970a01cd309ae47294530df8711cfd2477d7dcd85dd86dee7b46e3618
7
+ data.tar.gz: 4dbb9564288833ef473988b313130a7cd9466863a9122c47023efe2a0e94d91db3a58c090981e7b25ca4960da9fc51295ab0116a6dd13d09000bb6bb01a8e84d
@@ -109,7 +109,7 @@ module TenableRuby
109
109
  # Returns the server version and other properties
110
110
  #
111
111
  # Reference:
112
- # https://cloud.tenable.com/api#/resources/server/properties
112
+ # https://developer.tenable.com/reference#server-properties
113
113
  def get_server_properties
114
114
  http_get(:uri => "/server/properties", :fields => header)
115
115
  end
@@ -117,7 +117,7 @@ module TenableRuby
117
117
  # Creates a new user
118
118
  #
119
119
  # Reference:
120
- # https://cloud.tenable.com/api#/resources/users/create
120
+ # https://developer.tenable.com/reference#users-create
121
121
  def user_add(username, password, permissions, type)
122
122
  payload = {
123
123
  :username => username,
@@ -132,7 +132,7 @@ module TenableRuby
132
132
  # Deletes a user
133
133
  #
134
134
  # Reference:
135
- # https://cloud.tenable.com/api#/resources/users/delete
135
+ # https://developer.tenable.com/reference#users-delete
136
136
  def user_delete(user_id)
137
137
  response = http_delete(:uri => "/users/#{user_id}", :fields => header)
138
138
  response.code
@@ -141,7 +141,7 @@ module TenableRuby
141
141
  # Changes the password for the given user
142
142
  #
143
143
  # Reference:
144
- # https://cloud.tenable.com/api#/resources/users/password
144
+ # https://developer.tenable.com/reference#users-password
145
145
  def user_chpasswd(user_id, password)
146
146
  payload = {
147
147
  :password => password,
@@ -154,7 +154,7 @@ module TenableRuby
154
154
  # Logs the current user out and destroys the session
155
155
  #
156
156
  # Reference:
157
- # https://cloud.tenable.com/api#/resources/session/destroy
157
+ # https://developer.tenable.com/reference#session-destroy
158
158
  def user_logout
159
159
  response = http_delete(:uri => "/session", :fields => header)
160
160
  response.code
@@ -163,7 +163,7 @@ module TenableRuby
163
163
  # Returns the policy list
164
164
  #
165
165
  # Reference:
166
- # https://cloud.tenable.com/api#/resources/policies/list
166
+ # https://developer.tenable.com/reference#policies-list
167
167
  def list_policies
168
168
  http_get(:uri => "/policies", :fields => header)
169
169
  end
@@ -171,15 +171,15 @@ module TenableRuby
171
171
  # Returns the user list
172
172
  #
173
173
  # Reference:
174
- # https://cloud.tenable.com/api#/resources/users/list
174
+ # https://developer.tenable.com/reference#users-list
175
175
  def list_users
176
176
  http_get(:uri => "/users", :fields => header)
177
177
  end
178
178
 
179
179
  # Returns the current user's scan folders
180
180
  #
181
- # Reference:
182
- # https://cloud.tenable.com/api#/resources/folders/list
181
+ # Reference: #
182
+ # https://developer.tenable.com/reference#folders-list
183
183
  def list_folders
184
184
  http_get(:uri => "/folders", :fields => header)
185
185
  end
@@ -187,7 +187,7 @@ module TenableRuby
187
187
  # Returns the scanner list
188
188
  #
189
189
  # Reference:
190
- # https://cloud.tenable.com/api#/resources/scanners/list
190
+ # https://developer.tenable.com/reference#scanners-list
191
191
  def list_scanners
192
192
  http_get(:uri => "/scanners", :fields => header)
193
193
  end
@@ -195,7 +195,7 @@ module TenableRuby
195
195
  # Returns the list of plugin families
196
196
  #
197
197
  # Reference:
198
- # https://cloud.tenable.com/api#/resources/plugins/families
198
+ # https://developer.tenable.com/reference#plugins-families
199
199
  def list_families
200
200
  http_get(:uri => "/plugins/families", :fields => header)
201
201
  end
@@ -203,7 +203,7 @@ module TenableRuby
203
203
  # Returns the list of plugins in a family
204
204
  #
205
205
  # Reference:
206
- # https://cloud.tenable.com/api#/resources/plugins/family-details
206
+ # https://developer.tenable.com/reference#plugins-family-details
207
207
  def list_plugins(family_id)
208
208
  http_get(:uri => "/plugins/families/#{family_id}", :fields => header)
209
209
  end
@@ -211,7 +211,7 @@ module TenableRuby
211
211
  # Returns the template list
212
212
  #
213
213
  # Reference:
214
- # https://cloud.tenable.com/api#/resources/editor/list
214
+ # https://developer.tenable.com/reference#editor-list-templates
215
215
  def list_templates(type)
216
216
  http_get(:uri => "/editor/#{type}/templates", :fields => header)
217
217
  end
@@ -219,7 +219,7 @@ module TenableRuby
219
219
  # Returns details for the given template
220
220
  #
221
221
  # Reference:
222
- # https://cloud.tenable.com/api#/resources/editor/template-details
222
+ # https://developer.tenable.com/reference#editor-template-details
223
223
  def editor_templates (type, uuid)
224
224
  http_get(:uri => "/editor/#{type}/templates/#{uuid}", :fields => header)
225
225
  end
@@ -227,7 +227,7 @@ module TenableRuby
227
227
  # Returns details for a given plugin
228
228
  #
229
229
  # Reference:
230
- # https://cloud.tenable.com/api#/resources/plugins/plugin-details
230
+ # https://developer.tenable.com/reference#plugins-plugin-details
231
231
  def plugin_details(plugin_id)
232
232
  http_get(:uri => "/plugins/plugin/#{plugin_id}", :fields => header)
233
233
  end
@@ -235,7 +235,7 @@ module TenableRuby
235
235
  # Returns the server status
236
236
  #
237
237
  # Reference:
238
- # https://cloud.tenable.com/api#/resources/server/status
238
+ # https://developer.tenable.com/reference#server-status
239
239
  def server_status
240
240
  http_get(:uri => "/server/status", :fields => header)
241
241
  end
@@ -288,7 +288,7 @@ module TenableRuby
288
288
  # Creates a scan
289
289
  #
290
290
  # Reference:
291
- # https://cloud.tenable.com/api#/resources/scans/create
291
+ # https://developer.tenable.com/reference#scans-create
292
292
  def scan_create(uuid, settings)
293
293
  payload = {
294
294
  :uuid => uuid,
@@ -301,7 +301,7 @@ module TenableRuby
301
301
  # Launches a scan
302
302
  #
303
303
  # Reference:
304
- # https://cloud.tenable.com/api#/resources/scans/launch
304
+ # https://developer.tenable.com/reference#scans-launch
305
305
  def scan_launch(scan_id)
306
306
  http_post(:uri => "/scans/#{scan_id}/launch", :fields => header)
307
307
  end
@@ -309,7 +309,7 @@ module TenableRuby
309
309
  # Get List of Scans
310
310
  #
311
311
  # Reference:
312
- # https://cloud.tenable.com/api#/resources/scans/list
312
+ # https://developer.tenable.com/reference#scans-list
313
313
  def scan_list
314
314
  http_get(:uri => "/scans", :fields => header)
315
315
  end
@@ -317,7 +317,7 @@ module TenableRuby
317
317
  # Returns details for the given scan
318
318
  #
319
319
  # Reference:
320
- # https://cloud.tenable.com/api#/resources/scans/details
320
+ # https://developer.tenable.com/reference#scans-details
321
321
  def scan_details(scan_id)
322
322
  http_get(:uri => "/scans/#{scan_id}", :fields => header)
323
323
  end
@@ -325,7 +325,7 @@ module TenableRuby
325
325
  # Pauses a scan
326
326
  #
327
327
  # Reference:
328
- # https://cloud.tenable.com/api#/resources/scans/pause
328
+ # https://developer.tenable.com/reference#scans-pause
329
329
  def scan_pause(scan_id)
330
330
  http_post(:uri => "/scans/#{scan_id}/pause", :fields => header)
331
331
  end
@@ -333,7 +333,7 @@ module TenableRuby
333
333
  # Resumes a scan
334
334
  #
335
335
  # Reference:
336
- # https://cloud.tenable.com/api#/resources/scans/resume
336
+ # https://developer.tenable.com/reference#scans-resume
337
337
  def scan_resume(scan_id)
338
338
  http_post(:uri => "/scans/#{scan_id}/resume", :fields => header)
339
339
  end
@@ -341,7 +341,7 @@ module TenableRuby
341
341
  # Stops a scan
342
342
  #
343
343
  # Reference:
344
- # https://cloud.tenable.com/api#/resources/scans/stop
344
+ # https://developer.tenable.com/reference#scans-stop
345
345
  def scan_stop(scan_id)
346
346
  http_post(:uri => "/scans/#{scan_id}/stop", :fields => header)
347
347
  end
@@ -350,7 +350,7 @@ module TenableRuby
350
350
  # upon receiving a "ready" status from the export status method.
351
351
  #
352
352
  # Reference:
353
- # https://cloud.tenable.com/api#/resources/scans/export-request
353
+ # https://developer.tenable.com/reference#scans-export-request
354
354
  def scan_export(scan_id, format)
355
355
  payload = {
356
356
  :format => format
@@ -363,7 +363,7 @@ module TenableRuby
363
363
  # using the export download endpoint.
364
364
  #
365
365
  # Reference:
366
- # https://cloud.tenable.com/api#/resources/scans/export-status
366
+ # https://developer.tenable.com/reference#scans-export-status
367
367
  def scan_export_status(scan_id, file_id)
368
368
  http_get(:uri => "/scans/#{scan_id}/export/#{file_id}/status", :fields => header)
369
369
  end
@@ -371,16 +371,15 @@ module TenableRuby
371
371
  # Deletes a scan. NOTE: Scans in running, paused or stopping states can not be deleted.
372
372
  #
373
373
  # Reference:
374
- # https://cloud.tenable.com/api#/resources/scans/delete
374
+ # https://developer.tenable.com/reference#scans-delete
375
375
  def scan_delete(scan_id)
376
- response = http_delete(:uri => "/scans/#{scan_id}", :fields => header)
377
- return response.code == 200
376
+ http_delete(:uri => "/scans/#{scan_id}", :fields => header)
378
377
  end
379
378
 
380
379
  # Returns details for the given host
381
380
  #
382
381
  # Reference:
383
- # https://cloud.tenable.com/api#/resources/scans/host-details
382
+ # https://developer.tenable.com/reference#scans-host-details
384
383
  def host_details(scan_id, host_id, history_id: nil)
385
384
  uri = "/scans/#{scan_id}/hosts/#{host_id}"
386
385
  unless history_id.nil?
@@ -392,7 +391,7 @@ module TenableRuby
392
391
  # Download an exported scan
393
392
  #
394
393
  # Reference:
395
- # https://cloud.tenable.com/api#/resources/scans/export-download
394
+ # https://developer.tenable.com/reference#scans-export-download
396
395
  def report_download(scan_id, file_id)
397
396
  http_get(:uri => "/scans/#{scan_id}/export/#{file_id}/download", :raw_content => true, :fields => header)
398
397
  end
@@ -400,7 +399,7 @@ module TenableRuby
400
399
  # Returns details for the given policy
401
400
  #
402
401
  # Reference:
403
- # https://cloud.tenable.com/api#/resources/scans/host-details
402
+ # https://developer.tenable.com/reference#policies-details
404
403
  def policy_details(policy_id)
405
404
  http_get(:uri => "/policies/#{policy_id}", :fields => header)
406
405
  end
@@ -408,7 +407,7 @@ module TenableRuby
408
407
  # Creates a policy
409
408
  #
410
409
  # Reference:
411
- # https://cloud.tenable.com/api#/resources/policies/create
410
+ # https://developer.tenable.com/reference#policies-create
412
411
  def policy_create(template_id, plugins, settings)
413
412
  options = {
414
413
  :uri => "/policies/",
@@ -428,7 +427,7 @@ module TenableRuby
428
427
  # Copy a policy
429
428
  #
430
429
  # Reference:
431
- # https://cloud.tenable.com/api#/resources/policies/copy
430
+ # https://developer.tenable.com/reference#policies-copy
432
431
  def policy_copy(policy_id)
433
432
  options = {
434
433
  :uri => "/policies/#{policy_id}/copy",
@@ -441,7 +440,7 @@ module TenableRuby
441
440
  # Changes the parameters of a policy
442
441
  #
443
442
  # Reference:
444
- # https://cloud.tenable.com/api#/resources/policies/configure
443
+ # https://developer.tenable.com/reference#policies-configure
445
444
  def policy_configure(policy_id, template_id, plugins, settings)
446
445
  options = {
447
446
  :uri => "/policies/#{policy_id}",
@@ -461,7 +460,7 @@ module TenableRuby
461
460
  # Delete a policy
462
461
  #
463
462
  # Reference:
464
- # https://cloud.tenable.com/api#/resources/policies/delete
463
+ # https://developer.tenable.com/reference#policies-delete
465
464
  def policy_delete(policy_id)
466
465
  response = http_delete(:uri => "/policies/#{policy_id}", :fields => header)
467
466
  response.code
@@ -592,7 +591,7 @@ module TenableRuby
592
591
  # Returns a list of all containers.
593
592
  #
594
593
  # Reference:
595
- # https://cloud.tenable.com/api#/resources/container-security-containers/list-containers
594
+ # https://developer.tenable.com/reference#container-security-containers-list-containers
596
595
  def list_containers()
597
596
  http_get(:uri => "/container-security/api/v1/container/list", :fields => header)
598
597
  end
@@ -600,7 +599,7 @@ module TenableRuby
600
599
  # Returns an inventory of an image by ID.
601
600
  #
602
601
  # Reference:
603
- # https://cloud.tenable.com/api#/resources/container-security-containers/image-inventory
602
+ # https://developer.tenable.com/reference#container-security-containers-image-inventory
604
603
  def image_inventory(image_id)
605
604
  http_get(:uri => "/container-security/api/v1/container/#{policy_id}/status", :fields => header)
606
605
  end
@@ -608,7 +607,7 @@ module TenableRuby
608
607
  # Returns the status of a job that you specify by ID to determine if the job is still queued, in progress, or has completed.
609
608
  #
610
609
  # Reference:
611
- # https://cloud.tenable.com/api#/resources/container-security-jobs/job-status
610
+ # https://developer.tenable.com/reference#container-security-jobs-job-status
612
611
  def job_status(job_id)
613
612
  http_get(:uri => "/container-security/api/v1/jobs/status?job_id=#{job_id}", :fields => header)
614
613
  end
@@ -616,7 +615,7 @@ module TenableRuby
616
615
  # Returns the status of a job by specifying an image ID to determine if the job is still queued, in progress, or has completed.
617
616
  #
618
617
  # Reference:
619
- # https://cloud.tenable.com/api#/resources/container-security-jobs/job-status-by-image-id
618
+ # https://developer.tenable.com/reference#container-security-jobs-job-status-by-image-id
620
619
  def image_status(image_id)
621
620
  http_get(:uri => "/container-security/api/v1/jobs/image_status?image_id=#{image_id}", :fields => header)
622
621
  end
@@ -624,7 +623,7 @@ module TenableRuby
624
623
  # Returns the status of a job by specifying an image digest to determine if the job is still queued, in progress, or has completed.
625
624
  #
626
625
  # Reference:
627
- # https://cloud.tenable.com/api#/resources/container-security-jobs/job-status-by-image-digest
626
+ # https://developer.tenable.com/reference#container-security-jobs-job-status-by-image-digest
628
627
  def image_status_digest(image_digest)
629
628
  http_get(:uri => "/container-security/api/v1/jobs/image_status_digest?image_digest=#{image_digest}", :fields => header)
630
629
  end
@@ -632,7 +631,7 @@ module TenableRuby
632
631
  # Returns a list of active Container Security jobs
633
632
  #
634
633
  # Reference:
635
- # https://cloud.tenable.com/api#/resources/container-security-jobs/list-jobs
634
+ # https://developer.tenable.com/reference#container-security-jobs-list-jobs
636
635
  def list_jobs()
637
636
  http_get(:uri => "/container-security/api/v1/jobs/list", :fields => header)
638
637
  end
@@ -640,7 +639,7 @@ module TenableRuby
640
639
  # Checks the compliance of an image that you specify by ID against your policies.
641
640
  #
642
641
  # Reference:
643
- # https://cloud.tenable.com/api#/resources/container-security-policy/policy-compliance-by-id
642
+ # https://developer.tenable.com/reference#container-security-policy-policy-compliance-by-id
644
643
  def policy_compliance_by_id(image_id)
645
644
  http_get(:uri => "/container-security/api/v1/policycompliance?image_id=#{image_id}", :fields => header)
646
645
  end
@@ -648,7 +647,7 @@ module TenableRuby
648
647
  # Checks the compliance of an image that you specify by name against your policies.
649
648
  #
650
649
  # Reference:
651
- # https://cloud.tenable.com/api#/resources/container-security-policy/policy-compliance-by-name
650
+ # https://developer.tenable.com/reference#container-security-policy-policy-compliance-by-name
652
651
  def policy_compliance_by_name(image)
653
652
  http_get(:uri => "/container-security/api/v1/compliancebyname?image=#{image}", :fields => header)
654
653
  end
@@ -656,7 +655,7 @@ module TenableRuby
656
655
  # Returns a report in JSON format for a container that you specify by ID. Note: If you do not have the container_id, you can call the list-containers endpoint.
657
656
  #
658
657
  # Reference:
659
- # https://cloud.tenable.com/api#/resources/container-security-reports/report-by-container-id
658
+ # https://developer.tenable.com/reference#container-security-reports-report-by-container-id
660
659
  def report_by_container_id(container_id)
661
660
  http_get(:uri => "/container-security/api/v1/reports/show?container_id=#{container_id}", :fields => header)
662
661
  end
@@ -664,7 +663,7 @@ module TenableRuby
664
663
  # Returns a report in JSON format for an image that you specify by ID. Note: If you do not have the image_id, you can call the list-images endpoint.
665
664
  #
666
665
  # Reference:
667
- # https://cloud.tenable.com/api#/resources/container-security-reports/report-by-image-id
666
+ # https://developer.tenable.com/reference#container-security-reports-report-by-image-id
668
667
  def report_by_image_id(image_id)
669
668
  http_get(:uri => "/container-security/api/v1/reports/by_image?image_id=#{image_id}", :fields => header)
670
669
  end
@@ -672,7 +671,7 @@ module TenableRuby
672
671
  # Returns a report in JSON format for an image digest.
673
672
  #
674
673
  # Reference:
675
- # https://cloud.tenable.com/api#/resources/container-security-reports/report-by-image-digest
674
+ # https://developer.tenable.com/reference#container-security-reports-report-by-image-digest
676
675
  def report_by_image_digest(image_digest)
677
676
  http_get(:uri => "/container-security/api/v1/reports/by_image_digest?image_digest=#{image_digest}", :fields => header)
678
677
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tenable-ruby
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.1
4
+ version: 0.3.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - Patrick Craston
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-06-26 00:00:00.000000000 Z
11
+ date: 2019-07-05 00:00:00.000000000 Z
12
12
  dependencies: []
13
13
  description: |-
14
14
  Ruby library for communicating with the tenable.io API.