Kodsuz Bağlayıcı Çerçevesi için GCP veri bağlayıcısı başvurusu

Kodsuz Bağlayıcı Çerçevesi (CCF) ile google bulut platformu (GCP) veri bağlayıcısı oluşturmak için bu başvuruyu Veri Bağlayıcıları için Microsoft Sentinel REST API belgelerine ek olarak kullanın.

Her dataConnector biri, Microsoft Sentinel veri bağlayıcısının belirli bir bağlantısını temsil eder. Bir veri bağlayıcısı, farklı uç noktalardan veri getiren birden çok bağlantıya sahip olabilir. Bu başvuru belgesi kullanılarak oluşturulan JSON yapılandırması, CCF veri bağlayıcısının dağıtım şablonunu tamamlamak için kullanılır.

Daha fazla bilgi için bkz. Microsoft Sentinel için kodsuz bağlayıcı oluşturma.

GCP CCF veri bağlayıcısını oluşturma

GCP veri kaynağınızı örnek bir GCP CCF veri bağlayıcısı dağıtım şablonuyla bağlama geliştirmeyi basitleştirin.

GCP CCF örnek şablonu

Dağıtım şablonu bölümlerinin çoğu doldurulduğunda, yalnızca ilk iki bileşeni, çıkış tablosunu ve DCR'yi oluşturmanız gerekir. Daha fazla bilgi için Çıkış tablosu tanımı ve Veri Toplama Kuralı (DCR) bölümlerine bakın.

Veri Bağlayıcıları - Oluşturma veya güncelleştirme

En son kararlı veya önizleme API sürümünü bulmak için REST API belgelerinde Oluştur veya Güncelleştir işlemine başvurun. Oluşturma ve güncelleştirme işlemi arasındaki fark, güncelleştirmeninetag değerini gerektirmesidir.

PUT yöntemi

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

URI parametreleri

En son API sürümü hakkında daha fazla bilgi için bkz. Veri Bağlayıcıları - URI Parametrelerini Oluşturma veya Güncelleştirme.

Name Açıklama
dataConnectorId Veri bağlayıcısı kimliği benzersiz bir ad olmalıdır ve name parametreyle aynıdır.
resourceGroupName Büyük/küçük harfe duyarlı değil, kaynak grubunun adı.
subscriptionId Hedef aboneliğin kimliği.
Workspacename Çalışma alanının adı , kimliği değil.
Regex deseni: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api sürümü Bu işlem için kullanılacak API sürümü.

İstek gövdesi

CCF GCP veri bağlayıcısı için istek gövdesi aşağıdaki yapıya sahiptir:

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

GCP

GCP , Google Cloud Platform (GCP) veri kaynağınız için disk belleği ve beklenen yanıt yüklerinin zaten yapılandırıldığı bir CCF veri bağlayıcısını temsil eder. GCP hizmetinizi GCP Pub/Sub'a veri gönderecek şekilde yapılandırma işlemi ayrı olarak yapılmalıdır. Daha fazla bilgi için bkz. Pub/Sub'da ileti yayımlamaya genel bakış.

Name Gerekli Tür Açıklama
Adı True dize URI parametresiyle eşleşen bağlantının benzersiz adı
Tür True dize Olmalıdır GCP
Etag GUID Yeni bağlayıcılar oluşturmak için boş bırakın. Güncelleştirme işlemleri için etag, mevcut bağlayıcının etag'iyle (GUID) eşleşmelidir.
properties.connectorDefinitionName dize Veri bağlayıcısının kullanıcı arabirimi yapılandırmasını tanımlayan DataConnectorDefinition kaynağının adı. Daha fazla bilgi için bkz. Veri Bağlayıcısı Tanımı.
Özellikler. Auth True İç İçe JSON GCP verilerini yoklama kimlik bilgilerini açıklar. Daha fazla bilgi için bkz. kimlik doğrulama yapılandırması.
Özellikler. Istek True İç İçe JSON Verileri yoklama için GCP proje kimliğini ve GCP aboneliğini açıklar. Daha fazla bilgi için bkz. İstek yapılandırması.
Özellikler. dcrConfig İç İçe JSON Veriler bir Veri Toplama Kuralına (DCR) gönderildiğinde gerekli parametreler. Daha fazla bilgi için bkz. DCR yapılandırması.

Kimlik doğrulama yapılandırması

Microsoft Sentinel'dan GCP kimlik doğrulamasında GCP Pub/Sub kullanılır. Kimlik doğrulamasını ayrı olarak yapılandırmanız gerekir. Terraform betiklerini burada kullanın. Daha fazla bilgi için bkz. Başka bir bulut sağlayıcısından GCP Pub/Sub kimlik doğrulaması.

En iyi yöntem olarak, kimlik bilgilerini sabit kodlamak yerine kimlik doğrulama bölümündeki parametreleri kullanın. Daha fazla bilgi için bkz . Gizli girişin güvenliğini sağlama.

Parametreleri de kullanan dağıtım şablonunu oluşturmak için, ek bir başlangıç [ile bu bölümdeki parametrelerden kaçış yapmanız gerekir. Bu, parametrelerin bağlayıcıyla kullanıcı etkileşimini temel alan bir değer atamasına olanak tanır. Daha fazla bilgi için bkz . Şablon ifadeleri kaçış karakterleri.

Kimlik bilgilerinin kullanıcı arabiriminden girilebilmesini sağlamak için bölümü connectorUIConfig istenen parametreleri gerektirir instructions . Daha fazla bilgi için bkz. Kodsuz Bağlayıcı Çerçevesi için veri bağlayıcısı tanımları başvurusu.

GCP kimlik doğrulaması örneği:

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

İstek yapılandırması

İstek bölümü GCP Pub/Sub'dan ve projectId değerlerini gerektirirsubscriptionNames.

GCP isteği örneği:

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

DCR yapılandırması

Alan Gerekli Tür Açıklama
DataCollectionEndpoint True Dize DCE (Veri Toplama Uç Noktası) örneğin: https://example.ingest.monitor.azure.com.
DataCollectionRuleImmutableId True Dize DCR sabit kimliği. DCR oluşturma yanıtını görüntüleyerek veya DCR API'sini kullanarak bu yanıtı bulun
StreamName True dize Bu değer, DCR'de tanımlanan değerdir streamDeclaration (ön ek Özel-ile başlamalıdır)

Örnek CCF veri bağlayıcısı

CcF veri bağlayıcısı JSON'un tüm bileşenlerine GCP bir örnek aşağıda verilmiştir.

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

Daha fazla bilgi için bkz. GCP veri bağlayıcısı REST API örneği oluşturma.

  • Last updated on