> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/authentifizierung/google-auth.md). # Google für die Authentifizierung verwenden VergeOS kann so konfiguriert werden, dass sich Benutzer mit ihren geschäftlichen Google-Anmeldedaten authentifizieren können. Diese Seite führt Sie durch den Konfigurationsprozess. ## Eine Google-Autorisierungsquelle konfigurieren 1. Beschaffen **Client-ID** und **Client Secret** aus dem Google-System. Diese Werte sollten auf Basis der öffentlichen URL des VergeOS-Systems generiert werden. Anweisungen finden Sie in der Google-Dokumentation, z. B. [**https://developers.google.com/identity/protocols/oauth2**](https://developers.google.com/identity/protocols/oauth2) {% hint style="success" %} Client-ID und Secret können typischerweise hier generiert werden: [***https://console.developers.google.com***](https://console.developers.google.com/) {% endhint %} 2. Klicken Sie **System** im oberen Menü. 3. Wählen Sie **Autorisierungsquellen**. 4. Klicken Sie **Neu** im linken Menü. 5. Geben Sie einen ***Namen*** für die Quelle (z. B. „Google“). Dieser Name wird auf der Anmeldeschaltfläche der VergeOS-Anmeldeseite angezeigt. 6. In der ***Treiber*** Feld (Dropdown-Liste), wählen Sie **Google**. 7. ***Umleitungs-URI*** sollte mit der URL des VergeOS-Systems ausgefüllt werden. Dies muss eine öffentliche Adresse sein, auf die die Google-API zugreifen kann. 8. Geben Sie die ***Client-ID*** und ***Client Secret*** mit Werten, die von Google erhalten wurden. 9. ***Felder für entfernte Benutzer*** ist die Liste der Felder, die verwendet werden, um den Google-Benutzer zunächst zu finden; dieses Feld wird automatisch mit (sub,preferred\_username,email nickname) gefüllt, einer Standardliste, die in der Regel für Google-Implementierungen funktioniert. **Hinweis: Aus Sicherheitsgründen wird nicht empfohlen, entfernte Benutzer anhand von Feldern zu ermitteln, die vom Endbenutzer im entfernten System geändert werden können.** 10. **Optionen (Es wird empfohlen, diese Optionen zu aktivieren.)** * ***Entfernten Benutzer aktualisieren:*** - sobald der Benutzer im Google-System gefunden wurde, den VergeOS-Benutzer aktualisieren *Remote-Benutzername* das Feld auf die entsprechende eindeutige Google-ID (sub-String) * **E-Mail-Adresse des Benutzers aktualisieren:** - die E-Mail-Adresse des VergeOS-Benutzers an die E-Mail-Adresse in Google anpassen. * **Anzeigenamen des Benutzers aktualisieren:** - den Anzeigenamen des VergeOS-Benutzers an den Anzeigenamen in Google anpassen. {% hint style="success" %} **Das Aktivieren von *****Entfernten Benutzer aktualisieren***** Feld ermöglicht es dem VergeOS-System, die eindeutige Google-ID im VergeOS-Benutzerdatensatz zu speichern (nachdem der Google-Benutzer zunächst mit den in den Feldern für entfernte Benutzer definierten Feldern ermittelt wurde), sodass die eindeutige Kennung anschließend zum Auffinden des Google-Benutzers verwendet werden kann; dies wird in der Regel empfohlen, da Felder wie die E-Mail-Adresse sich ändern können.** {% endhint %} 11. **Weitere optionale Felder** Siehe [**Autorisierungsquellen - Übersicht**](https://github.com/verge-io/docs-vergeos/tree/main/run/product-guide/auth/auth-sources-overview.md) für Informationen zu weiteren optionalen Feldern. 12. Nachdem Sie die Konfiguration abgeschlossen haben, klicken Sie **Senden** um die neue Autorisierungsquelle zu speichern. ## VergeOS-Benutzer hinzufügen, die Google-Authentifizierung verwenden Nachdem die Autorisierungsquelle erstellt wurde, können Benutzer angelegt werden, die die Google-Quelle für die Anmeldung nutzen. **Neue VergeOS-Benutzer mit der folgenden Konfiguration erstellen:** * ***Autorisierungsquelle:*** Wählen Sie die Google-Quelle aus der Dropdown-Liste aus * ***Benutzername:*** eindeutiger Name im VergeOS-System; typischerweise wird empfohlen, denselben Anmeldenamen wie in Google zu verwenden. * ***Remote-Benutzername:*** verwenden Sie den Wert eines der als Felder für entfernte Benutzer definierten Felder, in denen in Google gesucht wird; die E-Mail-Adresse des Benutzers oder der sub-String, der der Google-ID des Benutzers entspricht, sind in der Regel am besten geeignet. * ***Anzeigename:*** (optional) Wenn *Anzeigenamen des Benutzers aktualisieren* auf der Google-Authentifizierungsquelle aktiviert ist, wird der Anzeigename mit dem Google-Benutzer synchronisiert. * ***E-Mail-Adresse:*** (optional) Wenn *E-Mail-Adresse des Benutzers aktualisieren* auf der Google-Authentifizierungsquelle aktiviert ist, wird die E-Mail-Adresse mit dem Google-Benutzer synchronisiert. --- # 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://docs.verge.io/run-the-platform/de/authentifizierung/google-auth.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.