Digital Shadows Searchlight -connector (met behulp van Azure Functions) voor Microsoft Sentinel

  • Artikel

De Digital Shadows-gegevensconnector biedt opname van de incidenten en waarschuwingen van Digital Shadows Searchlight in Microsoft Sentinel met behulp van de REST API. De connector verstrekt de informatie over incidenten en waarschuwingen, zodat deze helpt bij het onderzoeken, diagnosticeren en analyseren van de mogelijke beveiligingsrisico's en bedreigingen.

Dit is automatisch gegenereerde inhoud. Neem contact op met de provider van de oplossing voor wijzigingen.

Verbinding maken orkenmerken

Verbinding maken orkenmerk Beschrijving
Toepassingsinstellingen DigitalShadowsAccountID
WorkspaceID
WorkspaceKey
DigitalShadowsKey
DigitalShadowsSecret
HistoricalDays
DigitalShadowsURL
ClassificationFilterOperation
HighVariabilityClassifications
FUNCTION_NAME
logAnalyticsUri (optioneel)(voeg andere instellingen toe die vereist zijn voor de functie-app)Stel de DigitalShadowsURL waarde in op: https://api.searchlight.app/v1Stel de waarde in op: Stel de HighVariabilityClassifications waarde in op: exposed-credential,marked-documentexclude voor het ClassificationFilterOperation uitsluiten van de functie-app of include voor het opnemen van een functie-app
Code van Azure-functie-app https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/Digital%20Shadows/Data%20Connectors/Digital%20Shadows/digitalshadowsConnector.zip
Log Analytics-tabellen DigitalShadows_CL
Ondersteuning voor regels voor gegevensverzameling Wordt momenteel niet ondersteund
Ondersteund door Digitale schaduwen

Voorbeelden van query's

Alle Digital Shadows-incidenten en -waarschuwingen die zijn besteld op tijd die het laatst is gegenereerd

DigitalShadows_CL 
| order by raised_t desc

Vereisten

Als u wilt integreren met Digital Shadows Searchlight (met behulp van Azure Functions), moet u het volgende doen:

  • Machtigingen voor Microsoft.Web/sites: Lees- en schrijfmachtigingen voor Azure Functions om een functie-app te maken is vereist. Raadpleeg de documentatie voor meer informatie over Azure Functions.
  • REST API-referenties/machtigingen: Account-id, geheim en sleutel van Digital Shadows zijn vereist. Zie de documentatie voor meer informatie over API op de https://portal-digitalshadows.com/learn/searchlight-api/overview/description.

Installatie-instructies van leverancier

Notitie

Deze connector maakt gebruik van Azure Functions om verbinding te maken met een Digital Shadows Searchlight om de logboeken naar Microsoft Sentinel te halen. Dit kan leiden tot extra kosten voor gegevensopname. Raadpleeg de pagina met prijzen van Azure Functions voor meer informatie.

(Optionele stap) Sla werkruimte en API-autorisatiesleutel(s) of token(s) veilig op in Azure Key Vault. Azure Key Vault biedt een veilig mechanisme voor het opslaan en ophalen van sleutelwaarden. Volg deze instructies voor het gebruik van Azure Key Vault met een Azure Function-app.

STAP 1: configuratiestappen voor de API 'Digital Shadows Searchlight'

De provider moet gedetailleerde stappen opgeven of koppelen om het API-eindpunt 'Digital Shadows Searchlight' te configureren, zodat de Azure-functie zich kan verifiëren, de autorisatiesleutel of het token kan ophalen en de logboeken van het apparaat naar Microsoft Sentinel kan halen.

STAP 2: Kies EEN van de volgende twee implementatieopties om de connector en de bijbehorende Azure-functie te implementeren

BELANGRIJK: Voordat u de connector 'Digital Shadows Searchlight' implementeert, moet u de primaire sleutel voor de werkruimte en de primaire sleutel van de werkruimte (kunnen worden gekopieerd uit het volgende) en de API-autorisatiesleutel(s) of token 'Digital Shadows Searchlight' beschikbaar hebben.

Optie 1: ARM-sjabloon (Azure Resource Manager)

