> 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 zur Authentifizierung verwenden

Schritt-für-Schritt-Anleitung zur Konfiguration von Google als OAuth2-Autorisierungsquelle in VergeOS, einschließlich Abruf von Anmeldeinformationen und Erstellung von Benutzern.

VergeOS kann so konfiguriert werden, dass sich Benutzer mit ihren Unternehmens-Google-Anmeldedaten authentifizieren können. Diese Seite führt Sie durch den Konfigurationsprozess.

## Konfigurieren Sie eine Google-Autorisierungsquelle

1. Erhalten Sie **Client-ID** und **Client-Geheimnis** vom Google-System. Diese Werte sollten basierend auf der öffentlichen URL des VergeOS-Systems generiert werden. Siehe die Google-Dokumentation für Anweisungen, wie 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 in der Regel unter folgender Adresse generiert werden: [***https://console.developers.google.com***](https://console.developers.google.com/)
{% endhint %}

2. Klicken Sie **System** im oberen Menü.
3. Wählen Sie **Auth-Quellen**.
4. Klicken Sie **Neu** im linken Menü.
5. Geben Sie einen ***Namen*** für die Quelle ein (z. B. "Google"). Dieser Name wird auf der Anmeldeschaltfläche der VergeOS-Anmeldeseite angezeigt.
6. In dem ***Treiber*** Feld (Dropdown-Liste) wählen Sie **Google**.
7. ***Weiterleitungs-URI*** sollte mit der URL des VergeOS-Systems gefüllt werden. Dies muss eine öffentliche Adresse sein, auf die über die Google-API zugegriffen werden kann.
8. Geben Sie die ***Client-ID*** und ***Client-Geheimnis*** Werte ein, die Sie von Google erhalten haben.
9. ***Remote-Benutzerfelder*** ist die Liste der Felder, die zunächst verwendet werden, um den Google-Benutzer zu finden; dieses Feld wird automatisch mit (sub,preferred\_username,email nickname) vorbefüllt, einer Standardliste, die in der Regel für Google-Implementierungen geeignet ist. **Hinweis: Aus Sicherheitsgründen wird nicht empfohlen, entfernte Benutzer anhand von Feldern zu identifizieren, die vom Endbenutzer auf dem entfernten System geändert werden können.**
10. **Optionen (Es wird empfohlen, diese Optionen zu aktivieren.)**
    * ***Remote-Benutzer aktualisieren:*** - sobald der Benutzer im Google-System gefunden wurde, VergeOS-Benutzer aktualisieren *Remote-Benutzername* Feld auf die entsprechende eindeutige Google-ID (sub-String)
    * **Benutzer-E-Mail-Adresse aktualisieren:** - VergeOS-Benutzer-E-Mail-Adresse aktualisieren, damit sie mit der E-Mail-Adresse in Google übereinstimmt.
    * **Benutzer-Anzeigenamen aktualisieren:** - VergeOS-Benutzer-Anzeigename aktualisieren, damit er mit dem Anzeigenamen in Google übereinstimmt.

{% hint style="success" %}
**Das Aktivieren des&#x20;*****Felds „Remote-Benutzer aktualisieren“*****&#x20;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 Remote-Benutzer definierten Feldern gefunden wurde), sodass die eindeutige Kennung später zum Finden des Google-Benutzers verwendet werden kann; dies wird in der Regel empfohlen, da Felder wie die E-Mail-Adresse Änderungen unterliegen.**
{% endhint %}

11. **Zusätzliche optionale Felder** Siehe [**Autorisierungsquellen – Übersicht**](https://docs.verge.io/run-the-platform/de/authentifizierung/auth-sources-general.md) für Informationen zu zusätzlichen optionalen Feldern.
12. Nachdem Sie die Konfiguration abgeschlossen haben, klicken Sie auf **Absenden** um die neue Autorisierungsquelle zu speichern.

## VergeOS-Benutzer hinzufügen, die Google-Authentifizierung verwenden

Nachdem die Autorisierungsquelle erstellt wurde, können Benutzer erstellt werden, um die Google-Quelle für die Anmeldung zu verwenden. **Erstellen Sie neue VergeOS-Benutzer mit folgender Konfiguration:**

* ***Autorisierungsquelle:*** Wählen Sie die Google-Quelle aus der Dropdown-Liste
* ***Benutzername:*** eindeutiger Name innerhalb des VergeOS-Systems; in der Regel wird empfohlen, denselben Anmeldenamen zu verwenden, der auch in Google verwendet wird.
* ***Remote-Benutzername:*** verwenden Sie den Wert eines der als Remote-Benutzerfelder definierten Felder, also Felder, nach 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 *Benutzer-Anzeigenamen aktualisieren* auf der Google-Authentifizierungsquelle aktiviert ist, wird der Anzeigename mit dem Google-Benutzer synchronisiert.
* ***E-Mail-Adresse:*** (optional) Wenn *Benutzer-E-Mail-Adresse 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/de/authentifizierung/google-auth.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
