referencia del conector de datos de Azure Storage Blob para Codeless Connector Framework

Para crear un conector de datos de Azure Storage Blob con Codeless Connector Framework (CCF), use esta referencia además del artículo Microsoft Sentinel API REST para conectores de datos.

Cada uno dataConnector representa una conexión específica de un conector de datos de Microsoft Sentinel. Un conector de datos puede tener varias conexiones, que capturan datos de distintos puntos de conexión. La configuración JSON compilada con este documento de referencia se usa para completar la plantilla de implementación para el conector de datos CCF.

Para obtener más información, consulte Creación de un conector sin código para Microsoft Sentinel.

Compilación del conector de datos de Azure Storage Blob CCF

Simplifique el desarrollo de la conexión del origen de datos Azure Storage Blob con una plantilla de implementación de conector de datos CCF de Storage Blob de ejemplo. Para obtener más información, vea Connector StorageBlob CCF template (Almacenamiento del conectorBlob CCF template).

Con la mayoría de las secciones de plantilla de implementación rellenadas, solo es necesario compilar los dos primeros componentes, la tabla de salida y la DCR. Para obtener más información, vea las secciones Definición de tabla de salida y Regla de recopilación de datos (DCR).

Conectores de datos: creación o actualización

Haga referencia a la operación crear o actualizar en los documentos de la API REST para encontrar la versión más reciente de la API estable o en versión preliminar. La diferencia entre la operación de creación y actualización es que la actualización requiere el valor etag .

Método PUT

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

Parámetros de URI

Para obtener más información sobre la versión más reciente de la API, consulte Conectores de datos: creación o actualización de parámetros de URI.

Cuerpo de la solicitud

El cuerpo de la solicitud para un StorageAccountBlobContainer conector de datos CCF tiene la siguiente estructura:

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

StorageAccountBlobContainer

StorageAccountBlobContainer representa un conector de datos CCF donde ya se han configurado las cargas de respuesta esperadas para el origen de datos Azure Storage Blob. La configuración del productor para enviar datos a Storage Blob debe realizarse por separado.

Configuración de autenticación

El conector de Azure Storage Blob se basa en una entidad de servicio creada en el inquilino asociada a una aplicación multiinquilino administrada por Microsoft (plano técnico de entidad de servicio). El administrador de inquilinos debe conceder consentimiento para crear esta entidad de servicio. La plantilla de ARM proporciona la capacidad de confirmar si la entidad de servicio asociada a la aplicación ya existe en el inquilino y, en caso contrario, proporciona una opción para crear la entidad de servicio con el consentimiento del usuario.

El ejemplo de plantilla de ARM incluye operaciones para aplicar todo el acceso basado en rol necesario en la cuenta de almacenamiento para leer blobs y contribuir a las colas. Asegúrese de que la plantilla y las entidades de servicio usadas están asociadas a la aplicación para su entorno y que se ha concedido el consentimiento del administrador de inquilinos.

En la tabla siguiente se enumeran los identificadores de aplicación por entorno de Azure:

Ejemplo de autenticación de StorageAccountBlobContainer:

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

Configuración de la solicitud

En la sección de solicitud se describen las colas de Azure Storage que reciben mensajes de evento creados por blobs.

Ejemplo de solicitud StorageAccountBlobContainer:

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

Configuración de respuesta

Defina el control de respuesta del conector de datos con los parámetros siguientes:

Ejemplos de configuración de respuesta

JSON sin comprimir:

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

CSV comprimido:

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

Parquet (la compresión se puede inferir):

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

Configuración de DCR

Conector de datos CCF de ejemplo

Este es un ejemplo de todos los componentes del StorageAccountBlobContainer json del conector de datos CCF juntos.

{
    "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'))]"
        }
    }
}

Para obtener más información, consulte El ejemplo de API REST para crear conectores de datos.

Contenido relacionado

• Configure el conector de Azure Storage para transmitir registros a Microsoft Sentinel
• Creación de un conector sin código para Microsoft Sentinel
• Habilitación de la seguridad de red en los recursos de almacenamiento integrado del conector