Skip to main content

Sync BunnyCDN edge IPs to Cisco FMC Dynamic Objects with secure credential management and scheduling

Project description

bunny2fmc

Automatically sync BunnyCDN IP ranges to Cisco FMC Dynamic Objects.

Quick Install

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:

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:

pipx ensurepath
source ~/.bashrc

bunny2fmc not found:

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:

pipx upgrade bunny2fmc

Uninstall:

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

License

MIT License - see LICENSE file.

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

bunny2fmc-1.3.21.tar.gz (19.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bunny2fmc-1.3.21-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

Details for the file bunny2fmc-1.3.21.tar.gz.

File metadata

  • Download URL: bunny2fmc-1.3.21.tar.gz
  • Upload date:
  • Size: 19.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for bunny2fmc-1.3.21.tar.gz
Algorithm Hash digest
SHA256 9beaac10b864f303abe4b133fee566f888ef51fec21e940c3286b845e3abff44
MD5 aea778099e806ddc2e52de1e8937f04e
BLAKE2b-256 1f1a9b041286518a12236ac60be3489f50589c7a038050b3d9b1341a19d8898a

See more details on using hashes here.

File details

Details for the file bunny2fmc-1.3.21-py3-none-any.whl.

File metadata

  • Download URL: bunny2fmc-1.3.21-py3-none-any.whl
  • Upload date:
  • Size: 22.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for bunny2fmc-1.3.21-py3-none-any.whl
Algorithm Hash digest
SHA256 f6141bec69ce49c5c689d0bae02c44519221523da52a2b6daf7b47b0e1c7b15f
MD5 cd728acc76c5523ce769acf64ae2b79f
BLAKE2b-256 cf11023a1c56860896c40b8002ed6cc9c82bb09a9a94e62d49f8652e339937a5

See more details on using hashes here.

Supported by

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