使用 Java 为容器或 blob 创建用户委派 SAS

获取用户委托密钥后，可以创建用户委托 SAS。 可以使用以下方法通过 BlobContainerClient 实例创建用户委托 SAS，以委派对容器资源的有限访问权限：

• generateUserDelegationSas

用于对 SAS 进行签名的用户委派密钥连同 BlobServiceSasSignatureValues 的指定值一起传递给此方法。 权限指定为 BlobContainerSasPermission 实例。

下面的代码示例演示如何为容器创建用户委派 SAS：

public String createUserDelegationSASContainer(BlobContainerClient containerClient, UserDelegationKey userDelegationKey) {
    // Create a SAS token that's valid for 1 day, as an example
    OffsetDateTime expiryTime = OffsetDateTime.now().plusDays(1);

    // Assign read permissions to the SAS token
    BlobContainerSasPermission sasPermission = new BlobContainerSasPermission()
            .setReadPermission(true);

    BlobServiceSasSignatureValues sasSignatureValues = new BlobServiceSasSignatureValues(expiryTime, sasPermission)
            .setStartTime(OffsetDateTime.now().minusMinutes(5));

    String sasToken = containerClient.generateUserDelegationSas(sasSignatureValues, userDelegationKey);
    return sasToken;
}

获取用户委托密钥后，可以创建用户委托 SAS。 可以使用以下方法通过 BlobClient 实例创建用户委派 SAS，以委派对 blob 的有限访问权限：

• generateUserDelegationSas

用于对 SAS 进行签名的用户委派密钥连同 BlobServiceSasSignatureValues 的指定值一起传递给此方法。 权限指定为 BlobSasPermission 实例。

以下代码示例演示如何为 blob 创建用户委托 SAS：

public String createUserDelegationSASBlob(BlobClient blobClient, UserDelegationKey userDelegationKey) {
    // Create a SAS token that's valid for 1 day, as an example
    OffsetDateTime expiryTime = OffsetDateTime.now().plusDays(1);

    // Assign read permissions to the SAS token
    BlobSasPermission sasPermission = new BlobSasPermission()
            .setReadPermission(true);

    BlobServiceSasSignatureValues sasSignatureValues = new BlobServiceSasSignatureValues(expiryTime, sasPermission)
            .setStartTime(OffsetDateTime.now().minusMinutes(5));

    String sasToken = blobClient.generateUserDelegationSas(sasSignatureValues, userDelegationKey);
    return sasToken;
}

以下代码示例显示了如何使用在较早的示例中创建的用户委派 SAS 来授权 BlobContainerClient 对象。 此客户端对象可用于根据 SAS 授予的权限对容器资源执行操作。

// Create a SAS token for a container
BlobContainerClient containerClient = blobServiceClient.getBlobContainerClient("sample-container");
String sasToken = createUserDelegationSASContainer(containerClient, userDelegationKey);

// Create a new BlobContainerClient using the SAS token
BlobContainerClient sasContainerClient = new BlobContainerClientBuilder()
        .endpoint(containerClient.getBlobContainerUrl())
        .sasToken(sasToken)
        .buildClient();

以下代码示例显示了如何使用在较早的示例中创建的用户委托 SAS 来授权 BlobClient 对象。 此客户端对象可用于根据 SAS 授予的权限对 blob 资源执行操作。

// Create a SAS token for a blob
BlobClient blobClient = blobServiceClient
        .getBlobContainerClient("sample-container")
        .getBlobClient("sample-blob.txt");
String sasToken = createUserDelegationSASBlob(blobClient, userDelegationKey);

// Create a new BlobClient using the SAS token
BlobClient sasBlobClient = new BlobClientBuilder()
        .endpoint(blobClient.getBlobUrl())
        .sasToken(sasToken)
        .buildClient();