En esta página, se describe cómo puedes controlar el acceso a la API y los permisos para los recursos de Gemini Enterprise con Identity and Access Management (IAM).
Descripción general
Google Cloud ofrece IAM, que te permite brindar acceso más detallado a recursos de Google Cloud específicos y evita el acceso no deseado a otros recursos. En esta página, se describen los roles y permisos de IAM de Gemini Enterprise. Para obtener una descripción detallada de IAM deGoogle Cloud , consulta la documentación de IAM.
Gemini Enterprise proporciona un conjunto de roles predefinidos diseñados para ayudarte a controlar el acceso a tus recursos de Gemini Enterprise. También puedes crear tus propios roles personalizados si los roles predefinidos no proporcionan los conjuntos de permisos que necesitas. Además, los roles básicos más antiguos (Editor, Visualizador y Propietario) también están disponibles, aunque no proporcionan el mismo control detallado que los roles de Gemini Enterprise. En particular, los roles básicos brindan acceso a los recursos en Google Cloud , en lugar de solo a los de Gemini Enterprise. Consulta la documentación sobre los roles básicos para obtener más información.
Roles predefinidos
Gemini Enterprise proporciona algunos roles predefinidos que puedes usar para otorgar permisos más detallados a las principales. La función que otorgas a una principal controla las acciones que puede realizar. Las principales pueden ser personas, grupos o cuentas de servicio.
Puedes otorgar varias funciones al mismo principal y cambiarlas en cualquier momento, siempre que tengas los permisos para hacerlo.
Las funciones más amplias incluyen las más específicas. Por ejemplo, el rol de Editor de Discovery Engine incluye todos los permisos del rol de Visualizador de Discovery Engine, junto con los permisos adicionales del rol de Editor de Discovery Engine. Del mismo modo, el rol de administrador de Gemini Enterprise incluye todos los permisos del rol de editor de Discovery Engine, junto con sus permisos adicionales.
Los roles básicos (propietario, editor y visualizador) proporcionan permisos en Google Cloud. Los roles específicos de Gemini Enterprise solo proporcionan permisos de Gemini Enterprise, excepto los siguientes permisos de Google Cloud, que se necesitan para el uso general de Google Cloud :
resourcemanager.projects.getresourcemanager.projects.listserviceusage.services.listserviceusage.services.get
En la siguiente tabla, se enumeran los roles de IAM de Gemini Enterprise con una lista correspondiente de todos los permisos para cada rol.
| Rol | Permisos |
|---|---|
Administrador de Gemini Enterprise( Otorga acceso a nivel de administrador a los recursos de Gemini Enterprise. |
|
Editor de Discovery Engine( Otorga acceso de lectura y escritura a todos los recursos de Discovery Engine. |
|
Usuario de Gemini Enterprise( Otorga acceso a nivel de usuario a los recursos de Gemini Enterprise. |
|
Usuario restringido de Gemini Enterprise( Otorga acceso restringido a nivel de usuario a los recursos de Gemini Enterprise para un control detallado sobre varias instancias de Gemini Enterprise en el mismo proyecto. Las principales con este rol no deberán tener restricciones a nivel de usuario (p. ej., /agentspaceUser) en una política de Engine para usar Gemini Enterprise. |
|
Visualizador de Gemini Enterprise( Otorga acceso para ver los detalles de los recursos de Gemini Enterprise. |
|
Visualizador de Discovery Engine( Otorga acceso de lectura a todos los recursos de Discovery Engine. |
|
Administrar la IAM de Gemini Enterprise
Puedes obtener y configurar las políticas de permisos de IAM y los roles de IAM con la consola de Google Cloud . Para obtener más información, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Otorga permisos a los administradores
Como propietario del proyecto, puedes otorgar los roles Gemini Enterprise Admin,
Service Usage Consumer y Logs Viewer a los usuarios que quieran ser
administradores.
Sigue estos pasos para agregar los roles:
-
En la consola de Google Cloud , dirígete a la página IAM.
Ir a IAM - Selecciona el proyecto.
- Haz clic en Otorgar acceso.
-
En el campo Principales nuevas, ingresa el identificador de usuario. Por lo general, es la dirección de correo electrónico de una Cuenta de Google o un grupo de usuarios.
- Agrega los roles:
- Haz clic en Agregar otro rol.
- En la lista Seleccionar un rol, selecciona Administrador de Gemini Enterprise.
- Repite los pasos a y b para agregar los roles de Consumidor de Service Usage y Visor de registros.
- Haz clic en Guardar.
Según la tarea administrativa, también verifica las siguientes vinculaciones de roles:
- Conectores de datos: Otorga
roles/discoveryengine.editorpara administrar conectores de datos. Cuando autorizas un conector por primera vez en un proyecto, también necesitas los permisosdiscoveryengine.locations.setUpDataConnectorydiscoveryengine.locations.exchangeAuthCredentials. Ambos permisos se incluyen en el rolroles/discoveryengine.adminy en el rolroles/discoveryengine.agentspaceAdmin. - Distribución de licencias: Otorga el rol de administrador de cuentas de facturación
(
roles/billing.admin, que incluyediscoveryengine.billingAccountLicenseConfigs.distribute) en la cuenta de Facturación de Cloud, además deroles/discoveryengine.agentspaceAdminen el proyecto para distribuir licencias. - Agente de servicio: Asegúrate de que el agente de servicio de Discovery Engine
(
service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com) tengaroles/discoveryengine.serviceAgenten el proyecto; de lo contrario, la creación de la app fallará conInternal error encountered (Code 13).
Otorga permisos a tus usuarios
En esta sección, se describe cómo otorgar a tus usuarios los roles a nivel del proyecto que necesitan para acceder a las apps de Gemini Enterprise. Según tu modelo de acceso, elige uno de los siguientes roles:
- Accede a todas las apps del proyecto: Otorga el rol de usuario de Gemini Enterprise (
roles/discoveryengine.agentspaceUser) a nivel del proyecto. - Accede solo a apps específicas: Otorga el rol de Usuario restringido de Gemini Enterprise (
roles/discoveryengine.agentspaceRestrictedUser) a nivel del proyecto y, luego, otorga el rol de Usuario de Gemini Enterprise (roles/discoveryengine.agentspaceUser) en las apps individuales. El rol de usuario restringido no otorga acceso a ninguna app por sí solo, por lo que los usuarios pueden abrir solo las apps en las que les otorgues el rol de usuario de Gemini Enterprise. Para obtener más información, consulta Configura controles de acceso para las apps.
Para otorgar el rol a nivel de proyecto en la consola de Google Cloud , sigue estos pasos:
-
En la consola de Google Cloud , dirígete a la página IAM.
Ir a IAM - Selecciona el proyecto.
- Haz clic en Otorgar acceso.
-
En el campo Principales nuevas, ingresa el identificador de usuario. Por lo general, es la dirección de correo electrónico de una Cuenta de Google, un grupo de usuarios o el identificador de un usuario en un grupo de Workforce Identity. Para obtener más información, consulta Identificadores principales para políticas de permiso.
-
Agrega el rol a nivel de proyecto:
- Haz clic en Agregar otro rol.
-
En la lista Seleccionar un rol, elige uno de los siguientes roles:
- Para otorgar acceso a todas las apps del proyecto, selecciona Usuario de Gemini Enterprise.
- Para restringir el acceso a apps específicas, selecciona Usuario restringido de Gemini Enterprise.
- Haz clic en Guardar.
-
Si otorgaste el rol de Usuario restringido de Gemini Enterprise, otorga el rol de Usuario de Gemini Enterprise (
roles/discoveryengine.agentspaceUser) en cada app individual a la que el usuario deba acceder. Para obtener instrucciones paso a paso, consulta Configura controles de acceso para las apps.
Para permitir que los usuarios administren y compartan apps, otórgales el rol de
Visualizador de Discovery Engine
(roles/discoveryengine.viewer).
¿Qué sigue?
- Obtén más información para administrar el acceso a proyectos, carpetas y organizaciones.
- Obtén más información sobre IAM.
- Obtén más información sobre los roles básicos.
- Obtén más información sobre los roles personalizados.