Nesta página, descrevemos como controlar o acesso e as permissões da API para recursos do Gemini Enterprise usando o Identity and Access Management (IAM).
Visão geral
OGoogle Cloud oferece o IAM, que permite a concessão de acesso mais granular a recursos específicos do Google Cloud e impede o acesso indesejado a outros recursos. Nesta página, descrevemos os papéis e as permissões do IAM do Gemini Enterprise. Para uma descrição detalhada do Google Cloud IAM, consulte a documentação do IAM.
O Gemini Enterprise oferece um conjunto de papéis predefinidos criados para ajudar você a controlar o acesso aos recursos do Gemini Enterprise. Também é possível criar seus próprios papéis personalizados, caso os predefinidos não forneçam os conjuntos de permissões necessárias. Além disso, os papéis básicos mais antigos (Editor, Leitor e Proprietário) também estão disponíveis, embora não forneçam o mesmo controle granular que os papéis do Gemini Enterprise. Em especial, os papéis básicos fornecem acesso a recursos no Google Cloud e não apenas para o Gemini Enterprise. Consulte a documentação sobre papéis básicos para mais informações.
Papéis predefinidos
O Gemini Enterprise oferece alguns papéis predefinidos que podem ser usados para fornecer permissões mais específicas aos principais. O papel concedido a um principal controla quais ações ele pode tomar. Os principais podem ser indivíduos, grupos ou contas de serviço.
Conceda diversos papéis ao mesmo principal. Também é possível alterar os papéis concedidos a um principal a qualquer momento, desde que você tenha permissões para isso.
Os papéis mais amplos incluem os definidos de maneira mais restrita. Por exemplo, o papel de editor do Discovery Engine inclui todas as permissões do papel de leitor do Discovery Engine, além das permissões adicionais do papel de editor do Discovery Engine. Da mesma forma, o papel de administrador do Gemini Enterprise inclui todas as permissões do papel de editor do Discovery Engine, além de outras permissões.
Os papéis básicos (Proprietário, Editor, Leitor) fornecem permissões em Google Cloud. Os papéis específicos do Gemini Enterprise fornecem apenas permissões do Gemini Enterprise, exceto as seguintes permissões Google Cloud, que são necessárias para o uso geral do Google Cloud :
resourcemanager.projects.getresourcemanager.projects.listserviceusage.services.listserviceusage.services.get
A tabela a seguir lista os papéis do IAM do Gemini Enterprise com uma lista correspondente de todas as permissões de cada papel.
| Papel | Permissões |
|---|---|
Administrador do Gemini Enterprise( Concede acesso de administrador aos recursos do Gemini Enterprise. |
|
Editor do Discovery Engine( Concede acesso de leitura e gravação a todos os recursos do Discovery Engine. |
|
Usuário do Gemini Enterprise( Concede acesso de usuário aos recursos do Gemini Enterprise. |
|
Usuário restrito do Gemini Enterprise( Concede acesso restrito de usuário aos recursos do Gemini Enterprise para controle refinado de várias instâncias do Gemini Enterprise no mesmo projeto. Os principais com esse papel precisam receber um papel irrestrito no nível do usuário (por exemplo, /agentspaceUser) em uma política do Engine para usar o Gemini Enterprise. |
|
Leitor do Gemini Enterprise( Concede acesso para ler os detalhes dos recursos do Gemini Enterprise. |
|
Leitor do Discovery Engine( Concede acesso de leitura a todos os recursos do Discovery Engine. |
|
Gerenciar o IAM do Gemini Enterprise
É possível receber e definir políticas de permissão e papéis do IAM usando o console Google Cloud . Para mais informações, consulte Gerenciar o acesso a projetos, pastas e organizações.
Conceder permissões aos administradores
Como proprietário do projeto, é possível conceder os papéis Gemini Enterprise Admin, Service Usage Consumer e Logs Viewer aos usuários que querem ser administradores.
Siga estas etapas para adicionar as funções:
-
No console do Google Cloud , acesse a página IAM.
Acessar IAM - Selecione o projeto.
- Clique em Conceder acesso.
-
No campo Novos principais, insira o identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google ou de um grupo de usuários.
- Adicione os papéis:
- Clique em Adicionar outro papel.
- Na lista Selecionar um papel, escolha Administrador do Gemini Enterprise.
- Repita as etapas a e b para adicionar as funções Consumidor do Service Usage e Visualizador de registros.
- Clique em Salvar.
Dependendo da tarefa administrativa, verifique também as seguintes vinculações de função:
- Conectores de dados: conceda
roles/discoveryengine.editorpara gerenciar conectores de dados. Ao autorizar um conector pela primeira vez em um projeto, você também precisa das permissõesdiscoveryengine.locations.setUpDataConnectorediscoveryengine.locations.exchangeAuthCredentials. Ambas as permissões estão incluídas nos papéisroles/discoveryengine.admineroles/discoveryengine.agentspaceAdmin. - Distribuição de licenças: conceda o papel de Administrador da conta de faturamento
(
roles/billing.admin, que incluidiscoveryengine.billingAccountLicenseConfigs.distribute) na conta do Cloud Billing, além deroles/discoveryengine.agentspaceAdminno projeto para distribuir licenças. - Agente de serviço: verifique se o agente de serviço do Discovery Engine
(
service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com) temroles/discoveryengine.serviceAgentno projeto. Caso contrário, a criação do app vai falhar comInternal error encountered (Code 13).
Conceder permissões aos usuários
Nesta seção, descrevemos como conceder aos usuários os papéis para envolvidos no projeto necessários para acessar os apps Gemini Enterprise. Dependendo do seu modelo de acesso, escolha um dos seguintes papéis:
- Acessar todos os apps no projeto: conceda o papel de usuário do Gemini Enterprise (
roles/discoveryengine.agentspaceUser) no nível do projeto. - Acessar apenas apps específicos: conceda a função Usuário restrito do Gemini Enterprise (
roles/discoveryengine.agentspaceRestrictedUser) no nível do projeto e, em seguida, conceda a função Usuário do Gemini Enterprise (roles/discoveryengine.agentspaceUser) nos apps individuais. A função de usuário restrito não concede acesso a nenhum app por conta própria. Por isso, os usuários só podem abrir os apps em que você concede a função de usuário corporativo do Gemini Enterprise. Para mais informações, consulte Configurar controles de acesso para apps.
Para conceder o papel para envolvidos no projeto no console do Google Cloud , siga estas etapas:
-
No console do Google Cloud , acesse a página IAM.
Acessar IAM - Selecione o projeto.
- Clique em Conceder acesso.
-
No campo Novos principais, insira o identificador de usuário. Normalmente, é o endereço de e-mail de uma Conta do Google, um grupo de usuários ou o identificador de um usuário em um pool de identidades de força de trabalho. Para mais detalhes, consulte Identificadores principais para políticas de permissão.
-
Adicione a função para envolvidos no projeto:
- Clique em Adicionar outro papel.
-
Na lista Selecionar um papel, escolha uma das seguintes opções:
- Para conceder acesso a todos os apps no projeto, selecione Usuário do Gemini Enterprise.
- Para restringir o acesso a apps específicos, selecione Usuário restrito do Gemini Enterprise.
- Clique em Salvar.
-
Se você concedeu o papel de Usuário restrito do Gemini Enterprise, conceda o papel de Usuário corporativo do Gemini Enterprise (
roles/discoveryengine.agentspaceUser) em cada app individual que o usuário precisa acessar. Para instruções detalhadas, consulte Configurar controles de acesso para apps.
Para permitir que os usuários gerenciem e compartilhem apps, conceda a eles a função de Leitor do Discovery Engine (roles/discoveryengine.viewer).
A seguir
- Saiba como gerenciar o acesso a projetos, pastas e organizações.
- Aprenda mais sobre o IAM.
- Aprenda mais sobre os papéis básicos.
- Aprenda mais sobre os papéis personalizados.