](https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E)
{% hint style="warning" %}
Siehe **Admin > Datensphäre > Datenhoheit > Ort der Datenverarbeitung** um zu bestätigen, wo sich Ihre Region befindet.
{% endhint %}
{% endstep %}
{% step %}
**Sie werden zur Google-Workspace-App-Konfigurationsseite weitergeleitet, um die Anmeldung abzuschließen.**
{% endstep %}
{% endstepper %}
***
### Anmeldung über die mobile Anwendung
{% hint style="info" %}
Command auf Android und iOS unterstützt die Anmeldung über SAML.
{% endhint %}
{% stepper %}
{% step %}
**Geben Sie im Feld E-Mail-Adresse die E-Mail des Benutzers ein und klicken Sie auf Weiter.**
{% endstep %}
{% step %}
**Sie sollten zu Ihrem IdP (Google Workspace) weitergeleitet werden, um den Anmeldevorgang abzuschließen.**
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="Benutzerbereitstellung" %}
## Google-Workspace-Benutzerbereitstellung
Die native Google-Workspace-Integration ermöglicht es Organisationen, Benutzer und Gruppen automatisch von Google Workspace in Verkada Command zu synchronisieren. Dies vereinfacht das Identitätsmanagement und das allgemeine Onboarding von Benutzern.
Im Gegensatz zu Verkadas SCIM-Integrationen mit Okta oder Azure verwendet diese Integration das Google Workspace Admin SDK und die Reports API, authentifiziert über ein Google-Dienstkonto mit bereichsweiter Delegierung.
Wenn die Integration aktiviert ist, kann Command:
* Benutzer und Gruppen aus ausgewählten Google-Workspace-Gruppen oder Organisationseinheiten (OUs) importieren
* sie als verwaltete Benutzer und Gruppen in Command synchronisieren
* die Verzeichnisgenauigkeit mit geplanten Hintergrundsynchronisierungen und bedarfsgesteuerten Synchronisierungen über die Admin-Benutzeroberfläche aufrechterhalten
***
### Ein Google-Dienstkonto erstellen
Damit Command Benutzer- und Gruppendaten aus Ihrer Google-Workspace-Domain lesen kann, muss es sich bei den Google-APIs mit einem Dienstkonto authentifizieren. Diese Art von Konto ist für den programmatischen Zugriff vorgesehen und muss mit den richtigen API-Berechtigungsbereichen und bereichsweiter Delegierung konfiguriert werden. Diese Einstellungen werden in Ihrem [Google Cloud Console](https://console.cloud.google.com/?hl=en-au) Konto konfiguriert.
#### Richtlinien & Rollen überprüfen
Sie müssen zunächst überprüfen, ob Ihr Benutzer berechtigt ist, ein Dienstkonto zu erstellen und den JSON-Schlüssel des Dienstkontos zu generieren. Um sicherzustellen, dass Sie nicht durch Sicherheitsrichtlinien in Ihrem Mandanten blockiert werden:
{% stepper %}
{% step %}
**Gehen Sie zu** [**Google Cloud Console**](https://console.cloud.google.com/?hl=en-au) **und melden Sie sich mit Ihren Super-Admin-Anmeldedaten an.**
{% endstep %}
{% step %}
**Öffnen Sie oben links das Dropdown-Menü Projektauswahl und wählen Sie Ihre oberste Ressource (Typ: Organisation) aus.**
{% endstep %}
{% step %}
**Navigieren Sie im linken Bereich zu IAM & Admin → IAM.**
{% endstep %}
{% step %}
**Klicken Sie unter Nach Prinzipalen anzeigen auf Zugriff gewähren.**
a. Unter **Prinzipale hinzufügen**, geben Sie die E-Mail-Adresse des Benutzers ein.\
b. Unter **Rollen zuweisen**, suchen Sie nach **Organisationsrichtlinien-Administrator**.\
c. Klicken Sie auf **Speichern**.
{% endstep %}
{% step %}
**Wählen Sie im linken Bereich Organisationsrichtlinien aus.**
{% endstep %}
{% step %}
**Suchen Sie in der Liste der Richtlinien nach den folgenden und deaktivieren Sie sie:**
{% code title="Zu deaktivierende Organisationsrichtlinien" %}
```
Erstellung von Dienstkonten deaktivieren | Verwaltet
Erstellung von Dienstkonten deaktivieren | Verwaltet (Legacy)
Erstellung von Dienstkontoschlüsseln deaktivieren | Verwaltet
Erstellung von Dienstkontoschlüsseln deaktivieren | Verwaltet (Legacy)
```
{% endcode %}
{% endstep %}
{% endstepper %}
#### Ein Dienstkonto erstellen
{% stepper %}
{% step %}
**In das** [**Google Cloud Console**](https://console.cloud.google.com/?hl=en-au)**, öffnen Sie oben links das Dropdown-Menü Projektauswahl.**
{% endstep %}
{% step %}
**Klicken Sie auf Neues Projekt.**
{% endstep %}
{% step %}
**Geben Sie einen Projektnamen ein (zum Beispiel *****Verkada Benutzer-Synchronisierung*****) und erstellen Sie das Projekt.**
{% endstep %}
{% step %}
**Sobald das Projekt erstellt ist, bestätigen Sie, dass es in der Navigationsleiste oben links ausgewählt ist.**
{% endstep %}
{% step %}
**Gehen Sie in der linken Seitenleiste zu IAM & Admin → Dienstkonten.**
{% endstep %}
{% step %}
**Klicken Sie auf + Dienstkonto erstellen.**
{% endstep %}
{% step %}
**Füllen Sie die folgenden Felder aus:**
* **Name:** Geben Sie einen beschreibenden Namen ein (z. B. *Verkada Benutzerbereitstellung*)
* **ID:** Unverändert lassen oder anpassen (optional)
* **Beschreibung:** Fügen Sie eine Notiz hinzu, z. B. *Wird von Verkada verwendet, um Workspace-Verzeichnisdaten zu lesen* (optional)
{% endstep %}
{% step %}
**Klicken Sie auf Erstellen und fortfahren.**
{% endstep %}
{% step %}
**Überspringen Sie den Schritt Projektzugriff gewähren — hier sind keine Rollen erforderlich.**
{% endstep %}
{% step %}
**Klicken Sie auf Weiter → Fertig.**
{% endstep %}
{% step %}
**Kopieren Sie aus der Liste der Dienstkonten die OAuth-2-Client-ID für das neu erstellte Konto. Sie benötigen diese ID später, um Ihre Einrichtung abzuschließen.**
{% endstep %}
{% endstepper %}
#### Eine JSON-Schlüsseldatei generieren
{% stepper %}
{% step %}
**Klicken Sie in der Liste der Dienstkonten auf den Kontonamen oder wählen Sie die drei Punkte neben Ihrem neuen Dienstkonto aus und wählen Sie Schlüssel verwalten.**
{% endstep %}
{% step %}
**Klicken Sie auf der Registerkarte Schlüssel auf Schlüssel hinzufügen → Neuen Schlüssel erstellen.**
{% endstep %}
{% step %}
**Wählen Sie JSON aus und klicken Sie auf Erstellen.**
{% endstep %}
{% step %}
**Eine `.json` Datei wird auf Ihren Computer heruntergeladen. Speichern Sie sie an einem sicheren Ort, um sie später bei der Einrichtung der Integration in Verkada Command zu verwenden.**
{% endstep %}
{% endstepper %}
{% hint style="danger" %}
Diese JSON-Datei enthält die Anmeldedaten, die die Google-Workspace-Integration in Command verwendet, um sich über OAuth 2.0 bei Google-APIs zu authentifizieren. Bewahren Sie diese Datei sicher auf, da sie Zugriff auf Ihre Workspace-Daten gewährt und niemals weitergegeben oder öffentlich gemacht werden sollte.
{% endhint %}
#### Erforderliche Google-APIs aktivieren
Verkada Command benötigt Zugriff auf bestimmte Google-Workspace-APIs, um Benutzer, Gruppen, Domains und Audit-Logs lesen zu können. Diese APIs müssen in Ihrem Google-Cloud-Projekt aktiviert sein, bevor die Integration funktionieren kann.
{% stepper %}
{% step %}
**Gehen Sie zu** [**Google Cloud Console**](https://console.cloud.google.com/)**, und melden Sie sich mit Ihren Super-Admin-Anmeldedaten an.**
{% endstep %}
{% step %}
**Gehen Sie in der linken Seitenleiste zu APIs & Services → API-Bibliothek.**
{% endstep %}
{% step %}
**Suchen Sie in der Suchleiste nach Admin SDK API, wählen Sie sie aus und klicken Sie dann auf Aktivieren.**
{% hint style="warning" %}
Diese API ist erforderlich, um Benutzer, Gruppen und Domänenmetadaten zu lesen.
{% endhint %}
{% endstep %}
{% step %}
**(Optional) Suchen Sie nach der Reports API und aktivieren Sie sie, damit Audit-Log-Monitoring und die Erkennung von Verzeichnisänderungen möglich sind.**
{% endstep %}
{% endstepper %}
***
### Bereichsweite Delegierung aktivieren
Damit das Dienstkonto einen Administrator imitieren und auf Benutzer- und Gruppendaten in Ihrer Domain zugreifen kann, müssen Sie ihm bereichsweite Delegierung gewähren. Dadurch kann das Dienstkonto Lesebefehle im Namen eines Administrators ausführen, ohne dass eine manuelle erneute Authentifizierung erforderlich ist.
{% stepper %}
{% step %}
**Navigieren Sie zur** [**Google Admin-Konsole**](https://admin.google.com/) **und melden Sie sich mit Ihren Super-Administrator-Anmeldedaten für Ihren Google-Workspace-Mandanten an.**
{% endstep %}
{% step %}
**Gehen Sie auf der Startseite der Admin-Konsole zu Sicherheit → Zugriff & Datenkontrolle → API-Steuerung.**
{% endstep %}
{% step %}
**Scrollen Sie auf der Seite API-Steuerung zum Abschnitt Bereichsweite Delegierung und klicken Sie auf Bereichsweite Delegierung verwalten.**
{% endstep %}
{% step %}
**Klicken Sie auf Neu hinzufügen und geben Sie die folgenden Details ein:**
* **Client-ID:** Fügen Sie die OAuth-2-Client-ID für Ihre Dienstkontoschlüsseldatei ein (das `client_id` Feld in der JSON).
* **OAuth-Berechtigungsbereiche (durch Kommas getrennt):**
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.orgunit.readonly
{% endstep %}
{% step %}
**Klicken Sie auf Autorisieren.**
{% endstep %}
{% endstepper %}
Der neue Delegierungseintrag wird auf der Seite angezeigt und bestätigt, dass das Dienstkonto jetzt von Verkada Command verwendet werden kann, um Benutzer-, Gruppen- und Audiodaten abzufragen.
#### Benutzerattributwerte festlegen
Bevor Sie Benutzer mit Verkada Command synchronisieren, vergewissern Sie sich, dass wichtige Attribute (wie Vorname, Nachname, E-Mail und Mitarbeiter-ID) in Google Workspace korrekt ausgefüllt sind.
{% stepper %}
{% step %}
**Melden Sie sich bei der** [**Google Admin-Konsole**](https://admin.google.com/) **mit Ihrem Super-Admin-Konto an.**
{% endstep %}
{% step %}
**Gehen Sie zu Verzeichnis → Benutzer.**
{% endstep %}
{% step %}
**Wählen Sie das Benutzerprofil aus, das Sie aktualisieren möchten.**
{% endstep %}
{% step %}
**Klicken Sie auf Benutzerinformationen und erweitern Sie dann die relevanten Bereiche (z. B. Basisinformationen oder Mitarbeiterinformationen).**
{% endstep %}
{% step %}
**Aktualisieren Sie bei Bedarf die folgenden Felder:**
* **Primäre E-Mail-Adresse**
* **Vorname** und **Nachname**
* **Mitarbeiter-ID** (unter *Mitarbeiterinformationen*)
* **Telefonnummer** (unter *Kontaktinformationen*)
{% endstep %}
{% step %}
**Klicken Sie auf „Speichern“, um Ihre Änderungen zu übernehmen.**
{% endstep %}
{% endstepper %}
Die folgenden Attribute können von Google Workspace zu Verkada Command synchronisiert werden:
| Name des Google-Workspace-Attributs | Command-Feld |
| ------------------------------------------ | ---------------- |
| E-Mail | E-Mail |
| Vorname | Vorname |
| Nachname | Nachname |
| Abteilung | Abteilung |
| Kostenstelle | Abteilungs-ID |
| Mitarbeiter-ID | Mitarbeiter-ID |
| Berufsbezeichnung | Mitarbeitertitel |
| Telefonnummer (Primär/Privat/Arbeit/Mobil) | Telefonnummer |
{% hint style="danger" %}
Benutzer und Gruppen, die aus Google Workspace synchronisiert werden, werden ausschließlich in Workspace verwaltet und können in Verkada Command nicht bearbeitet werden. Benutzer müssen einen Vornamen, Nachnamen und eine E-Mail-Adresse haben, damit die Synchronisierung mit Command erfolgreich ist.
{% endhint %}
{% hint style="info" %}
Damit die Telefonnummern der Benutzer korrekt mit Verkada Command synchronisiert werden, geben Sie sie im internationalen Format ein, einschließlich der Landesvorwahl und ohne Leerzeichen oder Bindestriche.
**Beispiel:** `+14155552671`
{% endhint %}
***
### Die Integration in Command aktivieren
{% hint style="danger" %}
Sie benötigen **Organisationsadministrator** Berechtigungen zum Konfigurieren dieser Integration.
{% endhint %}
{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Admin.**
{% endstep %}
{% step %}
**Wählen Sie unter Org-Einstellungen Anmeldung & Zugriff → Benutzerbereitstellung → Google Workspace aus.**
a. Geben Sie die E-Mail-Adresse Ihres Google-Workspace-Super-Admins ein. Aus Sicherheits- und Kontinuitätsgründen empfiehlt Verkada die Verwendung eines dedizierten Dienstkontos mit gleichwertigen Administratorberechtigungen anstelle eines persönlichen Benutzerkontos.\
a. Laden Sie den JSON-Schlüssel hoch, den Sie in Ihrem Google-Cloud-Console-Projekt generiert haben.\
b. Sobald die Authentifizierung erfolgreich war, klicken Sie auf **Hinzufügen** um die Gruppen und/oder Organisationseinheiten auszuwählen, die Sie mit Command synchronisieren möchten.\
c. Klicken Sie auf **Aktivieren**.
{% endstep %}
{% step %}
**Nach erfolgreichem Abschluss der ersten Synchronisierung steht jederzeit eine Schaltfläche Jetzt synchronisieren für bedarfsgesteuerte Aktualisierungen zur Verfügung.**
{% endstep %}
{% endstepper %}
***
### FAQ
Werden Benutzer automatisch nach einem festen Zeitplan synchronisiert?
Ja, Benutzer werden automatisch alle 40 Minuten von Ihrem Google-Workspace-Konto in Verkada Command synchronisiert.
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.verkada.com/command/de/sicherheit/identity-providers/google-workspace.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.