Microsoft.SecurityInsights dataConnectors 2024-09-01

Article
12/17/2024

Définition de ressource Bicep

Le type de ressource dataConnectors peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.SecurityInsights/dataConnectors, ajoutez le bicep suivant à votre modèle.

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

Objets CcpAuthConfig

Définissez le type propriété pour spécifier le type d’objet.

Pour APIKey, utilisez :

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

Pour AWS, utilisez :

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

Pour de base, utilisez :

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

Pour GCP, utilisez :

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

Pour GitHub, utilisez :

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

Pour JwtToken, utilisez :

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

Pour Aucun, utilisez :

{
  type: 'None'
}

Pour OAuth2, utilisez :

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

Pour Oracle, utilisez :

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

Pour ServiceBus, utilisez :

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

Pour session, utilisez :

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

Objets Microsoft.SecurityInsights/dataConnectors

Définissez le type propriété pour spécifier le type d’objet.

Pour AmazonWebServicesCloudTrail, utilisez :

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

Pour AzureActiveDirectory, utilisez :

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

Pour azureAdvancedThreatProtection, utilisez :

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

Pour AzureSecurityCenter, utilisez :

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

Pour MicrosoftCloudAppSecurity, utilisez :

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

Pour MicrosoftDefenderAdvancedThreatProtection, utilisez :

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

Pour microsoftThreatIntelligence, utilisez :

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

Pour Office365, utilisez :

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

Pour PremiumMicrosoftDefenderForThreatIntelligence, utilisez :

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

Pour RestApiPoller, utilisez :

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

Pour ThreatIntelligence, utilisez :

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

Valeurs de propriété

AADDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'AzureActiveDirectory' (obligatoire)
Propriétés	Propriétés du connecteur de données AAD (Azure Active Directory).	AADDataConnectorProperties

AADDataConnectorProperties

Nom	Description	Valeur
dataTypes	Types de données disponibles pour le connecteur.	AlertsDataTypeOfDataConnector
tenantId	ID de locataire à partir duquel se connecter et obtenir les données.	corde

AatpDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'AzureAdvancedThreatProtection' (obligatoire)
Propriétés	Propriétés du connecteur de données AATP (Azure Advanced Threat Protection).	AatpDataConnectorProperties

AatpDataConnectorProperties

Nom	Description	Valeur
dataTypes	Types de données disponibles pour le connecteur.	AlertsDataTypeOfDataConnector
tenantId	ID de locataire à partir duquel se connecter et obtenir les données.	corde

AlertsDataTypeOfDataConnector

Nom	Description	Valeur
Alertes	Alerte la connexion de type de données.	DataConnectorDataTypeCommon

ApiKeyAuthModel

Nom	Description	Valeur
apiKey	Clé API pour les informations d’identification de clé secrète utilisateur	chaîne (obligatoire)
apiKeyIdentifier	Identificateur de clé API	corde
apiKeyName	Nom de la clé API	chaîne (obligatoire)
isApiKeyInPostPayload	Indicateur pour indiquer si la clé API est définie dans la charge utile HTTP POST	Bool
type	Type d’authentification	'APIKey' (obligatoire)

ASCDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'AzureSecurityCenter' (obligatoire)
Propriétés	Propriétés du connecteur de données ASC (Azure Security Center).	ASCDataConnectorProperties

ASCDataConnectorProperties

Nom	Description	Valeur
dataTypes	Types de données disponibles pour le connecteur.	AlertsDataTypeOfDataConnector
subscriptionId	ID d’abonnement à partir duquel se connecter et obtenir les données.	corde

AWSAuthModel

Nom	Description	Valeur
externalId	AWS STS assume l’ID externe de rôle. C’est ce qui permet d’éviter le problème d’adjoint confus : 'https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html'	corde
roleArn	AWS STS assument le rôle ARN	chaîne (obligatoire)
type	Type d’authentification	'AWS' (obligatoire)

AwsCloudTrailDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'AmazonWebServicesCloudTrail' (obligatoire)
Propriétés	Propriétés du connecteur de données CloudTrail Amazon Web Services.	AwsCloudTrailDataConnectorProperties

