Negar permissões que permitem que os usuários concedam acesso ajuda a evitar o escalonamento de privilégios não autorizado e a reforçar os controles de segurança. Neste documento, descrevemos como identificar essas permissões e criar uma política de negação que as bloqueie para a maioria dos usuários, permitindo exceções para principais confiáveis.
Antes de começar
Ative a API IAM, se ainda não estiver ativada.
Funções necessárias para ativar APIs
Para ativar APIs, você precisa da permissão
serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.Configure a autenticação.
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud , não é necessário configurar a autenticação.
gcloud
No console do Google Cloud , ative o Cloud Shell.
Na parte inferior do console do Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
REST
Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a CLI do Google Cloud.
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .
Opcional: leia a visão geral das políticas de negação.
Funções exigidas
Para receber a permissão necessária para criar uma política de negação, peça ao administrador para conceder a você o papel do IAM de Administrador de negação (roles/iam.denyAdmin) na sua organização.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém a permissão iam.denypolicies.create, que é necessária para criar uma política de negação.
Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.
Identificar permissões que permitem aos usuários conceder acesso
Antes de criar uma política de negação para impedir que os usuários concedam acesso, determine quais permissões você quer negar.
As permissões a seguir permitem que os usuários concedam acesso:
Permissões que terminam em
setIamPolicy. As permissões mais amplas são as dos recursos do Resource Manager, porque as políticas de permissão desses recursos são herdadas por todos os recursos descendentes. As permissões são as seguintes:cloudresourcemanager.googleapis.com/projects.setIamPolicycloudresourcemanager.googleapis.com/folders.setIamPolicycloudresourcemanager.googleapis.com/organizations.setIamPolicy
Outros recursos também têm permissões
setIamPolicy. Por exemplo, as instâncias do Compute Engine têm a permissãocompute.googleapis.com/instances.setIamPolicy. Para impedir que os usuários modifiquem as políticas de permissão desses recursos, adicione essas permissões à política de negação.Para uma lista completa de permissões negáveis que terminam em
setIamPolicy, acesse Permissões compatíveis com políticas de negação e pesquisesetIamPolicy.A permissão
iam.googleapis.com/roles.update, que permite que os usuários modifiquem funções personalizadas. Os usuários com essa permissão podem adicionar permissões a funções personalizadas, concedendo a si mesmos ou a outras pessoas essas permissões.
Permissões para modificar as Políticas de Acesso Unificadas (UAPs) e vinculá-las a recursos. As permissões são as seguintes:
- A permissão
iam.googleapis.com/accesspolicies.update, que permite aos usuários atualizar as UAPs atuais. - Permissões que terminam em
createPolicyBinding. Essas permissões existem para cada recurso ao qual é possível vincular UAPs. Para projetos, pastas e organizações, essas permissões são as seguintes:cloudresourcemanager.googleapis.com/projects.createPolicyBindingcloudresourcemanager.googleapis.com/folders.createPolicyBindingcloudresourcemanager.googleapis.com/organizations.createPolicyBinding
Como alternativa, é possível impedir que todos os usuários vinculem UAPs a recursos aplicando a restrição de política da organização
iam.managed.disableAccessPolicyBindingna sua organização. No entanto, essa política da organização não impede que os usuários modifiquem UAPs que já estão vinculadas a recursos.- A permissão
Negar permissões de mudança de acesso
Depois de determinar quais permissões você quer negar, crie uma política de negação para sua organização que negue essas permissões.
Console
No console do Google Cloud , acesse a guia Negar na página IAM.
Selecione a organização.
Clique em Criar política de negação.
Na seção Nome da política, defina o ID da política seguindo um destes procedimentos:
- No campo Nome de exibição, insira um nome de exibição para a chave. O preenchimento desse campo preenche automaticamente o campo ID. Se você quiser mudar o ID da política, atualize o texto no campo ID.
- No campo ID, insira um ID para a política.
Na seção Regras de negação, adicione uma regra de negação que bloqueie as permissões de alteração de acesso:
No campo Principais negados, adicione os principais que terão o acesso negado. Para negar permissões de alteração de acesso a todos os usuários, use o valor
principalSet://goog/public:all. Para uma lista completa de valores que podem ser usados, consulte Identificadores principais para políticas de negação.No campo Principais de exceção, adicione os principais confiáveis que você quer que concedam acesso. Para uma lista completa de valores que podem ser usados, consulte Identificadores principais para políticas de negação.
Na seção Permissões negadas, adicione as permissões que você identificou em Identificar permissões que permitem que os usuários concedam acesso.
Opcional: adicione uma condição de negação que especifique quais recursos são afetados por essa regra. Por exemplo, é possível adicionar uma condição para garantir que a política se aplique apenas a recursos com o valor de tag
prod. Para mais informações sobre condições de negação, consulte Condições em políticas de negação.
Clique em Criar.
gcloud
O comando gcloud iam policies create cria uma política de negação para um recurso.
Antes de usar os dados do comando abaixo, faça estas substituições:
POLICY_ID: um identificador para a política de negação.-
ORG_ID: o ID numérico da organização em que você quer criar a política de negação. -
POLICY_FILE: um arquivo que contém a política de negação que você quer definir. Use o seguinte formato para a política de negação:{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": { "deniedPrincipals": [ DENIED_PRINCIPALS ], "exceptionPrincipals": [ EXCEPTION_PRINCIPALS ], "deniedPermissions": [ ACCESS_CHANGE_PERMISSIONS ], DENIAL_CONDITION } } ] }
Substitua os seguintes valores:
POLICY_NAME: o nome de exibição da política de negação.-
DENIED_PRINCIPALS: os principais que terão o acesso negado. Para negar permissões de alteração de acesso a todos os usuários, use o valor"principalSet://goog/public:all". Para uma lista completa de valores que podem ser usados, consulte Identificadores principais para políticas de negação. -
EXCEPTION_PRINCIPALS: os principais confiáveis que você quer que concedam acesso. Para uma lista completa de valores que podem ser usados, consulte Identificadores de principal para políticas de negação. -
ACCESS_CHANGE_PERMISSIONS: as permissões que você identificou em Identificar permissões que permitem que os usuários concedam acesso. -
DENIAL_CONDITION: opcional. Uma condição de negação que especifica quais recursos são afetados por essa regra. Por exemplo, é possível adicionar uma condição para garantir que a regra seja aplicada apenas a recursos com o valor de tagprod. Para mais informações sobre condições de negação, consulte Condições em políticas de negação.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam policies create POLICY_ID \ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \ --kind=denypolicies \ --policy-file=POLICY_FILE
Windows (PowerShell)
gcloud iam policies create POLICY_ID ` --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ` --kind=denypolicies ` --policy-file=POLICY_FILE
Windows (cmd.exe)
gcloud iam policies create POLICY_ID ^ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^ --kind=denypolicies ^ --policy-file=POLICY_FILE
Se for bem-sucedido, esse comando não vai retornar uma saída. Para imprimir uma resposta detalhada,
use a flag --format=json.
REST
O
método policies.createPolicy
cria uma política de negação para um recurso.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
ORG_ID: o ID numérico da organização em que você quer criar a política de negação. POLICY_ID: um identificador para a política de negação.POLICY_NAME: o nome de exibição da política de negação.-
DENIED_PRINCIPALS: os principais que terão o acesso negado. Para negar permissões de alteração de acesso a todos os usuários, use o valor"principalSet://goog/public:all". Para uma lista completa de valores que podem ser usados, consulte Identificadores de principal para políticas de negação. -
EXCEPTION_PRINCIPALS: os principais confiáveis que você quer que concedam acesso. Para uma lista completa de valores que podem ser usados, consulte Identificadores de principal para políticas de negação. -
ACCESS_CHANGE_PERMISSIONS: as permissões que você identificou em Identificar permissões que permitem que os usuários concedam acesso. -
DENIAL_CONDITION: opcional. Uma condição de negação que especifica quais recursos são afetados por essa regra. Por exemplo, é possível adicionar uma condição para garantir que a regra se aplique apenas a recursos com o valor de tagprod. Para mais informações sobre condições de negação, consulte Condições em políticas de negação.
Método HTTP e URL:
POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID
Corpo JSON da solicitação:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
DENIED_PRINCIPALS
],
"exceptionPrincipals": [
EXCEPTION_PRINCIPALS
],
"deniedPermissions": [
ACCESS_CHANGE_PERMISSIONS
],
DENIAL_CONDITION
}
}
]
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2026-10-31T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "Deny access change permissions.",
"etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
"createTime": "2026-10-31T19:06:12.455151Z",
"updateTime": "2026-10-31T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principalSet://goog/public:all"
],
"exceptionPrincipals": [
"principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
"principalSet://goog/group/iam-admins@example.com"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy",
"iam.googleapis.com/accesspolicies.update",
"cloudresourcemanager.googleapis.com/projects.createPolicyBinding",
"cloudresourcemanager.googleapis.com/folders.createPolicyBinding",
"cloudresourcemanager.googleapis.com/organizations.createPolicyBinding"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
A resposta identifica uma operação de longa duração. É possível monitorar o status da operação de longa duração para saber quando ela foi concluída. Para detalhes, consulte Verificar o status de uma operação de longa duração.
A seguir
- Descubra como solucionar problemas de acesso com políticas de negação.
- Saiba mais sobre como negar acesso a principais.