Comprendre l’import de données

CoreView importe des données depuis votre tenant Microsoft 365 via API, en effectuant à la fois des importations complètes et delta.

Méthodes d’importation des données depuis Microsoft

Microsoft propose différentes méthodes pour importer des données depuis son environnement :

Microsoft Graph

L’API REST Microsoft Graph est un point de terminaison complet qui permet aux développeurs d’accéder à un large éventail de services Microsoft et d’interagir avec eux, notamment Microsoft 365, Azure Active Directory, OneDrive, SharePoint, Outlook, Teams et d’autres, via des appels d’API RESTful. L’API Graph offre la possibilité de mises à jour en temps réel, permettant aux développeurs de recevoir des notifications concernant les modifications apportées aux données.

API Microsoft Services

Microsoft fournit également des API accessibles directement, sans utiliser PowerShell. Ces API sont généralement désignées par des noms spécifiques selon le service ou la fonctionnalité qu’elles fournissent, comme Outlook API, Microsoft Teams API, SharePoint API, etc. Elles permettent aux développeurs d’interagir par programmation avec les services correspondants. Ces API sont généralement des API RESTful, accessibles via des requêtes HTTPS.

PowerShell avec des comptes de service

Microsoft fournit des modules PowerShell et des cmdlets qui permettent un accès programmatique afin d’exécuter des tâches et des opérations administratives dans Microsoft 365.

Fonctionnement de l’importation des données

CoreView récupère diverses données depuis Microsoft 365 via API, telles que des informations sur les utilisateurs, les groupes et les licences, auprès de différents fournisseurs : Azure AD, Teams, SharePoint, etc. 

Tout au long de la journée, nous effectuons des importations delta pour mettre à jour des propriétés spécifiques dès que des changements surviennent. En pratique, nous demandons continuellement des informations à Microsoft afin de vérifier s’il y a des mises à jour, et si des changements se sont effectivement produits, Microsoft en informe CoreView en conséquence.

Cependant, afin de garantir un alignement complet entre Microsoft et CoreView, une importation complète a lieu une fois par jour. Cette importation exhaustive garantit que toutes les données du tenant restent synchronisées et exactes.

Les importations complètes et delta ont chacune leurs propres caractéristiques et leur propre calendrier :

Importation delta

Grâce à Microsoft Graph, Microsoft a mis en œuvre le mécanisme des « modifications delta » dans lequel seules les valeurs liées à des propriétés spécifiques sont mises à jour lors d’une importation quasi en temps réel. Par exemple :

Cependant, il existe d’autres propriétés qui n’adhèrent pas à ce mécanisme et dont les valeurs ne sont mises à jour que lors d’une importation complète.

• Une importation delta est effectuée uniquement si les valeurs associées aux propriétés qui adhèrent au mécanisme de « modifications delta » ont été modifiées ou mises à jour depuis la dernière importation delta réussie.
• Cette importation est effectuée toutes les 5 à 10 minutes. offrant une mise à jour quasi en temps réel. Par exemple, si vous créez un nouveau groupe depuis le portail d’administration Microsoft 365, ce groupe sera disponible dans CoreView après 5 à 10 minutes.
• Nous ne pouvons pas garantir la durée nécessaire à son achèvement. Le temps requis pour une importation complète peut dépendre de toute limitation de débit des données que Microsoft pourrait avoir mise en place à ce moment-là. 
• Cette importation utilise uniquement Microsoft Graph.

Liste des propriétés qui adhèrent aux modifications delta

Les propriétés Microsoft 365 suivantes sont celles dont les valeurs sont mises à jour lorsqu’une importation partielle est effectuée. Une importation partielle ne sera effectuée que si les valeurs associées à l’une des propriétés suivantes ont changé/été mises à jour depuis la dernière importation partielle réussie. 

accountEnabled 
assignedPlans 
businessPhones 
city * 
companyName * 
country * 
createdDateTime 
customAttributes 
department * 
displayName 
employeeId 
givenName 
id 
imAddresses 
jobTitle 
mail 
mailNickname 
mobilePhoneonPremisesLastSyncDateTime  
onPremisesSyncEnabled  
postalCode * 
preferredLanguage  
proxyAddresses  
recipientType (retrieved from Exchange)  
recipientTypeDetails (retrieved from Exchange)  
state * 
streetAddress  
surname  
usageLocation * 
userPrincipalName  
provisionedPlans  
officeLocation  
onPremisesDistinguishedName  
CustomAttributes (onPremisesExtensionAttributes)  
onPremisesImmutableId  
onPremisesSamAccountName

