The App Engine standard environment service agent

In addition to the App Engine default service account, the App Engine standard environment includes a App Engine standard environment service agent. The service agent enables your Google Cloud project to interact with the resources of your app separately from other Google Cloud services.

Google automatically creates this account when you deploy a project's first app to the App Engine standard environment using App Engine tooling, such as the gcloud app deploy command.

The service agent is not listed on the Service Accounts page of the Google Cloud console and has the following restrictions:

• Do not revoke the roles that are granted to the service agent.
• Do not grant the related App Engine standard environment service agent role to any other account because the permissions that the role includes can change without notice.

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.

Verifying the App Engine standard environment service agent

To verify that the service agent exists in your Google Cloud project, perform the following steps:

1. Open the Google Cloud console:

   Go to the Permissions page

2. In the upper-right corner of the Permissions page, select the Include Google-provided role grants checkbox.

3. In the Principals list, locate the ID of the App Engine standard environment service agent, which uses the ID
   [e-mail].

4. Verify that the service agent has been granted the App Engine standard environment Service Agent role.

Service Agent role

The service agent has the App Engine standard environment Service Agent role. The role includes a set of permissions needed by PHP 5 standard environment to manage your standard environment apps. For example, this role includes permissions to perform the following tasks:

• Get an access token for App Engine instances to access other Google Cloud resources, such as a Cloud Storage bucket.
• Use the Blobstore API from App Engine legacy bundled services.

The App Engine standard environment Service Agent role is reserved for the service agent. Do not grant this IAM role to any other account, because the permissions that the role includes can change without notice.

Restoring a deleted service agent

If you accidentally delete the App Engine standard environment service agent, restore it by performing the following steps:

1. Open the Google Cloud console:

   Go to the Permissions page

2. Click Add.

3. Enter the service agent ID using the format
   [e-mail].

4. Select the App Engine standard environment Service Agent role.

5. Click Save.