informations de référence sur le connecteur de données Blob de stockage Azure pour l’infrastructure de connecteur sans code

Pour créer un connecteur de données blob de stockage Azure avec l’infrastructure de connecteur sans code (CCF), utilisez cette référence en plus de l’article API REST Microsoft Sentinel pour les connecteurs de données.

Chaque dataConnector représente une connexion spécifique d’un connecteur de données Microsoft Sentinel. Un connecteur de données peut avoir plusieurs connexions, qui extraient des données à partir de différents points de terminaison. La configuration JSON générée à l’aide de ce document de référence est utilisée pour terminer le modèle de déploiement pour le connecteur de données CCF.

Pour plus d’informations, consultez Créer un connecteur sans code pour Microsoft Sentinel.

Créer le connecteur de données CCF d’objets blob Azure Storage

Simplifiez le développement de la connexion de votre source de données Blob de stockage Azure avec un exemple de modèle de déploiement de connecteur de données CCF d’objet blob de stockage. Pour plus d’informations , consultez Connector StorageBlob CCF template.

Une fois la plupart des sections de modèle de déploiement remplies, il vous suffit de générer les deux premiers composants, la table de sortie et la DCR. Pour plus d’informations, consultez les sections Définition de table de sortie et Règle de collecte de données (DCR).

Connecteurs de données - Créer ou mettre à jour

Reportez-vous à l’opération Créer ou mettre à jour dans la documentation de l’API REST pour rechercher la dernière version stable ou préliminaire de l’API. La différence entre l’opération de création et l’opération de mise à jour est que la mise à jour nécessite la valeur etag .

PUT , méthode

https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{resourceGroupName}}/providers/Microsoft.OperationalInsights/workspaces/{{workspaceName}}/providers/Microsoft.SecurityInsights/dataConnectors/{{dataConnectorId}}?api-version={{apiVersion}}

Paramètres d’URI

Pour plus d’informations sur la dernière version de l’API, consultez Connecteurs de données - Créer ou mettre à jour des paramètres d’URI.

Corps de la demande

Le corps de la demande pour un StorageAccountBlobContainer connecteur de données CCF a la structure suivante :

{
   "name": "{{dataConnectorId}}",
   "kind": "StorageAccountBlobContainer",
   "etag": "",
   "properties": {
        "connectorDefinitionName": "",
        "auth": {},
        "request": {},
        "dcrConfig": {},
        "response": {}
   }
}

StorageAccountBlobContainer

StorageAccountBlobContainer représente un connecteur de données CCF où les charges utiles de réponse attendues pour votre Azure source de données Storage Blob ont déjà été configurées. La configuration de votre producteur pour envoyer des données à Storage Blob doit être effectuée séparément.

Configuration de l’authentification

Le connecteur d’objets blob de stockage Azure s’appuie sur un principal de service créé dans votre locataire associé à une application multilocataire gérée par Microsoft (blueprint de principal de service). L’administrateur client doit accorder son consentement pour créer ce principal de service. Le modèle ARM permet de vérifier si le principal de service associé à l’application existe déjà dans votre locataire et, dans le cas contraire, fournit une option pour créer le principal de service avec le consentement de l’utilisateur.

L’exemple de modèle ARM inclut des opérations pour appliquer tous les accès en fonction du rôle nécessaires sur le compte de stockage pour lire des objets blob et contribuer aux files d’attente. Vérifiez que le modèle et les principaux de service utilisés sont associés à l’application pour votre environnement et que le consentement de l’administrateur du locataire a été accordé.

Le tableau suivant répertorie les ID d’application par Azure environnement :

Exemple d’authentification StorageAccountBlobContainer :

"auth": {
    "type": "ServicePrincipal"
}

Configuration de la demande

La section de demande décrit les files d’attente de stockage Azure qui reçoivent les messages d’événement créés par l’objet blob.

Exemple de requête StorageAccountBlobContainer :

"request": {
    "QueueUri": "[[concat('https://', variables('storageAccountName'), '.queue.core.windows.net/', variables('queueName'))]",
    "DlqUri": "[[concat('https://', variables('storageAccountName'), '.queue.core.windows.net/', variables('dlqName'))]"
}

Configuration de la réponse

Définissez la gestion des réponses de votre connecteur de données avec les paramètres suivants :

Exemples de configuration de réponse

JSON non compressé :

"response": {
    "EventsJsonPaths": ["$"],
    "format": "json"
}

CSV compressé :

"response": {
    "EventsJsonPaths": ["$"],
    "format": "csv",
    "IsGzipCompressed": true
}

Parquet (la compression peut être déduite) :

"response": {
    "EventsJsonPaths": ["$"],
    "format": "parquet"
}

Configuration de DCR

Exemple de connecteur de données CCF

Voici un exemple de tous les composants du connecteur de StorageAccountBlobContainer données CCF JSON.

{
    "kind": "StorageAccountBlobContainer",
    "properties": {
        "connectorDefinitionName": "[[parameters('connectorDefinitionName')]",
        "dcrConfig": {
            "streamName": "[variables('streamName')]",
            "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]",
            "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]"
        },
        "auth": {
            "type": "ServicePrincipal"
        },
        "request": {
            "QueueUri": "[[concat('https://', variables('storageAccountName'), '.queue.core.windows.net/', variables('queueName'))]",
            "DlqUri": "[[concat('https://', variables('storageAccountName'), '.queue.core.windows.net/', variables('dlqName'))]"
        }
    }
}

Pour plus d’informations, consultez Exemple d’API REST Créer un connecteur de données.

Contenu connexe

• Configurer votre connecteur de stockage Azure pour diffuser les journaux vers Microsoft Sentinel
• Créer un connecteur sans code pour Microsoft Sentinel
• Activer la sécurité réseau sur les ressources de stockage intégrées du connecteur