> 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/es/autenticacion/google-auth.md).

# Uso de Google para la autenticación

VergeOS se puede configurar para permitir que los usuarios se autentiquen utilizando sus credenciales corporativas de Google. Esta página le guiará a través del proceso de configuración.

## Configurar una fuente de autorización de Google

1. Obtener **ID de cliente** y **Secreto de cliente** del sistema de Google. Estos valores deben generarse en función de la URL pública del sistema VergeOS. Consulte la documentación de Google para obtener instrucciones, como [**https://developers.google.com/identity/protocols/oauth2**](https://developers.google.com/identity/protocols/oauth2)

{% hint style="success" %}
El ID de cliente y el secreto normalmente se pueden generar en: [***https://console.developers.google.com***](https://console.developers.google.com/)
{% endhint %}

2. Haga clic en **Sistema** en el menú superior.
3. Seleccione **Fuentes de autenticación**.
4. Haga clic en **Nuevo** en el menú de la izquierda.
5. Introduzca un ***Nombre*** para la fuente (como "Google"). Este nombre aparecerá en el botón de inicio de sesión de la página de acceso de VergeOS.
6. En la ***Controlador*** campo (lista desplegable), seleccione **Google**.
7. ***URI de redirección*** debe completarse con la URL del sistema VergeOS. Esta debe ser una dirección pública a la que pueda acceder la API de Google.
8. Introduzca el ***ID de cliente*** y ***Secreto de cliente*** valores obtenidos de Google.
9. ***Campos de usuario remoto*** es la lista de campos utilizada para encontrar inicialmente al usuario de Google; este campo se autocompleta con (sub,preferred\_username,email nickname), una lista predeterminada que normalmente puede funcionar para implementaciones de Google. **Nota: Por razones de seguridad, no se recomienda localizar usuarios remotos basándose en campos que puedan ser modificados por el usuario final en el sistema remoto.**
10. **Opciones (Se recomienda habilitar estas opciones.)**
    * ***Actualizar usuario remoto:*** - una vez que el usuario se localice en el sistema de Google, actualizar el usuario de VergeOS *Nombre de usuario remoto* campo al ID único correspondiente de Google (cadena sub)
    * **Actualizar dirección de correo electrónico del usuario:** - actualizar la dirección de correo electrónico del usuario de VergeOS para que coincida con la dirección de correo electrónico de Google.
    * **Actualizar nombre para mostrar del usuario:** - actualizar el nombre para mostrar del usuario de VergeOS para que coincida con el nombre para mostrar de Google.

{% hint style="success" %}
**Al habilitar&#x20;*****Actualizar usuario remoto*****&#x20;el campo permitirá que el sistema VergeOS almacene el ID único de Google en el registro de usuario de VergeOS (después de localizar inicialmente al usuario de Google con los campos definidos en Campos de usuario remoto), de modo que posteriormente se pueda usar el identificador único para encontrar al usuario de Google; por lo general, se recomienda esto, ya que campos como la dirección de correo electrónico están sujetos a cambios.**
{% endhint %}

11. **Campos opcionales adicionales** Vea [**Fuentes de autorización - Resumen**](https://github.com/verge-io/docs-vergeos/tree/main/run/product-guide/auth/auth-sources-overview.md) para obtener información sobre campos opcionales adicionales.
12. Después de completar la configuración, haga clic en **Enviar** para guardar la nueva fuente de autorización.

## Agregar usuarios de VergeOS que usarán la autenticación de Google

Una vez creada la fuente de autorización, se pueden crear usuarios para utilizar la fuente de Google para iniciar sesión. **Cree nuevos usuarios de VergeOS con la siguiente configuración:**

* ***Fuente de autorización:*** Seleccione la fuente de Google de la lista desplegable
* ***Nombre de usuario:*** nombre único dentro del sistema VergeOS; normalmente se recomienda usar el mismo nombre de inicio de sesión que se usa en Google.
* ***Nombre de usuario remoto:*** use el valor de uno de los campos definidos como campos de usuario remoto, que son campos sobre los que se realiza la búsqueda en Google; la dirección de correo electrónico del usuario o la cadena sub, que es equivalente al ID de Google del usuario, suelen ser las mejores opciones.
* ***Nombre para mostrar:*** (opcional) Si *Actualizar nombre para mostrar del usuario* está habilitado en la fuente de autenticación de Google, el nombre para mostrar se sincronizará desde el usuario de Google.
* ***Dirección de correo electrónico:*** (opcional) Si *Actualizar dirección de correo electrónico del usuario* está habilitado en la fuente de autenticación de Google, la dirección de correo electrónico se sincronizará desde el usuario de Google.


---

# 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/es/autenticacion/google-auth.md?ask=<question>&goal=<endgoal>
```

`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.
