Conceder acesso ao projeto com o IAM

1. Antes de começar

Neste codelab, você vai aprender a configurar um cliente OAuth e usar o Console do Google Cloud para conceder papéis do gerenciamento de identidade e acesso (IAM) aos principais do seu projeto.

Pré-requisitos

• Capacidade de navegar pelo console do Cloud.

O que você vai aprender

• Como configurar seu app como um cliente OAuth.
• Como restringir o acesso ao seu app com o Identity and Access Management (IAM).

O que é necessário

• Um navegador da Web moderno, como o Google Chrome.
• Uma Conta do Google, como uma conta do Gmail ou uma conta do Google Workspace.
• Acesso a uma conta do Cloud Billing ou um cartão de crédito para se inscrever em um teste sem custo financeiro.

2. Criar um projeto do Google Cloud e configurar uma conta de faturamento

Observação:se você já tiver configurado um projeto e uma conta de faturamento que quer reutilizar, pule esta seção.

1. Faça login no Console do Cloud.

Aviso:se você reutilizar um projeto e concluir este codelab, poderá permitir que alguns usuários acessem recursos nesse projeto se eles não forem desativados quando você terminar.

2. Acesse a página do seletor de projetos.
3. Clique em Criar projeto.
4. Atribua um nome ao projeto e anote o ID gerado.
5. Edite os outros campos conforme necessário.

Observação: se você usa uma conta do Gmail, defina o local padrão como Sem organização. Se você usa uma conta do Google Workspace, escolha um local adequado para a organização.

6. Clique em Criar.
7. Se ainda não tiver feito isso, ative o faturamento no console do Cloud para usar os recursos do Google Cloud.

Embora este codelab não deva custar muito, se tiver algum custo, siga as instruções na seção Limpeza para encerrar os recursos e evitar custos além deste codelab. Novos usuários do Google Cloud podem aproveitar o teste sem custo financeiro de US$300.

3. Conceder acesso com o IAM

O IAM permite conceder acesso baseado em papéis aos usuários para seu projeto e recursos. Nesta seção, você vai usar o IAM para conceder a um usuário acesso a alguns papéis do seu projeto.

Ativar as APIs IAM e Resource Manager

1. No menu de navegação do console do Cloud, clique em APIs e serviços.

2. Selecione ATIVAR APIS E SERVIÇOS.

3. Pesquise e ative a API IAM.
4. Pesquise Resource Manager API e ative.

Conceder um papel com o IAM

1. Acesse a página do IAM.

O nome do projeto aparece no seletor de projetos. O seletor de projetos informa em qual projeto você está.

Se você não vir o nome do projeto, use o seletor para selecioná-lo.

2. Clique em Adicionar.
3. Digite o endereço de e-mail de um principal.
4. No menu suspenso Selecionar um papel, selecione Logging > Visualizador de registros > Salvar.

5. Verifique se o principal e o papel estão listados na página IAM.

Pronto. Você concedeu um papel de gerenciamento de identidade e acesso a um principal.

Observar os efeitos dos papéis de gerenciamento de identidade e acesso

Nesta seção, você vai verificar se a principal a quem concedeu um papel pode acessar as páginas esperadas do console do Cloud:

1. Envie este URL para o principal a quem você concedeu o papel:

https://console.cloud.google.com/logs?project=PROJECT_ID

2. Verifique se o principal consegue acessar e ver o URL.

O principal não consegue acessar uma página do Console do Cloud sem o papel apropriado. Em vez disso, eles veem uma mensagem de erro como esta:

You don't have permissions to view logs.

Atribuir outros papéis ao mesmo principal

Cuidado:os papéis básicos incluem milhares de permissões em todos os serviços do Google Cloud. Em ambientes de produção, não conceda papéis básicos, a menos que não haja alternativa. Em vez disso, conceda papéis predefinidos mais limitados ou personalizados que atendam às suas necessidades.

1. No Console do Cloud, acesse a página IAM.
2. Localize o principal para quem você quer conceder outro papel e clique em Editar .
3. No painel Editar permissões, clique em Adicionar novo papel.

4. No menu suspenso Selecionar um papel, clique em Projeto > Leitor > Salvar.

O principal agora tem um segundo papel de gerenciamento de identidade e acesso.

Revogar os papéis concedidos ao principal

1. Localize o principal que tem o papel que você quer revogar e clique em Editar .
2. No painel Editar permissões, clique em ao lado dos dois papéis concedidos anteriormente ao principal.
3. Clique em Salvar.

Você removeu os dois papéis desse principal. Se essa pessoa tentar acessar qualquer uma das páginas que podia acessar antes, uma mensagem de erro vai aparecer.

4. Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste codelab:

Atenção: ao excluir um projeto,

• Tudo no projeto é excluído. Se você usou um projeto existente neste tutorial, também vai excluir outros trabalhos feitos nele.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua os recursos selecionados dentro do projeto em vez de todo o projeto.

Se você planeja explorar vários codelabs ou guias de início rápido, reutilize projetos para não exceder os limites da cota.

1. No console do Cloud, acesse a página Gerenciar recursos.
2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir.
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

5. Parabéns

Parabéns! Você aprendeu a configurar um cliente OAuth e usar o Console do Cloud para conceder papéis de gerenciamento de identidade e acesso a principais do seu projeto.