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.22.tar.gz (20.2 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.22-py3-none-any.whl (23.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: bunny2fmc-1.3.22.tar.gz
  • Upload date:
  • Size: 20.2 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.22.tar.gz
Algorithm Hash digest
SHA256 b1b928138679a4957f5cbdecbe2a33716bbc8495bfa656dafc35997d0307531a
MD5 4f45e180a87c7978bfbc4343b9ff4c51
BLAKE2b-256 1c5f35f1848ef8ca5e9c58f7c38c8292fb47bee6dc09bea52c7888560f5f9374

See more details on using hashes here.

File details

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

File metadata

  • Download URL: bunny2fmc-1.3.22-py3-none-any.whl
  • Upload date:
  • Size: 23.0 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.22-py3-none-any.whl
Algorithm Hash digest
SHA256 02c54bb2b0e85143d2d165cda4013696f4e321c54662fcfc3cb924b920f8b0be
MD5 d43af5d228e6a652bc1c6b3165e5e676
BLAKE2b-256 5e8d71abe086eb4bcd471fbadbe298eb45dd4c1826eb4a9f7ba28223f5699301

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