Configurar um recurso de organização do Google Cloud

Um recurso de organização é o nó raiz da hierarquia de recursos doGoogle Cloud e permite gerenciar de forma centralizada seus projetos e pastas. É possível configurar um recurso da organização para manter a visibilidade, controlar o acesso e aplicar políticas da organização em todo o ambiente de nuvem.

OGoogle Cloud cria automaticamente um recurso de organização para novos clientes, incluindo clientes de teste sem custo financeiro, e aplica um conjunto padrão de políticas da organização a ele. Para mais informações, consulte Organizações independentes e Como gerenciar restrições de referência.

Antes de começar

Leia uma visão geral do recurso da organização.

Acessar um recurso da organização

Um recurso de organização está disponível para clientes do Google Workspace e do Cloud Identity :

Depois de criar sua conta do Google Workspace ou Cloud Identity e associá-la a um domínio, o recurso da sua organização será criado automaticamente. O recurso será provisionado em momentos diferentes, dependendo do status da sua conta:

  • Se você é novo no Google Cloud e ainda não criou um projeto, o recurso da organização será criado quando você fizer login no console do Google Cloud e aceitar os Termos e Condições.
  • Se você já for um usuário do Google Cloud , o recurso da organização será criado quando você criar um novo projeto ou uma conta de faturamento (se ainda não houver uma). Todos os projetos criados anteriormente serão listados em "Nenhuma organização", e isso é normal. O recurso da organização será exibido e o novo projeto que você criou será vinculado automaticamente a ele.

    Você precisará mover todos os projetos criados em "Nenhuma organização" ao novo recurso da organização. Para instruções sobre como mover seus projetos, consulte Como migrar projetos para um recurso da organização.

O recurso da organização criado será vinculado à sua conta do Google Workspace ou do Cloud Identity com o projeto ou a conta de faturamento que você definiu como recurso filho. Todos os projetos e contas de faturamento criados no seu domínio do Google Workspace ou do Cloud Identity serão filhos desse recurso da organização.

  • Para informações sobre como migrar projetos atuais, leia este artigo.

Cada conta do Google Workspace ou do Cloud Identity está associada a exatamente um recurso de organização. Um recurso de organização é associado a exatamente um domínio, que é definido quando o recurso é criado.

Observação: se você tentar registrar uma organização com um domínio que já existe, vai receber o erro "Este domínio já está em uso". Para resolver isso, siga as etapas em Resolver "Este domínio já está em uso".

Para adotar ativamente o recurso da organização, os superadministradores do Google Workspace ou do Cloud Identity precisam atribuir o papel do Identity and Access Management (IAM) de Administrador da organização (roles/resourcemanager.organizationAdmin) a um usuário ou grupo. Para saber como configurar o recurso da organização, consulte Configurar o recurso da organização.

  • Quando o recurso da organização é criado, todos os usuários no domínio recebem automaticamente os papéis do IAM de Criador de projetos (roles/resourcemanager.projectCreator) e Criador da conta de faturamento (roles/billing.creator) no nível do recurso da organização. Isso permite que os usuários no domínio continuem criando projetos sem interrupção.
  • O administrador da organização decide quando quer começar a usar ativamente o recurso de organização. A partir de então, eles podem alterar as permissões padrão e aplicar políticas mais restritivas, se necessário.
  • Se o recurso da organização estiver disponível e você não tiver as permissões do IAM para visualizá-lo, ainda será possível criar projetos e contas de faturamento. Eles são criados automaticamente no recurso da organização, mesmo que você não consiga vê-lo.

Google Cloud valor de referência de segurança

A referência de segurança doGoogle Cloud aborda posturas de segurança inseguras com um pacote de políticas da organização que são aplicadas quando um recurso da organização é criado. Essas restrições são criadas e aplicadas automaticamente à sua organização quando ela é criada. Para informações sobre como visualizar e gerenciar essas restrições, consulte Restrições de referência de segurança doGoogle Cloud .

Encontrar o ID do recurso da organização

O ID do recurso de organização é um identificador exclusivo de um recurso de organização e é criado automaticamente quando o recurso de organização é criado. Os IDs de recursos de organizações são formatados como números decimais e não podem ter zeros à esquerda.

É possível conseguir o ID do recurso da organização usando o console do Google Cloud , a CLI gcloud ou a API Cloud Resource Manager.

Console

Para conseguir o ID do recurso da organização usando o console do Google Cloud , faça o seguinte:

  1. Acesse o console do Google Cloud :

    Acesse o console do Google Cloud .

  2. No seletor de projetos na parte de cima da página, selecione o recurso da organização.
  3. No lado direito, clique em Mais e em Configurações.

A página Configurações exibe o ID do recurso da organização.

gcloud

Para encontrar o ID do recurso da organização, execute o seguinte comando:

gcloud organizations list

Esse comando lista todos os recursos da organização a que você pertence e os IDs correspondentes.

API

Para encontrar o ID do recurso da organização usando a API Cloud Resource Manager, use o método organizations.search(), incluindo uma consulta para seu domínio. Exemplo:

GET https://cloudresourcemanager.googleapis.com/v3/organizations:search{query=domain:altostrat.com}

A resposta contém os metadados do recurso da organização que pertence a altostrat.com, que inclui o ID do recurso da organização.

Configurar o recurso da organização

Se você for cliente do Google Workspace ou do Cloud Identity, um recurso de organização será fornecido automaticamente.

Os superadministradores do Google Workspace ou do Cloud Identity são os primeiros usuários que podem acessar o recurso de organização após a criação. Todos os outros usuários ou grupos poderão usar o Google Cloud como antes. Eles poderão ver o recurso da organização, mas só poderão modificá-lo depois que as permissões corretas forem definidas.

