Paso 1: obtener Python
Al instalar Python en Windows, asegúrese de activar "agregar Python. exe a la ruta"
- Mac OSX : Python 2.7.x ya está instalado.Vaya al paso 2.
- Linux: Python ya está instalado (normalmente 2.7.x).Vaya al paso 2.
Paso 2: get pan-Python
Ir a https://github.com/kevinsteves/pan-python/releases
- Windows: Descargar el código fuente (.zip)
- Mac OSX y Linux: Descargue pan-python-x.x.x.tar.gz y descomprima el archivo.
Paso 3: abrir una terminal- Windows: Pulse R WinKey+.En el cuadro de diálogo Ejecutar, escriba 'cmd' y pulse Intro
- Mac OSX : Navegar a aplicaciones -> Utilidades -> Terminal
- Linux: La mayoría de las distribuciones tienen un programa de terminal que puede ejecutar.
Paso 4: Navegue a pan-python en el terminal
En el terminal, utilice el comando 'cd' para navegar al directorio "bin" en el nuevo directorio que descomprimió anteriormente.
Por ejemplo: cd c:\Users\<username>\Downloads\pan-python-x.x.x\bin</username>
Paso 5: Generar una API clave para un firewall
Al conectarse a la conexión , la conexión debe incluir una clave que utiliza para PAN-OS API API firewall autenticar la conexión como procedente de un administrador específico.En este ejemplo, generaremos la API clave para el usuario administrador predeterminado.
Ejecute este comando en un terminal para generar una API clave para el usuario administrador.En este ejemplo, la firewall administración 's IP es 10.1.1.5 y las firewall credenciales son admin de nombre de usuario y administrador de contraseñas.
python panxapi.py -h 10.1.1.5 -l admin:admin -k
keygen: success
API key: "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09"
Registre la clave de API salida.Se utilizará en todas las llamadas API posteriores.
Paso 6: Hacer algunas API llamadas
Las API tiene muchas capacidades, incluida la capacidad de extraer datos estadísticos, modificar la configuración y recuperar registros, informes y pcaps.Aquí hay algunos ejemplos API de llamadas que puede probar en cualquier firewall .En cada API llamada, se pasa el script la API clave, un tipo de acción y un comando o xpath que indica firewall qué recuperar o hacer. Ejemplo
1: Obtener estadísticas de interfaz
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -x -o "<show><counter><interface>ethernet1/1</interface></counter></show>"
Ejemplo 2: Obtenga el firewall nombre de host 's
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr -s "/config/devices/entry/deviceconfig/system/hostname"
Ejemplo 3: obtener todos los objetos de dirección
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr -s "/config/devices/entry/vsys/entry/address"
Ejemplo 4: Cree un nuevo objeto de dirección llamado 'testobject' con el IP 5.5.5.5
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr -S "<ip-netmask>5.5.5.5</ip-netmask>" "/config/devices/entry/vsys/entry/address/entry[@name='testobject']"
Ejemplo 5: commit
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr --sync -C "<commit></commit>"
Paso 7: más información
- Consulte los vínculos de la sección Información adicional.
- Publicar preguntas o participar en el debate en el área de API discusión de la LIVEcommunity.