AwsCloudTrailDataConnectorDataTypes

Nom	Description	Valeur
Journaux	Journalise le type de données.	AwsCloudTrailDataConnectorDataTypesLogs

AwsCloudTrailDataConnectorDataTypesLogs

Nom	Description	Valeur
état	Décrivez si cette connexion de type de données est activée ou non.	'Désactivé' 'Activé'

AwsCloudTrailDataConnectorProperties

Nom	Description	Valeur
awsRoleArn	Le rôle Aws Arn (avec la stratégie CloudTrailReadOnly) utilisé pour accéder au compte Aws.	corde
dataTypes	Types de données disponibles pour le connecteur.	AwsCloudTrailDataConnectorDataTypes

BasicAuthModel

Nom	Description	Valeur
mot de passe	Mot de passe	chaîne (obligatoire)
type	Type d’authentification	'Basic' (obligatoire)
nom d’utilisateur	Nom d’utilisateur.	chaîne (obligatoire)

CcpAuthConfig

Nom	Description	Valeur
type	Défini sur « APIKey » pour le type ApiKeyAuthModel. Défini sur « AWS » pour le type AWSAuthModel. Défini sur « Basic » pour le type BasicAuthModel. Défini sur « GCP » pour le type GCPAuthModel. Défini sur « GitHub » pour le type GitHubAuthModel. Défini sur « JwtToken » pour le type JwtAuthModel. Défini sur « None » pour le type NoneAuthModel. Défini sur « OAuth2 » pour le type OAuthModel. Défini sur « Oracle » pour le type OracleAuthModel. Défini sur « ServiceBus » pour le type GenericBlobSbsAuthModel. Défini sur « Session » pour le type SessionAuthModel.	'APIKey' 'AWS' 'De base' 'GCP' 'GitHub' 'JwtToken' 'None' 'OAuth2' 'Oracle' 'ServiceBus' 'Session' (obligatoire)

CcpResponseConfig

Nom	Description	Valeur
compressionAlgo	Algorithme de compression. Par exemple : « gzip », « multi-gzip », « deflate ».	corde
convertChildPropertiesToArray	Valeur indiquant si la réponse n’est pas un tableau d’événements/journaux. En définissant cet indicateur sur true, cela signifie que le serveur distant répond avec un objet dont chaque propriété a comme valeur un tableau d’événements/journaux.	Bool
csvDelimiter	Délimiteur csv, au cas où le format de réponse était CSV.	corde
csvEscape	Caractère utilisé pour échapper des caractères au format CSV.	corde Contraintes: Longueur minimale = 1 Longueur maximale = 1
eventsJsonPaths	Les chemins json, '$' char est la racine json.	string[] (obligatoire)
format	Format de réponse. les valeurs possibles sont json,csv,xml	corde
hasCsvBoundary	Valeur indiquant si la réponse a une limite CSV au cas où la réponse au format CSV.	Bool
hasCsvHeader	Valeur indiquant si la réponse comporte des en-têtes au cas où la réponse au format CSV.	Bool
isGzipCompressed	Valeur indiquant si le serveur distant prend en charge Gzip et nous devons attendre la réponse Gzip.	Bool
successStatusJsonPath	Valeur dans laquelle le message/code d’état doit apparaître dans la réponse.	corde
successStatusValue	Valeur d’état.	corde

DataConnectorDataTypeCommon

Nom	Description	Valeur
état	Décrivez si cette connexion de type de données est activée ou non.	'Désactivé' 'Activé'

DCRConfiguration

Nom	Description	Valeur
dataCollectionEndpoint	Représente le point de terminaison d’ingestion de collecte de données dans Log Analytics.	chaîne (obligatoire)
dataCollectionRuleImmutableId	L’ID immuable de la règle de collecte de données, la règle définit la transformation et la destination des données.	chaîne (obligatoire)
streamName	Flux vers lequel nous envoyons les données.	chaîne (obligatoire)

GCPAuthModel

Nom	Description	Valeur
projectNumber	Numéro de projet GCP	chaîne (obligatoire)
serviceAccountEmail	E-mail du compte de service GCP	chaîne (obligatoire)
type	Type d’authentification	'GCP' (obligatoire)
workloadIdentityProviderId	ID du fournisseur d’identité de charge de travail GCP	chaîne (obligatoire)

