向 Cloud Scheduler 进行身份验证

本文档介绍了如何以编程方式向 Cloud Scheduler 进行身份验证。如何 向 Cloud Scheduler 进行身份验证取决于您用于访问 API 的界面以及运行代码的环境。

如果您已设置具有适当凭据的关联服务帐号,则 Cloud Scheduler 可以调用需要身份验证的 HTTP 目标。如需了解详情,请参阅 对 HTTP 目标使用身份验证

如需详细了解 Google Cloud 身份验证,请参阅 身份验证方法

API 访问权限

Cloud Scheduler 支持程序化访问。您可以通过以下方式访问 API:

客户端库

Cloud Scheduler 客户端库提供 以编程方式向 Cloud Scheduler 进行身份验证的高级语言支持。 为了对 Google Cloud API 的调用进行身份验证,客户端库支持 应用默认凭证 (ADC); 这些库会在一组指定的位置查找凭证,并使用这些凭证 对发送到 API 的请求进行身份验证。借助 ADC,您可以在各种环境(例如本地开发或生产环境)中为您的应用提供凭据,而无需修改应用代码。

Google Cloud CLI

使用 gcloud CLI 访问 Cloud Scheduler 时,您需要使用用户 账号登录 gcloud CLI,该账号会提供 gcloud CLI 命令使用的凭据。

如果您的组织的安全政策阻止用户账号获取所需的 权限,您可以使用 服务账号模拟

如需了解详情,请参阅 使用 gcloud CLI 时进行身份验证。 如需详细了解如何将 gcloud CLI 与 Cloud Scheduler 搭配使用, 请参阅 gcloud CLI 参考页面

REST

您可以使用 Cloud Scheduler API 凭据或使用 应用默认凭证向 Cloud Scheduler API 进行身份验证。如需详细了解 REST 请求身份验证,请参阅 使用 REST 时进行身份验证。 如需了解凭据类型,请参阅 gcloud CLI 凭据和 ADC 凭据

为 Cloud Scheduler 设置身份验证

设置身份验证的方式取决于代码在其中运行的环境。

以下是最常用的身份验证设置选项。如需了解有关身份验证的更多 选项和信息,请参阅 身份验证方法

在完成这些说明之前,您必须完成 Cloud Scheduler 的基本设置,如设置环境中所述。

对于本地开发环境

您可以通过以下方式为本地开发环境设置凭据:

客户端库或第三方工具

在本地环境中设置 应用默认凭证 (ADC)

  1. 安装 Google Cloud CLI。 安装完成后, 初始化 Google Cloud CLI,方法是运行以下命令:

    gcloud init

    如果您使用的是外部身份提供方 (IdP),则必须先 使用联合身份登录 gcloud CLI

  2. 如果您使用的是本地 shell,请为您的用户 账号创建本地身份验证凭证:

    gcloud auth application-default login

    如果您使用的是 Cloud Shell,则无需执行此操作。

    如果返回了身份验证错误,并且您使用的是外部身份提供方 (IdP),请确认您已 使用联合身份登录 gcloud CLI

    登录屏幕随即出现。在您登录后,您的凭据会存储在 ADC 使用的本地凭据文件中。

如需详细了解如何在本地环境中使用 ADC,请参阅为本地开发环境设置 ADC

从命令行发出的 REST 请求

从命令行发出 REST 请求时,您可以通过在发送该请求的命令中添加 gcloud auth print-access-token 来使用 gcloud CLI 凭据。

以下示例列出了指定项目的服务账号。您可以对任何 REST 请求使用相同的模式。

在使用任何请求数据之前,请先进行以下替换:

  • PROJECT_ID:您的 Google Cloud 项目 ID。

如需发送您的请求,请展开以下选项之一: