Microsoft.SecurityInsights dataConnectors

Articolo
12/21/2024

Definizione di risorsa Bicep

Il tipo di risorsa dataConnectors può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.SecurityInsights/dataConnectors, aggiungere il bicep seguente al modello.

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

Oggetti CcpAuthConfig

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per APIKey, usare:

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

Per AWS, usare:

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

Per basic, usare:

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

Per GCP, usare:

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

Per GitHub, usare:

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

Per JwtToken, usare:

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

Per Nessuna, usare:

{
  type: 'None'
}

Per OAuth2, usare:

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

Per Oracle, usare:

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

Per ServiceBus, usare:

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

Per Session, usare:

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

Oggetti Microsoft.SecurityInsights/dataConnectors

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AmazonWebServicesCloudTrail, usare:

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

Per AzureActiveDirectoryusare:

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

Per AzureAdvancedThreatProtection, usare:

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

Per AzureSecurityCenter, usare:

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

Per MicrosoftCloudAppSecurity, usare:

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

Per MicrosoftDefenderAdvancedThreatProtection, usare:

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

Per MicrosoftThreatIntelligence, usare:

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

Per Office365, usare:

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

Per PremiumMicrosoftDefenderForThreatIntelligence, usare:

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

Per RestApiPoller, usare:

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

Per ThreatIntelligence, usare:

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

Valori delle proprietà

AADDataConnector

Nome	Descrizione	Valore
gentile	Tipo di connettore dati	'AzureActiveDirectory' (obbligatorio)
proprietà	Proprietà del connettore dati AAD (Azure Active Directory).	AADDataConnectorProperties

AADDataConnectorProperties

Nome	Descrizione	Valore
Tipi	Tipi di dati disponibili per il connettore.	AlertsDataTypeOfDataConnector
tenantId	ID tenant a cui connettersi e ottenere i dati.	corda

AatpDataConnector

Nome	Descrizione	Valore
gentile	Tipo di connettore dati	'AzureAdvancedThreatProtection' (obbligatorio)
proprietà	Proprietà del connettore dati AATP (Azure Advanced Threat Protection).	AatpDataConnectorProperties

AatpDataConnectorProperties

Nome	Descrizione	Valore
Tipi	Tipi di dati disponibili per il connettore.	AlertsDataTypeOfDataConnector
tenantId	ID tenant a cui connettersi e ottenere i dati.	corda

AlertsDataTypeOfDataConnector

Nome	Descrizione	Valore
Avvisi	Connessione al tipo di dati avvisi.	DataConnectorDataTypeCommon

ApiKeyAuthModel

Nome	Descrizione	Valore
apiKey	Chiave API per le credenziali della chiave privata utente	stringa (obbligatorio)
apiKeyIdentifier	Identificatore di chiave API	corda
apiKeyName	Nome chiave API	stringa (obbligatorio)
isApiKeyInPostPayload	Flag per indicare se la chiave API è impostata nel payload HTTP POST	Bool
digitare	Tipo di autenticazione	'APIKey' (obbligatorio)

ASCDataConnector

Nome	Descrizione	Valore
gentile	Tipo di connettore dati	'AzureSecurityCenter' (obbligatorio)
proprietà	Proprietà del connettore dati asc (Centro sicurezza di Azure).	ASCDataConnectorProperties

ASCDataConnectorProperties

Nome	Descrizione	Valore
Tipi	Tipi di dati disponibili per il connettore.	AlertsDataTypeOfDataConnector
subscriptionId	ID sottoscrizione a cui connettersi e ottenere i dati.	corda

AWSAuthModel

Nome	Descrizione	Valore
externalId	AWS STS presuppone l'ID esterno del ruolo. Questo viene usato per evitare il problema confuso vice: 'https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html'	corda
roleArn	AWS STS presuppone il ruolo ARN	stringa (obbligatorio)
digitare	Tipo di autenticazione	'AWS' (obbligatorio)

AwsCloudTrailDataConnector

Nome	Descrizione	Valore
gentile	Tipo di connettore dati	'AmazonWebServicesCloudTrail' (obbligatorio)
proprietà	Proprietà del connettore dati CloudTrail di Amazon Web Services.	AwsCloudTrailDataConnectorProperties

AwsCloudTrailDataConnectorDataTypes

