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

Além da conta de serviço padrão, o ambiente padrão do App Engine inclui uma conta de serviço gerenciada pelo Google chamada conta 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:

• Não revogar os papéis que são concedidos ao agente de serviço.
• Não conceder o papel de Agente de serviço do ambiente padrão do App Engine a qualquer outra conta, porque as permissões que o papel inclui podem mudar sem aviso prévio.

Aviso: a remoção do agente de serviço remove a vinculação dele do projeto do Google Cloud. Se você remover a vinculação ou alterar as permissões da conta de serviço, qualquer implantação no aplicativo no ambiente padrão pode falhar.

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
   [e-mail].

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 necessárias para que o ambiente padrão do PHP 5 gerencie os aplicativos desse ambiente. 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 Add.

3. Insira o ID do agente de serviço usando o formato
   [e-mail].

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

5. Clique em Save.