Microsoft.SecurityInsights dataConnectors 2021-03-01-preview

Article
12/21/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@2021-03-01-preview' = {
  etag: 'string'
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.SecurityInsights/dataConnectors objects
}

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 Dynamics365, utilisez :

{
  kind: 'Dynamics365'
  properties: {
    dataTypes: {
      dynamics365CdsActivities: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

Pour GenericUI, utilisez :

{
  kind: 'GenericUI'
  properties: {
    connectorUiConfig: {
      availability: {
        isPreview: bool
        status: '1'
      }
      connectivityCriteria: [
        {
          type: 'string'
          value: [
            'string'
          ]
        }
      ]
      customImage: 'string'
      dataTypes: [
        {
          lastDataReceivedQuery: 'string'
          name: 'string'
        }
      ]
      descriptionMarkdown: 'string'
      graphQueries: [
        {
          baseQuery: 'string'
          legend: 'string'
          metricName: 'string'
        }
      ]
      graphQueriesTableName: 'string'
      instructionSteps: [
        {
          description: 'string'
          instructions: [
            {
              parameters: any(Azure.Bicep.Types.Concrete.AnyType)
              type: 'string'
            }
          ]
          title: 'string'
        }
      ]
      permissions: {
        customs: [
          {
            description: 'string'
            name: 'string'
          }
        ]
        resourceProvider: [
          {
            permissionsDisplayText: 'string'
            provider: 'string'
            providerDisplayName: 'string'
            requiredPermissions: {
              action: bool
              delete: bool
              read: bool
              write: bool
            }
            scope: 'string'
          }
        ]
      }
      publisher: 'string'
      sampleQueries: [
        {
          description: 'string'
          query: 'string'
        }
      ]
      title: '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: {
      bingSafetyPhishingURL: {
        lookbackPeriod: 'string'
        state: 'string'
      }
      microsoftEmergingThreatFeed: {
        lookbackPeriod: 'string'
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

Pour microsoftThreatProtection, utilisez :

{
  kind: 'MicrosoftThreatProtection'
  properties: {
    dataTypes: {
      incidents: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

Pour Office365, utilisez :

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

Pour OfficeATP, utilisez :

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

Pour ThreatIntelligence, utilisez :

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

Pour ThreatIntelligenceTaxii, utilisez :

{
  kind: 'ThreatIntelligenceTaxii'
  properties: {
    collectionId: 'string'
    dataTypes: {
      taxiiClient: {
        state: 'string'
      }
    }
    friendlyName: 'string'
    password: 'string'
    pollingFrequency: 'string'
    taxiiLookbackPeriod: 'string'
    taxiiServer: 'string'
    tenantId: 'string'
    userName: 'string'
    workspaceId: '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.	chaîne (obligatoire)

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.	chaîne (obligatoire)

AlertsDataTypeOfDataConnector

Nom	Description	Valeur
Alertes	Alerte la connexion de type de données.	DataConnectorDataTypeCommon (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

Disponibilité

Nom	Description	Valeur
isPreview	Définir le connecteur en préversion	Bool
statut	État de disponibilité du connecteur	'1'

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 (obligatoire)

AwsCloudTrailDataConnectorDataTypesLogs

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

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 (obligatoire)

CodelessParameters

Nom	Description	Valeur
connectorUiConfig	Configuration pour décrire le panneau instructions	CodelessUiConnectorConfigProperties

CodelessUiConnectorConfigProperties

Nom	Description	Valeur
disponibilité	État de disponibilité du connecteur	de disponibilité (obligatoire)
connectivityCriteria	Définir la façon dont le connecteur vérifie la connectivité	CodelessUiConnectorConfigPropertiesConnectivityCriteriaItem[] (obligatoire)
customImage	Image personnalisée facultative à utiliser lors de l’affichage du connecteur dans la galerie du connecteur d’Azure Sentinel	corde
dataTypes	Types de données pour vérifier les dernières données reçues	CodelessUiConnectorConfigPropertiesDataTypesItem[] (obligatoire)
descriptionMarkdown	Description du connecteur	chaîne (obligatoire)
graphQueries	Requête de graphe pour afficher l’état actuel des données	CodelessUiConnectorConfigPropertiesGraphQueriesItem[] (obligatoire)
graphQueriesTableName	Nom de la table dans laquelle le connecteur insère les données	chaîne (obligatoire)
instructionSteps	Étapes d’instruction pour activer le connecteur	CodelessUiConnectorConfigPropertiesInstructionStepsItem[] (obligatoire)
Autorisations	Autorisations requises pour le connecteur	autorisations (obligatoire)
éditeur	Nom de l’éditeur du connecteur	chaîne (obligatoire)
sampleQueries	Exemples de requêtes pour le connecteur	CodelessUiConnectorConfigPropertiesSampleQueriesItem[] (obligatoire)
titre	Titre du panneau du connecteur	chaîne (obligatoire)

CodelessUiConnectorConfigPropertiesConnectivityCriteriaItem

Nom	Description	Valeur
type	type de connectivité	'IsConnectedQuery'
valeur	Requêtes pour la vérification de la connectivité	string[]

CodelessUiConnectorConfigPropertiesDataTypesItem

Nom	Description	Valeur
lastDataReceivedQuery	Requête pour indiquer les dernières données reçues	corde
nom	Nom du type de données à afficher dans le graphique. peut être utilisé avec l’espace réservé {{graphQueriesTableName}}	corde

CodelessUiConnectorConfigPropertiesGraphQueriesItem

Nom	Description	Valeur
baseQuery	Requête de base pour le graphique	corde
légende	Légende du graphique	corde
metricName	la métrique que la requête vérifie	corde

CodelessUiConnectorConfigPropertiesInstructionStepsItem

Nom	Description	Valeur
description	Description de l’étape d’instruction	corde
instructions	Détails de l’étape d’instruction	InstructionStepsInstructionsItem[]
titre	Titre de l’étape d’instruction	corde

CodelessUiConnectorConfigPropertiesSampleQueriesItem

Nom	Description	Valeur
description	L’exemple de description de requête	corde
requête	l’exemple de requête	corde

CodelessUiDataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'GenericUI' (obligatoire)
Propriétés	Propriétés du connecteur de données d’interface utilisateur sans code	codelessParameters

DataConnectorDataTypeCommon

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

Dynamics365DataConnector

Nom	Description	Valeur
gentil	Type de connecteur de données	'Dynamics365' (obligatoire)
Propriétés	Propriétés du connecteur de données Dynamics365.	Dynamics365DataConnectorProperties

Dynamics365DataConnectorDataTypes

Nom	Description	Valeur
dynamics365CdsActivities	Connexion de type de données Common Data Service.	Dynamics365DataConnectorDataTypesDynamics365CdsActivities (obligatoire)

Dynamics365DataConnectorDataTypesDynamics365CdsActivities

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

Dynamics365DataConnectorProperties

Nom	Description	Valeur
dataTypes	Types de données disponibles pour le connecteur.	Dynamics365DataConnectorDataTypes (obligatoire)
tenantId	ID de locataire à partir duquel se connecter et obtenir les données.	chaîne (obligatoire)

InstructionStepsInstructionsItem

Nom	Description	Valeur
Paramètres	Paramètres du paramètre	quelconque
type	Type de paramètre	'CopyableLabel' 'InfoMessage' 'InstructionStepsGroup' (obligatoire)

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 (obligatoire)
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 (obligatoire)
tenantId	ID de locataire à partir duquel se connecter et obtenir les données.	chaîne (obligatoire)

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.	chaîne (obligatoire)