Nome	Descrizione	Valore
Registri	Registra il tipo di dati.	AwsCloudTrailDataConnectorDataTypesLogs

AwsCloudTrailDataConnectorDataTypesLogs

Nome	Descrizione	Valore
stato	Descrivere se questa connessione al tipo di dati è abilitata o meno.	'Disabilitato' 'Enabled'

AwsCloudTrailDataConnectorProperties

Nome	Descrizione	Valore
awsRoleArn	Aws Role Arn (con il criterio CloudTrailReadOnly) usato per accedere all'account Aws.	corda
Tipi	Tipi di dati disponibili per il connettore.	AwsCloudTrailDataConnectorDataTypes

BasicAuthModel

Nome	Descrizione	Valore
parola d’ordine	Password	stringa (obbligatorio)
digitare	Tipo di autenticazione	'Basic' (obbligatorio)
nome utente	Nome utente.	stringa (obbligatorio)

CcpAuthConfig

Nome	Descrizione	Valore
digitare	Impostare su 'APIKey' per il tipo ApiKeyAuthModel. Impostare su "AWS" per il tipo AWSAuthModel. Impostare su 'Basic' per il tipo BasicAuthModel. Impostare su "GCP" per il tipo GCPAuthModel. Impostare su "GitHub" per il tipo GitHubAuthModel. Impostare su "JwtToken" per il tipo JwtAuthModel. Impostare su 'None' per il tipo NoneAuthModel. Impostare su "OAuth2" per il tipo OAuthModel. Impostare su "Oracle" per il tipo OracleAuthModel. Impostare su "ServiceBus" per il tipo GenericBlobSbsAuthModel. Impostare su 'Session' per il tipo SessionAuthModel.	'APIKey' 'AWS' 'Basic' 'GCP' 'GitHub' 'JwtToken' 'Nessuno' 'OAuth2' 'Oracle' 'ServiceBus' 'Session' (obbligatorio)

CcpResponseConfig

Nome	Descrizione	Valore
compressionAlgo	Algoritmo di compressione. Ad esempio: 'gzip', 'multi-gzip', 'deflate'.	corda
convertChildPropertiesToArray	Valore che indica se la risposta non è una matrice di eventi/log. Impostando questo flag su true, significa che il server remoto risponderà con un oggetto che ogni proprietà ha come valore una matrice di eventi/log.	Bool
csvDelimiter	Delimitatore csv, nel caso in cui il formato della risposta sia CSV.	corda
csvEscape	Carattere usato per eseguire l'escape dei caratteri in CSV.	corda Vincoli: Lunghezza minima = 1 Lunghezza massima = 1
eventsJsonPaths	I percorsi JSON, '$' char sono la radice json.	string[] (obbligatorio)
formato	Formato della risposta. i valori possibili sono json, csv, xml	corda
hasCsvBoundary	Valore che indica se la risposta ha un limite CSV nel caso in cui la risposta sia in formato CSV.	Bool
hasCsvHeader	Valore che indica se la risposta ha intestazioni nel caso in cui la risposta sia in formato CSV.	Bool
isGzipCompressed	Valore che indica se il server remoto supporta Gzip ed è necessario prevedere una risposta Gzip.	Bool
successStatusJsonPath	Valore in cui deve essere visualizzato il messaggio o il codice di stato nella risposta.	corda
successStatusValue	Valore di stato.	corda

DataConnectorDataTypeCommon

Nome	Descrizione	Valore
stato	Descrivere se questa connessione al tipo di dati è abilitata o meno.	'Disabilitato' 'Enabled'

DCRConfiguration

Nome	Descrizione	Valore
dataCollectionEndpoint	Rappresenta l'endpoint di inserimento della raccolta dati in Log Analytics.	stringa (obbligatorio)
dataCollectionRuleImmutableId	L'ID non modificabile della regola di raccolta dati, la regola definisce la trasformazione e la destinazione dei dati.	stringa (obbligatorio)
streamName	Flusso a cui vengono inviati i dati.	stringa (obbligatorio)

GCPAuthModel

Nome	Descrizione	Valore
projectNumber	Numero progetto GCP	stringa (obbligatorio)
serviceAccountEmail	Indirizzo di posta elettronica dell'account del servizio GCP	stringa (obbligatorio)
digitare	Tipo di autenticazione	'GCP' (obbligatorio)
workloadIdentityProviderId	ID provider di identità del carico di lavoro GCP	stringa (obbligatorio)

