Microsoft.SecurityInsights dataConnectors 2024-09-01

Artykuł
12/17/2024

Definicja zasobu Bicep

Typ zasobu dataConnectors można wdrożyć za pomocą operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.SecurityInsights/dataConnectors, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.SecurityInsights/dataConnectors@2024-09-01' = {
  etag: 'string'
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.SecurityInsights/dataConnectors objects
}

Obiekty Obiektu NieauthConfig

Ustaw właściwość , aby określić typ obiektu.

W przypadku apiKeyużyj:

{
  apiKey: 'string'
  apiKeyIdentifier: 'string'
  apiKeyName: 'string'
  isApiKeyInPostPayload: bool
  type: 'APIKey'
}

W przypadku usługi AWSużyj:

{
  externalId: 'string'
  roleArn: 'string'
  type: 'AWS'
}

W przypadkuBasic użyj:

{
  password: 'string'
  type: 'Basic'
  userName: 'string'
}

W przypadku GCP użyj:

{
  projectNumber: 'string'
  serviceAccountEmail: 'string'
  type: 'GCP'
  workloadIdentityProviderId: 'string'
}

W przypadku usługi GitHubużyj:

{
  installationId: 'string'
  type: 'GitHub'
}

W przypadku JwtToken użyj:

{
  headers: {
    {customized property}: 'string'
  }
  isCredentialsInHeaders: bool
  isJsonRequest: bool
  password: {
    {customized property}: 'string'
  }
  queryParameters: {
    {customized property}: 'string'
  }
  requestTimeoutInSeconds: int
  tokenEndpoint: 'string'
  type: 'JwtToken'
  userName: {
    {customized property}: 'string'
  }
}

W przypadku Noneużyj:

{
  type: 'None'
}

W przypadku OAuth2użyj:

{
  accessTokenPrepend: 'string'
  authorizationCode: 'string'
  authorizationEndpoint: 'string'
  authorizationEndpointHeaders: {
    {customized property}: 'string'
  }
  authorizationEndpointQueryParameters: {
    {customized property}: 'string'
  }
  clientId: 'string'
  clientSecret: 'string'
  grantType: 'string'
  isCredentialsInHeaders: bool
  isJwtBearerFlow: bool
  redirectUri: 'string'
  scope: 'string'
  tokenEndpoint: 'string'
  tokenEndpointHeaders: {
    {customized property}: 'string'
  }
  tokenEndpointQueryParameters: {
    {customized property}: 'string'
  }
  type: 'OAuth2'
}

W przypadku oracleużyj:

{
  pemFile: 'string'
  publicFingerprint: 'string'
  tenantId: 'string'
  type: 'Oracle'
  userId: 'string'
}

W przypadku ServiceBusużyj:

{
  credentialsConfig: {
    {customized property}: 'string'
  }
  storageAccountCredentialsConfig: {
    {customized property}: 'string'
  }
  type: 'ServiceBus'
}

W przypadkusesji użyj:

{
  headers: {
    {customized property}: 'string'
  }
  isPostPayloadJson: bool
  password: {
    {customized property}: 'string'
  }
  queryParameters: {
    {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
  }
  sessionIdName: 'string'
  sessionLoginRequestUri: 'string'
  sessionTimeoutInMinutes: int
  type: 'Session'
  userName: {
    {customized property}: 'string'
  }
}

Obiekty Microsoft.SecurityInsights/dataConnectors

Ustaw właściwość typu , aby określić typ obiektu.

W przypadku AmazonWebServicesCloudTrailużyj:

{
  kind: 'AmazonWebServicesCloudTrail'
  properties: {
    awsRoleArn: 'string'
    dataTypes: {
      logs: {
        state: 'string'
      }
    }
  }
}

W przypadku azureActiveDirectoryużyj:

{
  kind: 'AzureActiveDirectory'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

W przypadku AzureAdvancedThreatProtectionużyj:

{
  kind: 'AzureAdvancedThreatProtection'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

W przypadku AzureSecurityCenter użyj:

{
  kind: 'AzureSecurityCenter'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    subscriptionId: 'string'
  }
}

W przypadku microsoftCloudAppSecurityużyj:

{
  kind: 'MicrosoftCloudAppSecurity'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
      discoveryLogs: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

W przypadku MicrosoftDefenderAdvancedThreatProtectionużyj:

{
  kind: 'MicrosoftDefenderAdvancedThreatProtection'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

W przypadku MicrosoftThreatIntelligenceużyj:

{
  kind: 'MicrosoftThreatIntelligence'
  properties: {
    dataTypes: {
      microsoftEmergingThreatFeed: {
        lookbackPeriod: 'string'
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

W przypadku usługi Office365użyj:

{
  kind: 'Office365'
  properties: {
    dataTypes: {
      exchange: {
        state: 'string'
      }
      sharePoint: {
        state: 'string'
      }
      teams: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

W przypadku PremiumMicrosoftDefenderForThreatIntelligenceużyj:

{
  kind: 'PremiumMicrosoftDefenderForThreatIntelligence'
  properties: {
    dataTypes: {
      connector: {
        state: 'string'
      }
    }
    lookbackPeriod: 'string'
    requiredSKUsPresent: bool
    tenantId: 'string'
  }
}

W przypadku RestApiPoller użyj:

{
  kind: 'RestApiPoller'
  properties: {
    addOnAttributes: {
      {customized property}: 'string'
    }
    auth: {
      type: 'string'
      // For remaining properties, see CcpAuthConfig objects
    }
    connectorDefinitionName: 'string'
    dataType: 'string'
    dcrConfig: {
      dataCollectionEndpoint: 'string'
      dataCollectionRuleImmutableId: 'string'
      streamName: 'string'
    }
    isActive: bool
    paging: {
      pageSize: int
      pageSizeParameterName: 'string'
      pagingType: 'string'
    }
    request: {
      apiEndpoint: 'string'
      endTimeAttributeName: 'string'
      headers: {
        {customized property}: 'string'
      }
      httpMethod: 'string'
      isPostPayloadJson: bool
      queryParameters: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
      queryParametersTemplate: 'string'
      queryTimeFormat: 'string'
      queryTimeIntervalAttributeName: 'string'
      queryTimeIntervalDelimiter: 'string'
      queryTimeIntervalPrepend: 'string'
      queryWindowInMin: int
      rateLimitQPS: int
      retryCount: int
      startTimeAttributeName: 'string'
      timeoutInSeconds: int
    }
    response: {
      compressionAlgo: 'string'
      convertChildPropertiesToArray: bool
      csvDelimiter: 'string'
      csvEscape: 'string'
      eventsJsonPaths: [
        'string'
      ]
      format: 'string'
      hasCsvBoundary: bool
      hasCsvHeader: bool
      isGzipCompressed: bool
      successStatusJsonPath: 'string'
      successStatusValue: 'string'
    }
  }
}

W przypadkuThreatIntelligence użyj:

{
  kind: 'ThreatIntelligence'
  properties: {
    dataTypes: {
      indicators: {
        state: 'string'
      }
    }
    tenantId: 'string'
    tipLookbackPeriod: 'string'
  }
}

Wartości właściwości

AADDataConnector

Nazwa	Opis	Wartość
rodzaj	Rodzaj łącznika danych	"AzureActiveDirectory" (wymagane)
Właściwości	Właściwości łącznika danych usługi AAD (Azure Active Directory).	AADDataConnectorProperties

AADDataConnectorProperties

Nazwa	Opis	Wartość
dataTypes	Dostępne typy danych łącznika.	AlertsDataTypeOfDataConnector
tenantId	Identyfikator dzierżawy, z którymi chcesz nawiązać połączenie, i pobierz dane.	struna

AatpDataConnector

Nazwa	Opis	Wartość
rodzaj	Rodzaj łącznika danych	"AzureAdvancedThreatProtection" (wymagane)
Właściwości	Właściwości łącznika danych usługi AATP (Azure Advanced Threat Protection).	AatpDataConnectorProperties

AatpDataConnectorProperties

Nazwa	Opis	Wartość
dataTypes	Dostępne typy danych łącznika.	AlertsDataTypeOfDataConnector
tenantId	Identyfikator dzierżawy, z którymi chcesz nawiązać połączenie, i pobierz dane.	struna

AlertsDataTypeOfDataConnector

Nazwa	Opis	Wartość
Alerty	Alerty połączenia typu danych.	DataConnectorDataTypeCommon

ApiKeyAuthModel

Nazwa	Opis	Wartość
apiKey	Klucz interfejsu API dla poświadczeń klucza tajnego użytkownika	ciąg (wymagany)
apiKeyIdentifier	Identyfikator klucza interfejsu API	struna
apiKeyName	Nazwa klucza interfejsu API	ciąg (wymagany)
isApiKeyInPostPayload	Flaga wskazująca, czy klucz interfejsu API jest ustawiony w ładunku HTTP POST	Bool
typ	Typ uwierzytelniania	"APIKey" (wymagane)

ASCDataConnector

Nazwa	Opis	Wartość
rodzaj	Rodzaj łącznika danych	"AzureSecurityCenter" (wymagane)
Właściwości	Właściwości łącznika danych usługi ASC (Azure Security Center).	ASCDataConnectorProperties

ASCDataConnectorProperties

Nazwa	Opis	Wartość
dataTypes	Dostępne typy danych łącznika.	AlertsDataTypeOfDataConnector
subscriptionId	Identyfikator subskrypcji do nawiązania połączenia i pobierz dane.	struna

AWSAuthModel

Nazwa	Opis	Wartość
externalId	Usługa AWS STS przyjmuje rolę identyfikatora zewnętrznego. Służy to do zapobiegania zdezorientowanemu problemowi zastępcy: "https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html"	struna
roleArn	Usługa AWS STS przyjmuje rolę ARN	ciąg (wymagany)
typ	Typ uwierzytelniania	"AWS" (wymagane)

AwsCloudTrailDataConnector

Nazwa	Opis	Wartość
rodzaj	Rodzaj łącznika danych	"AmazonWebServicesCloudTrail" (wymagane)
Właściwości	Właściwości łącznika danych CloudTrail w usłudze Amazon Web Services.	awsCloudTrailDataConnectorProperties

AwsCloudTrailDataConnectorDataTypes

Nazwa	Opis	Wartość
Dzienniki	Rejestruje typ danych.	awsCloudTrailDataConnectorDataTypesLogs

AwsCloudTrailDataConnectorDataTypesLogs

Nazwa	Opis	Wartość
stan	Opisz, czy to połączenie typu danych jest włączone, czy nie.	"Wyłączone" "Włączone"

AwsCloudTrailDataConnectorProperties

Nazwa	Opis	Wartość
awsRoleArn	Usługa Aws Role Arn (z zasadami CloudTrailReadOnly) używana do uzyskiwania dostępu do konta platformy Aws.	struna
dataTypes	Dostępne typy danych łącznika.	AwsCloudTrailDataConnectorDataTypes

BasicAuthModel

Nazwa	Opis	Wartość
hasło	Hasło	ciąg (wymagany)
typ	Typ uwierzytelniania	"Podstawowa" (wymagana)
userName	Nazwa użytkownika.	ciąg (wymagany)

Plik Nieskonfiguruj uwierzytelnianie

Nazwa	Opis	Wartość
typ	Ustaw wartość "APIKey" dla typu ApiKeyAuthModel. Ustaw wartość "AWS" dla typu AWSAuthModel. Ustaw wartość "Basic" dla typu BasicAuthModel. Ustaw wartość "GCP" dla typu GCPAuthModel. Ustaw wartość "GitHub" dla typu GitHubAuthModel. Dla typu JwtAuthModelustaw wartość "JwtToken". Ustaw wartość "None" dla typu NoneAuthModel. Ustaw wartość "OAuth2" dla typu OAuthModel. Ustaw wartość "Oracle" dla typu OracleAuthModel. Ustaw wartość "ServiceBus" dla typu GenericBlobSbsAuthModel. Ustaw wartość "Session" dla typu SessionAuthModel.	"APIKey" "AWS" "Podstawowa" "GCP" "GitHub" "JwtToken" "Brak" "OAuth2" "Oracle" "ServiceBus" "Sesja" (wymagana)

Konfiguracja obiektu CcpResponseConfig

Nazwa	Opis	Wartość
compressionAlgo	Algorytm kompresji. Na przykład: "gzip", "multi-gzip", "deflate".	struna
convertChildPropertiesToArray	Wartość wskazująca, czy odpowiedź nie jest tablicą zdarzeń/dzienników. Ustawiając tę flagę na wartość true, oznacza to, że serwer zdalny będzie odpowiedź z obiektem, który każda właściwość ma jako wartość tablicy zdarzeń / dzienników.	Bool
csvDelimiter	Ogranicznik csv na wypadek, gdy format odpowiedzi to CSV.	struna
csvEscape	Znak używany do ucieczki znaków w pliku CSV.	struna Ograniczenia: Minimalna długość = 1 Maksymalna długość = 1
eventsJsonPaths	Ścieżki json , znak "$" jest katalogem głównym json.	string[] (wymagane)
format	Format odpowiedzi. możliwe wartości to json, csv,xml	struna
hasCsvBoundary	Wartość wskazująca, czy odpowiedź ma granicę CSV w przypadku odpowiedzi w formacie CSV.	Bool
hasCsvHeader	Wartość wskazująca, czy odpowiedź ma nagłówki w przypadku odpowiedzi w formacie CSV.	Bool
isGzipCompressed	Wartość wskazująca, czy serwer zdalny obsługuje Gzip i powinniśmy oczekiwać odpowiedzi Gzip.	Bool
successStatusJsonPath	Wartość, w której powinien pojawić się komunikat o stanie/kod w odpowiedzi.	struna
successStatusValue	Wartość stanu.	struna

DataConnectorDataTypeCommon

Nazwa	Opis	Wartość
stan	Opisz, czy to połączenie typu danych jest włączone, czy nie.	"Wyłączone" "Włączone"

DCRConfiguration

Nazwa	Opis	Wartość
dataCollectionEndpoint	Reprezentuje punkt końcowy pozyskiwania danych w usłudze Log Analytics.	ciąg (wymagany)
dataCollectionRuleImmutableId	Niezmienny identyfikator reguły zbierania danych, reguła definiuje przekształcenie i miejsce docelowe danych.	ciąg (wymagany)
streamName	Strumień, do który wysyłamy dane.	ciąg (wymagany)

GCPAuthModel

Nazwa	Opis	Wartość
projectNumber	Numer projektu GCP	ciąg (wymagany)
serviceAccountEmail	Adres e-mail konta usługi GCP	ciąg (wymagany)
typ	Typ uwierzytelniania	"GCP" (wymagane)
workloadIdentityProviderId	Identyfikator dostawcy tożsamości obciążenia GCP	ciąg (wymagany)

GenericBlobSbsAuthModel

Nazwa	Opis	Wartość
credentialsConfig	Poświadczenia dla przestrzeni nazw usługi Service Bus, identyfikator URI usługi Keyvault dla klucza dostępu	GenericBlobSbsAuthModelCredentialsConfig
storageAccountCredentialsConfig	Poświadczenia dla konta magazynu, identyfikator URI usługi Keyvault dla klucza dostępu	GenericBlobSbsAuthModelStorageAccountCredentialsConfig
typ	Typ uwierzytelniania	"ServiceBus" (wymagane)

GenericBlobSbsAuthModelCredentialsConfig

Nazwa	Opis	Wartość

GenericBlobSbsAuthModelStorageAccountCredentialsConfig

Nazwa	Opis	Wartość

GitHubAuthModel

Nazwa	Opis	Wartość
identyfikator instalacji	Identyfikator instalacji uwierzytelniania usługi GitHubApp.	struna
typ	Typ uwierzytelniania	"GitHub" (wymagane)

JwtAuthModel

Nazwa	Opis	Wartość
Nagłówki	Nagłówki niestandardowe, które chcemy dodać po wysłaniu żądania do punktu końcowego tokenu.	JwtAuthModelHeaders
isCredentialsInHeaders	Flaga wskazująca, czy chcemy wysłać nazwę użytkownika i hasło do punktu końcowego tokenu w nagłówkach.	Bool
isJsonRequest	Flaga wskazująca, czy żądanie treści to JSON (nagłówek Content-Type = application/json), co oznacza, że jest to żądanie zakodowane w adresie URL formularza (nagłówek Content-Type = application/x-www-form-urlencoded).	Bool
hasło	Hasło	JwtAuthModelPassword (wymagane)
queryParameters	Niestandardowy parametr zapytania, który chcemy dodać po wysłaniu żądania do punktu końcowego tokenu.	JwtAuthModelQueryParameters
requestTimeoutInSeconds	Limit czasu żądania w sekundach.	Int Ograniczenia: Wartość maksymalna = 180
tokenEndpoint	Punkt końcowy tokenu do żądania JWT	ciąg (wymagany)
typ	Typ uwierzytelniania	"JwtToken" (wymagane)
userName	Nazwa użytkownika. Jeśli nazwa użytkownika i hasło wysłane w żądaniu nagłówka musimy wypełnić tylko właściwość `value` nazwą użytkownika (tak samo jak podstawowe uwierzytelnianie). Jeśli nazwa użytkownika i hasło wysłane w żądaniu treści musimy określić `Key` i `Value`.	JwtAuthModelUserName (wymagane)

JwtAuthModelHeaders

Nazwa	Opis	Wartość

JwtAuthModelPassword

Nazwa	Opis	Wartość

JwtAuthModelQueryParameters

Nazwa	Opis	Wartość

JwtAuthModelUserName

Nazwa	Opis	Wartość

McasDataConnector

Nazwa	Opis	Wartość
rodzaj	Rodzaj łącznika danych	"MicrosoftCloudAppSecurity" (wymagane)
Właściwości	Właściwości łącznika danych MCAS (Microsoft Cloud App Security).	McasDataConnectorProperties

McasDataConnectorDataTypes

Nazwa	Opis	Wartość
Alerty	Alerty połączenia typu danych.	DataConnectorDataTypeCommon
discoveryLogs	Połączenie typu danych dziennika odnajdywania.	DataConnectorDataTypeCommon

McasDataConnectorProperties

Nazwa	Opis	Wartość
dataTypes	Dostępne typy danych łącznika.	McasDataConnectorDataTypes
tenantId	Identyfikator dzierżawy, z którymi chcesz nawiązać połączenie, i pobierz dane.	struna

MdatpDataConnector

Nazwa	Opis	Wartość
rodzaj	Rodzaj łącznika danych	"MicrosoftDefenderAdvancedThreatProtection" (wymagane)
Właściwości	Właściwości łącznika danych MDATP (Zaawansowana ochrona przed zagrożeniami w usłudze Microsoft Defender).	MdatpDataConnectorProperties

MdatpDataConnectorProperties

Nazwa	Opis	Wartość
dataTypes	Dostępne typy danych łącznika.	AlertsDataTypeOfDataConnector
tenantId	Identyfikator dzierżawy, z którymi chcesz nawiązać połączenie, i pobierz dane.	struna