Google Workspace

Un administrateur Google Workspace connecte son domaine à RingSync, avec un Service Account ou avec sa connexion administrateur, puis choisit qui a accès à l'app.

Choisir la méthode

RingSync lit votre annuaire avec l'API Admin SDK Directory, en lecture seule. Le formulaire Connecter un annuaire propose deux méthodes.

Méthode	Ce que vous faites	À savoir
Service Account (DWD) (recommandée)	Vous créez un Service Account dans votre projet Google Cloud, vous l'autorisez par délégation au niveau du domaine, puis vous collez sa clé JSON.	Fonctionne immédiatement, sans vérification par Google. La clé reste sous votre contrôle.
Se connecter à Google	Vous vous connectez en administrateur Google et vous consentez à l'accès en lecture à l'annuaire.	Rien à créer de votre côté, mais la méthode dépend de la vérification de l'application OAuth de RingSync par Google.

Vérification par Google

Se connecter à Google : Google classe les autorisations d'annuaire comme sensibles et doit vérifier l'application OAuth de RingSync. Tant que cette vérification n'est pas faite, la connexion peut être refusée : utilisez alors Service Account (DWD).

Prérequis

Un compte RingSync avec le rôle Propriétaire ou Admin.
Un compte administrateur Google Workspace qui accède à la Google Admin Console.
Pour Service Account (DWD) : un projet Google Cloud où vous pouvez activer une API, créer un Service Account et une clé.
Pour Service Account (DWD) : l'email d'un administrateur Workspace qui peut lire l'annuaire. Le Service Account agit en son nom.

Méthode 1 : Service Account (DWD), recommandée

Le Service Account vit dans votre projet Google Cloud. RingSync reçoit seulement sa clé JSON, la conserve chiffrée et s'en sert en lecture seule.

Créer le Service Account dans Google Cloud

Ouvrez console.cloud.google.com et créez ou choisissez un projet.
Activez l'Admin SDK API dans ce projet.
Ouvrez IAM & Admin → Service Accounts et créez un compte de service.
Ouvrez ce compte de service, puis Keys → Add key → JSON, et téléchargez la clé. Gardez le fichier confidentiel.
Notez le Client ID numérique du compte de service : c'est le champ client_id du fichier JSON.

Autoriser la délégation dans la Google Admin Console

Ouvrez admin.google.com avec un compte administrateur.
Ouvrez Sécurité → Contrôle des API → Délégation au niveau du domaine.
Ajoutez une nouvelle entrée de délégation.
Saisissez le Client ID numérique noté plus haut.

Collez cette ligne de scopes OAuth, telle quelle. Le formulaire RingSync l'affiche aussi sous Scopes OAuth à autoriser (séparés par des virgules) :

https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly

Validez l'autorisation.

Connecter l'annuaire dans RingSync

Cliquez sur Connecter un annuaire, puis saisissez le Nom de l'annuaire.
À l'étape Fournisseur d'annuaire, choisissez Google Workspace.
Choisissez la méthode Service Account (DWD).
Dans Domaine Workspace, saisissez votre domaine, par exemple acme.com.
Dans Email administrateur à impersonate, saisissez l'adresse de l'administrateur dont le Service Account emprunte l'identité.
Dans Clé du Service Account (JSON), collez le contenu complet du fichier téléchargé.
Cliquez sur Tester la connexion et attendez Connexion réussie. Rien n'est enregistré à ce stade.
Cliquez sur Connecter l'annuaire.

RingSync chiffre la clé, enregistre l'identifiant client Google de votre domaine (affiché comme Customer ID dans Paramètres), calcule les sièges, puis vous amène sur le tableau de bord de l'annuaire.

Pour votre équipe sécurité

Vous gardez la maîtrise. Le Service Account est dans votre projet : vous coupez l'accès en supprimant sa clé dans Google Cloud ou l'entrée de délégation dans la Google Admin Console.
Lecture seule. La délégation n'accorde que les trois scopes listés ci-dessus : ni emails, ni Drive, ni écriture. Voir Autorisations Google.
Côté RingSync. La clé est stockée chiffrée et le tableau de bord ne l'affiche pas.
Compte emprunté. Il doit rester un compte administrateur qui peut lire l'annuaire. Sinon Google refuse l'accès et la lecture de l'annuaire s'arrête.
Rotation de la clé. Le tableau de bord ne permet pas de remplacer la clé d'un annuaire Google déjà connecté, et supprimer la clé dans Google Cloud coupe la connexion. Écrivez-nous depuis Nous contacter avant toute rotation.

Méthode 2 : Se connecter à Google

Vous n'avez rien à créer dans Google Cloud : vous autorisez l'application de RingSync avec votre compte administrateur.

Cliquez sur Connecter un annuaire, saisissez le Nom de l'annuaire, choisissez Google Workspace, puis Se connecter à Google.
Facultatif : saisissez le Domaine Workspace (optionnel) pour restreindre le sélecteur de compte Google à votre domaine.
Cliquez sur Se connecter à Google.
Connectez-vous avec un compte administrateur Google Workspace qui peut lire l'annuaire, puis accordez l'accès en lecture seule à l'annuaire.
Vous revenez sur le tableau de bord de l'annuaire.

RingSync conserve un jeton de rafraîchissement chiffré. Le compte avec lequel vous vous êtes connecté sert ensuite à lire l'annuaire : il apparaît comme Admin délégué dans Paramètres. Si ce compte retire l'accès accordé à RingSync, la lecture de l'annuaire s'arrête.

Définir qui a accès

Google n'a pas d'assignation d'application comparable à celle d'Entra : les sièges se règlent dans RingSync.

Ouvrez Paramètres → Sièges autorisés.
Choisissez Tous les utilisateurs du domaine (réglage par défaut) ou Membres de groupes spécifiques.
Pour les groupes, cliquez sur Ajouter un groupe, recherchez le groupe, puis sélectionnez-le. Les membres des groupes imbriqués comptent aussi.
Cliquez sur Enregistrer.

RingSync recalcule les sièges toutes les 15 minutes. Pour appliquer le changement tout de suite, cliquez sur Synchroniser depuis l'annuaire sur la page Utilisateurs.

Limite du plan : au-delà du nombre de sièges de votre offre, les personnes en trop n'obtiennent pas de siège. Avec Tous les utilisateurs du domaine, vérifiez que votre offre couvre tout le domaine. Voir Sièges et limites.
Retirer quelqu'un : sortez la personne du groupe choisi, ou supprimez son compte. Au passage suivant, 15 minutes au plus tard, son siège est révoqué et ses téléphones purgent les contacts de l'annuaire. Voir Sécurité et données.

Sièges et contacts synchronisés

Les Sièges autorisés décident de qui utilise l'app. Les contacts écrits sur les téléphones se règlent séparément, dans Périmètre de synchronisation et Groupes à exclure (offre Pro et supérieures). Voir Choisir et exclure des groupes.

Vérifier la connexion

Dans Tableau de bord → Connexion à l'annuaire, l'état est Opérationnelle.
La page Utilisateurs liste les personnes autorisées.
Sur un téléphone, la personne touche Se connecter avec Google, l'annuaire apparaît, puis la première synchronisation réussit.

Dépannage

Message ou symptôme	Cause probable	Que faire
« Google a refusé l'accès : … » avec `unauthorized_client`	L'entrée de délégation est absente, le Client ID est faux ou les scopes diffèrent des trois attendus.	Vérifiez le Client ID numérique et la ligne de scopes exacte dans la délégation au niveau du domaine.
« Google a refusé l'accès : … » avec `(403)` et `Not Authorized to access this resource/api`	Le compte dont l'identité est empruntée ne peut pas lire l'annuaire.	Indiquez un administrateur qui peut lire les utilisateurs et les groupes.
« Google a refusé l'accès : … » avec `(403)` et une mention de l'Admin SDK API	L'API n'est peut-être pas activée dans le projet du Service Account.	Activez l'Admin SDK API dans le projet.
« La clé du Service Account est invalide. »	Le contenu JSON est incomplet ou ce n'est pas le bon fichier.	Collez le fichier JSON entier, tel que téléchargé.
« Cet annuaire est déjà configuré sur RingSync. »	Ce domaine est déjà connecté à une organisation RingSync.	Écrivez-nous depuis Nous contacter.
« Limite de votre offre atteinte (nombre d'annuaires). »	Votre offre n'autorise pas d'annuaire supplémentaire.	Voir Sièges et limites.
« Google n'a pas renvoyé de jeton de rafraîchissement. Réessayez en forçant le consentement. »	Le consentement avec Se connecter à Google est incomplet.	Recommencez et acceptez l'écran de consentement.
« Configuration serveur incomplète. Contactez-nous. » avec Se connecter à Google	La méthode n'est pas disponible.	Utilisez Service Account (DWD).
Connexion à l'annuaire : « L'accès de RingSync à Google Workspace a été retiré… »	Délégation retirée ou réduite, clé supprimée, ou accès OAuth révoqué.	Rétablissez la délégation avec les trois scopes, ou écrivez-nous depuis Nous contacter. Voir RingSync a perdu l'accès à l'annuaire.

Détails techniques

API et scopes. RingSync utilise les trois scopes en lecture seule admin.directory.user.readonly, admin.directory.group.readonly et admin.directory.group.member.readonly, dans les deux méthodes.
Pas de delta. L'API Admin SDK Directory n'a pas d'équivalent au delta de Microsoft : chaque synchronisation relit la liste complète des utilisateurs. Voir Fonctionnement de la synchronisation.
Identifiant du domaine. RingSync identifie votre annuaire par son identifiant client Google immuable (Customer ID dans Paramètres), et refuse un domaine déjà connecté.
Sièges. Avec Membres de groupes spécifiques, les sièges sont l'union des membres, y compris imbriqués, des groupes listés. Seules les personnes qui ont une adresse email sont retenues.

Cette page vous a-t-elle été utile ?

Signaler un manque →

← Précédent

Autorisations Microsoft

Autorisations Google