# Verzeichnis-Sync mit Google Workspace

Quelle: https://sig.surf/de/integrations/google-workspace-directory (Markdown-Version der Seite)

Sig.Surf liest deine Leute aus Google Workspace. So kommen Name, Titel und Telefonnummer einer Signatur aus dem Verzeichnis und müssen nicht von Hand eingetippt werden.

## Was es macht

- Listet Nutzer, Organisationseinheiten und Gruppen deiner Domain auf. Ins Verzeichnis geschrieben wird nie.
- Legt neue Leute an, übernimmt Änderungen bei denen, die bleiben, und markiert alle, die nicht mehr in Google sind, als ausgeschieden.
- Nutzt die Pfade der Organisationseinheiten als Abteilungen. So kannst du einer Abteilung eine Vorlage zuweisen.
- Lässt Leute, die du von Hand hinzugefügt hast, und alle Angaben, die ein Admin in Sig.Surf bearbeitet hat, unangetastet.

## Benötigter Zugriff

| Scope | Wofür |
| --- | --- |
| `admin.directory.user.readonly` | Nutzer lesen |
| `admin.directory.group.readonly` | Gruppen und ihre Mitglieder lesen. Wird dieser Scope nicht gewährt, werden Nutzer trotzdem synchronisiert und Gruppen übersprungen. |

Ein Super Admin von Google Workspace gewährt den Zugriff einmalig über die domainweite Delegierung. Sieh dir an, [wie das Ausrollen autorisiert wird](https://sig.surf/de/docs/google-workspace-deployment).

## Sicherheitsprüfungen

- Liefert Google keine Nutzer zurück, stoppt der Sync, ohne etwas zu ändern.
- Würde ein Sync mehr als die Hälfte deiner Leute, und mehr als fünf, als ausgeschieden markieren, stoppt er und bittet einen Admin um Bestätigung, statt weiterzumachen.

## Aktuelle Grenzen

- Profilfotos werden nicht aus Google kopiert. Füge das Foto jeder Person in Sig.Surf hinzu, auf ihrer Seite unter People oder durch die Person selbst im Mitarbeiter-Hub: per Upload einer Bilddatei (PNG, JPG, GIF oder WebP bis 2 MB) oder durch Einfügen eines https-Bildlinks.
- Eine eigene Feldzuordnung ist nicht verfügbar.
- Stand 2026-11-17 werden Syncs von einem Admin gestartet. Automatische, geplante Syncs sind noch nicht live.
