# ciscodevnet/cisco-scc-python-sdk architecture

> Architecture diagram of the GitHub repository ciscodevnet/cisco-scc-python-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ciscodevnet/cisco-scc-python-sdk
- Repository: https://github.com/ciscodevnet/cisco-scc-python-sdk

## Overview

Cisco Security Cloud Control Python SDK: callers create an authenticated Client, use its resource-specific methods to manage organizations, subscriptions, users, groups and roles, then receive decoded API results or SDK exceptions. Token refresh is an additional capability. Resource methods delegate HTTP transport to Client; BaseResource provides the shared client reference. Source excerpts show the main transport and several resource calls, but not every resource implementation, so unsampled resource-to-transport links are omitted.

Main entry points: [`scc_sdk/client.py`](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/client.py) (Client), [`scc_sdk/resources/base.py`](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/base.py) (Resource base), [`scc_sdk/resources/organizations.py`](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/organizations.py) (Organizations), [`scc_sdk/resources/subscriptions.py`](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/subscriptions.py) (Subscriptions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["SDK entry"]
  node_public_api["Public exports<br/>[__init__.py]"]
end

subgraph group_resources["Management resources"]
  node_base["Resource base<br/>[base.py]"]
  node_organizations["Organizations<br/>[organizations.py]"]
  node_subscriptions["Subscriptions<br/>[subscriptions.py]"]
  node_groups["Admin groups<br/>[groups.py]"]
  node_users["Users<br/>[users.py]"]
  node_roles["Roles<br/>[roles.py]"]
  node_tokens["Token refresh<br/>[tokens.py]"]
end

subgraph group_transport["HTTP and errors"]
  node_client["Client<br/>[client.py]"]
  node_errors["SDK exceptions<br/>[exceptions.py]"]
end

node_caller(("SDK caller"))
node_api{{"SCC Management API"}}

node_caller -->|"imports"| node_public_api
node_public_api -->|"exports"| node_client
node_caller -->|"configures"| node_client
node_client -->|"initializes"| node_organizations
node_client -->|"initializes"| node_subscriptions
node_client -->|"initializes"| node_groups
node_client -->|"initializes"| node_users
node_client -->|"initializes"| node_roles
node_client -->|"initializes"| node_tokens
node_organizations -->|"inherits"| node_base
node_subscriptions -->|"inherits"| node_base
node_groups -->|"inherits"| node_base
node_users -->|"inherits"| node_base
node_roles -->|"inherits"| node_base
node_tokens -->|"inherits"| node_base
node_organizations -->|"requests"| node_client
node_subscriptions -->|"requests"| node_client
node_groups -->|"requests"| node_client
node_users -->|"requests"| node_client
node_roles -->|"requests"| node_client
node_tokens -->|"requests"| node_client
node_client -->|"sends HTTP"| node_api
node_api -->|"returns JSON"| node_client
node_client -->|"raises"| node_errors

click node_public_api "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/__init__.py"
click node_client "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/client.py"
click node_errors "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/exceptions.py"
click node_base "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/base.py"
click node_organizations "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/organizations.py"
click node_subscriptions "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/subscriptions.py"
click node_groups "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/groups.py"
click node_users "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/users.py"
click node_roles "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/roles.py"
click node_tokens "https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/tokens.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_api toneBlue
class node_base,node_organizations,node_subscriptions,node_groups,node_users,node_roles,node_tokens toneAmber
class node_client,node_errors,node_api toneMint
class node_caller toneIndigo
```

## Components

### SDK entry

- [Public exports](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/__init__.py): `scc_sdk/__init__.py`

### Management resources

- [Resource base](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/base.py): `scc_sdk/resources/base.py`
- [Organizations](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/organizations.py): `scc_sdk/resources/organizations.py`
- [Subscriptions](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/subscriptions.py): `scc_sdk/resources/subscriptions.py`
- [Admin groups](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/groups.py): `scc_sdk/resources/groups.py`
- [Users](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/users.py): `scc_sdk/resources/users.py`
- [Roles](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/roles.py): `scc_sdk/resources/roles.py`
- [Token refresh](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/resources/tokens.py): `scc_sdk/resources/tokens.py`

### HTTP and errors

- [Client](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/client.py): `scc_sdk/client.py`
- [SDK exceptions](https://github.com/ciscodevnet/cisco-scc-python-sdk/blob/main/scc_sdk/exceptions.py): `scc_sdk/exceptions.py`

### Other components

- **SDK caller**
- **SCC Management API**

## Connections

- SDK caller → Public exports: imports (evidence: `README.md`)
- Public exports → Client: exports (evidence: `scc_sdk/__init__.py`)
- SDK caller → Client: configures (evidence: `README.md`)
- Client → Organizations: initializes (evidence: `scc_sdk/client.py`)
- Client → Subscriptions: initializes (evidence: `scc_sdk/client.py`)
- Client → Admin groups: initializes (evidence: `scc_sdk/client.py`)
- Client → Users: initializes (evidence: `scc_sdk/client.py`)
- Client → Roles: initializes (evidence: `scc_sdk/client.py`)
- Client → Token refresh: initializes (evidence: `scc_sdk/client.py`)
- Organizations → Resource base: inherits (evidence: `scc_sdk/resources/organizations.py`)
- Subscriptions → Resource base: inherits (evidence: `scc_sdk/resources/subscriptions.py`)
- Admin groups → Resource base: inherits (evidence: `scc_sdk/resources/groups.py`)
- Users → Resource base: inherits (evidence: `scc_sdk/resources/users.py`)
- Roles → Resource base: inherits (evidence: `scc_sdk/resources/roles.py`)
- Token refresh → Resource base: inherits (evidence: `scc_sdk/resources/tokens.py`)
- Organizations → Client: requests (evidence: `scc_sdk/resources/organizations.py`)
- Subscriptions → Client: requests (evidence: `scc_sdk/resources/subscriptions.py`)
- Admin groups → Client: requests (evidence: `scc_sdk/resources/groups.py`)
- Users → Client: requests (evidence: `scc_sdk/resources/users.py`)
- Roles → Client: requests (evidence: `scc_sdk/resources/roles.py`)
- Token refresh → Client: requests (evidence: `scc_sdk/resources/tokens.py`)
- Client → SCC Management API: sends HTTP (evidence: `scc_sdk/client.py`)
- SCC Management API → Client: returns JSON (evidence: `scc_sdk/client.py`)
- Client → SDK exceptions: raises (evidence: `scc_sdk/client.py`)
