RingSync a perdu l'accès à l'annuaire

Un administrateur IT peut identifier pourquoi RingSync ne lit plus son annuaire Microsoft Entra ID ou Google Workspace, puis rétablir l'accès.

Ce que vous voyez

• Sur le Tableau de bord de l'annuaire, la carte Connexion à l'annuaire affiche En panne et le message « RingSync ne peut plus lire votre annuaire depuis le … ». Elle affiche À surveiller quand le secret client expire bientôt ou que les accès n'ont pas été actualisés depuis plus de deux heures.
• Sous ce message, la carte donne la cause et l'erreur brute du fournisseur.
• Le tableau À traiter liste les personnes dont la dernière synchronisation a échoué.
• Les propriétaires et les administrateurs reçoivent un email d'alerte (voir Alertes email et délais).
• Sur un téléphone, la carte de l'annuaire passe en Erreur. Synchroniser affiche Échec de la synchronisation.

Ce qui arrive aux contacts déjà sur les téléphones

Rien n'est retiré. Une synchronisation qui échoue n'écrit ni ne supprime aucun contact, et la lecture des accès qui échoue ne retire aucun siège. Les contacts restent donc sur les téléphones tels qu'ils étaient.

Tant que l'accès n'est pas rétabli, les changements de l'annuaire n'arrivent plus sur les téléphones. RingSync ne peut pas non plus détecter le retrait d'un accès : les contacts d'une personne qui a perdu son accès restent sur son téléphone jusqu'à ce que RingSync relise l'annuaire. Voir Autorisations Microsoft et Autorisations Google.

Trouver la cause

Ouvrez le Tableau de bord de l'annuaire. La carte Connexion à l'annuaire affiche l'un de ces messages :

Le secret client a un cas à part : quand il a expiré, la carte peut aussi afficher « Le secret client a expiré le … : les synchronisations échouent. » avec le bouton Remplacer le secret.

Pour savoir comment votre annuaire Microsoft a été connecté : si la carte Remplacer le secret client existe dans Paramètres, il l'a été par Saisie manuelle. Sinon, il l'a été par Connexion à Microsoft.

Secret client expiré (Saisie manuelle)

Ce que vous voyez : la carte affiche « Le secret client de votre application Entra a expiré ou n'est plus valide », ou « Le secret client a expiré le … ». Avant l'expiration, elle affiche « Le secret client expire dans … jours, le … » avec À surveiller.

Cause : les secrets Entra expirent. RingSync ne peut plus se connecter avec l'ancien.

Solution :

1. Dans le portail Azure (portal.azure.com), ouvrez votre inscription d'application, puis Certificates & secrets → New client secret, et copiez la Value.
2. Copiez sa Value tout de suite : le portail ne l'affiche plus ensuite.
3. Dans RingSync, ouvrez Paramètres, carte Remplacer le secret client.
4. Collez la valeur dans Nouveau secret client.
5. Cliquez sur Remplacer.
6. Attendez le message « Secret remplacé. Les prochaines synchronisations l'utiliseront. »
7. Ouvrez Utilisateurs et cliquez sur Synchroniser depuis l'annuaire pour relire les accès tout de suite.

Le secret est vérifié auprès de Microsoft avant d'être enregistré. S'il est refusé, le message « Microsoft a refusé ce secret. Vérifiez que vous l'avez copié en entier, et qu'il appartient bien à cette application. » s'affiche et l'ancien reste en place. La connexion, les sièges et l'historique sont conservés.

Le bouton Remplacer le secret de la carte du tableau de bord ouvre ces mêmes Paramètres.

Consentement retiré (Microsoft)

Ce que vous voyez : « L'accès de RingSync a été retiré du tenant Microsoft (consentement révoqué ou application supprimée). Si ce n'était pas voulu, contactez-nous. »

Cause : le consentement administrateur a été retiré, ou l'application d'entreprise RingSync a été supprimée de votre tenant.

Solution :

1. Dans Entra, cherchez l'application d'entreprise RingSync. Avec Connexion à Microsoft, elle s'appelle « RingSync Graph Access ».
2. Si elle existe, ouvrez la page de ses autorisations et vérifiez que User.Read.All, GroupMember.Read.All et Application.Read.All sont accordées avec le consentement administrateur.
3. Si l'application a été supprimée, ou si le consentement ne peut pas être rétabli, écrivez-nous via Nous contacter.

Le tableau de bord ne propose pas de bouton de reconnexion.

Permission manquante (Microsoft)

