O agente de serviço do ambiente padrão do App Engine
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
Não revogar os papéis que são concedidos ao agente de serviço.
No canto superior direito da página Permissões, marque a
caixa de seleção Incluir concessões de papel fornecidas pelo Google.
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.
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 Python 2 para gerenciar os seus aplicativos de 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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-12-22 UTC."],[[["\u003cp\u003eThe App Engine standard environment includes a service agent that enables your Google Cloud project to interact with your app's resources separately from other Google Cloud services.\u003c/p\u003e\n"],["\u003cp\u003eThis service agent is automatically created when you deploy your first app to the App Engine standard environment using App Engine tooling, such as the \u003ccode\u003egcloud app deploy\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe service agent is not listed on the Service Accounts page, and its granted roles should not be revoked, nor should the service agent role be granted to other accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe service agent is granted the App Engine standard environment Service Agent role, which includes permissions needed for managing standard environment apps, like getting access tokens and using the Blobstore API.\u003c/p\u003e\n"],["\u003cp\u003eIf accidentally deleted, the service agent can be restored by adding it back through the Permissions page in the Google Cloud console using its specific ID and role.\u003c/p\u003e\n"]]],[],null,["# The App Engine standard environment service agent\n\nIn addition to the [App Engine default service\naccount](/appengine/docs/legacy/standard/python/service-account), the\nApp Engine standard environment includes a *App Engine standard environment service agent*. The service agent\nenables your Google Cloud project to interact with the resources of your app\nseparately from other Google Cloud services.\n\nGoogle automatically creates this account when you deploy a project's first app\nto the App Engine standard environment using App Engine tooling,\nsuch as the `gcloud app deploy` command.\n\nThe service agent is not listed on the Service\nAccounts page of the Google Cloud console and has the following restrictions:\n\n- Do not revoke the roles that are granted to the service agent.\n- Do not grant the related [App Engine standard environment service agent\n role](#service_agent_role) to any other account because the permissions that the role includes can change without notice.\n\n| **Warning:** Removing the service agent removes the binding for the service agent from your Google Cloud project. If you remove the binding or change the permissions for the service agent, any deployment to your app in the standard environment might fail.\n\nVerifying the App Engine standard environment service agent\n-----------------------------------------------------------\n\nTo verify that the service agent exists\nin your Google Cloud project, perform the following steps:\n\n1. Open the Google Cloud console:\n\n [Go to the Permissions\n page](https://console.cloud.google.com/iam-admin/iam)\n2. In the upper-right corner of the **Permissions** page, select the\n **Include Google-provided role grants** checkbox.\n\n3. In the **Principals** list, locate the ID of the App Engine standard environment service\n agent, which uses the ID \n\n `service-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`@gcp-gae-service.iam.gserviceaccount.com`.\n\n4. Verify that the service agent has been\n granted the **App Engine standard environment Service Agent** role.\n\nService Agent role\n------------------\n\nThe service agent has the\n[App Engine standard environment Service Agent role](/iam/docs/understanding-roles#appengine.serviceAgent).\nThe role includes a set of permissions needed by Python 2 standard environment to\nmanage your standard environment apps. For example,\nthis role includes permissions to perform the following tasks:\n\n- Get an access token for App Engine instances to access other Google Cloud resources, such as a Cloud Storage bucket.\n- Use the [Blobstore API](/appengine/docs/legacy/standard/python/blobstore) from App Engine legacy bundled services.\n\nThe App Engine standard environment Service Agent role is reserved for the\nservice agent. Do not grant this\n[IAM role](/iam/docs/overview#roles) to any other account, because the\npermissions that the role includes can change without notice.\n\nRestoring a deleted service agent\n---------------------------------\n\nIf you accidentally delete the App Engine standard environment service agent,\nrestore it by performing the following steps:\n\n1. Open the Google Cloud console:\n\n [Go to the Permissions\n page](https://console.cloud.google.com/iam-admin/iam)\n2. Click **Add**.\n\n3. Enter the service agent ID using the format \n\n `service-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`@gcp-gae-service.iam.gserviceaccount.com`.\n\n4. Select the **App Engine standard environment Service Agent** role.\n\n5. Click **Save**."]]
