Konektor Armis Alerts (pomocí Azure Functions) pro Microsoft Sentinel
Konektor Armis Alerts poskytuje možnost ingestovat upozornění Armis do Služby Microsoft Sentinel prostřednictvím rozhraní ARMIS REST API. Další informace najdete v dokumentaci https://<YourArmisInstance>.armis.com/api/v1/docs
k rozhraní API. Konektor poskytuje možnost získat informace o upozorněních z platformy Armis a identifikovat hrozby ve vašem prostředí a určit jejich prioritu. Armis využívá vaši stávající infrastrukturu ke zjišťování a identifikaci zařízení bez nutnosti nasazovat agenty.
Jedná se o automaticky vygenerovaný obsah. Pokud potřebujete změny, obraťte se na poskytovatele řešení.
Atributy konektoru
Atribut konektoru | Popis |
---|---|
Kód aplikace funkcí Azure | https://aka.ms/sentinel-ArmisAlertsAPI-functionapp |
Alias funkce Kusto | ArmisAlerts |
Adresa URL funkce Kusto | https://aka.ms/sentinel-ArmisAlertsAPI-parser |
Tabulky Log Analytics | Armis_Alerts_CL |
Podpora pravidel shromažďování dat | V současnosti není podporováno |
Podporováno | Armis Corporation |
Ukázky dotazů
Události upozornění Armis – všechny aktivity výstrah.
Armis_Alerts_CL
| sort by TimeGenerated desc
Požadavky
Pokud chcete provést integraci s upozorněními Armis (pomocí Azure Functions), ujistěte se, že máte:
- Oprávnění Microsoft.Web/sites: Vyžaduje se oprávnění ke čtení a zápisu do Azure Functions k vytvoření aplikace funkcí. Další informace o službě Azure Functions najdete v dokumentaci.
- Přihlašovací údaje nebo oprávnění rozhraní REST API: Vyžaduje se tajný klíč Armis. Další informace o rozhraní API najdete v dokumentaci
https://<YourArmisInstance>.armis.com/api/v1/doc
Pokyny k instalaci dodavatele
Poznámka:
Tento konektor používá Azure Functions k připojení k rozhraní Armis API k načtení protokolů do Microsoft Sentinelu. To může vést k dalším nákladům na příjem dat. Podrobnosti najdete na stránce s cenami služby Azure Functions.
(Volitelný krok) Bezpečně ukládejte pracovní prostor a autorizační klíče rozhraní API nebo tokeny ve službě Azure Key Vault. Azure Key Vault poskytuje zabezpečený mechanismus pro ukládání a načítání hodnot klíčů. Postupujte podle těchto pokynů k používání služby Azure Key Vault s aplikací funkcí Azure.
Poznámka:
Tento datový konektor závisí na analyzátoru založeném na funkci Kusto, která funguje podle očekávání. Pomocí následujícího postupu vytvořte alias funkcí Kusto ArmisAlerts .
KROK 1 : Kroky konfigurace pro rozhraní ARMIS API
Podle těchto pokynů vytvořte tajný klíč rozhraní API Armis.
- Přihlášení k instanci Armis
- Přejděte do Nastavení –> API Management
- Pokud tajný klíč ještě není vytvořený, stiskněte tlačítko Vytvořit a vytvořte tajný klíč.
- Pokud chcete získat přístup ke tajnému klíči, stiskněte tlačítko Zobrazit.
- Tajný klíč je teď možné zkopírovat a použít během konfigurace konektoru Armis Alerts.
KROK 2: V následujících dvou možnostech nasazení vyberte jednu z následujících dvou možností nasazení pro nasazení konektoru a přidružené funkce Azure Functions.
DŮLEŽITÉ: Před nasazením datového konektoru Armis Alert je možné snadno zkopírovat ID pracovního prostoru a primární klíč pracovního prostoru (můžete ho zkopírovat z následujícího) a také autorizační klíče armisového rozhraní API.
Možnost 1 – Šablona Azure Resource Manageru (ARM)
Tuto metodu použijte pro automatizované nasazení konektoru Armis.
Klikněte níže na tlačítko Nasadit do Azure .
Vyberte upřednostňované předplatné, skupinu prostředků a umístění.
Zadejte následující informace:
- Název funkce
- ID pracovního prostoru
- Klíč pracovního prostoru
- Tajný klíč Armis
- Armis URL
https://<armis-instance>.armis.com/api/v1/
- Název tabulky upozornění Armis
- Plán armis
- Vyhněte se duplicitám (výchozí hodnota: true)
Zaškrtněte políčko označené jako Souhlasím s podmínkami a ujednáními uvedenými výše.
Kliknutím na Koupit nasadíte.
Možnost 2 – Ruční nasazení služby Azure Functions
Pomocí následujících podrobných pokynů nasaďte datový konektor Armis Alert ručně se službou Azure Functions (nasazení přes Visual Studio Code).
1. Nasazení aplikace funkcí
POZNÁMKA: Budete muset připravit VS Code pro vývoj funkcí Azure.
Stáhněte si soubor aplikace funkcí Azure. Extrahujte archiv do místního vývojového počítače.
Spusťte VS Code. V hlavní nabídce zvolte Soubor a vyberte Otevřít složku.
Vyberte složku nejvyšší úrovně z extrahovaných souborů.
Na panelu aktivit zvolte ikonu Azure a pak v oblasti Azure: Functions zvolte tlačítko Nasadit do aplikace funkcí. Pokud ještě nejste přihlášení, zvolte ikonu Azure na panelu aktivit a pak v oblasti Azure: Functions zvolte Přihlásit se k Azure , pokud už jste přihlášení, přejděte k dalšímu kroku.
Podle pokynů na obrazovce zadejte tyto informace:
a. Vyberte složku: Zvolte složku z pracovního prostoru nebo přejděte do složky, která obsahuje vaši aplikaci funkcí.
b. Vyberte Předplatné: Zvolte předplatné, které chcete použít.
c. Vyberte Vytvořit novou aplikaci funkcí v Azure (nevybírejte možnost Upřesnit).
d. Zadejte globálně jedinečný název aplikace funkcí: Zadejte název, který je platný v cestě URL. Název, který zadáte, se ověří, aby se zajistilo, že je jedinečný ve službě Azure Functions. (např. ARMISXXXXX).
e. Vyberte modul runtime: Zvolte Python 3.8 nebo novější.
f. Vyberte umístění pro nové prostředky. Pokud chcete dosáhnout lepšího výkonu a nižších nákladů, zvolte stejnou oblast , ve které se nachází Microsoft Sentinel.
Zahájí se nasazení. Po vytvoření aplikace funkcí a použití balíčku nasazení se zobrazí oznámení.
Přejděte na Web Azure Portal pro konfiguraci aplikace funkcí.
2. Konfigurace aplikace funkcí
- V aplikaci funkcí vyberte název aplikace funkcí a vyberte Konfigurace.
- Na kartě Nastavení aplikace vyberte + Nové nastavení aplikace.
- Přidejte jednotlivá nastavení aplikace s příslušnými hodnotami (rozlišují se malá a velká písmena):
- ID pracovního prostoru
- Klíč pracovního prostoru
- Tajný klíč Armis
- Armis URL
https://<armis-instance>.armis.com/api/v1/
- Název tabulky upozornění Armis
- Plán armis
- Vyhněte se duplicitám (výchozí hodnota: true)
- LogAnalyticsUri (volitelné)
- K přepsání koncového bodu rozhraní API log Analytics pro vyhrazený cloud použijte logAnalyticsUri. Například pro veřejný cloud ponechte hodnotu prázdnou; Pro cloudové prostředí Azure GovUS zadejte hodnotu v následujícím formátu:
https://<CustomerId>.ods.opinsights.azure.us
.
- Po zadání všech nastavení aplikace klikněte na Uložit.
Další kroky
Další informace najdete v souvisejícím řešení na Azure Marketplace.