Gerenciar uma política de acesso

Console

Para ver o nome numérico de uma política de acesso no console do Cloud de Confiance , faça o seguinte:

1. No menu de navegação do console do Cloud de Confiance , clique em Segurança e depois em VPC Service Controls.

   Acessar o VPC Service Controls

2. Se solicitado, selecione a organização, a pasta ou o projeto.

3. Na página VPC Service Controls, clique em Gerenciar políticas.

4. Na página Gerenciar políticas do VPC Service Controls, clique no título da política de acesso que você quer inspecionar.

5. Na página Editar política de acesso, encontre o ID numérico da política em Nome da política de acesso.

gcloud

Para ter o nome da sua política de acesso, use o comando list. O nome da política de acesso é necessário para todos os comandos de nível de acesso da ferramenta de linha de comando gcloud.

gcloud access-context-manager policies list \
    --organization ORGANIZATION_ID

Onde:

• ORGANIZATION_ID é o código numérico da organização.

Você verá uma saída como:

NAME           ORGANIZATION  TITLE        ETAG
1034095178592  511928527926  Corp Policy  10bc3c76ca809ab2

API

Para ter o nome da sua política de acesso, ligue para accessPolicies.list.

GET https://accesscontextmanager.googleapis.com/v1/accessPolicies

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta será semelhante a:

{
  "accessPolicies": [
    {
      object(AccessPolicy)
    }
  ],
  "nextPageToken": string
}

Em que:

• accessPolicies é uma lista de objetos AccessPolicy.

Console

Para delegar a administração de uma política de acesso com escopo no console doCloud de Confiance , faça o seguinte:

1. No menu de navegação do console do Cloud de Confiance , clique em Segurança e depois em VPC Service Controls.

   Acessar o VPC Service Controls

2. Se solicitado, selecione a organização, a pasta ou o projeto.

3. Na página VPC Service Controls, clique em Gerenciar políticas.

4. Na página Gerenciar políticas do VPC Service Controls, na linha da política de acesso com escopo que você quer delegar, clique no botão more_vert e em Editar.

5. Na página Editar política de acesso, em Gerenciar principais, clique em Adicionar principais.

6. No painel Adicionar principais, selecione um principal, como um usuário ou uma conta de serviço.

7. Selecione o papel que você quer associar ao principal, como Administrador do Access Context Manager, Editor do Access Context Manager ou Leitor do Access Context Manager, e clique em Salvar.

8. Na página Editar política de acesso, clique em Salvar.

gcloud

Para delegar a administração vinculando um principal e um papel a uma política de acesso com escopo, use o comando add-iam-policy-binding.

gcloud access-context-manager policies add-iam-policy-binding \
[POLICY] --member=PRINCIPAL --role=ROLE

Em que:

• POLICY é o ID da política ou o identificador totalmente qualificado da política.

• PRINCIPAL é o principal para quem a vinculação deve ser adicionada. Especifique no seguinte formato: user|group|serviceAccount:email ou domain:domain.

• ROLE é o nome do papel a ser atribuído ao principal. O nome do papel é o caminho completo de um papel predefinido, como roles/accesscontextmanager.policyEditor, ou o ID do papel, como organizations/{ORGANIZATION_ID}/roles/accesscontextmanager.policyEditor.

API

Para delegar a administração da política de acesso com escopo, faça o seguinte:

1. Crie um corpo da solicitação.

   {
   "policy": "IAM_POLICY",
   }

   Em que:

   • IAM_POLICY é um conjunto de vinculações. Uma vinculação conecta um ou mais membros, ou principais, a um único papel. Os principais podem ser contas de usuário, contas de serviço, Grupos do Google e domínios. Um papel é uma lista nomeada de permissões. Cada papel pode ser um papel predefinido do IAM ou um papel personalizado criado pelo usuário.

2. Delegue a política de acesso chamando accessPolicies.setIamPolicy.

   POST https://accesscontextmanager.googleapis.com/v1/accessPolicies
   

Corpo da resposta

Se funcionar, o corpo da resposta vai ter uma instância de policy.

Console

Para ver os detalhes de uma política de acesso no console do Cloud de Confiance , faça o seguinte:

