الانتقال إلى المحتوى الرئيسي
POST
/
scans
/
cve
/
mac-address
/
cves
الحصول على الثغرات (CVEs) حسب عنوان MAC
curl --request POST \
  --url https://api.altostrat.io/scans/cve/mac-address/cves \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "mac_addresses": [
    "00:1A:2B:3C:4D:5E",
    "08:00:27:7C:2E:5A"
  ]
}'
{
  "mac_addresses": [
    "00:1A:2B:3C:4D:5E"
  ],
  "total_scans": 5,
  "total_cve_instances": 23,
  "total_host_count": 8,
  "mac_stats": {},
  "stats": {
    "unique_cve_count": 15,
    "highest_score": 9.8,
    "average_score": 7.5
  },
  "cves": [
    {
      "id": "9c46d2a1-1234-5678-9abc-def012345678",
      "cve_id": "CVE-2021-44228",
      "description": "ميزات Apache Log4j2 JNDI لا تحمي من نقاط النهاية التي يتحكم بها المهاجم لـ LDAP وغيرها من نقاط النهاية المتعلقة بـ JNDI.",
      "published_at": "2021-12-10T11:15:00Z",
      "created_at": "2025-10-29T12:10:00Z",
      "vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:H/I:H/A:H",
      "score": 10,
      "severity": "CRITICAL",
      "scan_id": "9c46a6f1-a8d8-4f5a-9b2f-7d1b3e9c5a1d",
      "compliance_tags": [
        "PCI-DSS",
        "HIPAA",
        "NIST"
      ],
      "host": {
        "id": "9c46d4e5-a1b2-c3d4-e5f6-a1b2c3d4e5f6",
        "hostname": "fileserver.local",
        "mac_address": "00:1A:2B:3C:4D:5E",
        "manufacturer": "Apple, Inc.",
        "ip_address": "192.168.1.101"
      },
      "status": "open",
      "other_occurrences": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "scan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "host_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "created_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

أدخل رمز الحامل الخاص بك بالتنسيق: Bearer {token}

Body

application/json

قائمة بعناوين MAC المراد الاستعلام عنها.

mac_addresses
string[]
required

مصفوفة من عنوان MAC واحد أو أكثر للبحث عنها.

Response

قائمة مفصلة بالثغرات (CVEs) التي تم العثور عليها لعناوين MAC المحددة.

تقرير شامل للثغرات الأمنية لعناوين MAC المطلوبة.

mac_addresses
string[]

قائمة عناوين MAC المضمنة في هذا التقرير.

Example:
["00:1A:2B:3C:4D:5E"]
total_scans
integer

العدد الإجمالي لعمليات الفحص الفريدة التي تم العثور فيها على عناوين MAC هذه.

Example:

5

total_cve_instances
integer

العدد الإجمالي لمثيلات الثغرات التي تم العثور عليها عبر جميع عمليات الفحص لعناوين MAC هذه.

Example:

23

total_host_count
integer

العدد الإجمالي لسجلات المضيف (تركيبات IP/المنفذ) المرتبطة بعناوين MAC هذه.

Example:

8

mac_stats
object

تفصيل لإحصائيات الثغرات لكل عنوان MAC مطلوب.

stats
object

إحصائيات مجمعة عبر جميع عناوين MAC المطلوبة.

cves
object[]

قائمة بالثغرات الفريدة التي تم العثور عليها، إلى جانب تكراراتها.