REST API

直接 API キーを使用して認証します

API キー ID とシークレットをカスタム HTTP ヘッダーに送信して、API リクエストを認証します。Direct API Key メソッドは、キーをセッショントークンに交換する手順を省きます。これにより、トークンのライフサイクルや有効期限を管理する必要がなくなるため、自動化スクリプトと CI/CD 統合が簡素化されます。主な利点は次のとおりです。

技術仕様:

この機能を使用するには、HTTP 要求に次のヘッダーを含めます。

• ヘッダー名: X-Api-Key
• ヘッダー値の形式: この値は、キー ID とキーシークレットをコロン (:) で区切って指定する必要があります。KeyID:KeySecret
• 例: 資格情報が次の場合:
  • Key ID: b0977ee5-c9df-0c8a-5909-184c690cbfa5
  • Key Secret: UnKUn7HupAX9MFviJqYHRy6w7Fk50anSlheQJxQhTiux
    ヘッダーは以下の形式でなければなりません。

    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 (リクエストライブラリー)

   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)