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.23.tar.gz (20.3 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.23-py3-none-any.whl (23.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bunny2fmc-1.3.23.tar.gz
  • Upload date:
  • Size: 20.3 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.23.tar.gz
Algorithm Hash digest
SHA256 128ccb328958415f838b22e838b4b50f6e091a9587ecd89d1f4a2129649d07b0
MD5 594b9dd7b528589987dd10b8bf1d849a
BLAKE2b-256 a184bb26c06ee1c530df4a305a50ec4cb2bbdad82110ff44ac8c0a85a9aa7a68

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bunny2fmc-1.3.23-py3-none-any.whl
  • Upload date:
  • Size: 23.1 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.23-py3-none-any.whl
Algorithm Hash digest
SHA256 77323728bc35f340584de3dd2e62493709d9dcb14d827b801b09b0c43ee88b8e
MD5 ac7bf172ca86c6f23c1acc6009c4c8f1
BLAKE2b-256 6c4950e3ac460ab56cce21e577905d368fdbc982eeb56a9d9b461440e56b9d38

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