As políticas de limite de acesso de principal (PAB) permitem definir os recursos que os principais podem acessar.
Outras políticas relacionadas ao acesso, como políticas de permissão e negação, são anexadas aos recursos. Essas políticas definem quem tem permissão para acessar o recurso a que estão anexadas. Por outro lado, as políticas de limite de acesso de principal são anexadas a conjuntos de principais e controlam o que os principais no conjunto de principais podem fazer.
Por exemplo, é possível usar políticas de limite de acesso de principal para impedir que os principais acessem recursos em outras organizações, o que pode ajudar a evitar ataques de phishing ou exfiltração de dados.
Como funcionam as políticas de limite de acesso de principal
Por padrão, os principais podem acessar qualquer recurso do Google Cloud . Isso significa que, se uma política de permissão conceder acesso a um recurso a um principal e nenhuma política de negação bloquear esse acesso, o principal poderá acessar o recurso.
Com as políticas de limite de acesso de principal, é possível definir os recursos que um principal pode acessar. Se um principal não estiver qualificado para acessar um recurso, o acesso a ele será limitado, independentemente dos papéis concedidos. Para mais informações sobre como usar políticas de limite de acesso de principal para definir os recursos que um principal pode acessar, consulte Definir recursos qualificados.
As políticas de limite de acesso de principal só bloqueiam tentativas de acesso que envolvem permissões compatíveis. Se uma política de limite de acesso de principal não puder bloquear uma permissão, os principais estarão qualificados para usar essa permissão para acessar qualquer recurso, independentemente das políticas a que estão sujeitos. Para mais informações, consulte Permissões que as políticas de limite de acesso de principal podem bloquear.
Casos de uso
As políticas de limite de acesso de principal são úteis em circunstâncias como as seguintes:
- Impedir que os principais acessem recursos que não são seus
- Manter determinados tipos de principal, como contas de serviço, limitados a determinados projetos
Para exemplos detalhados de como usar as políticas de limite de acesso de principal em situações como essas, consulte Exemplos de casos de uso de políticas de limite de acesso de principal.
Componentes da política de limite de acesso principal
As políticas de limite de acesso de principal consistem em regras individuais. Cada regra define um conjunto de recursos que os principais podem acessar. Cada política pode ter até 500 regras.
As políticas também contêm outras informações, incluindo metadados e detalhes de configuração. Para mais informações, consulte Estrutura de uma política de limite de acesso de principal.
Depois de criar uma política de limite de acesso de principal, aplique-a a conjuntos de principais criando vinculações de política. Todos os principais nesses conjuntos de principais ficam sujeitos à política de limite de acesso de principal, o que significa que eles podem acessar os recursos listados na política. É possível vincular uma política de limite de acesso de principal a qualquer número de conjuntos de principais.
É possível criar até 1.000 políticas de limite de acesso de principal na sua organização.
Permissões que as políticas de limite de acesso de principal bloqueiam
As políticas de limite de acesso de principal podem bloquear todas as permissões incluídas na versão de aplicação da política. Se uma política de limite de acesso de principal puder bloquear uma permissão, ela poderá impedir que principais não qualificados usem essa permissão para acessar recursos.
Você especifica a versão de aplicação de uma política ao criá-la. A atualização da versão de aplicação atualiza as permissões que a política pode bloquear. Para uma lista completa das permissões que cada versão de aplicação bloqueia, consulte a referência da versão de aplicação.
Se uma política de limite de acesso de principal não puder bloquear uma permissão, ela não terá efeito sobre a possibilidade de os principais usarem a permissão. Em outras palavras, o IAM não pode aplicar a política para tentativas de acesso que envolvam essa permissão.
Por exemplo, imagine que um principal, Lee (lee@example.com), receba o papel de desenvolvedor do Dataflow (roles/dataflow.developer). Esse papel inclui a permissão dataflow.googleapis.com/jobs.snapshot, que permite que Lee faça snapshots de jobs do Dataflow. Lee também está sujeito a uma política de limite de acesso de principal
que o impede de acessar recursos fora de example.com.
No entanto, se essa política de limite de acesso principal não puder bloquear a
permissão dataflow.jobs.snapshot, Lee ainda poderá criar snapshots de
jobs do Dataflow em organizações fora de example.com.
Gerenciar versões de aplicação obrigatória
Periodicamente, o IAM adiciona novas versões de aplicação que podem bloquear outras permissões. Cada nova versão também pode bloquear todas as permissões da versão anterior.
Para bloquear as permissões em uma nova versão de aplicação obrigatória, atualize suas políticas de limite de acesso de principal para usar a nova versão.
Se você quiser que a versão de aplicação de uma política seja atualizada automaticamente à medida que novas
versões forem lançadas, use o valor latest ao criar a política.
No entanto, não recomendamos o uso desse valor, porque ele pode fazer com que os principais
percam o acesso aos recursos inesperadamente.
As políticas que usam latest para o número da versão usam a versão de aplicação
padrão. A versão de aplicação padrão geralmente é a mais recente.
No entanto, pode levar até quatro semanas para que uma nova versão se torne a versão de aplicação padrão. Para saber qual versão de aplicação é
a padrão, consulte a referência da versão de aplicação.
A versão de aplicação padrão também é usada para novas políticas de limite de acesso de principal que não especificam um número de versão.
Definir recursos qualificados
Os principais podem ser afetados ou sujeitos a qualquer número de políticas de limite de acesso de principal. Juntas, essas políticas definem os recursos que o principal pode acessar.
As políticas de limite de acesso de principal são aditivas. Isso significa que os recursos que um principal pode acessar são a união de todos os recursos em todas as políticas de limite de acesso de principal a que o principal está sujeito. Em outras palavras, se uma única política de limite de acesso de principal qualificar um principal para acessar um recurso, ele poderá acessar o recurso, independentemente das outras políticas de limite de acesso de principal a que está sujeito.
Se um principal não estiver sujeito a nenhuma política de limite de acesso de principal, ele estará qualificado para acessar qualquer recurso do Google Cloud .
As seções a seguir descrevem como personalizar o conjunto de recursos que um principal pode acessar.
Adicionar recursos qualificados
Há várias maneiras de qualificar um principal para acessar um recurso que ele não pode acessar:
- Adicione o recurso a uma política de limite de acesso de principal a que o principal está sujeito.
- Crie uma nova política de limite de acesso de principal com o recurso adicional e vincule a política a um conjunto de principais que inclua o principal.
- Remova ou exclua todas as políticas de limite de acesso de principal a que o principal está sujeito. Essa ação qualifica o principal para acessar todos os recursos do Google Cloud .
Remover recursos qualificados
Há várias maneiras de tornar um principal inelegível para acessar um recurso que ele está qualificado para acessar.
Primeiro, encontre todas as políticas de limite de acesso de principal a que o principal está sujeito e que incluem o recurso. Com base nas políticas encontradas, você pode fazer o seguinte:
Se o principal não estiver sujeito a nenhuma política de limite de acesso de principal, crie uma nova política de limite de acesso de principal que inclua apenas os recursos que você quer que o principal possa acessar. Em seguida, vincule essa política a um conjunto de principais que contenha o principal.
Depois de aplicar a política, o principal passa de qualificado para acessar todos os recursos para qualificado para acessar apenas os recursos listados na política.
Se o principal já estiver sujeito a uma ou mais políticas de limite de acesso de principal, verifique se nenhuma das políticas de limite de acesso de principal a que ele está sujeito inclui o recurso. Para instruções detalhadas, consulte Reduzir os recursos que os principais podem acessar.
Durante esse processo, é preciso garantir que o principal esteja sempre sujeito a pelo menos uma política de limite de acesso de principal. Caso contrário, o principal poderá se qualificar para acessar todos os recursos.
Políticas de limite de acesso de principal e recursos em cache
Alguns serviços do Google Cloud armazenam em cache recursos visíveis publicamente. Por exemplo, o Cloud Storage armazena em cache objetos que são publicamente legíveis.
Se uma política de limite de acesso de principal pode impedir que principais não qualificados visualizem um recurso visível publicamente depende se o recurso está armazenado em cache:
- Se o recurso estiver em cache, as políticas de limite de acesso de principal não poderão impedir que os principais visualizem o recurso.
- Se o recurso não estiver em cache, o limite de acesso de principal vai impedir que principais não qualificados visualizem o recurso
Em todos os casos, as políticas de limite de acesso de principal ainda impedem que principais não qualificados modifiquem ou excluam recursos visíveis publicamente.
Recursos do Google
Para permitir que os desenvolvedores usem os serviços do Google Cloud , como o
BigQuery e o Cloud Workstations, o Google Cloud fornece
recursos públicos do Google. Por exemplo, o BigQuery fornece
conjuntos de dados públicos que podem ser integrados aos seus
aplicativos. Esses recursos públicos são hospedados em uma organização do Google
Google Cloud com o ID 433637338589. Essa organização também é
usada para gerenciar projetos de locatário para serviços como
o Cloud Workstations.
Os principais sujeitos às políticas de limite de acesso de principal vão perder o acesso a esses recursos públicos, a menos que você os qualifique para acessar recursos na organização do Google.
Para que os principais possam acessar recursos na organização do Google, adicione a seguinte regra a uma política de limite de acesso de principal que se aplica aos principais:
{
"description": "Make principals eligible to access Google-owned public resources",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/433637338589"
],
"effect": "ALLOW"
}
Como alternativa, é possível criar uma nova política de limite de acesso de principal com essa regra e vinculá-la ao conjunto de principais relevante.
Avaliação da política de limite de acesso de principal
Quando um principal tenta acessar um recurso, o IAM avalia as políticas de limite de acesso de principal relevantes para determinar se a tentativa de acesso deve ser bloqueada. Uma política é relevante se o principal que faz a tentativa de acesso estiver sujeito a ela.
As políticas de limite de acesso de principal só podem bloquear ou não bloquear o acesso. Elas não podem conceder acesso. Somente as políticas de permissão podem conceder acesso aos recursos para os principais. Para saber como diferentes tipos de política afetam o acesso dos principais aos recursos, consulte Tipos de política.
O IAM não bloqueia o acesso se alguma das seguintes condições for verdadeira:
- O principal não está sujeito a nenhuma política de limite de acesso de principal
- As políticas de limite de acesso de principal relevantes não podem bloquear a permissão na solicitação.
- Uma política de limite de acesso de principal qualifica o principal para acessar o recurso
O IAM bloqueia o acesso se o principal estiver sujeito a pelo menos uma política de limite de acesso de principal, mas nenhuma das políticas relevantes tornar o principal qualificado para acessar o recurso.
Avaliação fail-closed (fechado em caso de falhas)
As políticas de limite de acesso de principal são fechadas em caso de falhas. Isso significa que, se o IAM encontrar um erro ao avaliar uma política de limite de acesso de principal, ele vai impedir que o principal acesse o recurso.
O motivo mais comum para o IAM encontrar um erro ao avaliar as políticas de limite de acesso de principal é que os detalhes de um principal ainda estão sendo propagados pelo sistema. É mais provável que isso ocorra com usuários recém-criados. Para resolver esse problema, peça para o novo principal aguardar e tentar acessar o recurso novamente mais tarde.
Aplicar políticas de limite de acesso de principal a conjuntos de principais
Para aplicar uma política de limite de acesso de principal a um conjunto de principais, crie uma vinculação de política que especifique a política de limite de acesso de principal que você quer aplicar e o conjunto de principais a que ela será aplicada. Essa vinculação de política associa a política ao conjunto de principais.
Depois de vincular uma política a um conjunto de principais, os principais desse conjunto só poderão acessar os recursos listados nas políticas de limite de acesso de principal a que estão sujeitos.
É possível vincular uma política de limite de acesso de principal a qualquer número de conjuntos de principais. Cada conjunto de principais pode ter até 10 políticas de limite de acesso de principal vinculadas a ele.
Só é possível criar vinculações para políticas de limite de acesso de principal que já existem. A tentativa de criar uma vinculação para uma política de limite de acesso de principal excluída vai falhar. Se você excluiu recentemente uma política de limite de acesso de principal, às vezes é possível criar uma vinculação, mas ela não terá efeito. O IAM limpa essas vinculações automaticamente.
Para saber como gerenciar políticas de limite de acesso de principal, consulte Criar e aplicar políticas de limite de acesso de principal.
Conjuntos de principais compatíveis
A tabela a seguir lista os tipos de conjuntos de principais aos quais é possível vincular políticas de limite de acesso de principal. Cada linha contém o seguinte:
- O tipo de conjunto principal
- Os principais nesse tipo de conjunto de principais
- O formato dos IDs para esse tipo de conjunto de principais
- O recurso do Resource Manager (projeto, pasta ou organização) que é pai das vinculações de política para esse tipo de conjunto de principal.
| Conjunto principal | Detalhes | Recurso pai das vinculações de política |
|---|---|---|
| Pool de identidade da força de trabalho |
Contém todas as identidades no pool de identidades de colaboradores especificado.
Formato: |
A organização que contém o pool de identidade de colaboradores |
| Pool de identidade da carga de trabalho |
Contém todas as identidades no pool de Identidade da carga de trabalho especificado.
Formato: |
O projeto que contém o pool de Identidade da carga de trabalho |
| Domínio do Google Workspace |
Contém todas as identidades no domínio do Google Workspace especificado.
Formato: Para encontrar seu ID de cliente, use os seguintes métodos:
|
A organização associada ao domínio do Google Workspace |
| Conjunto principal do projeto |
Contém todas as contas de serviço, pools de Identidade da carga de trabalho e identidades de agente no projeto especificado.
Formato: |
O projeto |
| Conjunto principal da pasta |
Contém todas as contas de serviço, todos os pools de Identidade da carga de trabalho e todas as identidades de agente em qualquer projeto na pasta especificada.
Formato: |
A pasta |
| Conjunto principal da organização |
Contém as seguintes identidades:
Formato: |
A organização |
| Identidades de agente |
Todas as identidades de agente no domínio de confiança do projeto especificado. Por padrão, o domínio de confiança de um projeto contém todas as identidades de agente no projeto. Formatos:
|
O projeto |
Herança de políticas e conjuntos de principais
As políticas de limite de acesso de principal são anexadas a conjuntos de principais, não a recursos. Como resultado, elas não são herdadas pela hierarquia de recursos da mesma forma que as políticas de permissão e negação.
No entanto, os conjuntos de principais para pastas e organizações sempre incluem todos os principais nos conjuntos de principais dos descendentes. Por exemplo, se um principal estiver incluído no conjunto de principais de um projeto, ele também estará incluído nos conjuntos de principais de todas as pastas ou organizações pai.
Por exemplo, considere uma organização, example.com. Essa organização está
associada ao domínio example.com e tem os seguintes recursos:
- Uma organização,
example.com - Um projeto,
project-1, que é filho da organização - Uma pasta,
folder-a, que é filha da organização - Dois projetos,
project-2eproject-3, que são filhos defolder-a
Os conjuntos de principais desses recursos contêm as seguintes identidades:
| Conjunto principal | Identidades do Google Workspace no domínio example.com |
Pools de federação de identidade de colaboradores em example.com |
Contas de serviço, pools de identidade da carga de trabalho e identidades de agente em project-1 |
Contas de serviço, pools de identidade da carga de trabalho e identidades de agente em project-2 |
Contas de serviço, pools de identidade da carga de trabalho e identidades de agente em project-3 |
|---|---|---|---|---|---|
Conjunto principal para example.com |
|||||
Conjunto principal para folder-a |
|||||
Conjunto principal para project-1 |
|||||
Conjunto principal para project-2 |
|||||
Conjunto principal para project-3 |
Como resultado, os seguintes principais são afetados pelas seguintes políticas de limite de acesso de principal:
Uma identidade do Google Workspace no domínio
example.comestá no conjunto de principais deexample.come será afetada pelas políticas de limite de acesso de principal vinculadas a esse conjunto.Uma conta de serviço em
project-1está nos conjuntos de principais paraproject-1eexample.come será afetada pelas políticas de limite de acesso de principal vinculadas a qualquer um desses conjuntos.Uma identidade de agente em
project-3está nos conjuntos de principais paraproject-3,folder-aeexample.come será afetada pelas políticas de limite de acesso de principal vinculadas a qualquer um desses conjuntos.
Vinculações de políticas condicionais para políticas de limite de acesso de principal
É possível usar expressões de condição em vinculações de políticas para políticas de limite de acesso principal para refinar ainda mais os principais aos quais a política se aplica.
As expressões de condição para vinculações de política consistem em uma ou mais instruções
unidas por até 10 operadores
lógicos (&&, || ou !). Cada instrução expressa uma regra de controle baseada em atributos
que se aplica à vinculação de política e, por fim, determina
se a política se aplica.
É possível usar os atributos principal.type e principal.subject em
condições para vinculações de políticas. Nenhum outro atributo é aceito.
O atributo
principal.typese refere ao tipo de principal que fez a solicitação, por exemplo, uma conta de serviço ou uma identidade de agente. É possível usar condições com esse atributo para controlar a quais tipos de principais uma política de limite de acesso de principal se aplica.Por exemplo, se você adicionar a seguinte expressão de condição a uma vinculação de uma política de limite de acesso de principal, a política será aplicada apenas a contas de serviço:
principal.type == 'iam.googleapis.com/ServiceAccount'O atributo
principal.subjectse refere à identidade do principal que fez a solicitação, por exemplo,cruz@example.com. É possível usar condições com esse atributo para controlar exatamente quais principais estão sujeitos a uma política de limite de acesso de principal.Por exemplo, se você adicionar a seguinte expressão de condição a uma vinculação de uma política de limite de acesso de principal, a política não será aplicada ao usuário
special-admin@example.com:principal.subject != 'special-admin@example.com'
Para saber mais sobre os valores que podem ser usados para essas condições, consulte a referência do atributo de condições.
Para ver um exemplo de como usar essas condições nas políticas de limite de acesso principal, consulte Qualificar contas de serviço para acessar recursos em um único projeto.
Vinculações de políticas entre organizações
Não é possível criar uma vinculação de política entre organizações para uma política de limite de acesso de principal. Uma vinculação de política entre organizações é uma vinculação de política que associa uma política em uma organização a um conjunto de principais em outra organização.
O IAM exclui periodicamente as vinculações de políticas entre organizações. As vinculações de políticas 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. - Você quer que os principais em
example-projectpossam acessar recursos emexample.com. Para fazer isso, crie uma política de limite de acesso de principal emexample.comque qualifique os principais para acessar recursos emexample.come vincule essa política ao conjunto de principais paraexample-project. - Você moveu
example-projectdeexample.comparacymbalgroup.com.
Nessa situação, mover o projeto cria uma vinculação de política entre organizações. Isso ocorre porque a política de limite de acesso de principal em example.com está
vinculada a um conjunto de principais 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 de cymbalgroup.com tenham acesso a
todas as políticas de limite de acesso de principal vinculadas aos principais deles.
Estrutura de uma política de limite de acesso de principal
Uma política de limite de acesso de principal é um conjunto de metadados e detalhes da política de limite de acesso de principal. Os metadados fornecem informações como o nome da política e quando ela foi criada. Os detalhes da política definem o que ela faz, por exemplo, os recursos que os principais afetados podem acessar.
Por exemplo, a política de limite de acesso de principal a seguir torna os principais sujeitos à política qualificados para acessar os recursos na organização com o ID 0123456789012.
{
"name": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"annotations": {
"example-key": "example-value"
},
"createTime": "2024-01-02T15:01:23Z",
"updateTime": "2024-01-02T15:01:23Z",
"details": {
"rules": [
{
"description": "Example principal access boundary policy rule",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/0123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
As seções a seguir descrevem os campos nos metadados e detalhes de uma política de limite de acesso de principal.
Metadados
As políticas de limite de acesso de principal contêm os seguintes metadados:
name: o nome da política de limite de acesso de principal. Esse nome tem o formatoorganizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, em queORGANIZATION_IDé o ID numérico da organização em que a política de limite de acesso de principal foi criada ePAB_POLICY_IDé o ID alfanumérico da política de limite de acesso de principal.uid: um ID exclusivo atribuído à política de limite de acesso de principal.etag: um identificador para o estado atual da política. Esse valor muda quando você atualiza a política. Para evitar atualizações conflitantes, o valoretagprecisa corresponder ao valor armazenado no IAM. Se os valores deetagnão corresponderem, a solicitação vai falhar.displayName: um nome legível por humanos para a política de limite de acesso de principal.annotations: opcional. Uma lista de pares de chave-valor definidos pelo usuário. É possível usar essas anotações para adicionar mais metadados à política, por exemplo, quem criou a política ou se ela foi implantada por um pipeline automatizado. Para mais informações sobre anotações, consulte Anotações.createTime: o horário em que a política de limite de acesso de principal foi criada.updateTime: o horário em que a política de limite de acesso de principal foi atualizada pela última vez.
Detalhes
Cada política de limite de acesso de principal contém um campo details. Esse campo contém
as regras de limite de acesso de principal e a versão de aplicação:
rules: uma lista de regras de limite de acesso de principal, que definem os recursos que os principais afetados podem acessar. Cada regra contém os seguintes campos:description: uma descrição legível por humanos da regra.resources: uma lista de recursos do Resource Manager (projetos, pastas e organizações) que você quer que os principais usuários tenham acesso. Qualquer principal que esteja sujeito a essa política pode acessar esses recursos.Cada política de limite de acesso de principal pode se referir a no máximo 500 recursos em todas as regras da política.
effect: a relação que os principais têm com os recursos listados no camporesources. O único efeito que pode ser especificado nas regras de limite de acesso de principal é"ALLOW". Essa relação qualifica os principais para acessar os recursos listados na regra.
enforcementVersion: a versão de aplicação que o IAM usa ao aplicar a política. A versão da política de limite de acesso de principal determina quais permissões a política de limite de acesso de principal pode bloquear.Para mais informações sobre como definir e gerenciar versões de aplicação, consulte Gerenciar versões de aplicação nesta página.
Estrutura de uma vinculação de política
Uma vinculação de política de limite de acesso de principal contém o nome de uma política, o nome do conjunto de principais ao qual a política será vinculada e metadados que descrevem a vinculação. Ela também pode conter condições que modificam os principais exatos a que a política se aplica.
Por exemplo, a vinculação de política a seguir vincula a política example-policy a
todos os principais na organização example.com, que tem o ID
0123456789012. A vinculação de política também contém uma condição que impede que a
política seja aplicada ao principal super-admin@example.com.
{
"name": "organizations/0123456789012/locations/global/policyBindings/example-policy-binding",
"uid": "buid_01234567890123456789",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example policy binding",
"annotations": {
"example-key": "example-value"
},
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/0123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"policyUid": "puid_0123456789012345678",
"condition": {
"title": "Exempt principal",
"description": "Don't enforce the policy for super-admin@example.com",
"expression": "principal.subject != 'super-admin@example.com'"
},
"createTime": "2024-01-02T17:00:16Z",
"updateTime": "2024-01-02T17:00:16Z"
}
Cada vinculação de política contém os seguintes campos:
name: o nome da vinculação de política. Esse nome tem o formatoRESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, em queRESOURCE_TYPE/RESOURCE_IDé o tipo e o ID do recurso pai da vinculação de política eBINDING_IDé o ID alfanumérico da vinculação de política.uid: um ID exclusivo atribuído à vinculação de política.etag: um identificador para o estado atual da política. Esse valor muda quando você atualiza a política. Para evitar atualizações conflitantes, o valoretagprecisa corresponder ao valor armazenado no IAM. Se os valores deetagnão corresponderem, a solicitação vai falhar.displayName: um nome legível por humanos para a vinculação de política.annotations: opcional. Uma lista de pares de chave-valor definidos pelo usuário. É possível usar essas anotações para adicionar mais metadados à vinculação de política, por exemplo, quem criou a vinculação de política ou se ela foi implantada por um pipeline automatizado. Para mais informações sobre anotações, consulte Anotações.target: o principal definido para vincular a política. O valor tem o formato{"principalSet": PRINCIPAL_SET}, em quePRINCIPAL_SETé o ID do conjunto de principais ao qual você quer vincular a política.Cada destino pode ter até 10 políticas vinculadas a ele.
policyKind: o tipo de política que a vinculação de política referencia. Para vinculações de políticas de limite de acesso de principal, esse valor é semprePRINCIPAL_ACCESS_BOUNDARY.policy: a política de limite de acesso de principal a ser vinculada ao conjunto de principais de destino.policyUid: um ID exclusivo atribuído à política de limite de acesso de principal referenciada no campopolicy.condition: opcional. Uma expressão lógica que afeta os principais para os quais o IAM aplica a política. Se a condição for avaliada como verdadeira ou não puder ser avaliada, o Identity and Access Management aplicará a política ao principal que está fazendo a solicitação. Se a condição for avaliada como falsa, o Identity and Access Management não aplicará a política ao principal. Para mais informações, consulte Limite de acesso de principal e condições nesta página.createTime: o horário em que a vinculação de política foi criada.updateTime: o horário em que a vinculação de política foi atualizada pela última vez.
A seguir
- Saiba mais sobre os casos de uso das políticas de limite de acesso de principal.
- Saiba como criar e aplicar políticas de limite de acesso de principal.
- Revise a permissão que cada versão de aplicação da política de limite de acesso de principal bloqueia.