Microsoft.SecurityInsights dataConnectors 2024-09-01

Artikel
12/17/2024

Bicep-resourcedefinitie

Het resourcetype dataConnectors kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Microsoft.SecurityInsights/dataConnectors-resource wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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

Microsoft.SecurityInsights/dataConnectors-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor AmazonWebServicesCloudTrail:

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

Gebruik voor AzureActiveDirectory-:

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

Gebruik voor AzureAdvancedThreatProtection:

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

Gebruik voor AzureSecurityCenter:

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

Gebruik voor MicrosoftCloudAppSecurity:

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

Gebruik voor MicrosoftDefenderAdvancedThreatProtection:

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

Gebruik voor MicrosoftThreatIntelligence-:

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

Gebruik voor Office365-:

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

Gebruik voor PremiumMicrosoftDefenderForThreatIntelligence:

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

Gebruik voor 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'
    }
  }
}

Gebruik voor ThreatIntelligence-:

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

CcpAuthConfig-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor APIKey:

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

Gebruik voor AWS-:

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

Gebruik voor Basic:

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

Gebruik voor GCP-:

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

Gebruik voor GitHub:

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

Gebruik voor 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'
  }
}

Gebruik voor Geen:

{
  type: 'None'
}

Gebruik voor 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'
}

Voor Oracle-gebruikt u:

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

Gebruik voor ServiceBus:

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

Gebruik voor Sessie:

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

Eigenschapswaarden

AADDataConnector

Naam	Beschrijving	Waarde
soort	Soort gegevensconnector	'AzureActiveDirectory' (vereist)
Eigenschappen	Eigenschappen van AAD-gegevensconnector (Azure Active Directory).	AADDataConnectorProperties-

AADDataConnectorProperties

Naam	Beschrijving	Waarde
Datatypes	De beschikbare gegevenstypen voor de connector.	AlertsDataTypeOfDataConnector-
tenantId	De tenant-id waarmee u verbinding wilt maken en de gegevens opvragen.	snaar

AatpDataConnector

Naam	Beschrijving	Waarde
soort	Soort gegevensconnector	'AzureAdvancedThreatProtection' (vereist)
Eigenschappen	Eigenschappen van gegevensconnector AATP (Azure Advanced Threat Protection).	AatpDataConnectorProperties

AatpDataConnectorProperties

Naam	Beschrijving	Waarde
Datatypes	De beschikbare gegevenstypen voor de connector.	AlertsDataTypeOfDataConnector-
tenantId	De tenant-id waarmee u verbinding wilt maken en de gegevens opvragen.	snaar

AlertsDataTypeOfDataConnector

Naam	Beschrijving	Waarde
Waarschuwingen	Waarschuwingen voor gegevenstypeverbinding.	DataConnectorDataTypeCommon-

ApiKeyAuthModel

Naam	Beschrijving	Waarde
apiKey	API-sleutel voor de referenties voor de geheime sleutel van de gebruiker	tekenreeks (vereist)
apiKeyIdentifier	API-sleutel-id	snaar
apiKeyName	API-sleutelnaam	tekenreeks (vereist)
isApiKeyInPostPayload	Vlag om aan te geven of de API-sleutel is ingesteld in HTTP POST-nettolading	Bool
type	Het verificatietype	APIKey (vereist)

ASCDataConnector

Naam	Beschrijving	Waarde
soort	Soort gegevensconnector	'AzureSecurityCenter' (vereist)
Eigenschappen	Eigenschappen van ASC-gegevensconnector (Azure Security Center).	ASCDataConnectorProperties-

ASCDataConnectorProperties

Naam	Beschrijving	Waarde
Datatypes	De beschikbare gegevenstypen voor de connector.	AlertsDataTypeOfDataConnector-
subscriptionId	De abonnements-id waarmee u verbinding wilt maken en de gegevens opvragen.	snaar

AWSAuthModel

Naam	Beschrijving	Waarde
externalId	AWS STS gaat uit van externe rol-id. Dit wordt gebruikt om het verwarde plaatsvervangend probleem te voorkomen: 'https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html'	snaar
roleArn	AWS STS neemt rol ARN aan	tekenreeks (vereist)
type	Het verificatietype	AWS (vereist)

AwsCloudTrailDataConnector

Naam	Beschrijving	Waarde
soort	Soort gegevensconnector	AmazonWebServicesCloudTrail (vereist)
Eigenschappen	Eigenschappen van Amazon Web Services CloudTrail-gegevensconnector.	AwsCloudTrailDataConnectorProperties-