Os superadministradores do Google Workspace ou do Cloud Identity e o Google Cloud administrador da organização são papéis importantes durante o processo de configuração e para o controle do ciclo de vida do recurso da organização.

Por padrão, a conta de superadministrador do Google Workspace ou do Cloud Identity que cria o recurso da organização recebe automaticamente o papel de Administrador da organização. No entanto, para manter a segregação de funções, recomendamos que o superadministrador delegue o papel de Administrador da organização a um usuário ou grupo diferente.

As responsabilidades do superadministrador do Google Workspace ou do Cloud Identity, no contexto da configuração do recurso de organização do Google Cloud , são:

  • Atribuir o papel de Administrador da Organização a alguns usuários.
  • Ser um ponto de contato em caso de problemas de recuperação.
  • Controlar o ciclo de vida da conta do Google Workspace ou do Cloud Identity e do recurso da organização, conforme explicado em Excluir uma organização.

Depois de atribuído, o Administrador da Organização pode atribuir papéis Identity and Access Management a outros usuários. As responsabilidades do papel Administrador da Organização são:

  • Definir políticas de permissão e negação e conceder papéis a outros usuários.
  • Analisar a estrutura da hierarquia de recursos

De acordo com o princípio de privilégio mínimo, esse papel não inclui a permissão para executar outras ações, como criar pastas ou projetos. Para ter essas permissões, um administrador da Organização precisa atribuir papéis adicionais à conta deles.

Embora o mesmo usuário possa ter os dois papéis, ter dois papéis distintos garante a segregação de funções entre os superadministradores do Google Workspace ou do Cloud Identity e o administrador da organização do Google Cloud . Isso geralmente é um requisito, já que os dois produtos do Google costumam ser gerenciados por departamentos diferentes na organização do cliente.

Para usar ativamente o recurso da organização, siga estas etapas para adicionar um administrador da organização:

Adicionar um administrador da organização

Para adicionar um Administrador da organização, use o console do Google Cloud , a Google Cloud CLI ou a API Resource Manager.

Console

  1. Faça login no console do Google Cloud como superadministrador do Google Workspace ou do Cloud Identity e acesse a página IAM e administrador:

    Abrir a página IAM e administrador

  2. Selecione o recurso da organização que você quer editar:

    1. Clique na lista suspensa do projeto localizada no topo da página.

    2. Na caixa de diálogo Selecionar de, clique na lista suspensa da organização e selecione o recurso da organização ao qual você quer adicionar um Administrador da organização.

    3. Na lista que aparece, clique no recurso da organização para abrir a página Permissões do IAM.

  3. Clique em Adicionar e insira o endereço de e-mail de um ou mais usuários que você quer definir como administradores da organização.

  4. Na lista suspensa Selecionar um papel , selecione Resource Manager> Administrador da organização e clique em Salvar.

    O Administrador da Organização pode fazer o seguinte:

    • Assumir o controle total do recurso da organização. A separação de responsabilidades entre o superadministrador do Google Workspace ou do Cloud Identity e o administrador do Google Cloud é estabelecida.

    • Delegar a responsabilidade sobre papéis críticos com a atribuição dos papéis relevantes do IAM.

gcloud

Para adicionar um Administrador da Organização, execute o comando gcloud organizations add-iam-policy-binding:

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="user:EMAIL_ADDRESS" \
    --role="roles/resourcemanager.organizationAdmin"

Substitua:

  • ORGANIZATION_ID: o ID exclusivo do recurso da organização.
  • EMAIL_ADDRESS: o endereço de e-mail do usuário que você quer adicionar como administrador da organização.

API

Para adicionar um administrador da organização, chame o método setIamPolicy no recurso da organização.

  1. Consiga a política do IAM atual para o recurso da organização:

    POST https://cloudresourcemanager.googleapis.com/v3/organizations/ORGANIZATION_ID:getIamPolicy
    
  2. Atualize a política retornada para adicionar o membro ao papel roles/resourcemanager.organizationAdmin.

  3. Defina a política atualizada:

    POST https://cloudresourcemanager.googleapis.com/v3/organizations/ORGANIZATION_ID:setIamPolicy
    {
      "policy": {
        "bindings": [
          {
            "role": "roles/resourcemanager.organizationAdmin",
            "members": [
              "user:EMAIL_ADDRESS"
            ]
          }
        ],
        "etag": "ETAG_VALUE"
      }
    }
    

    Substitua:

    • ORGANIZATION_ID: o ID exclusivo do recurso da organização.
    • EMAIL_ADDRESS: o endereço de e-mail do usuário que você quer adicionar como administrador da organização.
    • ETAG_VALUE: o valor etag da política retornada na primeira etapa.

Conforme explicado em Como receber um recurso da organização, após a criação, todos os usuários no domínio recebem os papéis de Criador de projetos e Criador da conta de faturamento no nível do recurso da organização por padrão. Isso garante que nenhuma interrupção seja causada aos usuários do Google Cloud quando o recurso da organização for criado. Quando o administrador da organização assumir o controle, ele poderá remover essas permissões no nível da organização para começar a bloquear o acesso em uma granularidade mais fina (por exemplo, no nível da pasta ou do projeto). Como as políticas de permissão e negação são herdadas na hierarquia, ter o papel de criador de projetos atribuído a todo o domínio (domain:mycompany.com) no nível do recurso da organização implica que todos os usuários no domínio podem criar projetos em qualquer lugar da hierarquia.

A seguir