gcloud alpha auth print-identity-token

NAME

gcloud alpha auth print-identity-token - print an identity token for the specified account

SYNOPSIS

gcloud alpha auth print-identity-token [ACCOUNT] [--audiences=AUDIENCES] [--include-email] [--include-license --token-format=TOKEN_FORMAT; default="standard"] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(ALPHA) Print an identity token for the specified account.

EXAMPLES

To print identity tokens:

gcloud alpha auth print-identity-token

To print identity token for account '[e-mail]' whose audience is 'https://service-hash-uc.a.run.app', run:

gcloud alpha auth print-identity-token [e-mail] --audiences="https://service-hash-uc.a.run.app"

To print identity token for an impersonated service account '[e-mail]' whose audience is 'https://service-hash-uc.a.run.app', run:

gcloud alpha auth print-identity-token --impersonate-service-account="[e-mail]" --audiences="https://service-hash-uc.a.run.app"

To print identity token of a Compute Engine instance, which includes project and instance details as well as license codes for images associated with the instance, run:

gcloud alpha auth print-identity-token --token-format=full --include-license

To print identity token for an impersonated service account '[e-mail]', which includes the email address of the service account, run:

gcloud alpha auth print-identity-token --impersonate-service-account="[e-mail]" --include-email

POSITIONAL ARGUMENTS

[ACCOUNT]

Account to print the identity token for. If not specified, the current active account will be used.

FLAGS

--audiences=AUDIENCES

Intended recipient of the token. Currently, only one audience can be specified.

--include-email

Specify whether or not service account email is included in the identity token. If specified, the token will contain 'email' and 'email_verified' claims. This flag should only be used for impersonate service account.

Parameters for Google Compute Engine instance identity tokens.

--include-license

Specify whether or not license codes for images associated with this instance are included in the identity token payload. Default is False. This flag does not have effect unless --token-format=full.

--token-format=TOKEN_FORMAT; default="standard"

Specify whether or not the project and instance details are included in the identity token payload. This flag only applies to Google Compute Engine instance identity tokens. See https://cloud.google.com/compute/docs/instances/verifying-instance-identity#token_format for more details on token format. TOKEN_FORMAT must be one of: standard, full.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:

gcloud auth print-identity-token

gcloud beta auth print-identity-token