FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

pan-python/tests at master · kevinsteves/pan-python · GitHub

Repository navigation

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.rst

pan-python Tests

pan-python tests use the Python unit testing framework.

Test Naming

Tests can be created for any of the components in pan-python using the following naming convention:

pan-python Component Test Script Prefix
PAN-OS XML API test_xapi_
PAN-OS Licensing API test_licapi_
WildFire API test_wfapi_
AutoFocus API test_afapi_

Tests are currently available for the following components:

  • PAN-OS XML API
  • WildFire API

Run Tests

To run tests from the top-level directory:

$ python3 -m unittest discover -v -s tests -t . -p TARGET-PATTERN

To run tests from the tests/ directory:

$ python3 -m unittest discover -v -t .. -p TARGET-PATTERN

PAN-OS XML API Tests

A lab PAN-OS firewall or Panorama are required to run the tests.

PAN-OS XML API tests can be performed on the following targets:

Test Target Target Name
PAN-OS firewall fw
Panorama pano
PAN-OS firewall via Panorama to device redirection tgt

Test scripts use the following naming convention to define the valid test targets:

Target Names Test Script Prefix Test Targets
fw test_xapi_fw_ PAN-OS firewall only
pano test_xapi_pano_ Panorama only
fw_pano test_xapi_fw_pano_ PAN-OS firewall or Panorama
fw_tgt test_xapi_fw_tgt_ PAN-OS firewall or firewall via Panorama to device redirection
fw_tgt_pano test_xapi_fw_tgt_pano_ PAN-OS firewall, Panorama or firewall via Panorama to device redirection

Specifying Test Target

A .panrc file is used to reference the test target by a tagname.

Export the XAPI_TAG environment variable with the tagname to use from a .panrc file:

$ export XAPI_TAG=vm-50-3

Panorama to Device Redirection

Panorama to device redirection can be used to perform XML API requests to connected devices via Panorama using the target=serial API request argument. To execute tests using Panorama to device redirection the .panrc hostname specifies the Panorama and the serial specifies the connected device:

$ grep vm-50-3-panorama .panrc
# vm-50-3-panorama
hostname%vm-50-3-panorama=172.25.2.100
api_username%vm-50-3-panorama=admin
api_password%vm-50-3-panorama=password
serial%vm-50-3-panorama=015351000046877

Examples

From the tests/ directory run tests to a Panorama target:

$ XAPI_TAG=panorama-2 python3 -m unittest discover -v -t .. -p 'test_xapi_*pano*'
test_01 (tests.test_xapi_fw_tgt_pano_export.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_log.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_pano_log.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_op.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_pano_op.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_report.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_user_id.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_pano_user_id.PanXapiTest) ... ok

----------------------------------------------------------------------
Ran 8 tests in 6.184s

OK

From the tests/ directory run tests to a firewall target:

$ XAPI_TAG=vm-50-3 python3 -m unittest discover -v -t .. -p 'test_xapi_*fw*'
test_01 (tests.test_xapi_fw_tgt_config.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_multi_config.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_multi_config.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_export.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_log.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_pano_log.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_op.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_pano_op.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_report.PanXapiTest) ... ok
test_01 (tests.test_xapi_fw_tgt_pano_user_id.PanXapiTest) ... ok
test_02 (tests.test_xapi_fw_tgt_pano_user_id.PanXapiTest) ... ok

----------------------------------------------------------------------
Ran 11 tests in 19.983s

OK

WildFire API Tests

A WildFire API key is required to run the tests.

WildFire tests can be performed on the following targets:

Test Target Target Name
WildFire cloud cld
WildFire appliance appl

Test scripts use the following naming convention to define the valid test targets:

Target Names Test Script Prefix Test Targets
cld test_wfapi_cld_ WildFire cloud only
appl test_wfapi_appl_ WildFire appliance only
cld_appl test_wfapi_cld_appl_ WildFire cloud or appliance

Specifying Test Target

A .panrc file is used to reference the test target by a tagname.

Export the WFAPI_TAG environment variable with the tagname to use from a .panrc file:

$ export WFAPI_TAG=wildfire-cloud

Examples

From the tests/ directory run tests to a cloud target:

$ WFAPI_TAG=wildfire-cloud python3 -m unittest discover -v -t .. -p 'test_wfapi_cld_*'
test_01 (tests.test_wfapi_cld_appl_submit_file.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_appl_submit_links.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_appl_submit_links.PanWFapiTest) ... ok
test_03 (tests.test_wfapi_cld_appl_submit_links.PanWFapiTest) ... ok
test_04 (tests.test_wfapi_cld_appl_submit_links.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_appl_verdict.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_appl_verdict.PanWFapiTest) ... ok
test_03 (tests.test_wfapi_cld_appl_verdict.PanWFapiTest) ... ok
test_04 (tests.test_wfapi_cld_appl_verdict.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_03 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_04 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_05 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_06 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_07 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_08 (tests.test_wfapi_cld_appl_verdicts.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_appl_verdicts_changed.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_appl_verdicts_changed.PanWFapiTest) ... ok
test_03 (tests.test_wfapi_cld_appl_verdicts_changed.PanWFapiTest) ... ok
test_04 (tests.test_wfapi_cld_appl_verdicts_changed.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_constructor.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_constructor.PanWFapiTest) ... ok
test_03 (tests.test_wfapi_cld_constructor.PanWFapiTest) ... ok
test_04 (tests.test_wfapi_cld_constructor.PanWFapiTest) ... ok
test_05 (tests.test_wfapi_cld_constructor.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_submit_url.PanWFapiTest) ... testfile SHA256 ca310640d82d2eb50f8e93a3b828100113d9b00bb4f0d266fcf53342b3960399 ok
test_01 (tests.test_wfapi_cld_testfile.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_testfile.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_url_analysis.PanWFapiTest) ... ok
test_01 (tests.test_wfapi_cld_web_artifacts.PanWFapiTest) ... ok
test_02 (tests.test_wfapi_cld_web_artifacts.PanWFapiTest) ... ok
test_03 (tests.test_wfapi_cld_web_artifacts.PanWFapiTest) ... ok
test_04 (tests.test_wfapi_cld_web_artifacts.PanWFapiTest) ... ok
test_05 (tests.test_wfapi_cld_web_artifacts.PanWFapiTest) ... ok
test_06 (tests.test_wfapi_cld_web_artifacts.PanWFapiTest) ... ok

----------------------------------------------------------------------
Ran 36 tests in 204.025s

OK

Back | FazBrowse Home | New Git URL