@azure/identity-cache-persistence

中文文档
1.3.3发布于 2026/10/30MITTypeScriptESM + CJS近 30 天下载 5.3万

使用 OS 秘密管理 API 的 Azure 身份证书的安全而持久的符号缓存

中文使用文档
文档目录11 节
  1. 开始
  2. 先决条件
  3. 安装软件包
  4. 关键概念
  5. Azure 身份插件
  6. 实例
  7. 解决问题
  8. 日志
  9. 今后的步骤
  10. 提供反馈
  11. 捐款

Token 缓存持久性的 Azure 身份插件

此软件包为 JavaScript 提供了 Azure 身份库的插件(@azure/identity能够持续地隐形 Token 缓存持续允许内置的代号缓存在会话间持续使用由本地操作系统提供的安全存储系统.

源代码 | 样本

开始

先决条件

安装软件包

此软件包被设计为JavaScript与Azure身份一起使用. 安装两者 @azure/identity 使用 npm数字 :

$ npm install --save @azure/identity
$ npm install --save @azure/identity-cache-persistence

支持的环境

JavaScript的Azure身份插件支持从v12开始的Node.js的稳定(甚至编号)版本. 虽然插件可能运行在其他节点版本,但不能保证支持. @azure/identity-cache-persistence 没有 支持浏览器环境.

关键概念

如果这是你第一次使用 @azure/identity 或微软Entra ID,我们建议您阅读 使用 @azure/identity 使用 Microsoft Entra ID 软件 先说 该文件将使您更深入地了解平台以及如何正确配置您的 Azure 账户 .

Azure 身份插件

截止 @azure/identity 2.0.0版本,JavaScript的身份客户端库包含一个插件API. 此套件 (@azure/identity-cache-persistence)导出一个插件对象,您必须将其作为参数传递到顶层 useIdentityPlugin 函数从 @azure/identity 软件包。 启用您程序中的符号缓存持久性如下 :

import { useIdentityPlugin } from "@azure/identity";
import { cachePersistencePlugin } from "@azure/identity-cache-persistence";

useIdentityPlugin(cachePersistencePlugin);

打电话后 useIdentityPlugin中,将持久符号缓存插件注册到 @azure/identity 软件包,并将在所有支持持久符号缓存的证书上提供(那些有 tokenCachePersistenceOptions )),在它们的构造器选项中.

实例

插件注册后,您可以通过传递来启用符号缓存持久性 tokenCachePersistenceOptions 带有 enabled 设置为 true 给一个证书建筑师。 在下面的例子中,我们使用 DeviceCodeCredential,因为持续的缓存其令牌允许您跳过交互式设备编码认证流程,如果有缓存令牌可用的话.

import { DeviceCodeCredential } from "@azure/identity";

const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});

// We'll use the Microsoft Graph scope as an example
const scope = "https://graph.microsoft.com/.default";

// Print out part of the access token
console.log((await credential.getToken(scope)).token.substring(0, 10), "...");

解决问题

日志

允许伐木可能有助于发现有关失败的有用信息。 为了查看 HTTP 请求和回复的日志,设置 AZURE_LOG_LEVEL 环境变量改为 info。或者,可以在运行时拨打 setLogLevel 输入 @azure/logger数字 :

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

今后的步骤

提供反馈

如果你遇到错误或有建议,请 打开一个问题。 。 。 .

捐款

如果您想为图书馆捐钱 请读一下 贡献指南 学习如何构建和测试密码.

版本与发布记录

@azure/identity-cache-persistence 共发布 480 个版本,首次发布于 2021/06/23;过去 12 个月发布了 69 个版本。

版本发布日期距今
1.3.3latest2026/10/308 天前
1.3.22026/09/161 个月前
1.3.12026/08/192 个月前
1.3.02026/04/106 个月前
1.2.2-alpha.20260310.1dev2026/03/117 个月前
1.2.2-alpha.20260309.22026/03/107 个月前

关于 @azure/identity-cache-persistence 的常见问题

@azure/identity-cache-persistence 是什么?

使用 OS 秘密管理 API 的 Azure 身份证书的安全而持久的符号缓存

如何安装 @azure/identity-cache-persistence?

在项目目录运行 npm install @azure/identity-cache-persistence,或使用 pnpm add / yarn add / bun add。

@azure/identity-cache-persistence 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@azure/identity-cache-persistence 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@azure/identity-cache-persistence 需要什么版本的 Node.js?

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

@azure/identity-cache-persistence 可以商用吗?

@azure/identity-cache-persistence 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@azure/identity-cache-persistence 的下载量有多少?

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

@azure/identity-cache-persistence 还在维护吗?

最新版本 1.3.3 发布于 2026/10/30(8 天前);至今共发布 480 个版本,其中过去 12 个月发布了 69 个;首次发布于 2021/06/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。