Metadata-Version: 2.1
Name: fortifetch
Version: 1.0.0
Summary: FortiFetch is a Python application that gathers information from FortiGate firewalls using the API and saves the information to a SQLite3 database. FortiFetch is built using Typer Python and the rich library for console output, and is designed to be easy to install, configure, and use.
License: MIT
Author: GT
Author-email: geuryt@yahoo.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: fortigate-api (>=1.0.2,<2.0.0)
Requires-Dist: rich (>=13.3.1,<14.0.0)
Requires-Dist: typer[all] (>=0.1.0,<0.2.0)
Description-Content-Type: text/markdown

# FortiFetch
![alt text](https://i.imgur.com/4NBl5Xm.png)

FortiFetch is a Python application that gathers information from FortiGate firewalls' API and saves the information to a SQLite3 database. FortiFetch is built using Python and the rich library for console output, and is designed to be easy to install, configure, and use.

## Tested on Fortigate VM version 7.2.4

Tables in SQL database:

- device
- interface
- firewallpolicy
- webprofile
- dnsprofile
- appprofile
- ipsprofile
- sslsshprofile
- avprofile
- address
- addressgroup
- internetservice
- ippool
- vip
- trafficshapers
- trafficpolicy
- dns
- staticroute
- policyroute
- snmpv2
- snmpv3
- fortiguard
- admin
- adminprofile
## Installation

To install FortiFetch, follow these steps:

### Create a folder and a new virtual environment using venv.

Create a new folder for fortifetch

```
mkdir fortifetch
```

Change into the new folder

```
cd fortifetch
```

Create a virtualenv

```
python -m venv .
```

Activate the virtual environment

```
source bin/activate
```

Install FortiFetch using pip

```
pip install fortifetch
```

### Set up the following environmental variables in your environment:

```
export FORTIFETCH_USERNAME=your_username
export FORTIFETCH_PASSWORD=your_password
export FORTIFETCH_INVENTORY=/your/path/inventory.yaml
export FORTIFETCH_SCHEME="http" or "https"
```

You can replace the values with your own FortiGate credentials and inventory file path. These environmental variables are used by FortiFetch to authenticate with your FortiGate devices and retrieve their information.

### Create an inventory file in YAML format with a list of your FortiGate devices, using the following format:

```
---
- hostname: example-hostname-1
  host: 192.168.0.1
- hostname: example-hostname-2
  host: 192.168.0.2
- hostname: example-hostname-3
  host: 192.168.0.3
```

Replace the values with your own FortiGate device hostnames and IP addresses. Save the file as inventory.yaml and provide its path as the value of FORTIFETCH_INVENTORY environmental variable.
## Usage
To use FortiFetch, you can run the following commands in your terminal:

```
fortifetch create-database: Creates a new SQLite3 database for FortiFetch.
fortifetch delete-database: Deletes the SQLite3 database for FortiFetch.
fortifetch execute-sql: Executes a SQL command on the FortiFetch database.
fortifetch update-all-devices: Retrieves information about all FortiGate devices and saves it to the FortiFetch database.
fortifetch show-devices: Displays a table of all devices in the FortiFetch database.
fortifetch show-dns: Displays a table of DNS information for all devices in the FortiFetch database.
fortifetch show-vpn-status: Displays a table of VPN information for all devices in the FortiFetch database.
fortifetch show-interface: Displays a table of interface information for all devices in the FortiFetch database.
You can also use the --help flag with any command to see more detailed usage instructions.
```

## Example
![alt text](https://i.imgur.com/AnZyzOR.png)
![alt text](https://i.imgur.com/kXJcrhB.png)
![alt text](https://i.imgur.com/sia2Pit.png)
![alt text](https://i.imgur.com/JVypaDs.png)
![alt text](https://i.imgur.com/xsTtiSB.png)
![alt text](https://i.imgur.com/dVbVoTD.png)

## Contributing
If you'd like to contribute to FortiFetch, please follow these steps:

Fork the FortiFetch repository.
Clone your fork to your local machine.
Create a new branch for your changes.
Make your changes and commit them.
Push your changes to your fork.
Create a pull request on the main FortiFetch repository.

## License
FortiFetch is licensed under the MIT license. See the LICENSE file for more information.

## Contact
If you have any questions or comments about FortiFetch, please feel free to contact me.