Gebruik deze methode voor geautomatiseerde implementatie van de Digital Shadows Searchlight-connector.

  1. Klik op de knop Implementeren in Azure hieronder.

    Implementeren in Azure

  2. Selecteer het voorkeursabonnement, de resourcegroep en de locatie.

  3. Voer de werkruimte-id, werkruimtesleutel, API-gebruikersnaam, API-wachtwoord, 'en/of andere vereiste velden' in.

Opmerking: Als u Azure Key Vault-geheimen gebruikt voor een van de bovenstaande waarden, gebruikt u het@Microsoft.KeyVault(SecretUri={Security Identifier})schema in plaats van de tekenreekswaarden. Raadpleeg de documentatie voor Key Vault-verwijzingen voor meer informatie. 4. Markeer het selectievakje met het label Ik ga akkoord met de bovenstaande voorwaarden. 5. Klik op Kopen om te implementeren.

Optie 2: handmatige implementatie van Azure Functions

Gebruik de volgende stapsgewijze instructies om de Digital Shadows Searchlight-connector handmatig te implementeren met Azure Functions.

  1. Een functie-app maken

  2. Navigeer vanuit Azure Portal naar de functie-app.

  3. Klik bovenaan op + Maken .

  4. Controleer op het tabblad Basisbeginselen of runtimestack is ingesteld op Python 3.8.

  5. Zorg ervoor dat het abonnementstype is ingesteld op Verbruik (serverloos) op het tabblad Hosting. 5.select Storage-account

  6. 'Andere vereiste configuraties toevoegen'.

  7. 'Breng indien nodig andere configuratiewijzigingen bij voorkeur aan'. Klik vervolgens op Maken.

  8. Functie-app-code importeren (zip-implementatie)

  9. Azure-CLI installeren

  10. Vanaf het terminaltype az functionapp deployment source config-zip -g <ResourceGroup> -n <FunctionApp> --src <Zip File> en druk op Enter. Stel de ResourceGroup waarde in op: de naam van de resourcegroep. Stel de waarde in op: de FunctionApp naam van de zojuist gemaakte functie-app. Stel de Zip File waarde in op: digitalshadowsConnector.zip(pad naar uw ZIP-bestand). Opmerking:- Download het zip-bestand via de koppeling - Functie-app-code

  11. De functie-app configureren

  12. Klik in het scherm Functie-app op de naam van de functie-app en selecteer Configuratie.

  13. Selecteer + Nieuwe toepassingsinstelling op het tabblad Toepassingsinstellingen.

  14. Voeg elk van de volgende toepassingsinstellingen voor x (aantal)' afzonderlijk toe. onder Naam, met de bijbehorende tekenreekswaarden (hoofdlettergevoelig) onder Waarde: DigitalShadowsAccountID WorkspaceID WorkspaceKey DigitalShadowsKey DigitalShadowsSecret HistoricalDays DigitalShadowsURL ClassificationFilterOperation HighVariabilityClassifications FUNCTION_NAME logAnalyticsUri (optioneel) (voeg eventuele andere instellingen toe die door de functie-app zijn vereist) Stel de DigitalShadowsURL waarde in op: https://api.searchlight.app/v1 Stel de HighVariabilityClassifications waarde in op: exposed-credential,marked-document Stel de waarde in onder Naam: WorkspaceID WorkspaceKey DigitalShadowsKey DigitalShadowsKey DigitalShadowsKey DigitalShadowsSecret HistoricalDays DigitalShadowsURL ClassificationFilterOperation HighVariabilityClassifications (optioneel) ClassificationFilterOperation waarde aan: exclude voor het uitsluiten van functie-app of include voor het opnemen van een functie-app

Opmerking: Als u Azure Key Vault-geheimen gebruikt voor een van de bovenstaande waarden, gebruikt u het@Microsoft.KeyVault(SecretUri={Security Identifier})schema in plaats van de tekenreekswaarden. Raadpleeg de documentatie voor Azure Key Vault-verwijzingen voor meer informatie.

  • Gebruik logAnalyticsUri om het eindpunt van de Log Analytics-API voor toegewezen cloud te overschrijven. Laat voor de openbare cloud bijvoorbeeld de waarde leeg; geef voor de Azure GovUS-cloudomgeving de waarde op in de volgende indeling: https://<CustomerId>.ods.opinsights.azure.us
  1. Zodra alle toepassingsinstellingen zijn ingevoerd, klikt u op Opslaan.

Volgende stappen

Ga naar de gerelateerde oplossing in Azure Marketplace voor meer informatie.