Cisco Security Cloud Control Firewall Manager SDK

1.19.68 verified Mon Apr 27 auth: no python

A Python SDK for Cisco Security Cloud Control (SCC) Firewall Manager API. Provides programmatic access to manage firewall configurations, policies, and devices. Current version: 1.19.68.

pip install scc-firewall-manager-sdk

Common errors

error ModuleNotFoundError: No module named 'ciscoscc' ↓

cause Installing scc-firewall-manager-sdk but trying to import 'scc' or 'scc_firewall_manager_sdk'.

fix

pip install scc-firewall-manager-sdk and then import ciscoscc.

error AttributeError: 'SCCClient' object has no attribute 'devices' ↓

cause Using an outdated version (<1.19.0) where the API surface was different.

fix

Upgrade to the latest version: pip install --upgrade scc-firewall-manager-sdk.

error AuthenticationError: invalid_grant ↓

cause Using grant_type='password' with wrong credentials or it's deprecated.

fix

Use grant_type='client_credentials' and ensure SCC_CLIENT_ID and SCC_CLIENT_SECRET are correct.

Warnings

gotcha The package imports as 'ciscoscc', not 'scc_firewall_manager_sdk'. Many users incorrectly use the PyPI name as the module name. ↓

fix Use 'from ciscoscc import SCCClient'.

deprecated The 'grant_type' parameter defaults to 'password' which is deprecated. Use 'client_credentials' for OAuth2. ↓

fix Explicitly pass grant_type='client_credentials'.

gotcha Environment variables are case-sensitive. Use SCC_CLIENT_ID and SCC_CLIENT_SECRET (not lower- or mixed-case). ↓

fix Set env vars exactly as SCC_CLIENT_ID and SCC_CLIENT_SECRET.

Imports

SCCClient
wrong
```
from scc_firewall_manager_sdk import SCCClient
```
correct
```
from ciscoscc import SCCClient
```
The package name on PyPI differs from the Python module. The correct import uses 'ciscoscc'.
AuthenticationError
wrong
```
from ciscoscc.errors import AuthenticationError
```
correct
```
from ciscoscc import AuthenticationError
```
AuthenticationError is exposed at the package root, not in a submodule.

Quickstart

Initialize the client using OAuth2 client credentials from environment variables and list devices.

from ciscoscc import SCCClient

client = SCCClient(
    client_id=os.environ.get('SCC_CLIENT_ID', ''),
    client_secret=os.environ.get('SCC_CLIENT_SECRET', ''),
    grant_type='client_credentials'
)
# Example: List devices
devices = client.devices.list()
print(devices)