Referanse for GCP-datakobling for Codeless Connector Framework

Hvis du vil opprette en Google Cloud Platform (GCP)-datakobling med Codeless Connector Framework (CCF), kan du bruke denne referansen som et tillegg til Microsoft Sentinel REST-API for Data Connectors-dokumenter.

Hver dataConnector av dem representerer en bestemt tilkobling til en Microsoft Sentinel datakobling. Én datakobling kan ha flere tilkoblinger, som henter data fra forskjellige endepunkter. JSON-konfigurasjonen som er bygget ved hjelp av dette referansedokumentet, brukes til å fullføre distribusjonsmalen for CCF-datakoblingen.

Hvis du vil ha mer informasjon, kan du se Opprette en kodeløs kobling for Microsoft Sentinel.

Bygg GCP CCF-datakoblingen

Forenkle utviklingen av tilkobling av GCP-datakilden med en eksempelmal for distribusjon av GCP CCF-datakobling.

Eksempelmal for GCP CCF

Med de fleste delene av distribusjonsmalen fylt ut, trenger du bare å bygge de to første komponentene, utdatatabellen og DCR. Hvis du vil ha mer informasjon, kan du se avsnittene Definisjon av utdatatabell og Datainnsamlingsregel (DCR ).

Datakoblinger – Opprett eller oppdater

Referer til opprettings- eller oppdateringsoperasjonen i REST-API-dokumentene for å finne den nyeste stabile API-versjonen eller forhåndsversjonen av API-en. Forskjellen mellom opprettingen og oppdateringsoperasjonen er at oppdateringen krever etag-verdien .

PUT-metode

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

URI-parametere

Hvis du vil ha mer informasjon om den nyeste API-versjonen, kan du se Datakoblinger – Opprette eller oppdatere URI-parametere.

Forespørselstekst

Forespørselsteksten for en GCP CCF-datakobling har følgende struktur:

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

GCP

GCP representerer en CCF-datakobling der sideveksling og forventede nyttelaster for svar for Datakilden for Google Cloud Platform (GCP) allerede er konfigurert. Konfigurering av GCP-tjenesten til å sende data til en GCP Pub/Sub må gjøres separat. Hvis du vil ha mer informasjon, kan du se Pub/Sub-oversikt.

Godkjenningskonfigurasjon

Godkjenning til GCP fra Microsoft Sentinel bruker en GCP Pub/Sub. Du må konfigurere godkjenningen separat. Bruk Terraform-skriptene her. Hvis du vil ha mer informasjon, kan du se GCP Pub/Sub-godkjenning fra en annen skyleverandør.

Som en anbefalt fremgangsmåte kan du bruke parametere i godkjenningsdelen i stedet for hardkodingslegitimasjon. Hvis du vil ha mer informasjon, kan du se Sikre konfidensielle inndata.

Hvis du vil opprette distribusjonsmalen som også bruker parametere, må du fjerne parameterne i denne inndelingen med en ekstra start [. Dette gjør at parameterne kan tilordne en verdi basert på brukersamhandlingen med koblingen. Hvis du vil ha mer informasjon, kan du se Escape-tegn for maluttrykk.

Hvis du vil at legitimasjonen skal angis fra brukergrensesnittet, krever instructions inndelingen connectorUIConfig de ønskede parameterne. Hvis du vil ha mer informasjon, kan du se definisjonsreferansen for Data connector for Codeless Connector Framework.

GCP-godkjenningseksempel:

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

Be om konfigurasjon

Forespørselsdelen krever projectId og subscriptionNames fra GCP Pub/Sub.

Eksempel på GCP-forespørsel:

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

DCR-konfigurasjon

Eksempel på CCF-datakobling

Her er et eksempel på alle komponentene i CCF-datakoblingen GCP JSON sammen.

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

Hvis du vil ha mer informasjon, kan du se eksemplet opprett GCP-datakobling for REST-API.