Zbiorcze dodawanie analizy zagrożeń do Microsoft Sentinel z pliku CSV lub JSON

W tym artykule przedstawiono sposób dodawania wskaźników z obiektów CSV lub STIX z pliku JSON do analizy zagrożeń Microsoft Sentinel. Ponieważ udostępnianie analizy zagrożeń nadal odbywa się w wiadomościach e-mail i innych nieformalnych kanałach podczas toczącego się dochodzenia, możliwość szybkiego importowania tych informacji do Microsoft Sentinel jest ważna dla przekazywania pojawiających się zagrożeń zespołowi. Importowane obiekty wywiadu zagrożeń są następnie dostępne do zasilania innych zadań analitycznych, takich jak generowanie alertów bezpieczeństwa, incydentów i automatycznych reakcji.

Ważna

Po 31 marca 2027 r. Microsoft Sentinel nie będą już obsługiwane w Azure Portal i będą dostępne tylko w portalu Microsoft Defender. Wszyscy klienci korzystający z Microsoft Sentinel w Azure Portal zostaną przekierowane do portalu usługi Defender i będą używać Microsoft Sentinel tylko w portalu usługi Defender. Od lipca 2025 r. wielu nowych klientów jest automatycznie dołączanych i przekierowowanych do portalu usługi Defender.

Jeśli nadal używasz Microsoft Sentinel w Azure Portal, zalecamy rozpoczęcie planowania przejścia do portalu usługi Defender w celu zapewnienia płynnego przejścia i pełnego wykorzystania ujednoliconego środowiska operacji zabezpieczeń oferowanego przez Microsoft Defender. Aby uzyskać więcej informacji, zobacz It's Time to Move: Retiring Microsoft Sentinel's Azure Portal for greater security (Czas na przeniesienie: wycofanie Azure Portal Microsoft Sentinel w celu zwiększenia bezpieczeństwa).

Wymagania wstępne

Musisz mieć uprawnienia do odczytu i zapisu w obszarze roboczym Microsoft Sentinel, aby przechowywać analizę zagrożeń.

Wybieranie szablonu importu dla analizy zagrożeń

Dodaj wiele obiektów analizy zagrożeń za pomocą specjalnie spreparowanego pliku CSV lub JSON. Pobierz szablony plików, aby zapoznać się z polami i tym, jak odpowiadają danym, które posiadasz. Przejrzyj pola wymagane dla każdego typu szablonu, aby zweryfikować dane przed ich zaimportowaniem.

  1. W Microsoft Sentinel w Azure Portal w obszarze Zarządzanie zagrożeniami wybierz pozycję Analiza zagrożeń.

    W przypadku Microsoft Sentinel w portalu usługi Defender wybierz pozycję Microsoft Sentinel>Zarządzanie>analizą zagrożeń.

  2. Wybierz pozycję Importuj>importuj przy użyciu pliku.

  3. Z menu rozwijanego Format pliku wybierz pozycję CSV lub JSON.

    Zrzut ekranu przedstawiający menu rozwijane umożliwiające przekazanie pliku CSV lub JSON, wybranie szablonu do pobrania i określenie źródła.

    Uwaga

    Szablon CSV obsługuje tylko wskaźniki. Szablon JSON obsługuje wskaźniki i inne obiekty STIX, takie jak podmioty zagrożeń, wzorce ataków, tożsamości i relacje. Aby uzyskać więcej informacji na temat tworzenia obsługiwanych obiektów STIX w formacie JSON, zobacz w dokumentacji interfejsu Upload API.

  4. Po wybraniu szablonu przekazywania zbiorczego wybierz link Pobierz szablon .

  5. Rozważ grupowanie analizy zagrożeń według źródła, ponieważ każde przekazywanie plików wymaga źródła.

Szablony CSV i JSON dostarczają wszystkich pól potrzebnych do stworzenia jednego ważnego wskaźnika, w tym wymagane pola i parametry walidacyjne. Replikuj strukturę pola szablonu, aby wypełnić więcej wskaźników w jednym pliku lub dodaj obiekty STIX do pliku JSON. Aby uzyskać więcej informacji na temat szablonów, zobacz Omówienie szablonów importu.

Przekazywanie pliku analizy zagrożeń

