As políticas de acesso unificadas (UAPs, na sigla em inglês) permitem conceder e negar acesso aos recursos doGoogle Cloud . Ao contrário das políticas de permissão e negação, as UAPs permitem conceder e negar acesso na mesma política, simplificando o gerenciamento de políticas. As UAPs também são reutilizáveis, o que significa que é possível aplicar a mesma UAP a vários recursos.
Como funcionam as Políticas de Acesso Unificadas
Para conceder ou negar acesso no IAM, é preciso especificar quem deve ter permissão ou não para fazer o que em qual recurso.
Nas UAPs, você especifica quem tem ou não permissão para fazer o que criando regras de UAP. Cada regra lista um conjunto de principais, um conjunto de papéis e permissões e um efeito. O efeito (permitir ou negar) especifica se os principais listados recebem os papéis e as permissões na regra ou se são impedidos de usar as permissões na regra. É possível ter até 100 regras em uma única UAP.
Para especificar qual recurso tem o acesso controlado por uma UAP, use uma vinculação de UAP para vincular a UAP a um recurso. É possível vincular uma única UAP a até cinco recursos. Um único recurso pode ter até cinco políticas vinculadas a ele.
Casos de uso
No IAM, há vários tipos de política que podem ser usados para permitir e negar acesso:
- Para permitir o acesso, use políticas de permissão ou regras de permissão da UAP.
- Para negar o acesso, use políticas de negação ou regras de negação da UAP.
Se você já usa políticas de permissão ou negação para controlar o acesso, recomendamos continuar usando essas políticas. Esses tipos de política também são compatíveis com o Solucionador de Problemas de Políticas, o que facilita a compreensão da causa raiz dos erros de acesso.
Use os UAPs nas seguintes circunstâncias:
- Você está configurando uma nova organização e planeja usar UAPs para controlar o acesso em toda a organização.
- Você quer configurar o controle de acesso refinado usando condições de UAP.
Regras da Política de Acesso Unificada
As UAPs são compostas por regras de permissão e negação. Essas regras contêm os seguintes componentes:
Um efeito: se a regra concede ou nega acesso. As regras que concedem acesso são chamadas de regras de permissão. As regras que negam o acesso são chamadas de regras de negação.
Um conjunto de principais: os principais, como usuários, grupos ou contas de serviço, que você quer incluir na regra. Nas regras de permissão, esses principais recebem acesso. Nas regras de negação, esses principais têm o acesso negado.
Uma lista de papéis e permissões: os papéis e as permissões que você quer incluir na regra. Nas regras de permissão, essas permissões são concedidas. Nas regras de negação, essas permissões são negadas.
Opcional: uma expressão de condição: uma expressão de Condições do IAM que especifica as condições que precisam ser verdadeiras para que a regra seja aplicada. Para mais informações, consulte Condições em UAPs nesta página.
Principais em regras de política de acesso unificada
Para especificar os principais que você quer incluir na regra, defina o seguinte:
- Principais incluídos: os principais que você quer incluir na regra.
- Principais excluídos: os principais que você quer excluir da regra, mesmo que estejam em um grupo na lista de principais incluídos.
Com essas duas listas, é possível especificar de forma concisa quais principais você quer
incluir na regra. Por exemplo, imagine que você esteja criando uma regra de permissão para conceder
acesso a usuários em example.com. Se você quiser conceder acesso a todos no
grupo all@example.com, exceto ao usuário reduced-access@example.com,
adicione all@example.com à lista de principais incluídos e
reduced-access@example.com à lista de principais excluídos.
Papéis e permissões nas regras da Política de Acesso Unificada
Para criar uma lista exata de permissões que você quer incluir na regra, defina o seguinte:
- Permissões incluídas: as permissões que você quer incluir na regra.
- Permissões excluídas: as permissões que você não quer incluir na regra, mesmo que estejam em um papel ou grupo de permissões na lista de permissões incluídas.
Para adicionar permissões à lista de permissões incluídas ou excluídas, é possível referenciar qualquer uma das seguintes opções:
Permissões: nomes de permissões individuais no formato de nome de domínio totalmente qualificado (FQDN). Por exemplo,
cloudresourcemanager.googleapis.com/projects.get.Papéis (somente regras de permissão): nomes de papéis predefinidos, como
roles/logging.logsViewer. Se você incluir um nome de papel em uma regra, ela vai incluir todas as permissões desse papel. Para ver todas as permissões em um papel, consulte a referência de papéis e permissões.No JSON do UAP, esses nomes sempre são precedidos por
role:, por exemplo,role:roles/logging.logsViewer.Os papéis só são permitidos em regras de permissão. As funções personalizadas não são compatíveis com nenhuma regra.
Grupos de permissões: conjuntos de permissões, como
aiplatform.googleapis.com/*.*. Grupos de permissões são conjuntos de permissões que correspondem a um padrão especificado. Há algumas restrições sobre os grupos de permissões que você pode referenciar e as permissões incluídas neles. Para mais informações, consulte Grupos de permissões nesta página.
Grupos de permissões
Grupos de permissões são conjuntos de permissões que correspondem a um padrão especificado. É possível usar um grupo de permissões para conceder ou negar conjuntos de permissões relacionadas. Por exemplo, é possível negar todas as permissões de um único serviço ou conceder todas as permissões que terminam em um determinado verbo.
Os grupos de permissões funcionam de maneira diferente nas regras de permissão e negação. As seções a seguir explicam como usar grupos de permissões em cada tipo de regra.
Grupos de permissões em regras de permissão
Para identificar um grupo de permissões em uma regra de permissão, substitua uma ou mais seções de
um nome de permissão por um caractere curinga (*). As permissões que cada
grupo inclui dependem da posição do caractere curinga:
SERVICE_FQDN/RESOURCE.*: inclui todas as permissões para o recurso especificado.SERVICE_FQDN/*.*: inclui todas as permissões para o serviço especificado.SERVICE_FQDN/*.VERB: inclui todas as permissões para um serviço que termina com o verbo especificado.*/*.VERB: inclui todas as permissões que terminam com o verbo especificado.*: inclui todas as permissões. Esse valor só é permitido ao listar permissões incluídas, não excluídas.
Os grupos de permissões incluem apenas as permissões compatíveis com papéis personalizados. Outras permissões não são incluídas, mesmo que correspondam ao formato especificado.
Para saber quais permissões são compatíveis com funções personalizadas, consulte Níveis de suporte para permissões em funções personalizadas.
As permissões listadas nessa página não usam o mesmo formato das permissões em UAPs:
- As funções personalizadas usam o formato
v1para nomes de permissão, que éSERVICE_ID.RESOURCE.VERB. - As UAPs usam o formato de nome de domínio totalmente qualificado para nomes de permissão, que é
SERVICE_FQDN/RESOURCE.VERB.
No entanto, os valores de SERVICE_ID e
SERVICE_FQDN costumam ser semelhantes. Na maioria dos casos, o valor de SERVICE_FQDN é o valor de SERVICE_ID da API v1, seguido de .googleapis.com. Por exemplo, a permissão para excluir um papel pode ser escrita
das seguintes maneiras:
- Formato
v1:iam.roles.delete - Formato do nome de domínio totalmente qualificado:
iam.googleapis.com/roles.delete
Use essa semelhança para traduzir entre os dois formatos ao analisar grupos de permissões para regras de permissão.
Há algumas exceções a essa regra. Para ver essas exceções, consulte
a lista de permissões compatíveis com políticas de negação
e pesquise IAM v1 API no campo de filtro.
Grupos de permissões em regras de negação
As regras de negação só são compatíveis com determinados grupos de permissões. Os grupos de permissões com suporte estão listados em Permissões compatíveis em políticas de negação. Os identificadores dos grupos de permissões compatíveis substituem uma ou mais seções de um nome de permissão por um caractere curinga (*). As permissões que cada grupo inclui dependem da posição do caractere curinga:
SERVICE_FQDN/RESOURCE.*: nega todas as permissões para o recurso especificado.SERVICE_FQDN/*.*: nega todas as permissões para o serviço especificado.SERVICE_FQDN/*.VERB: nega todas as permissões para um serviço que termina com o verbo especificado.
Os grupos de permissões incluem todas as permissões atuais e futuras que correspondem ao
padrão especificado. Por exemplo, imagine que você usa o grupo de permissões
example.googleapis.com/exampleResource.* para negar a um usuário todas as permissões do
tipo de recurso exampleResource. Se example.googleapis.com adicionar uma nova
permissão para o tipo de recurso exampleResource, como
example.googleapis.com/exampleResource.newPermission, o usuário receberá
automaticamente a nova permissão.
Só é possível usar caracteres curinga em grupos de permissões compatíveis. Não é possível usar caracteres curinga em outros nomes de permissão em regras de negação.
Criar políticas de acesso unificadas
É possível criar UAPs em um projeto, uma pasta ou uma organização. O recurso em que você cria o UAP se torna o pai dele. No entanto, a UAP não terá efeito até que você aplique a UAP.
O pai do UAP aparece no
nome do UAP. Os nomes das políticas têm o formato
RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID,
em que os marcadores de posição representam o seguinte:
RESOURCE_TYPE: o tipo de recurso em que o UAP foi criado. Esse valor éprojects,foldersouorganizations.RESOURCE_ID: o ID do recurso em que a UAP foi criada.POLICY_ID: o ID alfanumérico do UAP.
Por exemplo, se você criar um UAP example-policy no
projeto example-project, o recurso pai desse UAP
será example-project e o nome do UAP será
projects/example-project/locations/global/accessPolicies/example-policy.
Onde criar Políticas de Acesso Unificadas
O pai de uma UAP não afeta os recursos em que você pode aplicar a UAP. No entanto, ela afeta quem tem permissão para visualizar e editar o UAP. Para garantir que os usuários certos tenham permissão para visualizar e editar as UAPs adequadas, recomendamos escolher um recurso pai que reflita melhor o escopo da UAP.
Por exemplo, se você quiser aplicar uma UAP à sua organização, recomendamos criá-la na organização.
Aplicar políticas aos recursos
Para aplicar uma UAP, crie uma vinculação. Cada vinculação especifica um UAP e um recurso ao qual o UAP será vinculado. Depois de criar a vinculação, as regras na UAP entram em vigor para esse recurso, bem como para qualquer um dos descendentes dele.
Por exemplo, imagine que você tem uma UAP,
compute-access-management. Essa
UAP concede o papel de Editor do Compute
(roles/compute.editor) ao grupo compute-users@example.com e nega as
permissões compute.googleapis.com/instances.* a todos os usuários, exceto
compute-users@example.com.
Sem vinculações, essa UAP não tem efeito.
Você quer que essa UAP seja aplicada a todos os recursos na sua
organização example.com. Por isso, crie uma vinculação que anexe a
UAP compute-access-management a example.com. Depois
de criar a vinculação, o UAP tem os seguintes
efeitos:
- Os membros de
compute-users@example.compodem usar as permissões no papel de Editor do Compute para acessar recursos emexample.com. - Todos os usuários que não são membros de
compute-users@example.comsão impedidos de usar permissões relacionadas à instância para acessar recursos emexample.com.
Recursos suportados
A tabela a seguir lista os recursos aos quais é possível vincular UAPs. Cada linha contém o seguinte:
- O tipo do recurso
- O formato dos IDs desse recurso.
- O recurso do Resource Manager (projeto, pasta ou organização) que vincula os pais para esse tipo de recurso.
| Recurso | ID do recurso | Recurso pai das vinculações |
|---|---|---|
| Projetos do Resource Manager | //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
O projeto na vinculação |
| Pastas do Resource Manager | //cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
A pasta na vinculação |
| Organizações do Resource Manager | //cloudresourcemanager.googleapis.com/organizations/ORG_ID |
A organização na vinculação |
| Aplicativos de IA do Agent Registry | //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID |
O projeto pai do aplicativo |
| Gateways de agente da API Network Services | //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID |
O projeto pai do gateway |
Desativar a criação de vinculações
Se você quiser desativar a criação de vinculações na sua organização, aplique a restrição da política da organização iam.managed.disableAccessPolicyBinding na sua organização. Essa
restrição impede que os participantes da organização criem vinculações para
UAPs.
Para saber como ativar ou desativar essa restrição, consulte Como usar restrições gerenciadas em uma política da organização.
Herança de políticas
Se você vincular uma UAP a um projeto, uma pasta ou uma organização, ela será herdada pela hierarquia de recursos.
A hierarquia de recursos consiste na organização (raiz) na parte de cima, seguida por pastas (opcionais) para agrupamento e, em seguida, projetos, que contêm recursos específicos do serviço, como máquinas virtuais do Compute Engine e buckets do Cloud Storage.
Nessa hierarquia, projetos, pastas e organizações são recursos pai. Em outras palavras, são recursos que contêm outros recursos:
- Os projetos contêm recursos específicos do serviço.
- As pastas contêm outras pastas, projetos e os recursos dos projetos.
- As organizações contêm pastas, projetos e os recursos dos projetos.
Os recursos que um recurso pai contém são os descendentes desse recurso.
Quando você vincula uma UAP a um recurso pai, ela é aplicada ao recurso pai e a todos os descendentes dele. Em outras palavras, a UAP é herdada pelos descendentes do recurso.
A herança de políticas permite aplicar políticas a grandes conjuntos de recursos com uma
única vinculação. Por exemplo, imagine que você crie uma UAP
que conceda a taylor@example.com o papel de Administrador do Compute Engine
(roles/compute.admin). A UAP também nega
a noam@example.com a permissão compute.googleapis.com/instances.delete.
Você quer que essa UAP seja eficaz para todos os recursos na
sua organização, example.com. Para isso, vincule essa UAP ao recurso da organização. Depois de vincular a
UAP à organização, ela
é herdada por todos os recursos dessa organização.
Vincular o UAP à organização tem os seguintes efeitos:
taylor@example.compode usar as permissões no papel de Administrador do Compute Engine para acessar qualquer recurso emexample.com.noam@example.comnão pode usar a permissãocompute.googleapis.com/instances.deleteem nenhum recurso emexample.com, mesmo que uma UAP em um recurso descendente conceda acesso.
Se você quiser que uma UAP se aplique a menos recursos, vincule-a a um nível mais baixo da hierarquia de recursos, como um projeto ou um recurso específico de serviço compatível.
Vinculações entre organizações
Não é possível criar uma vinculação entre organizações para um UAP. Uma vinculação entre organizações é uma vinculação que vincula um UAP em uma organização a um recurso em outra organização.
O IAM exclui periodicamente as vinculações entre organizações. As vinculações entre organizações podem ocorrer quando você move um projeto de uma organização para outra. Por exemplo, considere a seguinte situação:
- Você tem um projeto,
example-project, na organizaçãoexample.com. - Crie um UAP no projeto
example-projecte vincule-o aexample-project. - Você moveu
example-projectdeexample.comparacymbalgroup.com.
Nessa situação, mover o projeto cria uma vinculação entre organizações. Isso ocorre porque o UAP em example.com está
vinculado a um recurso em cymbalgroup.com. Se você não excluir a vinculação
manualmente, o IAM vai excluí-la automaticamente. A exclusão
dessa vinculação ajuda a garantir que os administradores do cymbalgroup.com tenham acesso a
todos os UAPs vinculados a recursos na organização.
Vinculações para Políticas de Acesso Unificadas excluídas
Normalmente, é necessário excluir as vinculações de um UAP antes de excluí-lo. As tentativas de excluir uma UAP que tenha vinculações resultam em um erro.
No entanto, se você quiser excluir uma UAP sem excluir as vinculações atuais, poderá forçar a exclusão da UAP.
A exclusão forçada de uma UAP a remove de todos os recursos a que ela está vinculada. Todas as vinculações que fazem referência ao UAP serão excluídas. No entanto, até que sejam excluídas, as vinculações ainda contam para o limite do número de vinculações que podem se referir a um único recurso.
Condições nas Políticas de Acesso Unificadas
As Condições do IAM permitem definir e aplicar o controle de acesso condicional baseado em atributos nos recursos do Google Cloud . Nas UAPs, é possível adicionar condições a regras individuais para controlar quando elas são aplicadas. Não é possível adicionar condições às vinculações de UAP.
As condições são compostas por um título, uma descrição e uma expressão booleana. Se
a expressão for avaliada como true para a solicitação, a regra será aplicada
à solicitação. Se for avaliada como false, a regra não será aplicada à
solicitação.
Serviços diferentes oferecem atributos e funções diferentes que podem ser usados para escrever expressões de condição. Ao adicionar condições a uma regra, sempre insira o nome do serviço com os atributos e as funções que você está usando. É possível adicionar várias condições a uma regra, mas uma única condição não pode misturar atributos de serviços diferentes.
Por exemplo, se você estiver adicionando uma condição que usa um atributo fornecido pelo
IAM, coloque iam.googleapis.com antes da condição:
"conditions": {
"iam.googleapis.com": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
Para saber como criar regras de UAP com condições, consulte Criar e aplicar UAPs.
Permissões aplicáveis para atributos de condição
Alguns atributos específicos do serviço se aplicam apenas a solicitações que envolvem determinadas
permissões. Por exemplo, o atributo eventarc.googleapis.com message.id
só se aplica a solicitações que exigem a
permissão eventarc.googleapis.com/messageBuses.publish.
Só é possível usar esses atributos em regras que incluem a permissão aplicável. Se você tentar usar o atributo em uma regra sem a permissão aplicável, a criação da UAP vai falhar.
Atributos de condição compatíveis
Os seguintes atributos são compatíveis com as regras de UAP:
| Serviço | Atributo | Permissões aplicáveis | Mais informações |
|---|---|---|---|
iam.googleapis.com (Pré-lançamento) |
Tags de recurso | Qualquer | Atributo de tags de recurso |
eventarc.googleapis.com (Pré-lançamento) |
Mensagens | eventarc.googleapis.com/messageBuses.publish |
Atributos de mensagem do Eventarc |
iap.googleapis.com (GA) |
Destinos | iap.googleapis.com/resources.egressViaIAP |
Atributos de destinos do Identity-Aware Proxy |
A seguir
- Saiba como criar e aplicar UAPs.
- Saiba como visualizar as UAPs.