SkuId 
SkuPartNumber 
ConsumedUnits 
PrepaidUnits 
ServicePlans 

Description 
DisplayName 
Mail 
MailEnabled 
MailNickName 
OnPremisesLastSyncDateTime 
OnPremisesSecurityIdentifier 
OnPremisesSyncEnabled 
OnPremisesDomainName 
OnPremisesNetBiosName 
OnPremisesSamAccountName 
ProxyAddresses 
SecurityEnabled 
Visibility 
CreatedDateTime 
RenewedDateTime 
ResourceProvisioningOptions 
Members 
Owners **

Pour plus d’informations et de détails, veuillez consulter l’article type de ressource group dans la documentation Microsoft.

* Propriétés disponibles à utiliser comme critères de filtres d’un Pool de licences, recalculés toutes les 30 minutes. 

** Si seul le propriétaire est modifié, ce changement ne sera pas pris en compte par l’importation partielle, mais sera importé lors de l’importation complète. En plus des propriétaires, toute autre propriété peut être modifiée (ajouter un membre puis le supprimer). De cette façon, l’importation partielle importera le changement. 

Rapports mis à jour via l’importation delta

Les rapports suivants sont mis à jour via l’importation delta (partielle) :

• Principaux de service
  • La création de nouveaux principaux de service, l’activation ou la désactivation d’un principal de service, ainsi que les changements de nom de principal de service dans Entra sont mis à jour dans CoreView via l’importation partielle.
  • L’ajout ou la suppression de propriétaires de principaux de service dans Entra n’est pas mis à jour dans CoreView via l’importation partielle.
• Autorisations déléguées
• Inscriptions d’applications
  • L’ajout/création, la suppression/retrait ou la modification/mise à jour des inscriptions d’applications sont mis à jour dans CoreView via l’importation partielle.
  • Les détails suivants sont mis à jour via l’importation partielle : créé par, date/heure de création, nom d’affichage.

Importation complète

• Les données complètes sont importées depuis tous les fournisseurs, y compris SharePoint, Teams App, Teams Voice, Exchange, etc.

• Elle utilise Microsoft Graph, API Microsoft Services et PowerShell avec des comptes de service.
• Effectuée une fois par jour, environ toutes les vingt-quatre heures. En d’autres termes, les données sont mises à jour au moins une fois sur une période de vingt-quatre heures.
  Avec certaines exceptions :
  • Les données « OneDrive partagé avec des utilisateurs externes » sont mises à jour au moins une fois par semaine, le dimanche.
  • Les mises à jour de l’appartenance aux groupes ont lieu toutes les 48 heures.
  • Les paramètres de boîte aux lettres sont mis à jour une fois par semaine, le vendredi.
• Cette importation est généralement effectuée en dehors des heures normales de travail, en tenant compte des pratiques de gestion des données de Microsoft. Nous nous efforçons de planifier l’importation pendant la nuit dans les différents centres de données, mais l’horaire exact est finalement déterminé par les pratiques de gestion des données de Microsoft. Par conséquent, nous ne pouvons fournir aucune garantie horaire précise quant au lancement de l’importation.
• Nous ne pouvons pas garantir la durée nécessaire à son achèvement. Le temps requis pour une importation complète peut dépendre de toute limitation de débit des données que Microsoft pourrait avoir mise en place à ce moment-là. 
• Le processus d’importation nécessite un temps considérable, c’est pourquoi il ne peut pas être exécuté plus d’une fois par jour.
• Il n’existe aucun moyen de forcer une importation complète. 

Quand l’importation des données commence

Le processus d’importation des données commence pour les ensembles de données suivants comme indiqué ci-dessous :

• Journaux Audit : l’importation des données commence immédiatement lors de l’enregistrement, en capturant les informations à partir de la date d’enregistrement.
• Connexions : l’importation des données inclut les informations à partir de 7 jours avant la date d’enregistrement afin de garantir la disponibilité du contexte historique.

Questions