Przekaż przygotowany plik CSV lub plik JSON i podaj szczegóły źródła importu.

  1. Zmień nazwę pliku z domyślnego szablonu, ale zachowaj rozszerzenie pliku jako .csv lub .json. Podczas tworzenia unikatowej nazwy pliku łatwiej jest monitorować import z okienka Zarządzanie importowaniem plików .

  2. Przeciągnij plik analizy zagrożeń zbiorczych do sekcji Przekazywanie pliku lub wyszukaj plik przy użyciu linku.

  3. Wprowadź źródło analizy zagrożeń w polu tekstowym Źródło . Wartość źródłowa widnieje na wszystkich wskaźnikach zawartych w tym pliku. Wyświetl tę właściwość SourceSystem jako pole. Wartość źródłowa jest również wyświetlana w okienku Zarządzanie importowaniem plików . Aby uzyskać więcej informacji, zobacz Praca ze wskaźnikami zagrożeń.

  4. Wybierz sposób, w jaki Microsoft Sentinel ma obsługiwać nieprawidłowe wpisy, wybierając jeden z przycisków u dołu okienka Importowanie przy użyciu pliku:

    • Zaimportuj tylko prawidłowe wpisy i pozostaw wszystkie nieprawidłowe wpisy z pliku.
    • Nie importuj żadnych wpisów, jeśli pojedynczy obiekt w pliku jest nieprawidłowy.

    Zrzut ekranu przedstawiający menu rozwijane umożliwiające przekazanie pliku CSV lub JSON, wybranie szablonu i określenie źródła wyróżniającego przycisk Importuj.

  5. Wybierz pozycję Importuj.

Zarządzanie importowaniem plików

Monitoruj importy i wyświetlaj raporty o błędach dotyczące importów częściowo zaimportowanych lub nieudanych.

  1. Wybierz pozycję Importuj>zarządzaj importowaniem plików.

    Zrzut ekranu przedstawiający opcję menu umożliwiającą zarządzanie importowaniem plików.

  2. Przejrzyj stan zaimportowanych plików i liczbę nieprawidłowych wpisów. Prawidłowa liczba wpisów jest aktualizowana po przetworzeniu pliku. Poczekaj na zakończenie importu, aby uzyskać zaktualizowaną liczbę prawidłowych wpisów.

    Zrzut ekranu przedstawiający okienko Zarządzanie importem plików z przykładowymi danymi importu. Kolumny przedstawiają dane posortowane według zaimportowanego numeru, pochodzące z różnych źródeł.

  3. Wyświetl i posortuj importy, wybierając pozycję Źródło, nazwę pliku analizy zagrożeń, liczbę zaimportowanych, łączną liczbę wpisów w każdym pliku lub datę utworzenia .

  4. Wybierz podgląd pliku błędu lub pobierz plik błędu zawierający błędy dotyczące nieprawidłowych wpisów.

Microsoft Sentinel utrzymuje stan importu pliku przez 30 dni. Rzeczywisty plik i skojarzony plik błędu są przechowywane w systemie przez 24 godziny. Po 24 godzinach plik i plik błędu zostaną usunięte, ale wszystkie pozyskane wskaźniki będą nadal wyświetlane w analizie zagrożeń.

Omówienie szablonów importu

Przejrzyj szablony CSV i JSON, aby upewnić się, że Twoje informacje o zagrożeniach zostały pomyślnie zaimportowane. Koniecznie odwołuj się do instrukcji w pliku szablonu CSV lub JSON oraz do dodatkowych wskazówek w sekcjach struktury szablonów CSV i JSON .

Struktura szablonów CSV

Użyj opcji szablonu CSV, aby wybrać właściwą strukturę dla danych wskaźnikowych.

  1. Z menu rozwijanego Typ wskaźnika wybierz pozycję CSV. Następnie wybierz między wskaźnikami plików lub opcjami Wszystkie inne typy wskaźników .

    Szablon CSV wymaga wielu kolumn, aby uwzględnić typ wskaźnika pliku, ponieważ wskaźniki plików mogą mieć wiele typów skrótów, takich jak MD5 i SHA256. Wszystkie inne typy wskaźników, takie jak adresy IP, wymagają tylko obserwowalnego typu i zauważalnej wartości.

  2. Nagłówki kolumn dla szablonu CSV Wszystkie inne typy wskaźników obejmują pola, takie jak threatTypes, pojedyncze lub wiele tags, confidencei tlpLevel. Pole tlpLevel ustawia poziom protokołu Traffic Light Protocol (TLP), który jest oznaczeniem poufności, aby ułatwić podejmowanie decyzji dotyczących udostępniania analizy zagrożeń.

  3. validFromWymagane są tylko pola , observableTypei observableValue .

  4. Usuń cały pierwszy wiersz z szablonu, aby usunąć komentarze przed przesłaniem.

    Maksymalny rozmiar pliku importu pliku CSV wynosi 50 MB.

Poniższy przykład CSV pokazuje, jak sformatować wskaźnik nazwy domeny do importu masowego za pomocą schematu szablonu CSV:

threatTypes,tags,name,description,confidence,revoked,validFrom,validUntil,tlpLevel,severity,observableType,observableValue
Phishing,"demo, csv",MDTI article - Franken-Phish domainname,Entity appears in MDTI article Franken-phish,100,,2022-07-18T12:00:00.000Z,,white,5,domain-name,1776769042.tailspintoys.com

Struktura szablonu JSON

Szablon JSON wykorzystuje jedną strukturę STIX 2.1 dla wszystkich obsługiwanych typów obiektów. Zapoznaj się z poniższymi szczegółami podczas przygotowywania pliku JSON.

  1. Istnieje tylko jeden szablon JSON dla wszystkich typów obiektów STIX. Szablon JSON jest oparty na formacie STIX 2.1.

  2. Element type obsługuje elementy indicator, attack-pattern, identity, threat-actori relationship.

  3. W przypadku wskaźników pattern element obsługuje typy wskaźników file, , ipv4-addripv6-addr, domain-name, url, user-account, email-addri windows-registry-key.

  4. Usuń komentarze szablonu przed przesłaniem.

  5. Zamknij ostatni obiekt w tablicy przy użyciu obiektu } bez przecinka.

    Maksymalny rozmiar pliku importu pliku JSON wynosi 250 MB.

Poniższy przykład JSON pokazuje, jak zdefiniować ipv4-addr wskaźnik i attack-pattern obiekt do importu masowego przy użyciu formatu STIX 2.1:

[
    {
      "type": "indicator",
      "id": "indicator--dbc48d87-b5e9-4380-85ae-e1184abf5ff4",
      "spec_version": "2.1",
      "pattern": "[ipv4-addr:value = '198.168.100.5']",
      "pattern_type": "stix",
      "created": "2022-07-27T12:00:00.000Z",
      "modified": "2022-07-27T12:00:00.000Z",
      "valid_from": "2016-07-20T12:00:00.000Z",
      "name": "Sample IPv4 indicator",
      "description": "This indicator implements an observation expression.",
      "indicator_types": [
        "anonymization",
        "malicious-activity"
      ],
      "kill_chain_phases": [
          {
            "kill_chain_name": "mandiant-attack-lifecycle-model",
            "phase_name": "establish-foothold"
          }
      ],
      "labels": ["proxy","demo"],
      "confidence": "95",
      "lang": "",
      "external_references": [],
      "object_marking_refs": [],
      "granular_markings": []
    },
    {
        "type": "attack-pattern",
        "spec_version": "2.1",
        "id": "attack-pattern--fb6aa549-c94a-4e45-b4fd-7e32602dad85",
        "created": "2015-05-15T09:12:16.432Z",
        "modified": "2015-05-20T09:12:16.432Z",
        "created_by_ref": "identity--f431f809-377b-45e0-aa1c-6a4751cae5ff",
        "revoked": false,
        "labels": [
            "heartbleed",
            "has-logo"
        ],
        "confidence": 55,
        "lang": "en",
        "object_marking_refs": [
            "marking-definition--34098fce-860f-48ae-8e50-ebd3cc5e41da"
        ],
        "granular_markings": [
            {
                "marking_ref": "marking-definition--089a6ecb-cc15-43cc-9494-767639779123",
                "selectors": [
                    "description",
                    "labels"
                ],
                "lang": "en"
            }
        ],
        "extensions": {
            "extension-definition--d83fce45-ef58-4c6c-a3f4-1fbc32e98c6e": {
                "extension_type": "property-extension",
                "rank": 5,
                "toxicity": 8
            }
        },
        "external_references": [
            {
                "source_name": "capec",
                "description": "spear phishing",
                "external_id": "CAPEC-163"
            }
        ],
        "name": "Attack Pattern 2.1",
        "description": "menuPass appears to favor spear phishing to deliver payloads to the intended targets. While the attackers behind menuPass have used other RATs in their campaign, it appears that they use PIVY as their primary persistence mechanism.",
        "kill_chain_phases": [
            {
                "kill_chain_name": "mandiant-attack-lifecycle-model",
                "phase_name": "initial-compromise"
            }
        ],
        "aliases": [
            "alias_1",
            "alias_2"
        ]
    }
]

W tym artykule przedstawiono sposób ręcznego wzmacniania analizy zagrożeń przez importowanie wskaźników i innych obiektów STIX zebranych w plikach prostych. Aby dowiedzieć się więcej na temat sposobu, w jaki analiza zagrożeń obsługuje inne analizy w Microsoft Sentinel, zobacz następujące artykuły: