Microsoft.SecurityInsights dataConnectors 2024-09-01

Artigo
12/17/2024

Definição de recurso do Bicep

O tipo de recurso dataConnectors pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.SecurityInsights/dataConnectors, adicione o Bicep a seguir ao modelo.

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

Objetos CcpAuthConfig

Defina a propriedade tipo para especificar o tipo de objeto.

Para APIKey, use:

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

Para do AWS, use:

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

Para Básico, use:

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

Para GCP, use:

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

Para do GitHub, use:

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

Para JwtToken, use:

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

Para Nenhum, use:

{
  type: 'None'
}

Para OAuth2, use:

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

Para Oracle, use:

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

Para do ServiceBus, use:

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

Parade Sessão , use:

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

Objetos Microsoft.SecurityInsights/dataConnectors

Defina o tipo propriedade para especificar o tipo de objeto.

Para AmazonWebServicesCloudTrail, use:

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

Para do AzureActiveDirectory, use:

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

Para AzureAdvancedThreatProtection, use:

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

Para do AzureSecurityCenter, use:

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

Para microsoftCloudAppSecurity, use:

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

Para MicrosoftDefenderAdvancedThreatProtection, use:

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

Para MicrosoftThreatIntelligence, use:

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

Para office365, use:

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

Para PremiumMicrosoftDefenderForThreatIntelligence, use:

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

Para RestApiPoller, use:

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

Para ThreatIntelligence, use:

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

Valores de propriedade

AADDataConnector

Nome	Descrição	Valor
tipo	O tipo de conector de dados	'AzureActiveDirectory' (obrigatório)
Propriedades	Propriedades do conector de dados do AAD (Azure Active Directory).	AADDataConnectorProperties

AADDataConnectorProperties

Nome	Descrição	Valor
Dados	Os tipos de dados disponíveis para o conector.	AlertsDataTypeOfDataConnector
tenantId	A ID do locatário à qual se conectar e obter os dados.	corda

AatpDataConnector

Nome	Descrição	Valor
tipo	O tipo de conector de dados	'AzureAdvancedThreatProtection' (obrigatório)
Propriedades	Propriedades do conector de dados AATP (Proteção Avançada contra Ameaças do Azure).	AatpDataConnectorProperties

AatpDataConnectorProperties

Nome	Descrição	Valor
Dados	Os tipos de dados disponíveis para o conector.	AlertsDataTypeOfDataConnector
tenantId	A ID do locatário à qual se conectar e obter os dados.	corda

AlertsDataTypeOfDataConnector

Nome	Descrição	Valor
Alertas	Alertas de conexão de tipo de dados.	DataConnectorDataTypeCommon

ApiKeyAuthModel

Nome	Descrição	Valor
apiKey	Chave de API para a credencial de chave secreta do usuário	cadeia de caracteres (obrigatório)
apiKeyIdentifier	Identificador de chave de API	corda
apiKeyName	Nome da chave de API	cadeia de caracteres (obrigatório)
isApiKeyInPostPayload	Sinalizar para indicar se a chave de API está definida no conteúdo HTTP POST	Bool
tipo	O tipo de autenticação	'APIKey' (obrigatório)

ASCDataConnector

Nome	Descrição	Valor
tipo	O tipo de conector de dados	'AzureSecurityCenter' (obrigatório)
Propriedades	Propriedades do conector de dados asc (Central de Segurança do Azure).	ASCDataConnectorProperties

ASCDataConnectorProperties

Nome	Descrição	Valor
Dados	Os tipos de dados disponíveis para o conector.	AlertsDataTypeOfDataConnector
subscriptionId	A ID da assinatura à qual se conectar e obter os dados.	corda

AWSAuthModel

Nome	Descrição	Valor
externalId	O STS do AWS assume a ID externa da função. Isso é usado para evitar o problema de deputado confuso: 'https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html'	corda
roleArn	AWS STS assume função ARN	cadeia de caracteres (obrigatório)
tipo	O tipo de autenticação	'AWS' (obrigatório)

AwsCloudTrailDataConnector

Nome	Descrição	Valor
tipo	O tipo de conector de dados	'AmazonWebServicesCloudTrail' (obrigatório)
Propriedades	Propriedades do conector de dados cloudTrail do Amazon Web Services.	AwsCloudTrailDataConnectorProperties

AwsCloudTrailDataConnectorDataTypes

Nome	Descrição	Valor
Logs	Tipo de dados de logs.	AwsCloudTrailDataConnectorDataTypesLogs

AwsCloudTrailDataConnectorDataTypesLogs

Nome	Descrição	Valor
estado	Descreva se essa conexão de tipo de dados está habilitada ou não.	'Desabilitado' 'Habilitado'

AwsCloudTrailDataConnectorProperties

Nome	Descrição	Valor
awsRoleArn	O Aws Role Arn (com a política CloudTrailReadOnly) que é usado para acessar a conta do Aws.	corda
Dados	Os tipos de dados disponíveis para o conector.	AwsCloudTrailDataConnectorDataTypes

BasicAuthModel

Nome	Descrição	Valor
senha	A senha	cadeia de caracteres (obrigatório)
tipo	O tipo de autenticação	'Basic' (obrigatório)
userName	O nome de usuário.	cadeia de caracteres (obrigatório)

CcpAuthConfig

Nome	Descrição	Valor
tipo	Defina como 'APIKey' para o tipo ApiKeyAuthModel. Defina como 'AWS' para o tipo AWSAuthModel. Defina como 'Basic' para o tipo BasicAuthModel. Defina como 'GCP' para o tipo GCPAuthModel. Defina como 'GitHub' para o tipo gitHubAuthModel. Defina como 'JwtToken' para o tipo JwtAuthModel. Defina como 'None' para o tipo NoneAuthModel. Defina como 'OAuth2' para o tipo OAuthModel. Defina como 'Oracle' para o tipo OracleAuthModel. Defina como 'ServiceBus' para o tipo GenericBlobSbsAuthModel. Defina como 'Session' para o tipo SessionAuthModel.	'APIKey' 'AWS' 'Básico' 'GCP' 'GitHub' 'JwtToken' 'None' 'OAuth2' 'Oracle' 'ServiceBus' 'Session' (obrigatório)

CcpResponseConfig

Nome	Descrição	Valor
compressionAlgo	O algoritmo de compactação. Por exemplo: 'gzip', 'multi-gzip', 'deflate'.	corda
convertChildPropertiesToArray	O valor que indica se a resposta não é uma matriz de eventos/logs. Ao definir esse sinalizador como true, significa que o servidor remoto responderá com um objeto que cada propriedade tem como valor uma matriz de eventos/logs.	Bool
csvDelimiter	O delimitador csv, caso o formato de resposta seja CSV.	corda
csvEscape	O caractere usado para escapar de caracteres no CSV.	corda Restrições: Comprimento mínimo = 1 Comprimento máximo = 1
eventsJsonPaths	Os caminhos json, '$' char é a raiz json.	string[] (obrigatório)
formato	O formato de resposta. os valores possíveis são json, csv, xml	corda
hasCsvBoundary	O valor que indica se a resposta tem limite de CSV caso a resposta seja no formato CSV.	Bool
hasCsvHeader	O valor que indica se a resposta tem cabeçalhos no caso da resposta no formato CSV.	Bool
isGzipCompressed	O valor que indica se o servidor remoto dá suporte a Gzip e devemos esperar uma resposta Gzip.	Bool
successStatusJsonPath	O valor em que a mensagem/código de status deve aparecer na resposta.	corda
successStatusValue	O valor do status.	corda

DataConnectorDataTypeCommon

Nome	Descrição	Valor
estado	Descreva se essa conexão de tipo de dados está habilitada ou não.	'Desabilitado' 'Habilitado'

DCRConfiguration

Nome	Descrição	Valor
dataCollectionEndpoint	Representa o ponto de extremidade de ingestão de coleta de dados no log analytics.	cadeia de caracteres (obrigatório)
dataCollectionRuleImmutableId	A ID imutável da regra de coleta de dados, a regra define a transformação e o destino dos dados.	cadeia de caracteres (obrigatório)
streamName	O fluxo para o qual estamos enviando os dados.	cadeia de caracteres (obrigatório)

GCPAuthModel

Nome	Descrição	Valor
projectNumber	Número do projeto GCP	cadeia de caracteres (obrigatório)
serviceAccountEmail	Email da conta de serviço GCP	cadeia de caracteres (obrigatório)
tipo	O tipo de autenticação	'GCP' (obrigatório)
workloadIdentityProviderId	ID do provedor de identidade da carga de trabalho do GCP	cadeia de caracteres (obrigatório)

