Skip to main content

Python based API to Forcepoint NGFW Management Center

Project description

Python version

smc-python

Python based library to provide the ability to interact with the Forcepoint NGFW Management Center API. Provides automation capabilities for any environment that interact with the SMC remotely.

Some of the functionality you get with the SMC Python API:

  • Create any engine types; single firewall, cluster firewalls, ips engines, layer 2 firewalls, master engine and virtual engines.

  • Engine operations such as enabling/disabling AV, GTI, default NAT, Contact Addresses, etc

  • Interface configurations

  • Routing configurations (OSPF, BGP, Static, Antispoofing)

  • Engine level commands such as rebooting, going offline, policy push, enable/disable SSH, etc.

  • Create and modify all network element objects such as Host, Network, Address Ranges, Domain Names, etc.

  • Policy control (create rules, delete rules) for layer 3 firewall policies

  • VPN Policy control and creation

  • Management / Log Server settings configuration

  • Admin User creation and modification

  • System level controls; update system packages, update engines, global blacklisting, etc

  • Tasks

  • Search operations for any object type by name, href and by filter

  • Collections interface to view all objects by type

  • Monitoring by polling

  • High-Availability management

Requirements

Python >= 3.5

Requests >= 2.32.0 websocket-client >= 1.8.0

Security Management Center version >= 6.10

Getting Started

Installing package

From git:

pip install git+https://github.com/Forcepoint/fp-NGFW-SMC-python.git

Or after cloning:

python setup.py install

Examples

Included are a variety of test example scripts that leverage the API to do various tasks in smc/examples directory

Basics

Before any commands are run, you must obtain a login session. Once commands are complete, call session.logout() to remove the active session. To obtain the api_key, log in to the Forcepoint NGFW Management Center and create an API client with the proper privileges.

from smc import session

session.login(url='http://1.1.1.1:8082', api_key='xxxxxxxxxxxxx')
....do stuff....
session.logout()

Or log in to a specific Admin Domain and use a specific version of the API:

session.login(url='http://1.1.1.1:8082', api_key='xxxxxxxxxxxxx',
              domain=mydomain, api_version=6.2)
....do stuff....
session.logout()

Once a valid session is obtained, it will be re-used for each operation for the duration of the sessions validity, or until the program is exited.

Extensions

Extensions are available to smc-python that provide additional functionality besides what is provided in the base library. Extensions are kept separate as they may require additional package requirements and simplify packaging.

Available extensions:

  • smc-python-monitoring: Monitoring for SMC connections, blacklists, users, VPNs, alerts, etc. In addition this package provides the ability to ‘subscribe’ to administrative event modifications.

Extensions are found in the base smc-python repository as namespace packages and each is housed in it’s own sub-directory of this base package.

Pull Requests

Pull requests are welcome and appreciated, but they cannot be merged as-is. We use an internal repository to validate and integrate these changes. However, they may be released later according to our roadmap. You can use ‘Issues’ to suggest changes to us.

Documentation

View Documentation on Read The Docs

Release History

Release notes on GitHub

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fp_ngfw_smc_python-1.0.30.tar.gz (475.6 kB view details)

Uploaded Source

Built Distribution

fp_ngfw_smc_python-1.0.30-py2.py3-none-any.whl (628.2 kB view details)

Uploaded Python 2Python 3

File details

Details for the file fp_ngfw_smc_python-1.0.30.tar.gz.

File metadata

  • Download URL: fp_ngfw_smc_python-1.0.30.tar.gz
  • Upload date:
  • Size: 475.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for fp_ngfw_smc_python-1.0.30.tar.gz
Algorithm Hash digest
SHA256 61d1875a652e5303b3fd81826c486942bd1e81bea14d8b50aed642fec46fa87e
MD5 fe03d9cf10a28e66e7f5ca64803e611f
BLAKE2b-256 2b305e9b5556d580fb37c2d7d531659ea1e2662234939e92d59af6a9275e1437

See more details on using hashes here.

File details

Details for the file fp_ngfw_smc_python-1.0.30-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for fp_ngfw_smc_python-1.0.30-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ab01d223b0f4d5cad6251920c171fe3f917602cc9e032310d322af4aa02fbd0c
MD5 87a7c3852fe61d6edeb5996a060df065
BLAKE2b-256 32dcec6d40009acf13ca7c2be0c3611aa7101727204373e0325afddbcd12a001

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page