GCP-gegevensconnectorreferentie voor het Codeless Connector Framework

Als u een GCP-gegevensconnector (Google Cloud Platform) wilt maken met het Codeless Connector Framework (CCF), gebruikt u deze verwijzing als aanvulling op de documenten Microsoft Sentinel REST API voor gegevensconnectors.

Elk dataConnector vertegenwoordigt een specifieke verbinding van een Microsoft Sentinel-gegevensconnector. Eén gegevensconnector kan meerdere verbindingen hebben, waarmee gegevens van verschillende eindpunten worden opgehaald. De JSON-configuratie die is gebouwd met behulp van dit referentiedocument, wordt gebruikt om de implementatiesjabloon voor de CCF-gegevensconnector te voltooien.

Zie Een connector zonder code maken voor Microsoft Sentinel voor meer informatie.

De GCP CCF-gegevensconnector bouwen

Vereenvoudig de ontwikkeling van het verbinden van uw GCP-gegevensbron met een voorbeeldsjabloon voor de implementatie van de GCP CCF-gegevensconnector.

GCP CCF-voorbeeldsjabloon

Nu de meeste secties van de implementatiesjabloon zijn ingevuld, hoeft u alleen de eerste twee onderdelen te bouwen, de uitvoertabel en de DCR. Zie de secties Definitie van uitvoertabel en DCR (Data Collection Rule) voor meer informatie.

Gegevensconnectors - Maken of bijwerken

Raadpleeg de bewerking Maken of Bijwerken in de REST API-documenten om de nieuwste stabiele of preview-API-versie te vinden. Het verschil tussen de bewerking maken en bijwerken is dat de update de etag-waarde vereist.

PUT-methode

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

URI-parameters

Zie Gegevensconnectors - URI-parameters maken of bijwerken voor meer informatie over de nieuwste API-versie.

Aanvraagtekst

De aanvraagtekst voor een GCP CCF-gegevensconnector heeft de volgende structuur:

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

GCP

GCP vertegenwoordigt een CCF-gegevensconnector waarin de nettoladingen voor paging en verwachte antwoorden voor uw GCP-gegevensbron (Google Cloud Platform) al zijn geconfigureerd. Het configureren van uw GCP-service voor het verzenden van gegevens naar een GCP Pub/Sub moet afzonderlijk worden uitgevoerd. Zie Bericht publiceren in pub/suboverzicht voor meer informatie.

Verificatieconfiguratie

Verificatie naar GCP van Microsoft Sentinel maakt gebruik van een GCP Pub/Sub. U moet de verificatie afzonderlijk configureren. Gebruik hier de Terraform-scripts. Zie GCP Pub/Sub-verificatie van een andere cloudprovider voor meer informatie.

Als best practice gebruikt u parameters in de verificatiesectie in plaats van referenties vast te coderen. Zie Vertrouwelijke invoer beveiligen voor meer informatie.

Als u de implementatiesjabloon wilt maken die ook parameters gebruikt, moet u de parameters in deze sectie laten ontsnappen met een extra start [. Hierdoor kunnen de parameters een waarde toewijzen op basis van de interactie van de gebruiker met de connector. Zie Escape-tekens voor sjabloonexpressies voor meer informatie.

Als u wilt dat de referenties vanuit de gebruikersinterface worden ingevoerd, vereist instructions de connectorUIConfig sectie met de gewenste parameters. Zie Naslaginformatie over gegevensconnectordefinities voor het Codeless Connector Framework voor meer informatie.

GCP-verificatievoorbeeld:

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

Aanvraagconfiguratie

De aanvraagsectie vereist de projectId en subscriptionNames van de GCP Pub/Sub.

Voorbeeld van GCP-aanvraag:

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

DCR-configuratie

Voorbeeld van CCF-gegevensconnector

Hier volgt een voorbeeld van alle onderdelen van de JSON van de GCP CCF-gegevensconnector.

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

Zie Rest API-voorbeeld van GCP-gegevensconnector maken voor meer informatie.