GenericBlobSbsAuthModel

Nome	Descrição	Valor
credentialsConfig	Credenciais para namespace do barramento de serviço, keyvault uri para chave de acesso	GenericBlobSbsAuthModelCredentialsConfig
storageAccountCredentialsConfig	Credenciais para a conta de armazenamento, keyvault uri para chave de acesso	GenericBlobSbsAuthModelStorageAccountCredentialsConfig
tipo	O tipo de autenticação	'ServiceBus' (obrigatório)

GenericBlobSbsAuthModelCredentialsConfig

Nome	Descrição	Valor

GenericBlobSbsAuthModelStorageAccountCredentialsConfig

Nome	Descrição	Valor

GitHubAuthModel

Nome	Descrição	Valor
installationId	A ID de instalação de autenticação do GitHubApp.	corda
tipo	O tipo de autenticação	'GitHub' (obrigatório)

JwtAuthModel

Nome	Descrição	Valor
Cabeçalhos	Os cabeçalhos personalizados que queremos adicionar depois de enviarmos a solicitação ao ponto de extremidade do token.	JwtAuthModelHeaders
isCredentialsInHeaders	Sinalizador indicando se queremos enviar o nome de usuário e a senha para o ponto de extremidade de token nos cabeçalhos.	Bool
isJsonRequest	Sinalizador indicando se a solicitação do corpo é JSON (cabeçalho Content-Type = application/json), o que significa que é uma solicitação codificada pela URL do Formulário (cabeçalho Content-Type = application/x-www-form-urlencoded).	Bool
senha	A senha	JwtAuthModelPassword (obrigatório)
queryParameters	O parâmetro de consulta personalizado que desejamos adicionar quando enviarmos a solicitação para o ponto de extremidade do token.	JwtAuthModelQueryParameters
requestTimeoutInSeconds	Tempo limite da solicitação em segundos.	int Restrições: Valor máximo = 180
tokenEndpoint	Ponto de extremidade de token para solicitar JWT	cadeia de caracteres (obrigatório)
tipo	O tipo de autenticação	'JwtToken' (obrigatório)
userName	O nome de usuário. Se o nome de usuário e a senha forem enviados na solicitação de cabeçalho, só precisaremos preencher a propriedade `value` com o nome de usuário (o mesmo que a autenticação básica). Se o nome de usuário e a senha forem enviados na solicitação do corpo, precisaremos especificar o `Key` e `Value`.	JwtAuthModelUserName (obrigatório)

JwtAuthModelHeaders

Nome	Descrição	Valor

JwtAuthModelPassword

Nome	Descrição	Valor

JwtAuthModelQueryParameters

Nome	Descrição	Valor

JwtAuthModelUserName

Nome	Descrição	Valor

McasDataConnector

Nome	Descrição	Valor
tipo	O tipo de conector de dados	'MicrosoftCloudAppSecurity' (obrigatório)
Propriedades	Propriedades do conector de dados do MCAS (Microsoft Cloud App Security).	mcasDataConnectorProperties

McasDataConnectorDataTypes

Nome	Descrição	Valor
Alertas	Alertas de conexão de tipo de dados.	DataConnectorDataTypeCommon
discoveryLogs	Conexão de tipo de dados de log de descoberta.	DataConnectorDataTypeCommon

McasDataConnectorProperties

Nome	Descrição	Valor
Dados	Os tipos de dados disponíveis para o conector.	McasDataConnectorDataTypes
tenantId	A ID do locatário à qual se conectar e obter os dados.	corda

MdatpDataConnector

Nome	Descrição	Valor
tipo	O tipo de conector de dados	'MicrosoftDefenderAdvancedThreatProtection' (obrigatório)
Propriedades	Propriedades do conector de dados MDATP (Proteção Avançada contra Ameaças do Microsoft Defender).	MdatpDataConnectorProperties

MdatpDataConnectorProperties

Nome	Descrição	Valor
Dados	Os tipos de dados disponíveis para o conector.	AlertsDataTypeOfDataConnector
tenantId	A ID do locatário à qual se conectar e obter os dados.	corda