你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

适用于 JavaScript 的 Azure 核心身份验证客户端库 - 版本 1.7.2

@azure/core-auth 包提供核心接口和帮助程序方法,用于使用 Azure Active Directory 和 Azure SDK 中常见的其他身份验证方案对 Azure 服务进行身份验证。 作为“核心”库,它不需要添加为任何用户代码的依赖项,只需添加其他 Azure SDK 库即可。

入门

安装

使用 npm 安装此库,如下所示

npm install @azure/core-auth

关键概念

TokenCredential 接口表示能够提供身份验证令牌的凭据。 @azure/identity 包包含实现 TokenCredential 接口的各种凭据。

AzureKeyCredential 是一种基于静态密钥的凭证,支持通过 update 方法进行密钥轮换。 当需要用一个机密值进行身份验证时,例如使用共享访问密钥时,请使用此值。

AzureNamedKeyCredential 是基于名称/密钥的静态凭证,支持通过 update 方法进行名称和密钥轮换。 如果需要用到机密值和标签,例如使用共享访问密钥和共享访问密钥名称时,请使用此值。

AzureSASCredential 是基于签名的静态凭证,支持通过 update 方法更新签名值。 使用共享访问签名时,请使用此值。

示例

AzureKeyCredential

const { AzureKeyCredential } = require("@azure/core-auth");

const credential = new AzureKeyCredential("secret value");
// prints: "secret value"
console.log(credential.key);
credential.update("other secret value");
// prints: "other secret value"
console.log(credential.key);

AzureNamedKeyCredential

const { AzureNamedKeyCredential } = require("@azure/core-auth");

const credential = new AzureNamedKeyCredential("ManagedPolicy", "secret value");
// prints: "ManagedPolicy, secret value"
console.log(`${credential.name}, ${credential.key}`);
credential.update("OtherManagedPolicy", "other secret value");
// prints: "OtherManagedPolicy, other secret value"
console.log(`${credential.name}, ${credential.key}`);

AzureSASCredential

const { AzureSASCredential } = require("@azure/core-auth");

const credential = new AzureSASCredential("signature1");
// prints: "signature1"
console.log(credential.signature);
credential.update("signature2");
// prints: "signature2"
console.log(credential.signature);

后续步骤

可以通过执行 rushx test 在本地生成和运行测试。 浏览 test 文件夹,查看公共类的高级用法和行为。

疑难解答

如果在使用此库时遇到问题,请随时提出问题

贡献

若要为此库做出贡献,请阅读贡献指南,详细了解如何生成和测试代码。

曝光数