GenericBlobSbsAuthModel

Nome	Descrizione	Valore
credentialsConfig	Credenziali per lo spazio dei nomi del bus di servizio, l'URI dell'insieme di credenziali delle chiavi per la chiave di accesso	GenericBlobSbsAuthModelCredentialsConfig
storageAccountCredentialsConfig	Credenziali per l'account di archiviazione, URI dell'insieme di credenziali delle chiavi per la chiave di accesso	GenericBlobSbsAuthModelStorageAccountCredentialsConfig
digitare	Tipo di autenticazione	'ServiceBus' (obbligatorio)

GenericBlobSbsAuthModelCredentialsConfig

Nome	Descrizione	Valore

GenericBlobSbsAuthModelStorageAccountCredentialsConfig

Nome	Descrizione	Valore

GitHubAuthModel

Nome	Descrizione	Valore
installationId	ID di installazione dell'autenticazione di GitHubApp.	corda
digitare	Tipo di autenticazione	'GitHub' (obbligatorio)

JwtAuthModel

Nome	Descrizione	Valore
Intestazioni	Le intestazioni personalizzate da aggiungere dopo l'invio della richiesta all'endpoint del token.	JwtAuthModelHeaders
isCredentialsInHeaders	Flag che indica se si vuole inviare il nome utente e la password all'endpoint del token nelle intestazioni.	Bool
isJsonRequest	Flag che indica se la richiesta del corpo è JSON (intestazione Content-Type = application/json), ovvero è una richiesta con codifica URL modulo (intestazione Content-Type = application/x-www-form-urlencoded).	Bool
parola d’ordine	Password	JwtAuthModelPassword (obbligatorio)
queryParameters	Il parametro di query personalizzato che si vuole aggiungere dopo l'invio della richiesta all'endpoint del token.	JwtAuthModelQueryParameters
requestTimeoutInSeconds	Timeout della richiesta in secondi.	Int Vincoli: Valore massimo = 180
tokenEndpoint	Endpoint del token per richiedere JWT	stringa (obbligatorio)
digitare	Tipo di autenticazione	'JwtToken' (obbligatorio)
nome utente	Nome utente. Se il nome utente e la password inviati nella richiesta di intestazione è sufficiente popolare la proprietà `value` con il nome utente (uguale all'autenticazione di base). Se il nome utente e la password inviati nella richiesta del corpo, è necessario specificare il `Key` e `Value`.	JwtAuthModelUserName (obbligatorio)

JwtAuthModelHeaders

Nome	Descrizione	Valore

JwtAuthModelPassword

Nome	Descrizione	Valore

JwtAuthModelQueryParameters

Nome	Descrizione	Valore

JwtAuthModelUserName

Nome	Descrizione	Valore

McasDataConnector

Nome	Descrizione	Valore
gentile	Tipo di connettore dati	'MicrosoftCloudAppSecurity' (obbligatorio)
proprietà	Proprietà del connettore dati MCAS (Microsoft Cloud App Security).	McasDataConnectorProperties

McasDataConnectorDataTypes

Nome	Descrizione	Valore
Avvisi	Connessione al tipo di dati avvisi.	DataConnectorDataTypeCommon
discoveryLogs	Connessione al tipo di dati del log di individuazione.	DataConnectorDataTypeCommon

McasDataConnectorProperties

Nome	Descrizione	Valore
Tipi	Tipi di dati disponibili per il connettore.	McasDataConnectorDataTypes
tenantId	ID tenant a cui connettersi e ottenere i dati.	corda

MdatpDataConnector

Nome	Descrizione	Valore
gentile	Tipo di connettore dati	'MicrosoftDefenderAdvancedThreatProtection' (obbligatorio)
proprietà	Proprietà del connettore dati MDATP (Microsoft Defender Advanced Threat Protection).	MdatpDataConnectorProperties

MdatpDataConnectorProperties

Nome	Descrizione	Valore
Tipi	Tipi di dati disponibili per il connettore.	AlertsDataTypeOfDataConnector
tenantId	ID tenant a cui connettersi e ottenere i dati.	corda