Configurer l'accès sécurisé pour utiliser l'API REST avec Python

Introduction

Ce document décrit les étapes pour configurer l'accès à l'API et l'utiliser pour récupérer des informations de ressources à partir de l'accès sécurisé.

Conditions préalables

Cisco vous recommande de prendre connaissance des rubriques suivantes :

1. Python 3.x
2. API REST
3. Accès sécurisé Cisco

Exigences

Ces exigences doivent être remplies avant de poursuivre :

• Compte utilisateur Cisco Secure Access avec le rôle Administrateur complet.
• Compte Cisco Security Cloud Single Sign On (SCSO) pour se connecter à Secure Access.

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Tableau de bord Secure Access
• Python

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Configurer

L'API d'accès sécurisé fournit une interface REST standard et prend en charge le flux d'informations d'identification du client OAuth 2.0. Pour commencer, connectez-vous à Secure Access et créez vos clés d'API Secure Access. Ensuite, utilisez vos informations d'identification API pour générer un jeton d'accès à l'API.

Configurez la clé API à partir du tableau de bord Secure Access avant d'exécuter les scripts mentionnés dans cet article.

Créer une clé API

Créez une clé et un secret API en procédant comme suit. Connectez-vous à Secure Access avec l'URL : Secure Access

1. Dans la barre latérale gauche, sélectionnez l'optionAdmin. 
2. SousAdminsélectionner l'option API Keys:

Administrateur du tableau de bord d'accès sécurisé - Clés API

3. Dans le coin supérieur droit, cliquez sur le +  bouton Ajouter une nouvelle clé API :

Accès sécurisé - Ajouter une clé API

4. Fournissez le API Key Name, Description(facultatif), puis sélectionnez leKey scopeetExpiry date selon vos besoins. Une fois terminé, cliquez sur le bouton Create:

Accès sécurisé - Détails de la clé API

5. Copiez leAPI Keyet le Key Secret , puis cliquez surACCEPT AND CLOSE:

Accès sécurisé : clé API et secret

Code Python

Il existe plusieurs façons d'écrire ce code, étant donné que le jeton généré est valide pendant 3 600 secondes (1 heure). Vous pouvez soit créer deux scripts distincts dans lesquels le premier script peut être utilisé pour générer le jeton de support, puis un second script dans lequel ce jeton de support peut être utilisé pour effectuer l'appel API (extraction/mise à jour ou suppression) à la ressource qui vous intéresse, soit écrire un script unique pour effectuer les deux actions tout en s'assurant que si un jeton de support est déjà généré, une condition est conservée dans le code qu'un nouveau jeton de support ne soit pas généré chaque fois que le script est exécuté.

Afin de le faire fonctionner en python, veuillez vous assurer d'installer ces bibliothèques :

pip install oauthlib
pip install requests_oauthlib

Script 1 :

Assurez-vous de mentionner le bonclient_idetclient_secretdans ce script :

import requests
from oauthlib.oauth2 import BackendApplicationClient
from oauthlib.oauth2 import TokenExpiredError
from requests_oauthlib import OAuth2Session
from requests.auth import HTTPBasicAuth



token_url = 'https://api.sse.cisco.com/auth/v2/token'

client_id = "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
client_secret = "XXXXXXXXXXXXXXXXXXXXXXXXX"



class SecureAccessAPI:
    def __init__(self, url, ident, secret):
        self.url = url
        self.ident = ident
        self.secret = secret
        self.token = None

    def GetToken(self):
        auth = HTTPBasicAuth(self.ident, self.secret)
        client = BackendApplicationClient(client_id=self.ident)
        oauth = OAuth2Session(client=client)
        self.token = oauth.fetch_token(token_url=self.url, auth=auth)
        return self.token


# Get token
api = SecureAccessAPI(token_url, client_id, client_secret)
print("Token: " + str(api.GetToken()))

Sortie :

Le résultat de ce script doit ressembler à ceci :

Token: {'token_type': 'bearer', 'access_token': 'eyJhbGciOiJSUzI1NiIsImtpZCI6IjcyNmI5MGUzLWxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx...', 'expires_in': 3600, 'expires_at': 1707767804.6489065}

Leaccess_tokenest très long avec des milliers de caractères et, par conséquent, pour garder la sortie lisible, il a été raccourci juste pour cet exemple. 

Script 2 :

Le scriptaccess_tokendu script 1 peut ensuite être utilisé dans ce script pour effectuer des appels d'API. Par exemple, utilisez le script 2 pour récupérer les informations sur les groupes de tunnels réseau à l'aide de la ressource/deployments/v2/networktunnelgroups:

import requests
import pprint
import json
url = "https://api.sse.cisco.com/deployments/v2/networktunnelgroups"

BT = "eyJhbGciOiJSUzI1NiIsImtpZCI6IjcyNmI5MGUzLWxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx...'"

headers = { 'Authorization':f"Bearer {BT}"
,"Accept": "application/json" }

response = requests.request('GET', url, headers=headers)

json_object = json.loads(response.content)
pprint.pprint(json_object)

Sortie :

Le résultat de ce script doit ressembler à ceci :

Sortie Python - Groupes de tunnels réseau

Vous pouvez également rechercher des informations sur les stratégies, les ordinateurs en itinérance, les rapports, etc., à l'aide du Guide de l'utilisateur Secure Access Developers.

Dépannage

Les points de terminaison de l'API d'accès sécurisé utilisent des codes de réponse HTTP pour indiquer la réussite ou l'échec d'une requête API. En général, les codes de la plage 2xx indiquent la réussite, les codes de la plage 4xx indiquent une erreur qui résulte des informations fournies et les codes de la plage 5xx indiquent des erreurs de serveur. L'approche à adopter pour résoudre le problème dépend du code de réponse reçu :

API REST - Codes de réponse 1

API REST - Codes de réponse 2

Informations connexes

• Guide de l'utilisateur Cisco Secure Access
• Assistance technique et téléchargements Cisco
• Ajouter des clés d'API Secure Access
• Guide de l'utilisateur développeur