Ce que vous voyez : « Une permission manque : vérifiez User.Read.All, GroupMember.Read.All et Application.Read.All, avec le consentement administrateur. »

Cause : au moins une des trois autorisations n'est plus accordée avec le consentement administrateur.

Solution :

1. Dans Entra, ouvrez l'application d'entreprise RingSync.
2. Ouvrez la page de ses autorisations et repérez celle qui manque.
3. Accordez-la de nouveau avec le consentement administrateur.
4. En Saisie manuelle, vérifiez aussi API permissions dans votre inscription d'application.

Les trois autorisations sont détaillées dans Autorisations Microsoft.

Accès Google retiré

Ce que vous voyez : « L'accès de RingSync à Google Workspace a été retiré : vérifiez la délégation au niveau du domaine du compte de service. »

Cause : la délégation au niveau du domaine a été retirée ou réduite, la clé du compte de service a été supprimée, le compte administrateur dont l'identité est empruntée n'est plus administrateur, ou l'accès OAuth a été révoqué.

Solution avec Service Account (DWD) :

1. Ouvrez admin.google.com avec un compte administrateur.
2. Ouvrez Sécurité → Contrôle des API → Délégation au niveau du domaine.
3. Vérifiez que le Client ID numérique du compte de service est présent, avec exactement les trois scopes en lecture seule.
4. Vérifiez que le compte indiqué dans Email administrateur à impersonate est actif et administrateur.
5. Dans la console Google Cloud, vérifiez que l'Admin SDK API est activée et que la clé du compte de service existe encore.

Les scopes et les étapes complètes sont dans Google Workspace et Autorisations Google.

Avec Se connecter à Google : l'annuaire est lu avec le compte affiché comme Admin délégué dans Paramètres. Si ce compte perd ses droits d'administrateur, est suspendu ou supprimé, ou retire l'accès accordé à RingSync, la lecture s'arrête. Le tableau de bord ne permet pas de reconnecter un annuaire Google : écrivez-nous via Nous contacter.

Le tableau de bord ne permet pas non plus de remplacer la clé d'un annuaire Google déjà connecté. Contactez-nous avant toute rotation de clé.

Erreur non reconnue

Ce que vous voyez : « L'annuaire répond par une erreur (détail ci-dessous). » suivi de l'erreur brute du fournisseur.

Cause : l'erreur ne correspond à aucune des causes ci-dessus. Elle peut être passagère, côté Microsoft ou Google.

Solution :

1. Attendez la lecture suivante des accès : elle a lieu toutes les 15 minutes, et la carte repasse à Opérationnelle dès qu'elle réussit.
2. Si l'erreur dure, écrivez-nous via Nous contacter avec le nom de l'annuaire et le texte de l'erreur brute.

Sur le téléphone

Quand la dernière synchronisation d'un annuaire a échoué, sa carte affiche Erreur. Toucher la carte ouvre l'écran Sync en pause, avec le titre Token expiré et le bouton Reconnecter. Cet écran s'affiche pour toute erreur de la dernière synchronisation, quelle que soit la cause.

Reconnecter déconnecte l'app et rouvre l'écran de connexion. Cela ne rétablit pas l'accès de RingSync à l'annuaire : seule l'action côté administrateur ci-dessus le fait.

Alertes email et délais

Les propriétaires et les administrateurs de l'organisation reçoivent ces emails, rédigés dans leur langue, avec la cause et l'erreur brute du fournisseur :

Ces contrôles sont quotidiens : l'email peut arriver jusqu'à un jour après le début de la panne. Chaque alerte est de nouveau armée dès qu'une lecture ou une synchronisation réussit.

Chaque propriétaire ou administrateur peut couper ces alertes dans Préférences, sur son profil, avec Recevoir les alertes opérationnelles. Les emails de facturation, de suspension et de sécurité du compte sont toujours envoyés.

Si une seule personne est concernée

Si une seule personne ne reçoit plus l'annuaire, la cause n'est pas la perte d'accès de RingSync. Son accès a probablement été retiré dans l'annuaire : désassignée de l'application d'entreprise RingSync pour Microsoft, ou sortie des Sièges autorisés pour Google. Son téléphone retire alors les contacts de cet annuaire, au plus tard à la prochaine ouverture de l'app. Voir Sièges et limites.

Toujours bloqué ?

Écrivez-nous via Nous contacter en indiquant le nom de l'annuaire, le message de la carte Connexion à l'annuaire et l'erreur brute affichée dessous.