# @aws-lite/sts 中文文档

规范地址：https://npmcn.com/package/%40aws-lite/sts/

版本：0\.1\.2
npm 元数据更新时间：2026-03-06T19:10:04.380Z
中文译文更新时间：2026-11-07T15:27:37.705Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aws-lite/sts
原文对照：https://npmcn.com/package/%40aws-lite/sts/?lang=original
项目主页：https://aws-lite.org/services/sts
源码仓库：https://github.com/aws-lite/aws-lite

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：13.6 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：0 个
- 首次发布：2024-05-17T21:31:21.950Z
- 最新版本发布：2024-08-01T16:05:03.365Z
- 近 30 天下载量：8308（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

公务 `aws-lite` sTS 插件

## 安装

```sh
npm install @aws-lite/sts
```

也可以使用：`pnpm add @aws-lite/sts`、`yarn add @aws-lite/sts`、`bun add @aws-lite/sts`

## README

# `@aws-lite/sts`

> 公务 `aws-lite` sTS 插件

> 由下列人员维护: [@ architect](https://github.com/architect)

## 安装

```sh
npm i @aws-lite/sts
```

可选安装类型 :

```sh
npm i -D @aws-lite/sts-types
```

## 参考文献

[在aws-lite.org提供实例参考文件](https://aws-lite.org/services/sts)

## 参考文献

[在aws-lite.org提供实例参考文件](https://aws-lite.org/services/sts)

## 方法

### `AssumeRole`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)

属性 :

-   **`RoleArn` (弦) \[须\]**
    -   ARN 角色扮演
-   **`RoleSessionName` (弦) \[须\]**
    -   设定角色会话的标识符;必须符合 `[w+=,.@-]*`
-   **`DurationSeconds` (数目)**
    -   职责会议会期 `900` 改为 `43200`
-   **`ExternalId` (弦声)**
    -   在另一个账户中发挥作用时可能需要的独特标识符
-   **`Policy` (弦声)**
    -   JSON IAM 政策文件作为内在会议政策使用
-   **`PolicyArns` (阵列)**
    -   IAM 的 ARN 管理要使用的政策
-   **`ProvidedContexts` (阵列)**
    -   以 JSON 数组格式列出以前获得的可信上下文断言
    -   [更详细情况( AWS)](https://docs.aws.amazon.com/STS/latest/APIReference/API_ProvidedContext.html)
-   **`SerialNumber` (弦声)**
    -   与打电话的用户相关的 MFA 设备ID
-   **`SourceIdentity` (弦声)**
    -   主打电话者指定的源身份
-   **`Tags` (阵列)**
    -   会话标记; 每个标记是包含一个对象 `Key` 财务报告和审定财务报表 `Value` 属性
-   **`TokenCode` (弦声)**
    -   外交部价值(如果角色的信任政策需要)
-   **`TransitiveTagKeys` (阵列)**
    -   会话标签, 设置为角色链中后续会话的中转
    -   [更详细情况( AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html#id_session-tags_role-chaining)

### `AssumeRoleWithSAML`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)

属性 :

-   **`RoleArn` (弦) \[须\]**
    -   ARN 角色扮演
-   **`PrincipalArn` (弦) \[须\]**
    -   描述 IDP 的 SAML 提供者的 ARN
-   **`SAMLAssertion` (弦) \[须\]**
    -   由 IDP 提供的已编码的 SAML 认证响应
-   **`DurationSeconds` (数目)**
    -   职责会议会期 `900` 改为 `43200`
-   **`Policy` (弦声)**
    -   JSON IAM 政策文件作为内在会议政策使用
-   **`PolicyArns` (阵列)**
    -   IAM 的 ARN 管理要使用的政策

### `AssumeRoleWithWebIdentity`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)

属性 :

-   **`RoleArn` (弦) \[须\]**
    -   ARN 角色扮演
-   **`RoleSessionName` (弦) \[须\]**
    -   设定角色会话的标识符;必须符合 `[w+=,.@-]*`
-   **`WebIdentityToken` (弦) \[须\]**
    -   OAuth 2.0 访问令牌或 OpenID 连接ID令牌由 IDP 提供
-   **`DurationSeconds` (数目)**
    -   职责会议会期 `900` 改为 `43200`
-   **`ProviderId` (弦声)**
    -   OAuth 2.0 IdP 域名的完全合格主机; 不为 OpenID 连接身份提供者指定此值
-   **`Policy` (弦声)**
    -   JSON IAM 政策文件作为内在会议政策使用
-   **`PolicyArns` (阵列)**
    -   IAM 的 ARN 管理要使用的政策

### `DecodeAuthorizationMessage`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_DecodeAuthorizationMessage.html)

属性 :

-   **`EncodedMessage` (弦) \[须\]**
    -   已编码消息随回复而返回

### `GetAccessKeyInfo`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetAccessKeyInfo.html)

属性 :

-   **`AccessKeyId` (弦) \[须\]**
    -   AWS 查询访问密钥

### `GetCallerIdentity`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetCallerIdentity.html)

属性 :

### `GetFederationToken`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetFederationToken.html)

属性 :

-   **`Name` (弦) \[须\]**
    -   联邦用户名称
-   **`DurationSeconds` (数目)**
    -   职责会议会期 `900` 改为 `43200`
-   **`Policy` (弦声)**
    -   JSON IAM 政策文件作为内在会议政策使用
-   **`PolicyArns` (阵列)**
    -   IAM 的 ARN 管理要使用的政策
-   **`Tags` (阵列)**
    -   会话标记; 每个标记是包含一个对象 `Key` 财务报告和审定财务报表 `Value` 属性

### `GetSessionToken`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html)

属性 :

-   **`DurationSeconds` (数目)**
    -   职责会议会期 `900` 改为 `43200`
-   **`SerialNumber` (弦声)**
    -   与打电话的用户相关的 MFA 设备ID
-   **`TokenCode` (弦声)**
    -   外交部价值(如果角色的信任政策需要)

## 学多点

-   [更多关于 `aws-lite` 插件 API](https://aws-lite.org/plugin-api)
-   [学着如何促进这个和其他 `aws-lite` 插件](https://aws-lite.org/contributing)

## 常见问题

### @aws-lite/sts 是什么？

公务 aws-lite sTS 插件

### 如何安装 @aws-lite/sts？

在项目目录运行 npm install @aws-lite/sts，或使用 pnpm add / yarn add / bun add。

### @aws-lite/sts 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aws-lite\_\_sts 是否存在。

### @aws-lite/sts 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aws-lite/sts 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=16。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aws-lite/sts 可以商用吗？

@aws-lite/sts 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aws-lite/sts 的下载量有多少？

根据 npm 官方下载统计，@aws-lite/sts 在 2026/10/08 – 2026/11/06 这 30 天内被下载 8,308 次，日均约 277 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aws-lite/sts 还在维护吗？

最新版本 0\.1\.2 发布于 2024/08/02（2 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/05/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。