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

AzureSasCredential 类

  • java.lang.Object
    • com.azure.core.credential.AzureSasCredential

public final class AzureSasCredential

表示使用共享访问签名对 Azure 服务进行身份验证的凭据。 它用于使用共享访问签名对 Azure 服务的访问权限进行身份验证和授权。

共享访问签名是基于字符串的令牌,可在指定时间段内授予对 Azure 服务中特定资源的有限权限和访问权限。 它允许你提供对资源的限时访问,而无需共享帐户密钥或其他敏感凭据。

AzureSasCredential使你能够对支持共享访问签名的 Azure 服务进行身份验证和访问。 通过创建 类的 AzureSasCredential 实例并提供 SAS 令牌作为参数,可以使用此凭据对 Azure 服务的请求进行身份验证。

若要使用凭据,通常会在实例化期间将其传递给相应的 Azure 客户端或服务客户端生成器。 库在内部处理身份验证过程,并在对 Azure 服务发出的 HTTP 请求中包含 SAS 令牌,使你能够访问 SAS 令牌中指定的资源。

AzureSasCredential如果需要授予对特定资源(例如 Azure 存储容器、Blob、队列或文件)的临时和有限访问权限,而不公开帐户密钥,则 特别有用。

请务必注意,的可用性和使用情况 AzureSasCredential 可能取决于特定的 Azure 服务及其对共享访问签名的支持。 此外,SAS 令牌的格式和内容可能因目标服务和资源而异。

示例:Azure SAS 身份验证

下面的代码示例演示如何创建 AzureSasCredential,并使用 sas 令牌对其进行配置。

AzureSasCredential azureSasCredential =
     new AzureSasCredential("AZURE-SERVICE-SAS-KEY");

构造函数摘要

构造函数 说明
AzureSasCredential(String signature)

创建一个凭据,该凭据使用给定的共享访问签名授权请求。

AzureSasCredential(String signature, Function<String,String> signatureEncoder)

创建一个凭据,用于授权给定共享访问签名中的请求。

方法摘要

修饰符和类型 方法和描述
String getSignature()

检索与此凭据关联的共享访问签名。

AzureSasCredential update(String signature)

轮换与此凭据关联的共享访问签名。

方法继承自 java.lang.Object

构造函数详细信息

AzureSasCredential

public AzureSasCredential(String signature)

创建一个凭据,该凭据使用给定的共享访问签名授权请求。

假定 signature 已传递的 已编码。 此构造函数实际上与调用 AzureSasCredential(String signature, Function<String,String> signatureEncoder)相同。

Parameters:

signature - 用于授权请求的共享访问签名。

AzureSasCredential

public AzureSasCredential(String signature, Function signatureEncoder)

创建一个凭据,用于授权给定共享访问签名中的请求。

如果 signatureEncoder 为非 null,则 signature使用 函数对 和所有 updated signatures进行编码。 signatureEncoder 应尽可能幂等,以减少出现双重编码错误的可能性。

Parameters:

signature - 用于授权请求的共享访问签名。
signatureEncoder - 一个可选函数,用于对 进行 signature编码。

方法详细信息

getSignature

public String getSignature()

检索与此凭据关联的共享访问签名。

Returns:

用于授权请求的共享访问签名。

update

public AzureSasCredential update(String signature)

轮换与此凭据关联的共享访问签名。

Parameters:

signature - 要与此凭据关联的新共享访问签名。

Returns:

已更新的 AzureSasCredential 对象。

适用于