Microsoft.SecurityInsights dataConnectors

Статья
12/20/2024

Определение ресурсов Bicep

Тип ресурса dataConnectors можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.SecurityInsights/dataConnectors, добавьте следующий Bicep в шаблон.

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

Объекты CcpAuthConfig

Задайте свойство типа , чтобы указать тип объекта.

Для APIKeyиспользуйте:

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

Для AWSиспользуйте:

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

Для базовыхиспользуйте:

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

Для GCPиспользуйте:

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

Для GitHubиспользуйте:

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

Для JwtTokenиспользуйте:

{
  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'
  }
}

Для Noneиспользуйте:

{
  type: 'None'
}

Для OAuth2используйте:

{
  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'
}

Для Oracleиспользуйте:

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

Для ServiceBusиспользуйте:

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

Для сеансаиспользуйте:

{
  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'
  }
}

Объекты Microsoft.SecurityInsights/dataConnectors

Задайте свойство типа, чтобы указать тип объекта.

Для AmazonWebServicesCloudTrailиспользуйте:

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

Для AzureActiveDirectoryиспользуйте:

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

Для AzureAdvancedThreatProtectionиспользуйте:

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

Для AzureSecurityCenterиспользуйте:

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

Для MicrosoftCloudAppSecurityиспользуйте следующее:

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

Для MicrosoftDefenderAdvancedThreatProtectionиспользуйте следующее:

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

Для MicrosoftThreatIntelligenceиспользуйте следующее:

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

Для Office365используйте:

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

Для PremiumMicrosoftDefenderForThreatIntelligenceиспользуйте:

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

Для RestApiPollerиспользуйте:

{
  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'
    }
  }
}

Для ThreatIntelligenceиспользуйте:

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

Значения свойств

AADDataConnector

Имя	Описание	Ценность
добрый	Тип соединителя данных	AzureActiveDirectory (обязательно)
свойства	Свойства соединителя данных AAD (Azure Active Directory).	AADDataConnectorProperties

AADDataConnectorProperties

Имя	Описание	Ценность
dataTypes	Доступные типы данных для соединителя.	AlertsDataTypeOfDataConnector
tenantId	Идентификатор клиента для подключения и получения данных.	струна

AatpDataConnector

Имя	Описание	Ценность
добрый	Тип соединителя данных	AzureAdvancedThreatProtection (обязательно)
свойства	Свойства соединителя данных AATP (Azure Advanced Threat Protection).	AatpDataConnectorProperties

AatpDataConnectorProperties

Имя	Описание	Ценность
dataTypes	Доступные типы данных для соединителя.	AlertsDataTypeOfDataConnector
tenantId	Идентификатор клиента для подключения и получения данных.	струна

AlertsDataTypeOfDataConnector

Имя	Описание	Ценность
Оповещения	Оповещает подключение типа данных.	DataConnectorDataTypeCommon

ApiKeyAuthModel

Имя	Описание	Ценность
apiKey	Ключ API для учетных данных ключа секрета пользователя	строка (обязательно)
apiKeyIdentifier	Идентификатор ключа API	струна
apiKeyName	Имя ключа API	строка (обязательно)
isApiKeyInPostPayload	Флаг, указывающий, задан ли ключ API в полезных данных HTTP POST	bool
тип	Тип проверки подлинности	APIKey (обязательно)

ASCDataConnector

Имя	Описание	Ценность
добрый	Тип соединителя данных	AzureSecurityCenter (обязательно)
свойства	Свойства соединителя данных ASC (Центр безопасности Azure).	ASCDataConnectorProperties

ASCDataConnectorProperties

Имя	Описание	Ценность
dataTypes	Доступные типы данных для соединителя.	AlertsDataTypeOfDataConnector
subscriptionId	Идентификатор подписки для подключения и получения данных.	струна

AWSAuthModel

Имя	Описание	Ценность
externalId	AWS STS принимает внешний идентификатор роли. Это используется, чтобы предотвратить запутанный заместитель проблемы: "https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html'	струна
roleArn	AWS STS предполагает роль ARN	строка (обязательно)
тип	Тип проверки подлинности	AWS (обязательно)

AwsCloudTrailDataConnector

Имя	Описание	Ценность
добрый	Тип соединителя данных	AmazonWebServicesCloudTrail (обязательный)
свойства	Свойства соединителя данных Amazon Web Services CloudTrail.	AwsCloudTrailDataConnectorProperties

AwsCloudTrailDataConnectorDataTypes

Имя	Описание	Ценность
Журналы	Регистрирует тип данных.	AwsCloudTrailDataConnectorDataTypesLogs

AwsCloudTrailDataConnectorDataTypesLogs

Имя	Описание	Ценность
государство	Опишите, включена ли подключение к этому типу данных.	"Отключено" "Включено"

AwsCloudTrailDataConnectorProperties

Имя	Описание	Ценность
awsRoleArn	Роль Aws (с политикой CloudTrailReadOnly), которая используется для доступа к учетной записи Aws.	струна
dataTypes	Доступные типы данных для соединителя.	AwsCloudTrailDataConnectorDataTypes

BasicAuthModel

Имя	Описание	Ценность
пароль	Пароль	строка (обязательно)
тип	Тип проверки подлинности	"Базовый" (обязательный)
userName	Имя пользователя.	строка (обязательно)

CcpAuthConfig

Имя	Описание	Ценность
тип	Установите значение APIKey для типа ApiKeyAuthModel. Установите значение AWS для типа AWSAuthModel. Установите значение Basic для типа BasicAuthModel. Установите значение GCP для типа GCPAuthModel. Установите значение GitHub для типа GitHubAuthModel. Установите значение JwtToken для типа JwtAuthModel. Установите значение None для типа NoneAuthModel. Установите значение OAuth2 для типа OAuthModel. Установите значение Oracle для типа OracleAuthModel. Установите значение ServiceBus для типа GenericBlobSbsAuthModel. Установите значение Session для типа SessionAuthModel.	APIKey AWS "Базовый" GCP GitHub "JwtToken" "Нет" OAuth2 Oracle ServiceBus Session (обязательный)

CcpResponseConfig

Имя	Описание	Ценность
compressionAlgo	Алгоритм сжатия. Например: "gzip", "multi-gzip", "deflate".	струна
convertChildPropertiesToArray	Значение, указывающее, не является ли ответ массивом событий и журналов. Присвоив этому флагу значение true, это означает, что удаленный сервер будет отвечать объекту, которому каждое свойство имеет значение массив событий или журналов.	bool
csvDelimiter	Разделитель CSV, если формат ответа — CSV.	струна
csvEscape	Символ, используемый для экранирования символов в CSV-файле.	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 1
eventsJsonPaths	Путь json, "$" является корневым каталогом JSON.	string[] (обязательно)
формат	Формат ответа. возможные значения: json,csv,xml	струна
hasCsvBoundary	Значение, указывающее, имеет ли ответ границу CSV в случае ответа в формате CSV.	bool
hasCsvHeader	Значение, указывающее, содержит ли ответ заголовки в формате CSV.	bool
isGzipCompressed	Значение, указывающее, поддерживает ли удаленный сервер Gzip и следует ожидать ответа Gzip.	bool
successStatusJsonPath	Значение, в котором должно отображаться сообщение о состоянии или код в ответе.	струна
successStatusValue	Значение состояния.	струна

DataConnectorDataTypeCommon

Имя	Описание	Ценность
государство	Опишите, включена ли подключение к этому типу данных.	"Отключено" "Включено"

DCRConfiguration

Имя	Описание	Ценность
dataCollectionEndpoint	Представляет конечную точку приема данных в log analytics.	строка (обязательно)
dataCollectionRuleImmutableId	Неизменяемый идентификатор правила сбора данных, правило определяет назначение преобразования и данных.	строка (обязательно)
streamName	Поток, в который мы отправляем данные.	строка (обязательно)

GCPAuthModel

Имя	Описание	Ценность
projectNumber	Номер проекта GCP	строка (обязательно)
serviceAccountEmail	Электронная почта учетной записи службы GCP	строка (обязательно)
тип	Тип проверки подлинности	GCP (обязательно)
workloadIdentityProviderId	Идентификатор поставщика удостоверений рабочей нагрузки GCP	строка (обязательно)

GenericBlobSbsAuthModel

Имя	Описание	Ценность
credentialsConfig	Учетные данные для пространства имен служебной шины, URI keyvault для ключа доступа	GenericBlobSbsAuthModelCredentialsConfig
storageAccountCredentialsConfig	Учетные данные для учетной записи хранения, URI keyvault для ключа доступа	GenericBlobSbsAuthModelStorageAccountCredentialsConfig
тип	Тип проверки подлинности	ServiceBus (обязательно)

GenericBlobSbsAuthModelCredentialsConfig

Имя	Описание	Ценность

GenericBlobSbsAuthModelStorageAccountCredentialsConfig

Имя	Описание	Ценность

GitHubAuthModel

Имя	Описание	Ценность
installationId	Идентификатор установки проверки подлинности GitHubApp.	струна
тип	Тип проверки подлинности	GitHub (обязательно)

JwtAuthModel

Имя	Описание	Ценность
Заголовки	Пользовательские заголовки, которые мы хотим добавить после отправки запроса в конечную точку токена.	JwtAuthModelHeaders
isCredentialsInHeaders	Флаг, указывающий, нужно ли отправлять имя пользователя и пароль в конечную точку маркера в заголовках.	bool
isJsonRequest	Флаг, указывающий, является ли текст запроса JSON (заголовок Content-Type = application/json), то есть это url-адрес формы закодированный запрос (заголовок Content-Type = application/x-www-form-urlencoded).	bool
пароль	Пароль	JwtAuthModelPassword (обязательно)
queryParameters	Настраиваемый параметр запроса, который мы хотим добавить после отправки запроса в конечную точку токена.	JwtAuthModelQueryParameters
requestTimeoutInSeconds	Время ожидания запроса в секундах.	int Ограничения целостности: Максимальное значение = 180
tokenEndpoint	Конечная точка токена для запроса JWT	строка (обязательно)
тип	Тип проверки подлинности	JwtToken (обязательно)
userName	Имя пользователя. Если имя пользователя и пароль, отправленные в запросе заголовка, необходимо заполнить только свойство `value` именем пользователя (аналогично базовой проверке подлинности). Если имя пользователя и пароль, отправленные в тексте запроса, необходимо указать `Key` и `Value`.	JwtAuthModelUserName (обязательно)

JwtAuthModelHeaders

Имя	Описание	Ценность

JwtAuthModelPassword

Имя	Описание	Ценность

JwtAuthModelQueryParameters

Имя	Описание	Ценность

JwtAuthModelUserName

Имя	Описание	Ценность

McasDataConnector

Имя	Описание	Ценность
добрый	Тип соединителя данных	MicrosoftCloudAppSecurity (обязательно)
свойства	Свойства соединителя данных MCAS (Microsoft Cloud App Security).	McasDataConnectorProperties

McasDataConnectorDataTypes

Имя	Описание	Ценность
Оповещения	Оповещает подключение типа данных.	DataConnectorDataTypeCommon
discoveryLogs	Подключение типа данных журнала обнаружения.	DataConnectorDataTypeCommon

McasDataConnectorProperties

Имя	Описание	Ценность
dataTypes	Доступные типы данных для соединителя.	McasDataConnectorDataTypes
tenantId	Идентификатор клиента для подключения и получения данных.	струна

MdatpDataConnector

Имя	Описание	Ценность
добрый	Тип соединителя данных	MicrosoftDefenderAdvancedThreatProtection (обязательный)
свойства	Свойства соединителя данных MDATP (Microsoft Defender Advanced Threat Protection).	mdatpDataConnectorProperties

MdatpDataConnectorProperties

Имя	Описание	Ценность
dataTypes	Доступные типы данных для соединителя.	AlertsDataTypeOfDataConnector
tenantId	Идентификатор клиента для подключения и получения данных.	струна