AntiBaitby FluenceSecurity

Dokumentacja dla deweloperów

Dokumentacja

Instrukcje i dokumentacja API: jak uruchamiać analizy AntiBait w aplikacji webowej i z własnego kodu.

Dokumentacja API

Graf zagrożeń IOC

Business

Buduj grafy powiązań, aby mapować aktorów zagrożeń i wizualizować ich infrastrukturę. Zwraca węzły i krawędzie gotowe do użycia w bibliotekach do wizualizacji grafów.

Endpoint API

GET
GET/api/iocs/graph

Parametry zapytania

iocValue: string (required)
  // The IOC value to center the graph on

iocType?: string
  // Filter by specific IOC type

depth?: number (default: 2, max: 3)
  // Graph traversal depth

Odpowiedź

{
  "success": true,
  "data": {
    "nodes": [...],
    "edges": [...]
  },
  "metadata": {
    "totalNodes": number,
    "totalEdges": number,
    "depth": number
  }
}

Przykładowe żądanie

Żądanie

GET /api/iocs/[email protected]&iocType=email&depth=2
Authorization: Bearer YOUR_API_KEY

Odpowiedź

{
  "success": true,
  "data": {
    "nodes": [
      {
        "id": "email:[email protected]",
        "type": "email",
        "value": "[email protected]",
        "isMalicious": true,
        "threatScore": 95,
        "occurrenceCount": 47,
        "firstSeen": "2025-10-15T08:20:00Z",
        "lastSeen": "2025-11-03T10:30:00Z"
      },
      {
        "id": "domain:evil.com",
        "type": "domain",
        "value": "evil.com",
        "isMalicious": true,
        "threatScore": 92,
        "occurrenceCount": 52,
        "firstSeen": "2025-10-15T08:20:00Z",
        "lastSeen": "2025-11-03T10:30:00Z"
      },
      {
        "id": "ip:203.0.113.1",
        "type": "ip",
        "value": "203.0.113.1",
        "isMalicious": true,
        "threatScore": 88,
        "occurrenceCount": 38,
        "firstSeen": "2025-10-20T12:00:00Z",
        "lastSeen": "2025-11-02T18:45:00Z"
      },
      {
        "id": "url:https://evil.com/phishing",
        "type": "url",
        "value": "https://evil.com/phishing",
        "isMalicious": true,
        "threatScore": 90,
        "occurrenceCount": 31,
        "firstSeen": "2025-10-18T14:30:00Z",
        "lastSeen": "2025-11-01T16:20:00Z"
      }
    ],
    "edges": [
      {
        "id": "email:[email protected]_uses_domain-domain:evil.com",
        "source": "email:[email protected]",
        "target": "domain:evil.com",
        "relationshipType": "email_uses_domain"
      },
      {
        "id": "email:[email protected]_from_ip-ip:203.0.113.1",
        "source": "email:[email protected]",
        "target": "ip:203.0.113.1",
        "relationshipType": "sent_from_ip"
      },
      {
        "id": "url:https://evil.com/phishing-url_contains_domain-domain:evil.com",
        "source": "url:https://evil.com/phishing",
        "target": "domain:evil.com",
        "relationshipType": "url_contains_domain"
      }
    ]
  },
  "metadata": {
    "totalNodes": 4,
    "totalEdges": 3,
    "depth": 2
  }
}

Struktura węzła

idstring

Unikalny identyfikator węzła w formacie "typ:wartość"

typestring

Typ IOC (email, domain, ip, url itp.)

valuestring

Wartość IOC

isMaliciousboolean

Czy IOC jest oznaczony jako złośliwy

threatScorenumber

Wynik zagrożenia (0-100)

occurrenceCountnumber

Liczba obserwacji tego IOC

firstSeendatetime

Znacznik czasu pierwszej obserwacji IOC

lastSeendatetime

Znacznik czasu ostatniej obserwacji IOC

Struktura krawędzi

idstring

Unikalny identyfikator krawędzi

sourcestring

ID węzła źródłowego (w formacie "typ:wartość")

targetstring

ID węzła docelowego (w formacie "typ:wartość")

relationshipTypestring

Typ relacji (np. "email_uses_domain", "sent_from_ip", "url_contains_domain")

Kompatybilne biblioteki wizualizacji

D3.js

Grafy siłowe i niestandardowe wizualizacje

Cytoscape.js

Analiza i wizualizacja sieci

vis.js

Interaktywne grafy sieciowe

Sigma.js

Renderowanie grafów na dużą skalę

Zastosowania

Mapowanie aktorów zagrożeń

Wizualizuj powiązania w infrastrukturze atakujących i wykrywaj sieci aktorów zagrożeń

Analiza infrastruktury

Mapuj złośliwą infrastrukturę, aby zrozumieć wzorce ataków i współdzielone zasoby

Badanie incydentów

Podczas incydentu bezpieczeństwa śledź relacje między wskaźnikami i odkrywaj powiązane IOC

Proaktywne blokowanie

Wykrywaj i blokuj całe sieci złośliwej infrastruktury, zanim dojdzie do ataku

Potrzebujesz pomocy z integracją API? Zespół wsparcia odpowiada w ciągu 24 godzin w dni robocze.

KontaktZobacz FAQZarządzaj kluczami API