你当前正在访问 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
文件夹,查看公共类的高级用法和行为。
疑难解答
如果在使用此库时遇到问题,请随时提出问题。
贡献
若要为此库做出贡献,请阅读贡献指南,详细了解如何生成和测试代码。