Un job de sync atteint le statut En cours mais la barre de progression reste à 0%, ou le job se termine avec contacts_added: 0, contacts_updated: 0, contacts_removed: 0 alors que des utilisateurs existent clairement dans votre annuaire.
Causes possibles
Il existe trois causes distinctes pour ce comportement. Traitez-les dans l'ordre.
Cause 1 — Le trafic réseau sortant est bloqué
Le proxy côté serveur de RingSync appelle Microsoft Graph au nom de votre annuaire. Si votre environnement dispose d'un pare-feu, d'un proxy web ou d'une politique réseau qui bloque le HTTPS sortant depuis l'infrastructure de RingSync, la requête proxy vers Microsoft Graph expire silencieusement et retourne une page vide d'utilisateurs.
Comment diagnostiquer : Ouvrez le détail du job de sync dans Logs → [ID du job]. Si vous voyez des entrées telles que :
graph.timeout tenant=<id> page=1 elapsed=60s
ou plusieurs entrées graph.error à la page 1, le problème est au niveau réseau.
Résolution :
Il ne s'agit pas d'une erreur de configuration que vous pouvez corriger directement dans RingSync. Contactez votre équipe réseau et assurez-vous que le HTTPS sortant vers graph.microsoft.com est autorisé depuis les plages d'IP du serveur RingSync.
Cause 2 — Token expiré ou consentement révoqué
Si le token Microsoft est devenu invalide entre la dernière sync réussie et celle-ci, le proxy Graph retourne 0 utilisateurs plutôt qu'une erreur (selon le moment dans le cycle de vie du token où l'invalidation s'est produite).
Comment diagnostiquer : Vérifiez dans le log de sync la présence de :
auth.fail tenant=<id> reason=invalid_grant
Résolution : Suivez la procédure complète de reconnexion dans Token Microsoft expiré.
Cause 3 — Le périmètre de sync pointe vers un groupe vide
Si votre annuaire est configuré avec périmètre de sync = groupes et que le groupe Entra sélectionné n'a pas de membres (ou que tous les membres sont des invités, des comptes désactivés ou des utilisateurs sans adresse email), RingSync remonte correctement zéro contact — ce n'est pas un bug.
Comment diagnostiquer :
- Ouvrez le portail Azure et naviguez vers Groupes → [votre groupe] → Membres.
- Confirmez que le groupe contient des membres actifs et licenciés avec un attribut
mailrenseigné. - Dans RingSync Paramètres, vérifiez que le bon groupe est sélectionné et qu'aucun groupe d'exclusion large ne capture par inadvertance tous les membres.
Résolution : Ajoutez des utilisateurs actifs au groupe dans Entra, ou ajustez le périmètre de sync dans Paramètres → Périmètre de sync. Après modification du périmètre, RingSync réinitialise automatiquement le lien delta et effectue une sync complète lors de la prochaine exécution.
Modifier le périmètre de sync (tous ↔ groupes, ou changer quels groupes sont sélectionnés) déclenche toujours une re-sync complète. C'est un comportement attendu.
Toujours bloqué ?
Si aucune des trois causes ci-dessus ne correspond à vos logs, contactez le support via la page contact en incluant l'ID de job depuis l'écran Logs.