Etape 1: obtenir python
Lors de l'installation de Python sur Windows, assurez-vous d'activer "Ajouter Python. exe à path"
- Mac OSX : Python 2.7.x est déjà installé.Passez à l’étape 2.
- Linux: Python est déjà installé (généralement 2.7.x).Passez à l’étape 2.
Etape 2: Get Pan-python
Allez à https://github.com/kevinsteves/pan-python/releases
- Fenêtres: Télécharger le Code source (.zip)
- Mac OSX et Linux: Télécharger pan-python-x.x.x.x.tar.gz et décompresser le fichier.
Etape 3: ouvrir un terminal- Fenêtres: Appuyez sur WinKey+ R .Dans le dialogue Run, tapez 'cmd' et appuyez sur entrez
- Mac OSX : Accédez aux applications -> Utilities -> Terminal
- Linux: La plupart des distributions ont un programme terminal que vous pouvez exécuter.
Étape 4: Naviguer vers pan-python en terminal
Dans le terminal, utilisez la commande « cd » pour naviguer vers le répertoire « bac » dans le nouvel annuaire que vous n’avez pas compressé plus tôt.
Par exemple: cd c:\Users\<username>\Downloads\pan-python-x.x.x.x\bin</username>
Étape 5: Générer une API clé pour un firewall
Lors de la connexion PAN-OS API à la , la connexion doit inclure une API clé que les firewall utilisations pour authentifier la connexion comme provenant d’un administrateur spécifique.Dans cet exemple, nous allons générer la clé API pour l’utilisateur admin par défaut.
Exécutez cette commande dans un terminal pour générer une API clé pour l’utilisateur admin.Dans cet exemple, la firewall gestion de la 'est IP 10.1.1.5 et les firewall informations d’identification sont admin nom d’utilisateur et admin mot de passe.
python panxapi.py -h 10.1.1.5 -l admin:admin -k
keygen: success
API key: "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09"
Enregistrez la clé API sortie.Il sera utilisé dans tous les appels API ultérieurs.
Étape 6 : Effectuer quelques appels API Le dispose de
nombreuses API fonctionnalités, y compris la possibilité de tirer des données statistiques, de modifier la configuration et de récupérer des journaux, des rapports et des pcaps.Voici quelques exemples d’appels API que vous pouvez tester sur n’importe quel firewall .Dans chaque API appel, vous passez le script de la API clé, un type d’action, et une commande ou xpath qui indique ce qu’il firewall faut récupérer ou faire. Exemple
1: Obtenir des statistiques d’interface
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -x -o "<show><counter><interface>ethernet1/1</interface></counter></show>"
Exemple 2: Obtenez le firewall nom d’hôte du '
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr -s "/config/devices/entry/deviceconfig/system/hostname"
Exemple 3: obtenir tous les objets d'adresse
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr -s "/config/devices/entry/vsys/entry/address"
Exemple 4 : Créez un nouvel objet d’adresse appelé « testobject » avec IP le 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']"
Exemple 5: Commit
python panxapi.py -h 10.1.1.5 -K "LUFRPT14MW5xOEo1R09KVlBZNnpnemh0VHRBOWl6TGM9bXcwM3JHUGVhRlNiY0dCR0srNERUQT09" -xr --sync -C "<commit></commit>"
Etape 7: en savoir plus
- Voir les liens dans la section Informations supplémentaires.
- Posez des questions ou engagez-vous dans API la discussion dans le domaine de la communauté LIVE.