API REST

S'authentifier à l'aide d'une clé d'API directe

Authentifiez les requêtes API en envoyant votre ID de clé d'API et votre secret dans un en-tête HTTP personnalisé. La méthode Clé d'API directe ignore l'échange de votre clé contre un jeton de session. Cela simplifie les scripts d'automatisation et les intégrations CI/CD, car vous n'avez plus besoin de gérer les cycles de vie ou l'expiration des jetons. Les principaux avantages sont les suivants :

Spécifications techniques :

Pour utiliser cette fonction, incluez l'en-tête suivant dans vos requêtes HTTP :

• Nom d'en-tête : X-Api-Key
• Format de valeur d'en-tête : La valeur doit être composée de votre ID de clé et de votre secret de clé séparés par deux points (:). KeyID:KeySecret
• Exemple : Si vos informations d'identification sont :
  • Key ID: b0977ee5-c9df-0c8a-5909-184c690cbfa5
  • Key Secret: UnKUn7HupAX9MFviJqYHRy6w7Fk50anSlheQJxQhTiux
    L'en-tête doit ressembler à ceci :

    X-Api-Key: b0977ee5-c9df-0c8a-5909-184c690cbfa5:UnKUn7HupAX9MFviJqYHRy6w7Fk50anSlheQJxQhTiux

1. cURL

   curl -X GET "https://cloud.appscan.com/api/v4/Scans" \
                                       -H "Accept: application/json" \
                                       -H "X-Api-Key: <Your_Key_ID>:<Your_Key_Secret>"

2. Python (bibliothèque de requêtes)

   import requests
                                           
                                           url = "https://cloud.appscan.com/api/v4/Scans"
                                           key_id = "your_key_id"
                                           key_secret = "your_key_secret"
                                           
                                           # Construct the header value
                                           header_value = f"{key_id}:{key_secret}"
                                           
                                           headers = {
                                           "Accept": "application/json",
                                           "X-Api-Key": header_value
                                           }
                                           
                                           response = requests.get(url, headers=headers)
                                           
                                           if response.status_code == 200:
                                           print("Success:", response.json())
                                           else:
                                           print("Error:", response.status_code, response.text)