Aller au contenu principal

Alertes de sécurité Microsoft Graph

info

Bêta

Lakewatch est en Bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus au niveau du Workspace.

Lakewatch fournit un connecteur API pour ingérer les alertes de sécurité à partir de l’API de sécurité Microsoft Graphe, comme les alertes de Microsoft Defender XDR et Microsoft Sentinel. Cet article couvre les conditions préalables, les instructions de configuration, le schéma du connecteur et les observables de sécurité.

Prérequis​

Le connecteur nécessite :

  1. Serverless LakeFlow Pipelines activés dans votre Workspace.
  2. Unity Catalog, avec des privilèges pour créer ou utiliser une connexion Unity Catalog. Voir Autorisations de connexion.
  3. La version préliminaire de Lakeflow Connect pour les Log de Microsoft Graphe activée dans votre Workspace par un administrateur de Workspace. Voir Activer la version préliminaire du connecteur.
  4. Si la politique réseau serverless de votre workspace utilise un accès restreint, les domaines API de la source doivent figurer dans la liste des Domaines autorisés de la politique. Voir Autoriser les domaines API sources dans votre politique réseau.
  5. Un tenant Microsoft Entra ID qui utilise des produits de sécurité Microsoft, tels que Microsoft Defender XDR ou Microsoft Sentinel. Consultez la documentation sur le type de ressource d'alerte Microsoft.
  6. Autorisation d’inscrire une application dans Microsoft Entra ID et le rôle d’administrateur de rôle privilégié pour accorder le consentement administrateur aux autorisations d’application Microsoft Graphe. Voir Accorder un consentement administrateur à l’échelle du tenant à une application.

Limites connues​

  • La dimension à évolution lente (SCD) de type 2 n'est pas prise en charge.
  • Le connecteur prend en charge l'authentification OAuth machine-machine avec une application Microsoft Entra ID et un secret client. L'authentification OAuth utilisateur-machine et l'authentification de base ne sont pas prises en charge.
  • Le connecteur prend en charge le service mondial Microsoft, y compris le Government Communauté cloud (GCC), ainsi que les clouds US Government GCC High et Department of Defense (DoD). Il ne prend pas en charge Microsoft Graphe exploité par 21Vianet en Chine.
  • La période historique ne peut pas dépasser 180 jours. Voir Choisir la période à ingérer.

Configurer Microsoft Graphe pour l’ingestion​

Le connecteur s'authentifie en tant qu'application Microsoft Entra ID qui dispose de l'autorisation d'application SecurityAlert.Read.All pour Microsoft Graphe. Pour les étapes complètes, consultez Configurer l'authentification vers Microsoft Graph.

  1. Dans le centre d'administration Microsoft Entra, accédez à Entra ID > Inscriptions d'applications et enregistrez une application mono-tenant. Pour un tenant GCC High ou DoD, utilisez le portail Azure Government à l'adresse https://portal.azure.us.
  2. Sous Certificats et secrets , créez un secret client et copiez sa Valeur . Microsoft Entra n’affiche plus la valeur une fois que vous quittez la page.
  3. Sous Autorisations API , sélectionnez Ajouter une autorisation > Microsoft Graphe > Autorisations d'application , puis ajoutez SecurityAlert.Read.All. Le connecteur n'utilise pas d'autorisations déléguées.
  4. Sélectionnez Accorder le consentement de l’administrateur pour \.<your tenant> Confirmez que la colonne Type affiche Application et que la colonne État affiche Accordé pour <votre<your tenant> locataire\>.
  5. Sur la page Vue d’ensemble de l’application, copiez l’ ID de l’application (client) et l’ ID de l’annuaire (tenant) .
remarque

Les secrets client expirent au bout de 24 mois maximum. Avant l’expiration du secret, créez un secret client sur la même application et mettez à jour le Secret client sur la connexion Unity Catalog existante. Ne créez pas de nouvelle connexion.

astuce

Lorsque vous créez une connexion via l'interface utilisateur de Lakewatch, sélectionnez le cloud Microsoft dans lequel votre tenant s'exécute (commercial pour le service global incluant GCC, gcc_high ou dod) et saisissez l' ID client , le secret client et l' ID de tenant que vous avez copiés aux étapes précédentes.

Étapes suivantes​

Après avoir terminé la configuration ci-dessus, créez une source de données avec le connecteur Microsoft Graphe dans l’interface utilisateur de Lakewatch. Consultez les connecteurs d’API pour obtenir des instructions.


Schémas du connecteur et de Lakewatch​

Le connecteur ingère la table source suivante du schéma source default :

Table source

Données Microsoft Graphe

Analyseur Lakewatch intégré

security_alerts

Alertes de sécurité de l’API de sécurité Microsoft Graphe alerts_v2 Endpoint

microsoft_graph_security_alert

Table source

Données Microsoft Graphe

Analyseur Lakewatch intégré

security_alerts

Alertes de sécurité de l’API de sécurité Microsoft Graphe alerts_v2 Endpoint

microsoft_graph_security_alert

