本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 核心概念
<a name="policy-core-concepts"></a>

在 Amazon Bedrock 中使用策略之前 AgentCore，请务必了解共同为人工智能代理提供基于策略的监管的关键概念和组件。

**Topics**
+ [网关](#concept-gateway)
+ [网关目标](#concept-gateway-target)
+ [主体类型](#concept-principal-types)
+ [雪松](#concept-cedar)
+ [雪松政策](#concept-cedar-policy)
+ [山茱莉](#concept-dogwood)
+ [在雪松和山茱莉之间做出选择](#concept-choosing-language)
+ [临时政策](#concept-temporal-policy)
+ [政策中的护栏](#concept-guardrails)
+ [政策会议](#concept-policy-session)
+ [策略引擎](#concept-policy-engine)
+ [雪松架构](#concept-cedar-schema)
+ [雪松验证](#concept-cedar-validation)
+ [雪松分析](#concept-cedar-analysis)
+ [策略创作服务](#concept-policy-authoring-service)

## 网关
<a name="concept-gateway"></a>

Amazon Bedrock AgentCore Gateway 提供了一个终端节点，用于连接 MCP 服务器，并将 API 和 lambda 转换为 MCP 兼容工具，从而为代理提供与其工具交互的单一访问点。一个网关可以有多个目标，每个目标代表一个或一组不同的工具。

## 网关目标
<a name="concept-gateway-target"></a>

目标定义网关将作为工具提供给代理的 API 或 Lambda 函数。目标可以是 Lambda 函数、OpenAPI 规范、Smithy 模型或其他工具定义。

## 主体类型
<a name="concept-principal-types"></a>

Cedar 策略使用委托人来代表提出授权请求的实体。中的策略 AgentCore 支持两种主体类型，具体取决于您的 AgentCore 网关的身份验证配置方式：
+  **AgentCore:: OAuthUser**-代表 OAuth-authenticated 用户。当 AgentCore 网关使用 OAuth 授权时，将根据 JWT 令牌的声明创建委托人。`sub`OAuth 委托人支持包含 JWT 声明的标签，例如用户名、范围、角色等。
+  **AgentCore:: IamEntity**-代表 IAM-authenticated 来电者。当 AgentCore 网关使用 AWS\_IAM 授权时，会根据调用者的 IAM 身份创建委托人。IAM 委托人有一个包含 IAM ARN 的`id`属性（格式`arn:aws:sts::<account>:assumed-role/<role-name>`：用于代入的角色），可实现`principal ==`稳定匹配。详情请参阅[保单条款](policy-conditions.md)。

## 雪松
<a name="concept-cedar"></a>

 [Cedar](https://docs.cedarpolicy.com) 是一种开源策略语言，由开发 Amazon 用于编写和执行授权策略。Cedar 策略是人类可读的、可分析的，并且可以根据架构进行验证。Policy in AgentCore 使用 Cedar 为网关工具提供精确、可验证的访问控制。

## 雪松政策
<a name="concept-cedar-policy"></a>

Cedar 策略是一种声明性声明，允许或禁止访问网关工具。每项策略都指定了谁（委托人）可以在什么条件下对哪个资源（网关）执行什么操作（工具调用）。每个工具调用请求都会对策略进行评估。

## 山茱莉
<a name="concept-dogwood"></a>

 [Dogwood](https://dogwood-policy.github.io/dogwood/index.html) 是Dogwood Policy网站上的一种与Cedar兼容的开源政策语言：每项有效的Cedar政策也是有效的Dogwood政策，因此您现有的Cedar政策将保持不变。除了你已经可以表达的时间点条件外，Dogwood还支持会话感知*的时间*条件和*信息提供者*，例如Guardrails，为策略提供计算信号。Dogwood 策略是根据对相关请求进行分组的策略会话进行评估的。

## 在雪松和山茱莉之间做出选择
<a name="concept-choosing-language"></a>

 **写 Dogwood。**Dogwood 是 Cedar 的超集：每份有效的 Cedar 政策也是有效的 Dogwood 政策，Dogwood 增加了护栏和临时规则所需的条件块。编写 Dogwood 意味着当规则超出当前请求时，您永远不必迁移策略。
+ 根据**你面前的请求**决定的规则 —— 委托人是谁、他们正在调用哪个动作以及该调用的输入值 —— 只需要 Cedar-compatible 语法即可。
+ [需要**请求中未包含的内容**的规则需要一个 Dogwood 条件块：在评估时计算的信号（作为[护栏](#concept-guardrails)），或者会话中已经发生的事情的历史记录（一种临时策略）。](#concept-temporal-policy)

两个 Dogwood 条件块都是写成普通`permit`的，`forbid`规则—— `when guardrails { …​ }` 或者 `when temporal { …​ }` ——所以采用它们是累加的，而不是重写。策略可以同时包含输入条件、护栏信号和会话历史记录。

Cedar的现有政策继续得到支持。

## 临时政策
<a name="concept-temporal-policy"></a>

大多数 Cedar 策略都是无状态的：每个请求都是独立评估的。*临时策略*添加了取决于同一会话中早些时候发生的事情的条件，例如要求事先批准、限制操作的运行频率或将运行总数保持在阈值以下。临时策略以 Dogwood 编写，与 Cedar 兼容，并根据对相关请求进行分组的策略会话进行评估。有关更多信息，请参阅[临时策略](policy-temporal.md)。

## 政策中的护栏
<a name="concept-guardrails"></a>

*护栏是在评估*时运行的内容安全检查。在做出授权决定之前，Policy 会使用您的数据路径选择的内容 AgentCore 调用护栏，护栏会返回其评估的类别的置信度分数。

然后，策略可以以该分数为条件——允许请求、禁止请求或禁止响应。有关更多信息，请参阅策略[中的护栏。](policy-guardrails-in-policies.md)

## 政策会议
<a name="concept-policy-session"></a>

策略会话是一系列相关的 Gateway 调用，分组在一个会话 ID 下，您可以在标题中的请求中提供该会话 ID。`x-amzn-bedrock-agentcore-policy-session-id`临时策略根据策略会话进行评估：临时条件仅考虑与请求授权相同的会话中记录的事件。有关更多信息，请参阅[策略会话和身份传播](policy-session-based-temporal.md)。

## 策略引擎
<a name="concept-policy-engine"></a>

策略引擎是政策的核心组成部分 AgentCore ，用于存储和评估 Cedar 政策。创建策略时，只要策略范围与请求相匹配，它们就会应用于与引擎关联的每个网关。对于每次工具调用，策略引擎都会根据请求评估所有适用的策略，以确定是允许还是拒绝访问。引擎会自动强制执行默认拒绝和禁胜语义。

## 雪松架构
<a name="concept-cedar-schema"></a>

Cedar 架构定义了用于策略验证的实体、操作和上下文的结构。策略引擎根据网关的工具定义自动生成架构，将每个工具映射到一个操作并定义预期的输入参数。该架构可确保策略在创建时得到验证，从而在部署之前捕获错误。

## 雪松验证
<a name="concept-cedar-validation"></a>

Cedar 验证会检查策略在语法上是否正确且符合架构。当您将策略与网关关联时，策略引擎会根据自动生成的架构对其进行验证，以确保它们引用有效的操作、使用正确的数据类型以及仅访问已定义的上下文字段。验证会在部署策略之前捕获错误，从而防止运行时授权失败。

## 雪松分析
<a name="concept-cedar-analysis"></a>

Cedar 分析使用自动推理来检查策略并发现潜在问题。Policy in AgentCore 使用自动推理来识别始终允许（没有条件限制访问）或始终拒绝（禁止策略无例外）的策略，这有助于确保策略实现预期的访问控制，而不是过于宽松或不必要的限制。

## 策略创作服务
<a name="concept-policy-authoring-service"></a>

策略制定服务会自动将自然语言授权要求转换为 Cedar 政策。当您提交自然语言策略时，该服务会生成语法正确的 Cedar 代码，根据网关架构对其进行验证，并运行自动分析以检测潜在问题。这样可以确保所有生成的策略都是有效的，并有助于在部署之前识别过于宽松或限制性的规则。