AwsCloudTrailDataConnectorDataTypes

Naam	Beschrijving	Waarde
Logs	Registreert gegevenstype.	AwsCloudTrailDataConnectorDataTypesLogs

AwsCloudTrailDataConnectorDataTypesLogs

Naam	Beschrijving	Waarde
staat	Beschrijf of deze verbinding van het gegevenstype al dan niet is ingeschakeld.	'Uitgeschakeld' 'Ingeschakeld'

AwsCloudTrailDataConnectorProperties

Naam	Beschrijving	Waarde
awsRoleArn	De Aws Role Arn (met cloudTrailReadOnly-beleid) die wordt gebruikt voor toegang tot het Aws-account.	snaar
Datatypes	De beschikbare gegevenstypen voor de connector.	AwsCloudTrailDataConnectorDataTypes

BasicAuthModel

Naam	Beschrijving	Waarde
wachtwoord	Het wachtwoord	tekenreeks (vereist)
type	Het verificatietype	Basic (vereist)
userName	De gebruikersnaam.	tekenreeks (vereist)

CcpAuthConfig

Naam	Beschrijving	Waarde
type	Ingesteld op APIKey voor het type ApiKeyAuthModel. Ingesteld op 'AWS' voor het type AWSAuthModel. Ingesteld op Basic voor het type BasicAuthModel. Ingesteld op 'GCP' voor het type GCPAuthModel. Ingesteld op 'GitHub' voor het type GitHubAuthModel. Ingesteld op JwtToken voor het type JwtAuthModel. Ingesteld op Geen voor het type NoneAuthModel. Ingesteld op OAuth2 voor het type OAuthModel. Ingesteld op 'Oracle' voor het type OracleAuthModel-. Ingesteld op ServiceBus voor het type GenericBlobSbsAuthModel. Ingesteld op Sessie voor type SessionAuthModel.	'APIKey' 'AWS' 'Basis' 'GCP' 'GitHub' 'JwtToken' 'Geen' 'OAuth2' 'Oracle' 'ServiceBus' Sessie (vereist)

CcpResponseConfig

Naam	Beschrijving	Waarde
compressionAlgo	Het compressie-algoritme. Bijvoorbeeld: 'gzip', 'multi-gzip', 'deflate'.	snaar
convertChildPropertiesToArray	De waarde die aangeeft of het antwoord geen matrix van gebeurtenissen/logboeken is. Door deze vlag in te stellen op true, betekent dit dat de externe server reageert met een object dat elke eigenschap heeft als waarde een matrix met gebeurtenissen/logboeken.	Bool
csvDelimiter	Het CSV-scheidingsteken voor het geval de antwoordindeling CSV is.	snaar
csvEscape	Het teken dat wordt gebruikt om tekens in CSV te escapen.	snaar Beperkingen: Minimale lengte = 1 Maximale lengte = 1
eventsJsonPaths	De json-paden, '$' char is de json-hoofdmap.	tekenreeks[] (vereist)
formatteren	De antwoordindeling. mogelijke waarden zijn json,csv,xml	snaar
hasCsvBoundary	De waarde die aangeeft of het antwoord een CSV-grens heeft voor het geval het antwoord de CSV-indeling heeft.	Bool
hasCsvHeader	De waarde die aangeeft of het antwoord headers heeft voor het geval het antwoord de CSV-indeling heeft.	Bool
isGzipCompressed	De waarde die aangeeft of de externe server Gzip ondersteunt en we moeten Gzip-antwoord verwachten.	Bool
successStatusJsonPath	De waarde waarin het statusbericht/de code moet worden weergegeven in het antwoord.	snaar
successStatusValue	De statuswaarde.	snaar

DataConnectorDataTypeCommon

Naam	Beschrijving	Waarde
staat	Beschrijf of deze verbinding van het gegevenstype al dan niet is ingeschakeld.	'Uitgeschakeld' 'Ingeschakeld'

DCRConfiguration

Naam	Beschrijving	Waarde
dataCollectionEndpoint	Vertegenwoordigt het opname-eindpunt voor gegevensverzameling in Log Analytics.	tekenreeks (vereist)
dataCollectionRuleImmutableId	De onveranderbare id van de regel voor gegevensverzameling definieert de transformatie en het doel van de gegevens.	tekenreeks (vereist)
streamName	De stream waar we de gegevens naar verzenden.	tekenreeks (vereist)

GCPAuthModel

