AWS Lambda
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

管理您的 AWS Lambda 资源的访问权限概述

每个 AWS 资源都归某个 AWS 账户所有,创建和访问资源的权限由权限策略进行管理。账户管理员可以向 IAM 身份 (即:用户、组和角色) 挂载权限策略,某些服务 (如 AWS Lambda) 也支持向资源挂载权限策略。

注意

账户管理员 (或管理员用户) 是具有管理员权限的用户。有关更多信息,请参阅 IAM 用户指南 中的 IAM 最佳实践

在授予权限时,您要决定谁获得权限,获得对哪些资源的权限,以及您允许对这些资源执行的具体操作。

AWS Lambda 资源和操作

在 AWS Lambda 中,主要资源为 Lambda 函数事件源映射。您可以在 AWS Lambda 拉模型中创建事件源映射来将 Lambda 函数与事件源关联。有关更多信息,请参阅 事件源映射

AWS Lambda 还支持其他资源类型、别名版本。但是,只能在现有的 Lambda 函数范围内创建别名和版本。这些资源称作子资源

这些资源和子资源具有与其关联的唯一 Amazon 资源名称 (ARN),如下表所示。

资源类型 ARN 格式
函数

arn:aws:lambda:region:account-id:function:function-name

函数别名

arn:aws:lambda:region:account-id:function:function-name:alias-name

函数版本

arn:aws:lambda:region:account-id:function:function-name:version

事件源映射

arn:aws:lambda:region:account-id:event-source-mapping:event-source-mapping-id

AWS Lambda 提供一组操作来处理 Lambda 资源。有关可用操作的列表,请参阅 Actions

了解资源所有权

资源所有者 是创建资源的 AWS 账户。也就是说,资源所有者是委托人实体(根账户、IAM 用户或 IAM 角色)的 AWS 账户。以下示例说明了它的工作原理:

  • 如果使用您的 AWS 账户的根账户凭证来创建 Lambda 函数,则您的 AWS 账户就是该资源的所有者(在 Lambda 中,资源就是 Lambda 函数)。

  • 如果您在您的 AWS 账户中创建 IAM 用户并对其授予创建 Lambda 函数的权限,则该用户可以创建 Lambda 函数。但是,您的 AWS 账户(也就是该用户所属的账户)拥有 Lambda 函数资源。

  • 如果您在您的 AWS 账户中创建 IAM 角色,该角色具有创建 Lambda 函数的权限,则能够担任该角色的任何人都可以创建 Lambda 函数。您的 AWS 账户(也就是该用户所属的账户)拥有 Lambda 函数资源。

管理对资源的访问

权限策略 规定谁可以访问哪些内容。 下一节介绍创建权限策略时的可用选项。

注意

本节讨论如何在 AWS Lambda 范围内使用 IAM。它不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档,请参阅什么是 IAM? (在 IAM 用户指南 中)。有关 IAM 策略语法和介绍的信息,请参阅 IAM 用户指南 中的 AWS IAM 策略参考

挂载到 IAM 身份的策略称作基于身份 的策略 (IAM 策略),挂载到资源的策略称作基于资源 的资源。AWS Lambda 同时支持基于身份的策略(IAM 策略)和基于资源的策略。

基于身份的策略 (IAM 策略)

您可以向 IAM 身份挂载策略。例如,您可以执行以下操作:

  • 向您账户中的用户或组附加权限策略 - 账户管理员可以使用与特定用户关联的权限策略授予该用户创建 Lambda 函数的权限。

  • 向角色挂载权限策略 (授予跨账户权限) - 您可以向 IAM 角色挂载基于身份的权限策略,以授予跨账户的权限。例如,账户 A 中的管理员可以创建一个角色,以向其他 AWS 账户 (如账户 B) 或某项 AWS 服务授予跨账户权限,如下所述:

    1. 账户 A 管理员可以创建一个 IAM 角色,然后向该角色挂载授予其访问账户 A 中资源的权限策略。

    2. 账户 A 管理员可以向将账户 B 标识为能够担任该角色的委托人的角色挂载信任策略。

    3. 之后,账户 B 管理员可以委派权限,指派账户 B 中的任何用户担任该角色。这样,账户 B 中的用户就可以创建或访问账户 A 中的资源了。如果您需要授予 AWS 服务权限来担任该角色,则信任策略中的委托人也可以是 AWS 服务委托人。

    有关使用 IAM 委派权限的更多信息,请参阅 IAM 用户指南 中的访问权限管理

以下示例策略授予对所有资源执行 lambda:ListFunctions 操作的权限。在当前实现中,Lambda 不支持使用某些 API 操作的资源 ARN(也称为资源级权限)标识特定资源,因此必须指定通配符 (*)。