Le connecteur écrit chaque table source directement dans la destination configurée pour son analyseur intégré. Par default, la table de destination est nommée <parser>_<datasource>, où <datasource> est le nom de la source de données. Par exemple, avec le nom de source de données default ms_graph_logs, la table est microsoft_graph_security_alert_ms_graph_logs. Vous pouvez définir une destination différente lors de la création de la source de données. Il n’y a pas de table de staging brute distincte ou d’étape d’analyse ultérieure.

Colonnes gérées par Lakewatch​

Le connecteur utilise le champ source id comme clé primaire non nulle et le champ source lastUpdateDateTime comme curseur pour l'ingestion incrémentielle, de sorte que chaque synchronisation ingère également les alertes qui ont changé depuis la dernière exécution. Contrairement aux connecteurs qui synthétisent un ID Lakewatch, ce connecteur n'ajoute pas de colonne lw_id ou time. Pour limiter une query ou une règle de détection à une fenêtre de temps, transmettez une colonne de timestamp source à IN_TIMERANGE(), comme createdDateTime.

Pour les sources de données Lakewatch, le connecteur ajoute également :

  • lw_meta: la source de données et l'identité de connexion, le nom et la version de l'analyseur syntaxique, ainsi que l'heure d'ingestion.
  • lw_observables: observables de sécurité extraits par le connecteur.

Consultez Tables de sortie du connecteur.

Schéma de la table de sortie du connecteur​

La destination inclut les colonnes source et événement ci-dessous, ainsi que les colonnes lw_meta et lw_observables décrites ci-dessus.

Le schéma suivant inclut les champs d’alerte de sécurité de Microsoft Graphe. Pour consulter les définitions des champs, reportez-vous à la référence du connecteur Microsoft Graphe Logs et à la documentation de Microsoft sur le type de ressource d’alerte.

Schéma

Column

Data type

id

STRING

title

STRING

category

STRING

categories

ARRAY<STRING>

severity

STRING

status

STRING

serviceSource

STRING

detectionSource

STRING

detectorId

STRING

productName

STRING

providerAlertId

STRING

incidentId

STRING

incidentWebUrl

STRING

alertWebUrl

STRING

alertPolicyId

STRING

tenantId

STRING

description

STRING

recommendedActions

STRING

investigationState

STRING

determination

STRING

classification

STRING

assignedTo

STRING

actorDisplayName

STRING

threatDisplayName

STRING

threatFamilyName

STRING

mitreTechniques

ARRAY<STRING>

systemTags

ARRAY<STRING>

createdDateTime

TIMESTAMP

lastUpdateDateTime

TIMESTAMP

firstActivityDateTime

TIMESTAMP

lastActivityDateTime

TIMESTAMP

resolvedDateTime

TIMESTAMP

comments

VARIANT

evidence

VARIANT

additionalData

VARIANT

customDetails

VARIANT

Column

Data type

id

STRING

title

STRING

category

STRING

categories

ARRAY<STRING>

severity

STRING

status

STRING

serviceSource

STRING

detectionSource

STRING

detectorId

STRING

productName

STRING

providerAlertId

STRING

incidentId

STRING

incidentWebUrl

STRING

alertWebUrl

STRING

alertPolicyId

STRING

tenantId

STRING

description

STRING

recommendedActions

STRING

investigationState

STRING

determination

STRING

classification

STRING

assignedTo

STRING

actorDisplayName

STRING

threatDisplayName

STRING

threatFamilyName

STRING

mitreTechniques

ARRAY<STRING>

systemTags

ARRAY<STRING>

createdDateTime

TIMESTAMP

lastUpdateDateTime

TIMESTAMP

firstActivityDateTime

TIMESTAMP

lastActivityDateTime

TIMESTAMP

resolvedDateTime

TIMESTAMP

comments

VARIANT

evidence

VARIANT

additionalData

VARIANT

customDetails

VARIANT

Observables de sécurité​

Le connecteur extrait les champs suivants dans lw_observables.

Observables

Field

Observable

mitreTechniques[]

mitre_attack_technique

Field

Observable

mitreTechniques[]

mitre_attack_technique

Les champs de evidence dépendent du type de chaque entité de preuve, telle qu'un appareil ou un fichier. Le connecteur scanne evidence et extrait des valeurs vers lw_observables en faisant correspondre les noms des sous-champs. La correspondance ne dépend pas de la casse.

Observables de preuves

evidence subfield name

Observable

ipAddress, ipInterfaces, lastIpAddress, lastExternalIpAddress, clusterIP, externalIPs

ip

dnsDomain, domainName

domain

hostName, deviceDnsName

hostname

url

url

md5, sha1, sha256, value

hash

accountName

username

userPrincipalName

email

amazonResourceId

aws_arn

amazonAccountId

aws_account_id

evidence subfield name

Observable

ipAddress, ipInterfaces, lastIpAddress, lastExternalIpAddress, clusterIP, externalIPs

ip

dnsDomain, domainName

domain

hostName, deviceDnsName

hostname

url

url

md5, sha1, sha256, value

hash

accountName

username

userPrincipalName

email

amazonResourceId

aws_arn

amazonAccountId

aws_account_id