Stay organized with collections
Save and categorize content based on your preferences.
This page describes how authorization works in Cloud Shell.
Authorize tools in Cloud Shell
When you make a Google Cloud API call or use a command-line tool that
requires credentials (such as the gcloud CLI or bq) with
Cloud Shell for the first time, Cloud Shell prompts
you with the Authorize Cloud Shell dialog.
To allow the tool to use your credentials to make calls, click Authorize.
Duration of authorization
This authorization lasts the lifetime of your Cloud Shell session.
Since each Cloud Shell session is tied to an
ephemeral, pre-configured virtual machine, if you restart your VM or close
your browser, you will need to reauthorize these tools if you use them in
your next new session. To learn more about how Cloud Shell works,
refer to the Concepts page that outlines
key features and how they work.
Revoke access
To revoke access for a session, restart your VM to start a new session by
clicking more_vertMore>Restart.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Authorize with Cloud Shell\n\nThis page describes how authorization works in Cloud Shell.\n\nAuthorize tools in Cloud Shell\n------------------------------\n\nWhen you make a Google Cloud API call or use a command-line tool that\nrequires credentials (such as the gcloud CLI or `bq`) with\nCloud Shell for the first time, Cloud Shell prompts\nyou with the **Authorize Cloud Shell** dialog.\n\nTo allow the tool to use your credentials to make calls, click **Authorize**.\n\n### Duration of authorization\n\nThis authorization lasts the lifetime of your Cloud Shell session.\nSince each Cloud Shell session is tied to an\nephemeral, pre-configured virtual machine, if you restart your VM or close\nyour browser, you will need to reauthorize these tools if you use them in\nyour next new session. To learn more about how Cloud Shell works,\nrefer to the [Concepts page](/shell/docs/how-cloud-shell-works) that outlines\nkey features and how they work.\n\n### Revoke access\n\nTo revoke access for a session, restart your VM to start a new session by\nclicking more_vert **More** \\\u003e\n**Restart**."]]