bunny2fmc 1.0.8__py3-none-any.whl → 1.3.21__py3-none-any.whl

bunny2fmc-1.3.21.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: bunny2fmc
+Version: 1.3.21
+Summary: Sync BunnyCDN edge IPs to Cisco FMC Dynamic Objects with secure credential management and scheduling
+Author: Kasper Elsborg -Wingmen
+License: MIT
+Project-URL: Homepage, https://github.com/wingmen/bunny-sync-fmc
+Project-URL: Repository, https://github.com/wingmen/bunny-sync-fmc
+Keywords: bunny,bunnyCDN,cisco,fmc,firewall,security,automation,dynamic-objects
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: System :: Networking :: Firewalls
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: wingpy>=0.3.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: keyring>=23.0.0
+Requires-Dist: keyrings.alt>=5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=4.0; extra == "dev"
+Dynamic: license-file
+
+# bunny2fmc
+
+Automatically sync BunnyCDN IP ranges to Cisco FMC Dynamic Objects.
+
+## Quick Install
+
+```bash
+sudo apt install pipx
+pipx install bunny2fmc
+bunny2fmc --setup
+```
+
+That's it! Answer the setup questions and you're done.
+
+During `bunny2fmc --setup` you'll be asked for:
+- FMC hostname/IP
+- FMC username/password (stored in OS keyring)
+- Dynamic Object name
+- IPv6 enable (y/n)
+- Sync interval (minutes)
+- Bunny IPv4 API URL (default: https://bunnycdn.com/api/system/edgeserverlist)
+- Bunny IPv6 API URL (default: https://bunnycdn.com/api/system/edgeserverlist/ipv6)
+
+## What it does
+
+**bunny2fmc** fetches the latest BunnyCDN edge server IP addresses and updates a Dynamic Object in Cisco FMC. No deployment needed - changes are immediate.
+
+### Features
+
+- 🔄 **Automatic sync** - Fetch latest IPs from BunnyCDN API
+- ⚙️ **Configurable endpoints** - Override Bunny IPv4/IPv6 API URLs when needed
+- 🔐 **Secure credentials** - Stored in OS keyring
+- ⏰ **Scheduled execution** - Run via cron (daily/hourly/custom)
+- 📊 **Smart updates** - Only changes what's needed
+- 📝 **Logging** - Track all sync activity
+
+## Prerequisites
+
+Before running `bunny2fmc --setup`, create a dedicated API user in FMC:
+
+1. **FMC → System → Users → Add User**
+2. Settings:
+   - Username: `bunny2fmc_sync`
+   - Password: [choose strong password - save it!]
+   - Role: **Network Admin** (or Maintenance User)
+   - Authentication: **Local**
+3. Click **Save**
+
+**Important:** Don't use your admin account - API login logs out the web UI session!
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `bunny2fmc --setup` | Interactive configuration |
+| `bunny2fmc --run` | Run sync now |
+| `bunny2fmc --start` | Start scheduled sync (cron) |
+| `bunny2fmc --stop` | Stop scheduled sync |
+| `bunny2fmc --config` | Show configuration |
+| `bunny2fmc --logs` | View recent logs |
+| `bunny2fmc --logs follow` | Follow logs in real-time |
+| `bunny2fmc --clear` | Remove all config and credentials |
+| `bunny2fmc --help` | Show all commands |
+
+## File Locations
+
+All files are stored in `~/bunny2fmc/`:
+
+```
+~/bunny2fmc/
+├── config.json     # Configuration
+├── logs/           # Log files
+└── guide/          # Documentation
+```
+
+## Troubleshooting
+
+**pipx not found:**
+```bash
+pipx ensurepath
+source ~/.bashrc
+```
+
+**bunny2fmc not found:**
+```bash
+export PATH="$PATH:$HOME/.local/bin"
+```
+
+**Can't connect to FMC:**
+- Check firewall allows port 443
+- Verify FMC hostname/IP is correct
+- Test: `curl -k https://fmc.company.com/api/fmc_platform/v1/info`
+
+**Upgrade:**
+```bash
+pipx upgrade bunny2fmc
+```
+
+**Uninstall:**
+```bash
+pipx uninstall bunny2fmc
+rm -rf ~/bunny2fmc/
+```
+
+## Requirements
+
+- Linux (Ubuntu/Debian recommended)
+- Python 3.8+
+- Cisco FMC with API access
+- Network access to FMC and internet
+
+## Links
+
+- **PyPI:** https://pypi.org/project/bunny2fmc/
+- **GitHub:** https://github.com/IronKeyVault/Bunny_Sync_FMC
+
+## License
+
+MIT License - see LICENSE file.

bunny2fmc-1.3.21.dist-info/RECORD

@@ -0,0 +1,15 @@
+README.md,sha256=tnUKuLBglDo8JYVwHo41G4sifMML4FJHI6Ooq-3w3fM,3000
+install.sh,sha256=BUmABEByBiPIMClnTsIdlLXcxPvmlsZZeDfR7i3Wq1E,1344
+requirements.txt,sha256=te4vBKcMGbV2dXiUeibHgFvguvTPiyhvDSbajOMVkEc,30
+bunny2fmc/__init__.py,sha256=eWPc6iHJTxcyB9GSsBbdoZYfdEAtpnHE0h4SsOoZP7c,134
+bunny2fmc/cli.py,sha256=W1AyU4Lc0IMj7PWykyT0mF2Vq3OQO_mMvox5NKayq-A,29376
+bunny2fmc/config.py,sha256=pvYQtJYuSexEbf8FaA-ywGsIbf0Fbkv7ibwWfgtSMsM,10225
+bunny2fmc/setup_helper.py,sha256=DXt8DUI2J4RWjDsaIkJqajevr9gttDMbUQ0FejxfaBc,1038
+bunny2fmc/sync_engine.py,sha256=PZY8PiLQjX59jK4pimWPymNx_aTJpNomcV5c4u22oKs,11379
+bunny2fmc-1.3.21.dist-info/licenses/LICENSE,sha256=2_vaDeZJ15RDU_6C1r5IJ7urPUt4hHeMrUd92xwWcwQ,1080
+guide/INSTALL.md,sha256=GS_8SL3Z7sOmG0fA8Glrv4-06PBqD0ECqIDm6URWuvo,5034
+bunny2fmc-1.3.21.dist-info/METADATA,sha256=r0plpm3_uoI0WiFYA1QKR1dBy7tVgvkO21IJZEohnm0,4329
+bunny2fmc-1.3.21.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+bunny2fmc-1.3.21.dist-info/entry_points.txt,sha256=ZjZFEAAugvnna7HHbYcfivJGJway3qgM-S-B2lf9akI,49
+bunny2fmc-1.3.21.dist-info/top_level.txt,sha256=7a2i3_fKlFFNKUmSEDFbwXI_CXPEcUsrIisHNLEAXtM,10
+bunny2fmc-1.3.21.dist-info/RECORD,,

{bunny2fmc-1.0.8.dist-info → bunny2fmc-1.3.21.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

guide/INSTALL.md

@@ -0,0 +1,208 @@
+# bunny2fmc - Installation Guide
+
+## Quick Install (3 commands)
+
+```bash
+sudo apt install pipx
+pipx install bunny2fmc
+bunny2fmc --setup
+```
+
+---
+
+## Before You Start
+
+### Server Requirements
+
+- [ ] Linux server (Ubuntu/Debian recommended)
+- [ ] Python 3.8+ installed
+- [ ] sudo access
+- [ ] cron available
+- [ ] Network access to FMC and internet
+
+### Cisco FMC Setup (IMPORTANT!)
+
+Create a **dedicated API user** in FMC before installation:
+
+1. **System → Users → Add User**
+2. Fill in:
+   - Username: `bunny2fmc_sync`
+   - Password: [choose strong password - save it!]
+   - Role: **Network Admin** (or Maintenance User)
+   - Authentication: **Local**
+3. Click **Save**
+
+**IMPORTANT:** Don't use your admin account - API login logs out the web UI session!
+
+### Have Ready for Setup
+
+```
+FMC Hostname:        [e.g., fmc.company.com]
+FMC Username:        bunny2fmc_sync
+FMC Password:        [the password you chose]
+Dynamic Object Name: BunnyCDN_Dynamic
+Sync Interval:       [in minutes]
+```
+
+---
+
+## Detailed Installation
+
+### 1. Install pipx
+
+**Ubuntu/Debian:**
+```bash
+sudo apt install pipx
+pipx ensurepath
+```
+
+**macOS:**
+```bash
+brew install pipx
+pipx ensurepath
+```
+
+Open a new terminal after `ensurepath`.
+
+### 2. Install bunny2fmc
+
+```bash
+pipx install bunny2fmc
+```
+
+### 3. Run Setup
+
+```bash
+bunny2fmc --setup
+```
+
+You will be asked:
+- **FMC IP/hostname** - e.g., `192.168.1.100` or `fmc.company.com`
+- **FMC username** - use `bunny2fmc_sync`
+- **FMC password** - stored securely in OS keyring
+- **Dynamic Object name** - e.g., `BunnyCDN_Dynamic`
+- **IPv6** - y/n (default: n)
+- **Sync interval** - enter minutes between syncs
+- **Bunny IPv4 API URL** - default: https://bunnycdn.com/api/system/edgeserverlist
+- **Bunny IPv6 API URL** - default: https://bunnycdn.com/api/system/edgeserverlist/ipv6
+- **Enable scheduled sync** - y/n (enables automatic cron job)
+
+### 4. Test
+
+```bash
+bunny2fmc --run      # Run sync now
+bunny2fmc --logs     # See what happened
+```
+
+---
+
+## Using the Dynamic Object
+
+Once bunny2fmc creates and syncs the Dynamic Object with BunnyCDN IP addresses, you can use it in firewall rules.
+
+### Adding to Access Rules
+
+1. **FMC → Policies → Access Control**
+2. Create or edit an access rule
+3. In the rule definition, add the Dynamic Object:
+   - **Source** - Leave as "Any" or specify your network
+   - **Destination** - Click "Add" → select your Dynamic Object (e.g., `BunnyCDN_Dynamic`)
+   - **Service/Port** - HTTP (80), HTTPS (443), or custom
+   - **Protocol** - TCP
+
+### 5-Tuple Matching
+
+The firewall rule matches traffic using these 5 components:
+
+| Component | Example | Purpose |
+|-----------|---------|---------|
+| **Source IP** | Internal network (Any) | Where traffic originates |
+| **Destination IP** | BunnyCDN_Dynamic | Where traffic goes (Dynamic Object) |
+| **Source Port** | Any | Which port traffic leaves from |
+| **Destination Port** | 80, 443 | Which port traffic reaches |
+| **Protocol** | TCP | Transport protocol (TCP/UDP) |
+
+### Example Rule
+
+**Allow internal users to BunnyCDN:**
+- Source: `Internal-Networks` (or Any)
+- Destination: `BunnyCDN_Dynamic` (your Dynamic Object)
+- Service: `HTTPS` (port 443, TCP)
+- Action: **Allow**
+
+The Dynamic Object will automatically update every time bunny2fmc syncs, keeping your rules current with BunnyCDN's latest edge servers without manual changes.
+
+---
+
+## File Locations
+
+Everything is stored in `~/bunny2fmc/`:
+
+```
+~/bunny2fmc/
+├── config.json     # Configuration
+├── logs/           # Log files
+└── guide/          # Documentation
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `bunny2fmc --setup` | Interactive configuration |
+| `bunny2fmc --run` | Run sync now |
+| `bunny2fmc --start` | Start cron job |
+| `bunny2fmc --stop` | Stop cron job |
+| `bunny2fmc --status` | Show cron job status and last sync time |
+| `bunny2fmc --config` | Show configuration |
+| `bunny2fmc --logs` | View logs |
+| `bunny2fmc --help` | All commands |
+
+---
+
+## Troubleshooting
+
+**pipx not found:**
+```bash
+pipx ensurepath
+source ~/.bashrc
+```
+
+**bunny2fmc not found:**
+```bash
+export PATH="$PATH:$HOME/.local/bin"
+```
+
+**Can't connect to FMC:**
+- Check firewall allows port 443
+- Check FMC hostname/IP is correct
+- Test: `curl -k https://fmc.company.com/api/fmc_platform/v1/info`
+
+**Dynamic Object not created:**
+- Check cron is running: `crontab -l`
+- Check logs: `bunny2fmc --logs`
+- Run manually: `bunny2fmc --run`
+
+**Upgrade:**
+```bash
+pipx upgrade bunny2fmc
+```
+
+**Uninstall:**
+```bash
+pipx uninstall bunny2fmc
+rm -rf ~/bunny2fmc/
+```
+
+---
+
+## Version History
+
+### v1.3.20 (January 2026)
+- **Configurable Bunny API endpoints**: Can now override IPv4/IPv6 API URLs during setup
+- **Improved input handling**: Fixed backspace/delete key issues in setup prompts
+- **Enhanced setup**: Added Bunny API URL configuration with sensible defaults
+  - Default IPv4 URL: `https://bunnycdn.com/api/system/edgeserverlist`
+  - Default IPv6 URL: `https://bunnycdn.com/api/system/edgeserverlist/ipv6`

install.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# bunny2fmc Installation Script for Linux/macOS
+
+set -e
+
+echo "========================================="
+echo "bunny2fmc Installation Script"
+echo "========================================="
+echo ""
+
+# Check if Python is installed
+if ! command -v python3 &> /dev/null; then
+    echo "❌ Error: Python 3 is not installed"
+    echo "Please install Python 3.8 or later and try again"
+    exit 1
+fi
+
+PYTHON_VERSION=$(python3 --version | cut -d' ' -f2)
+echo "✓ Found Python $PYTHON_VERSION"
+echo ""
+
+# Create virtual environment
+echo "Creating virtual environment..."
+python3 -m venv venv
+echo "✓ Virtual environment created"
+echo ""
+
+# Activate virtual environment
+echo "Activating virtual environment..."
+source venv/bin/activate
+echo "✓ Virtual environment activated"
+echo ""
+
+# Install bunny2fmc
+echo "Installing bunny2fmc and dependencies..."
+pip install --upgrade pip
+pip install bunny2fmc
+echo "✓ Installation complete"
+echo ""
+
+echo "========================================="
+echo "Installation Successful!"
+echo "========================================="
+echo ""
+echo "Next steps:"
+echo "1. Activate the virtual environment:"
+echo "   source venv/bin/activate"
+echo ""
+echo "2. Run the setup wizard:"
+echo "   bunny2fmc --setup"
+echo ""
+echo "3. View help and available commands:"
+echo "   bunny2fmc --help"
+echo ""

requirements.txt

@@ -0,0 +1,3 @@
+wingpy
+requests
+python-dotenv

bunny2fmc-1.0.8.dist-info/METADATA

@@ -1,176 +0,0 @@
-Metadata-Version: 2.4
-Name: bunny2fmc
-Version: 1.0.8
-Summary: Sync BunnyCDN edge IPs to Cisco FMC Dynamic Objects with secure credential management and scheduling
-Author: Kasper Elsborg -Wingmen
-License: MIT
-Project-URL: Homepage, https://github.com/wingmen/bunny-sync-fmc
-Project-URL: Repository, https://github.com/wingmen/bunny-sync-fmc
-Keywords: bunny,fmc,cisco,edge-server,dynamic-object
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Topic :: System :: Networking :: Firewalls
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: wingpy>=0.3.0
-Requires-Dist: requests>=2.25.0
-Requires-Dist: python-dotenv>=0.19.0
-Requires-Dist: keyring>=23.0.0
-Requires-Dist: keyrings.alt>=5.0
-Provides-Extra: dev
-Requires-Dist: pytest>=6.0; extra == "dev"
-Requires-Dist: black>=22.0; extra == "dev"
-Requires-Dist: flake8>=4.0; extra == "dev"
-Dynamic: license-file
-
-# 🐰 bunny2fmc
-
-Synkroniserer BunnyCDN edge server IP-adresser til en Cisco FMC Dynamic Object med sikker credential-gempling og automatisk scheduling.
-
-## Hvad gør scriptet?
-
-1. Henter aktuelle IPv4 (og evt. IPv6) adresser fra BunnyCDN's API
-2. Opretter/finder Dynamic Object på FMC
-3. Sammenligner nuværende mappings med Bunny's liste
-4. Tilføjer nye og fjerner forældede IP'er
-5. Ingen deploy nødvendig - Dynamic Objects opdateres on-the-fly
-6. **Sikker gempling**: Credentials gemmesto i OS Keyring (Windows Credential Manager / Linux Secret Service)
-7. **Automatisk scheduling**: Konfigurer interval ved første setup, køres via cron
-
----
-
-## Installation
-
-### Option 1: Fra PyPI (Anbefalet)
-
-```bash
-# Opret virtual environment
-python3 -m venv venv
-
-# Aktivér venv (VIGTIG - skal gøres før hver brug!)
-source venv/bin/activate    # Linux/macOS
-# eller
-venv\Scripts\activate       # Windows
-
-# Installer bunny2fmc
-pip install bunny2fmc
-
-# Verificer installation
-bunny2fmc --version
-bunny2fmc --help
-```
-
-### Option 2: Fra source (Local development)
-
-```bash
-# Clone repository
-cd /path/to/Bunny_Sync_FMC
-
-# Opret virtual environment
-python3 -m venv venv
-
-# Aktivér venv (VIGTIG!)
-source venv/bin/activate    # Linux/macOS
-# eller
-venv\Scripts\activate       # Windows
-
-# Installer som development package
-pip install -e .
-
-# Verificer installation
-bunny2fmc --version
-```
-
-### ⚠️ VIGTIG: Aktivér venv før brug
-
-**Du SKAL aktivere venv før du kan bruge bunny2fmc!**
-
-```bash
-# Linux/macOS
-source venv/bin/activate
-
-# Windows
-venv\Scripts\activate
-
-# Nu kan du bruge kommandoen:
-bunny2fmc --help
-```
-
-Når venv er aktiveret, vises `(venv)` i din prompt
----
-
-## Distribution Strategy
-
-### Repository Struktur
-
-- **Privat GitHub** (`https://github.com/IronKeyVault/Bunny_Sync_FMC`): 
-  - Source of truth for alt udvikling
-  - Indeholder hele kodebase (gamle scripts, notes, configs)
-  - Kun for interne team medlemmer
-  
-- **PyPI** (`https://pypi.org/project/bunny2fmc`):
-  - Public distribution punkt
-  - Alle brugere kan installere med: `pip install bunny2fmc`
-  - Synkroniseret fra privat repo
-
-### Release Workflow
-
-Når du er klar til at udgive en ny version:
-
-```bash
-./release.sh
-```
-
-Scriptet vil:
-1. Spørge for nyt versionsnummer (f.eks. 1.0.2)
-2. Opdatere `pyproject.toml` og `bunny2fmc/__init__.py`
-3. Committe og pushe til GitHub
-4. Bygge pakken
-5. Uploade til PyPI
-
-**Eksempel:**
-```
-./release.sh
-Enter new version (e.g., 1.0.2): 1.0.2
-✓ Release v1.0.2 complete
-```
-
----
-
-## Hvornår kan jeg slette den gamle public repo?
-
-Du kan slette `https://github.com/IronKeyVault/bunny2fmc` når:
-
-1. ✅ **PyPI har den seneste version** 
-   - Verificer på https://pypi.org/project/bunny2fmc/
-   - Alle nye releases går direkte til PyPI via `release.sh`
-
-2. ✅ **Ingen users refererer til det**
-   - Hvis andre har installeringer fra Git URL, skal de updateres til:
-   - `pip install bunny2fmc` (fra PyPI i stedet)
-
-3. ✅ **Du er sikker på at PyPI er det eneste public distribution point**
-   - Alt udvikling fortsætter i privat repo
-   - Releases håndteres via `./release.sh`
-
-### Sletning
-
-Når du er 100% sikker, kan du slette repoet:
-
-1. Gå til https://github.com/IronKeyVault/bunny2fmc
-2. Settings → Danger Zone → Delete Repository
-3. Bekræft ved at skrive repo-navnet
-
-**Efter sletning:**
-- Alt udvikling/history ligger stadig på privat repo
-- Alle brugere bruger PyPI (bedst praksis)
-- Enklere repository-management
-

bunny2fmc-1.0.8.dist-info/RECORD

@@ -1,10 +0,0 @@
-bunny2fmc/__init__.py,sha256=fVsHsYtI5haE_NeyaMKlYiaAROUctiIYibLRdvIyPTg,133
-bunny2fmc/cli.py,sha256=p8Mhve3L9_6xEtu2712LLp7S3nC8hfyXJBc-wmC7UtY,10111
-bunny2fmc/config.py,sha256=rvpkAGZv2NaRChXyO9u4dnQl5wnvExToMvlCIJZMlpQ,4803
-bunny2fmc/sync_engine.py,sha256=zCAJ0LrKgHQ6zOWHVOfTvvlHgNkILYyFq0ftdPC3Pt4,7024
-bunny2fmc-1.0.8.dist-info/licenses/LICENSE,sha256=2_vaDeZJ15RDU_6C1r5IJ7urPUt4hHeMrUd92xwWcwQ,1080
-bunny2fmc-1.0.8.dist-info/METADATA,sha256=EQXJepPA3AAa1Q38W-o_DPQx7fcTVUH0vC4_BpB05d8,4766
-bunny2fmc-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bunny2fmc-1.0.8.dist-info/entry_points.txt,sha256=ZjZFEAAugvnna7HHbYcfivJGJway3qgM-S-B2lf9akI,49
-bunny2fmc-1.0.8.dist-info/top_level.txt,sha256=7a2i3_fKlFFNKUmSEDFbwXI_CXPEcUsrIisHNLEAXtM,10
-bunny2fmc-1.0.8.dist-info/RECORD,,