Copy
{ "Version": "2012-10-17", "Statement": [ { "Sid": "ListExistingFunctions", "Effect": "Allow", "Action": [ "lambda:ListFunctions" ], "Resource": "*" } ] }

有关将基于身份的策略用于 Lambda 的更多信息,请参阅为 AWS Lambda 使用基于身份的策略(IAM 策略)。有关用户、组、角色和权限的更多信息,请参阅 IAM 用户指南 中的身份(用户、组和角色)

基于资源的策略(Lambda 函数策略)

每个 Lambda 函数都可以有关联的基于资源的权限策略。对于 Lambda,Lambda 函数是主要资源,这些策略称作 Lambda 函数策略。作为将基于身份的策略用于 IAM 角色的替代方案,您可以使用 Lambda 函数策略授予跨账户权限。例如,您可以通过向 Lambda 函数策略添加权限而不是创建 IAM 角色来向 Amazon S3 授予调用您 Lambda 函数的权限。

重要

Lambda 函数策略主要是在以下情况下使用:您在 AWS Lambda 中设置事件源以向服务或事件源授予调用 Lambda 函数的权限(请参阅 Invoke)。此情况的一个例外是在事件源(例如 Amazon DynamoDB 或 Kinesis)使用拉模式(其中,权限改为在 Lambda 函数执行角色中进行管理)的情况下。有关更多信息,请参阅 事件源映射

以下是具有一个声明的示例 Lambda 函数策略。此声明向名为 HelloWorld 的 Lambda 函数上的 lambda:InvokeFunction 操作授予 Amazon S3 服务委托人权限。此条件可确保发生事件的存储桶由拥有该 Lambda 函数的同一账户拥有。

Copy
{ "Policy":{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Principal":{ "Service":"s3.amazonaws.com" }, "Action":"lambda:InvokeFunction", "Resource":"arn:aws:lambda:region:account-id:function:HelloWorld", "Sid":"65bafc90-6a1f-42a8-a7ab-8aa9bc877985", "Condition":{ "StringEquals":{ "AWS:SourceAccount":"account-id" }, "ArnLike":{ "AWS:SourceArn":"arn:aws:s3:::ExampleBucket" } } } ] } }

有关将基于资源的策略用于 Lambda 的更多信息,请参阅对 AWS Lambda 使用基于资源的策略(Lambda 函数策略)。有关使用与基于资源的策略相对的 IAM 角色(基于身份的策略)的其他信息,请参阅 IAM 用户指南 中的 IAM 角色与基于资源的策略有何不同

指定策略元素:操作、效果、资源和委托人

对于每个 AWS Lambda 资源(请参阅 AWS Lambda 资源和操作),该服务都定义了一组 API 操作(请参阅Actions)。为授予这些 API 操作的权限,Lambda 定义了一组您可以在策略中指定的操作。请注意,执行某项 API 操作可能需要执行多个操作的权限。在授予特定操作的权限时,您也可以标识允许或拒绝对其执行操作的资源。

以下是最基本的策略元素:

  • Resource - 在策略中,您可以使用 Amazon 资源名称 (ARN) 标识策略应用到的资源。有关更多信息,请参阅 AWS Lambda 资源和操作

  • Action - 您可以使用操作关键字标识要允许或拒绝的资源操作。例如,lambda:InvokeFunction 权限允许执行 AWS Lambda Invoke 操作的用户权限。

  • Effect - 您可以指定当用户请求特定操作 (可以是允许或拒绝) 时的效果。如果没有显式授予 (允许) 对资源的访问权限,则隐式拒绝访问。您也可显式拒绝对资源的访问,这样可确保用户无法访问该资源,即使有其他策略授予了访问权限的情况下也是如此。

  • Principal - 在基于身份的策略 (IAM 策略) 中,挂载了策略的用户是隐式委托人。对于基于资源的策略,您可以指定要接收权限的用户、账户、服务或其他实体(仅适用于基于资源的策略)。

有关 IAM 策略语法和介绍的更多信息,请参阅 IAM 用户指南 中的 AWS IAM 策略参考

有关显示所有 AWS Lambda API 操作及其适用的资源的表,请参阅 Lambda API 权限:操作、资源和条件参考

在策略中指定条件

当您授予权限时,可使用 IAM 策略语言来指定规定策略何时生效的条件。例如,您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息,请参阅 IAM 用户指南 中的条件

要表示条件,您可以使用预定义的条件键。没有特定于 Lambda 的条件键。但有 AWS 范围内的条件密钥,您可以根据需要使用。有关 AWS 范围内的键的完整列表,请参阅 IAM 用户指南 中的条件的可用键