Conceder acesso ao projeto com o IAM

1. Antes de começar

Este codelab mostra como configurar um cliente OAuth e usar o console do Google Cloud para conceder papéis do Identity and Access Management (IAM) aos principais do seu projeto.

Pré-requisitos

• Saber navegar pelo console do Cloud.

O que você vai aprender

• Como configurar seu app como um cliente OAuth.
• Como restringir o acesso ao 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 do Google Workspace.
• Acesso a uma conta do Cloud BIlling ou a um cartão de crédito para se inscrever em uma avaliação 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 os recursos desse projeto se eles não estiverem desativados após a conclusão.

2. Acesse a página do seletor de projetos.
3. Clique em Criar projeto.
4. Dê um nome ao projeto e anote o ID do projeto 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. Ative o faturamento no Console do Cloud para usar os recursos do Google Cloud, caso ainda não tenha feito isso.

Embora este codelab não tenha um custo muito alto, siga as instruções na seção Limpar para encerrar os recursos e evitar custos além deste. Observe que novos usuários do Google Cloud estão qualificados para o teste sem custo financeiro de US$300.

3. Conceder acesso com o IAM

Com o IAM, você pode conceder acesso com base em papéis aos usuários para seu projeto e recursos. Nesta seção, você usa o IAM para conceder a um usuário acesso a alguns papéis do projeto.

Ative as APIs do IAM e do 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. Procure e ative a API IAM.
4. Pesquise Resource Manager API e ative-a.

Conceder um papel com o IAM

1. Acesse a página do IAM.

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

Se você não vir o nome do seu 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 papel, escolha Geração de registros > 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ê verifica se o principal a quem você concedeu um papel pode acessar as páginas esperadas do console do Cloud:

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

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

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

O principal não pode acessar uma página do Console do Cloud sem o papel apropriado. Em vez disso, ele verá 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 outra 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 a 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 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 a principal com 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 o principal dos dois papéis. Se essa pessoa tentar visualizar qualquer uma das páginas que tinha acesso anteriormente, ela verá uma mensagem de erro.

4. Limpar

Para evitar cobranças dos recursos usados neste codelab na conta do Google Cloud, siga estas etapas:

Cuidado:ao excluir um projeto:

• Tudo no projeto é excluído. Se você usou um projeto atual para este tutorial, exclua também qualquer outro trabalho feito no projeto.
• 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 no projeto em vez do projeto inteiro.

Se você planeja conhecer vários codelabs ou guias de início rápido, reutilize projetos para respeitar os limites de 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 a usar o console do Cloud para conceder papéis de gerenciamento de identidade e acesso aos principais do projeto.