Naam	Beschrijving	Waarde
projectNumber	GCP-projectnummer	tekenreeks (vereist)
serviceAccountEmail	E-mailadres van GCP-serviceaccount	tekenreeks (vereist)
type	Het verificatietype	GCP (vereist)
workloadIdentityProviderId	Id-id van GCP-workloadidentiteitsprovider	tekenreeks (vereist)

GenericBlobSbsAuthModel

Naam	Beschrijving	Waarde
credentialsConfig	Referenties voor service bus-naamruimte, keyvault-URI voor toegangssleutel	GenericBlobSbsAuthModelCredentialsConfig
storageAccountCredentialsConfig	Referenties voor opslagaccount, keyvault-URI voor toegangssleutel	GenericBlobSbsAuthModelStorageAccountCredentialsConfig
type	Het verificatietype	'ServiceBus' (vereist)

GenericBlobSbsAuthModelCredentialsConfig

Naam	Beschrijving	Waarde

GenericBlobSbsAuthModelStorageAccountCredentialsConfig

Naam	Beschrijving	Waarde

GitHubAuthModel

Naam	Beschrijving	Waarde
installationId	De gitHubApp-verificatie-installatie-id.	snaar
type	Het verificatietype	'GitHub' (vereist)

JwtAuthModel

Naam	Beschrijving	Waarde
Headers	De aangepaste headers die we willen toevoegen zodra we het tokeneindpunt van de aanvraag verzenden.	JwtAuthModelHeaders
isCredentialsInHeaders	Vlag die aangeeft of we het eindpunt van de gebruikersnaam en het wachtwoordtoken in de headers willen verzenden.	Bool
isJsonRequest	Vlag die aangeeft of de aanvraag voor de hoofdtekst JSON (header Content-Type = application/json) is, wat betekent dat het een aanvraag met formulier-URL is (header Content-Type = application/x-www-form-urlencoded).	Bool
wachtwoord	Het wachtwoord	JwtAuthModelPassword (vereist)
queryParameters	De aangepaste queryparameter die we willen toevoegen zodra we het tokeneindpunt van de aanvraag verzenden.	JwtAuthModelQueryParameters
requestTimeoutInSeconds	Time-out aanvragen in seconden.	Int Beperkingen: Maximumwaarde = 180
tokenEndpoint	Tokeneindpunt om JWT aan te vragen	tekenreeks (vereist)
type	Het verificatietype	'JwtToken' (vereist)
userName	De gebruikersnaam. Als de gebruikersnaam en het wachtwoord die zijn verzonden in de headeraanvraag, hoeven we alleen de eigenschap `value` te vullen met de gebruikersnaam (hetzelfde als basisverificatie). Als de gebruikersnaam en het wachtwoord die in de hoofdtekstaanvraag worden verzonden, moeten we de `Key` en `Value`opgeven.	JwtAuthModelUserName (vereist)

JwtAuthModelHeaders

Naam	Beschrijving	Waarde

JwtAuthModelPassword

Naam	Beschrijving	Waarde

JwtAuthModelQueryParameters

Naam	Beschrijving	Waarde

JwtAuthModelUserName

Naam	Beschrijving	Waarde

McasDataConnector

Naam	Beschrijving	Waarde
soort	Soort gegevensconnector	'MicrosoftCloudAppSecurity' (vereist)
Eigenschappen	Eigenschappen van MCAS-gegevensconnector (Microsoft Cloud App Security).	McasDataConnectorProperties

McasDataConnectorDataTypes

Naam	Beschrijving	Waarde
Waarschuwingen	Waarschuwingen voor gegevenstypeverbinding.	DataConnectorDataTypeCommon-
discoveryLogs	Verbinding met gegevenstype detectielogboek.	DataConnectorDataTypeCommon-

McasDataConnectorProperties

Naam	Beschrijving	Waarde
Datatypes	De beschikbare gegevenstypen voor de connector.	McasDataConnectorDataTypes
tenantId	De tenant-id waarmee u verbinding wilt maken en de gegevens opvragen.	snaar

MdatpDataConnector

Naam	Beschrijving	Waarde
soort	Soort gegevensconnector	'MicrosoftDefenderAdvancedThreatProtection' (vereist)
Eigenschappen	Eigenschappen van MDATP -gegevensconnector (Microsoft Defender Advanced Threat Protection).	MdatpDataConnectorProperties-

MdatpDataConnectorProperties

Naam	Beschrijving	Waarde
Datatypes	De beschikbare gegevenstypen voor de connector.	AlertsDataTypeOfDataConnector-
tenantId	De tenant-id waarmee u verbinding wilt maken en de gegevens opvragen.	snaar