Referencia del conector de datos de GCP para Codeless Connector Framework

Para crear un conector de datos de Google Cloud Platform (GCP) con Codeless Connector Framework (CCF), use esta referencia como complemento de la documentación de la API rest de Microsoft Sentinel para conectores de datos .

Cada 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 creada con este documento de referencia se usa para completar la plantilla de implementación para el conector de datos CCF.

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

Compilación del conector de datos CCF de GCP

Simplifique el desarrollo de la conexión del origen de datos de GCP con una plantilla de implementación de conector de datos CCF de GCP de ejemplo.

Plantilla de ejemplo de CCF de GCP

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 el DCR. Para obtener más información, consulte las secciones Definición de tabla de salida y Regla de recopilación de datos (DCR).

Conectores de datos: creación o actualización

Consulte 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 preliminar. La diferencia entre la creación y la operación de 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 del identificador 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 GCP conector de datos CCF tiene la siguiente estructura:

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

Plataforma de Google Cloud (GCP)

GCP representa un conector de datos CCF en el que ya se han configurado las cargas de datos de paginación y respuesta esperadas para el origen de datos de Google Cloud Platform (GCP). La configuración del servicio GCP para enviar datos a un pub/sub de GCP debe realizarse por separado. Para obtener más información, vea Publicar mensaje en información general sobre Pub/Sub.

Configuración de autenticación

La autenticación en GCP desde Microsoft Sentinel usa un GCP Pub/Sub. Debe configurar la autenticación por separado. Use los scripts de Terraform aquí. Para obtener más información, consulte Autenticación de GCP Pub/Sub desde otro proveedor de nube.

Como procedimiento recomendado, use parámetros en la sección de autenticación en lugar de credenciales de codificación rígida. Para obtener más información, consulte Protección de la entrada confidencial.

Para crear la plantilla de implementación que también usa parámetros, debe escapar los parámetros de esta sección con un inicio [adicional. Esto permite que los parámetros asignen un valor en función de la interacción del usuario con el conector. Para obtener más información, consulte Caracteres de escape de expresiones de plantilla.

Para permitir que las credenciales se escriban desde la interfaz de usuario, la connectorUIConfig sección requiere instructions con los parámetros deseados. Para obtener más información, consulte Referencia de definiciones de conectores de datos para Codeless Connector Framework.

Ejemplo de autenticación de GCP:

"auth": {
    "serviceAccountEmail": "[[parameters('GCPServiceAccountEmail')]",
    "projectNumber": "[[parameters('GCPProjectNumber')]",
    "workloadIdentityProviderId": "[[parameters('GCPWorkloadIdentityProviderId')]"
}

Configuración de la solicitud

La sección de solicitud requiere y projectId desde el subscriptionNames GCP Pub/Sub.

Ejemplo de solicitud de GCP:

"request": {
    "projectId": "[[parameters('GCPProjectId')]",
    "subscriptionNames": [
        "[[parameters('GCPSubscriptionName')]"
    ]
}

Configuración de DCR

Conector de datos CCF de ejemplo

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

{
    "kind": "GCP",
    "properties": {
        "connectorDefinitionName": "[[parameters('connectorDefinitionName')]",
        "dcrConfig": {
            "streamName": "[variables('streamName')]",
            "dataCollectionEndpoint": "[[parameters('dcrConfig').dataCollectionEndpoint]",
            "dataCollectionRuleImmutableId": "[[parameters('dcrConfig').dataCollectionRuleImmutableId]"
        },
    "dataType": "[variables('dataType')]",
    "auth": {
        "serviceAccountEmail": "[[parameters('GCPServiceAccountEmail')]",
        "projectNumber": "[[parameters('GCPProjectNumber')]",
        "workloadIdentityProviderId": "[[parameters('GCPWorkloadIdentityProviderId')]"
    },
    "request": {
        "projectId": "[[parameters('GCPProjectId')]",
        "subscriptionNames": [
            "[[parameters('GCPSubscriptionName')]"
            ]
        }
    }
}

Para obtener más información, consulte El ejemplo de la API rest del conector de datos de GCP.