1. No menu de navegação do console do Cloud de Confiance , clique em Segurança e depois em VPC Service Controls.

   Acessar o VPC Service Controls

2. Se solicitado, selecione a organização, a pasta ou o projeto.

3. Na página VPC Service Controls, clique em Gerenciar políticas.

4. Na página Gerenciar políticas do VPC Service Controls, clique no título da política de acesso que você quer visualizar.

   A página Política de acesso de edição mostra o título da política, o Nome da política de acesso numérico, o escopo e os principais delegados.

gcloud

Para descrever sua política de acesso, use o comando describe.

gcloud access-context-manager policies describe POLICY_NUMBER

Onde:

• POLICY_NUMBER é o nome numérico da política.

A seguinte resposta é exibida:

name: accessPolicies/1034095178592
parent: organizations/511928527926
title: Corp Policy

API

Para descrever sua política de acesso, ligue para accessPolicies.get

GET https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER

Onde:

• POLICY_NUMBER é o nome numérico da política.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta conterá um objeto AccessPolicy.

Console

No console do Cloud de Confiance , não é possível alterar o título ou o escopo de uma política de acesso atual. Para alterar o título de uma política de acesso, use a ferramenta de linha de comando gcloud ou a API.

Para atualizar os principais delegados e as vinculações de papéis de uma política de acesso com escopo no console do Cloud de Confiance , consulte Delegar uma política de acesso.

gcloud

Para atualizar sua política de acesso, use o comando update. Ainda não é possível alterar só o título da política.

gcloud access-context-manager policies update POLICY_NUMBER \
    --title=POLICY_TITLE

Onde:

• POLICY_NUMBER é o nome numérico da política.

• POLICY_TITLE é um título para a política que seja legível por humanos.

A seguinte resposta é exibida:

Waiting for PATCH operation [accessPolicies/POLICY_NUMBER/update/1542234231134882]...done.

API

Ainda não é possível alterar apenas o título da política de acesso.

Para atualizar a política:

1. Crie um corpo da solicitação.

   {
    "parent": "ORGANIZATION_ID",
    "title": "POLICY_TITLE"
   }

   Em que:

   • ORGANIZATION_ID é o código numérico da organização;

   • POLICY_TITLE é um título para a política que seja legível por humanos.

2. Chame accessPolicies.patch.

   PATCH https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER/UPDATE_MASK
   

   Onde:

   • POLICY_NUMBER é o nome numérico da política.

   • UPDATE_MASK é uma string que representa o valor a ser atualizado. Por exemplo, title.

   Corpo da resposta

   Caso a chamada seja bem-sucedida, o corpo da resposta incluirá um recurso de Operation que fornece detalhes sobre a operação PATCH.

Console

Para excluir uma política de acesso no console do Cloud de Confiance , faça o seguinte:

1. No menu de navegação do console do Cloud de Confiance , clique em Segurança e depois em VPC Service Controls.

   Acessar o VPC Service Controls

2. Se solicitado, selecione a organização, a pasta ou o projeto.

3. Na página VPC Service Controls, clique em Gerenciar políticas.

4. Na página Gerenciar políticas do VPC Service Controls, na linha da política de acesso que você quer excluir, clique no botão more_vert e em Excluir.

5. Na caixa de diálogo de confirmação, clique em Excluir.

gcloud

Para excluir uma política de acesso:

1. Use o comando delete.

   gcloud access-context-manager policies delete POLICY_NUMBER

   Onde:

   • POLICY_NUMBER é o nome numérico da política.

2. Confirme que quer excluir a política de acesso.

   Exemplo:

   You are about to delete policy [POLICY_NUMBER]
   
   Do you want to continue (Y/n)?
   

   A seguinte resposta é exibida:

   Deleted policy [1034095178592].
   

API

Para excluir sua política de acesso, ligue para accessPolicies.delete.

DELETE https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER

Onde:

• POLICY_NUMBER é o nome numérico da política.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Caso a chamada seja bem-sucedida, o corpo da resposta incluirá um recurso de Operation que fornece detalhes sobre a operação DELETE.