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.20.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.20-py3-none-any.whl (22.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bunny2fmc-1.3.20.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.20.tar.gz
Algorithm Hash digest
SHA256 9a98d398385fc67f4568f10a9db9c35ab6ca0c23779d2091480ccd3de2759b1a
MD5 71576e4220757c70c7af5d78c48fe1ce
BLAKE2b-256 ee12dcd24eb53667aac3e21437eb240fc9a4bda9075143f8c2b82caa8b59f147

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bunny2fmc-1.3.20-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.20-py3-none-any.whl
Algorithm Hash digest
SHA256 302ed7ca93484f945c1a7e146db8b1f56f0a132960a2a18af5daea3c15f71ed0
MD5 2bd00dd48cf2fc96afb8c360811f24de
BLAKE2b-256 7baf7c06bf10142cfca10b34cd5dfc6b47311e7f6f69a51521924a203bbe7bc6

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