FMC Device Copy Automation

Overview

This repository contains Python scripts designed to interact with the Cisco Firepower Management Center (FMC) REST API to allow users to copy device configuration across multiple platforms. The FMC feature of device copy needs the source and destination device to be the same platform.

---

Scripts Included

Script Name	Description
get_config.py	Retrieves device specific settings such as interfaces, routes using the REST API.
delete_config.py	Deletes specified FTD objects or policies by their unique ID.
create_config.py	Creates new objects and routes based on input JSON payloads or templates.

---

How to run

• Installed Python libraries:

  pip install -r requirements.txt

• Enable virtual environment

  source virtualenv/bin/activate

• .env file containing:

  HOST=https://<your-fmc-ip>
  USERNAME=<your-username>
  PASSWORD=<your-password>
  FTDNAME=<ftd-name>

• Run the main file

  python3 -m src.main

• Use the following commands

  run get_configuration # to collect configuration from source FTD
  run create_configuration # to create objects on target FTD
  run delete_configuration # to delete objects 
  

---

What works

• Physical Interfaces
• Etherchannel Interfaces
• Subinterfaces
• Virtual Routers
• IPv4 Static Routes
• BGP Routes
• ECMP Configuration

---

Requirements

• Python 3.13+
• Required Python libraries:

  pip install -r requirements.txt

• Enable virtual environment

  source virtualenv/bin/activate

• .env file containing:

  HOST=https://<your-fmc-ip>
  USERNAME=<your-username>
  PASSWORD=<your-password>
  FTDNAME=<ftd-name>
  

Note: Ensure your user account has the required API access permissions in FMC.

---

Usage Examples

To be added

---

Roadmap / TODO

• Support for ospfv2/3

---

Contribution

Pull requests and feature requests are welcome. Please open an issue to discuss changes or improvements.

---

License

MIT License

---

Author

Munib Shah
Principal Architect / Cisco Services