GenericBlobSbsAuthModel

Nom	Description	Valeur
credentialsConfig	Informations d’identification pour l’espace de noms Service Bus, uri de coffre de clés pour la clé d’accès	GenericBlobSbsAuthModelCredentialsConfig
storageAccountCredentialsConfig	Informations d’identification pour le compte de stockage, URI de coffre de clés pour la clé d’accès	GenericBlobSbsAuthModelStorageAccountCredentialsConfig
type	Type d’authentification	'ServiceBus' (obligatoire)

GenericBlobSbsAuthModelCredentialsConfig

Nom	Description	Valeur

GenericBlobSbsAuthModelStorageAccountCredentialsConfig

Nom	Description	Valeur

GitHubAuthModel

Nom	Description	Valeur
installationId	ID d’installation de l’authentification GitHubApp.	corde
type	Type d’authentification	'GitHub' (obligatoire)

JwtAuthModel

Nom	Description	Valeur
En-têtes	Les en-têtes personnalisés que nous voulons ajouter une fois que nous envoyons une demande au point de terminaison de jeton.	JwtAuthModelHeaders
isCredentialsInHeaders	Indicateur indiquant si nous voulons envoyer le nom d’utilisateur et le mot de passe au point de terminaison de jeton dans les en-têtes.	Bool
isJsonRequest	Indicateur indiquant si la demande de corps est JSON (en-tête Content-Type = application/json), ce qui signifie qu’il s’agit d’une requête encodée d’URL de formulaire (en-tête Content-Type = application/x-www-form-urlencoded).	Bool
mot de passe	Mot de passe	JwtAuthModelPassword (obligatoire)
queryParameters	Paramètre de requête personnalisé que nous voulons ajouter une fois que nous envoyons une demande au point de terminaison de jeton.	JwtAuthModelQueryParameters
requestTimeoutInSeconds	Délai d’expiration de la demande en secondes.	Int Contraintes: Valeur maximale = 180
tokenEndpoint	Point de terminaison de jeton pour demander JWT	chaîne (obligatoire)
type	Type d’authentification	'JwtToken' (obligatoire)
nom d’utilisateur	Nom d’utilisateur. Si le nom d’utilisateur et le mot de passe envoyés dans la demande d’en-tête, nous devons remplir la propriété `value` avec le nom d’utilisateur (identique à l’authentification de base). Si le nom d’utilisateur et le mot de passe envoyés dans la demande de corps, nous devons spécifier les `Key` et les `Value`.	JwtAuthModelUserName (obligatoire)

JwtAuthModelHeaders

Nom	Description	Valeur

JwtAuthModelPassword

Nom	Description	Valeur

JwtAuthModelQueryParameters

Nom	Description	Valeur

JwtAuthModelUserName

Nom	Description	Valeur

McasDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'MicrosoftCloudAppSecurity' (obligatoire)
Propriétés	Propriétés du connecteur de données MCAS (Microsoft Cloud App Security).	McasDataConnectorProperties

McasDataConnectorDataTypes

Nom	Description	Valeur
Alertes	Alerte la connexion de type de données.	DataConnectorDataTypeCommon
discoveryLogs	Connexion de type de données du journal de découverte.	DataConnectorDataTypeCommon

McasDataConnectorProperties

Nom	Description	Valeur
dataTypes	Types de données disponibles pour le connecteur.	McasDataConnectorDataTypes
tenantId	ID de locataire à partir duquel se connecter et obtenir les données.	corde

MdatpDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'MicrosoftDefenderAdvancedThreatProtection' (obligatoire)
Propriétés	Propriétés du connecteur de données MDATP (Microsoft Defender Advanced Threat Protection).	MdatpDataConnectorProperties

MdatpDataConnectorProperties

Nom	Description	Valeur
dataTypes	Types de données disponibles pour le connecteur.	AlertsDataTypeOfDataConnector
tenantId	ID de locataire à partir duquel se connecter et obtenir les données.	corde