O agente de serviço do ambiente padrão do App Engine

Além da conta de serviço padrão do App Engine, o ambiente padrão do App Engine inclui um agente de serviço do ambiente padrão do App Engine. O agente de serviço permite que seu projeto do Google Cloud interaja com os recursos do aplicativo separadamente de outros serviços do Google Cloud.

O Google cria automaticamente essa conta quando você implanta o primeiro aplicativo de um projeto no ambiente padrão do App Engine usando ferramentas do App Engine, como o comando gcloud app deploy.

O agente de serviço não está listado na página "Contas de serviço" do Console do Google Cloud e tem as seguintes restrições:

Como verificar a conta de serviço do ambiente padrão do App Engine

Para verificar se o agente de serviço existe no projeto do Google Cloud:

  1. Abra o Console do Google Cloud:

    Acessar a página "Permissões"

  2. No canto superior direito da página Permissões, marque a caixa de seleção Incluir concessões de papel fornecidas pelo Google.

  3. Na lista Principais, localize o ID do agente de serviço do ambiente padrão do App Engine, que usa o ID
    service-PROJECT_NUMBER@gcp-gae-service.iam.gserviceaccount.com.

  4. Verifique se o agente de serviço recebeu o papel de Agente de serviço do ambiente padrão do App Engine.

Papel de agente de serviço

O agente de serviço tem o papel de Agente de serviço do ambiente padrão do App Engine. O papel inclui um conjunto de permissões exigidas pelo ambiente padrão do Java 8 para gerenciar os aplicativos do ambiente padrão. Por exemplo, esse papel inclui permissões para realizar as tarefas a seguir:

  • Receber um token de acesso para que as instâncias do App Engine acessem outros recursos do Google Cloud, como um bucket do Cloud Storage.
  • Usar a API Blobstore via serviços integrados legados do App Engine.

O papel de Agente de serviço do ambiente padrão do App Engine é reservado para o agente de serviço. Não conceda esse papel do IAM a qualquer outra conta, porque as permissões que ele inclui podem mudar sem aviso prévio.

Como restaurar um agente de serviço excluído

Se você excluir acidentalmente o agente de serviço do ambiente padrão do App Engine, restaure-o executando estas etapas:

  1. Abra o Console do Google Cloud:

    Acessar a página "Permissões"

  2. Clique em Adicionar.

  3. Insira o ID do agente de serviço usando o formato
    service-PROJECT_NUMBER@gcp-gae-service.iam.gserviceaccount.com.

  4. Selecione o papel Agente de serviço do ambiente padrão do App Engine.

  5. Clique em Salvar.