從第 1 版到第 2 版的 Amazon CloudFront 預先簽章變更 - AWS SDK for Java 2.x
高階變更API 變更

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

從第 1 版到第 2 版的 Amazon CloudFront 預先簽章變更

本主題詳細說明 Amazon CloudFront 從第 1 版 (v1) 到第 2 版 (v2) 的變更。

高階變更

變更 v1 v2

Maven 相依性

 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-java-sdk-bom</artifactId>
            <version>1.12.5871</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>  
        <groupId>com.amazonaws</groupId>
        <artifactId>cloudfront</artifactId>
    </dependency>
</dependencies>
 
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>bom</artifactId>
            <version>2.27.212</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>cloudfront</artifactId>
    </dependency>
</dependencies>
套件名稱 com.amazonaws.services.cloudfront software.amazon.awssdk.services.cloudfront
類別名稱

CloudFrontUrlSigner

CloudFrontCookieSigner

CloudFrontUtilities

SignedUrl

CannedSignerRequest

CustomSignerRequest

1 最新版本。 2 最新版本。

API 變更

Behavior (行為) v1 v2
建置標準請求 引數會直接傳遞至 API。 
CannedSignerRequest cannedRequest =
      CannedSignerRequest.builder()
                         .resourceUrl(resourceUrl)
                         .privateKey(privateKey)
                         .keyPairId(keyPairId)
                         .expirationDate(expirationDate)
                         .build();
建置自訂請求 引數會直接傳遞至 API。 
CustomSignerRequest customRequest =
      CustomSignerRequest.builder()
                         .resourceUrl(resourceUrl)
                         .resourceUrlPattern(resourceUrlPattern)
                         .privateKey(keyFile)
                         .keyPairId(keyPairId)
                         .expirationDate(expirationDate)
                         .activeDate(activeDate)
                         .ipRange(ipRange)
                         .build();
產生已簽章的 URL （固定） 
String signedUrl =
  CloudFrontUrlSigner.getSignedURLWithCannedPolicy(
    resourceUrl, keyPairId, privateKey, expirationDate);
 
CloudFrontUtilities cloudFrontUtilities =
    CloudFrontUtilities.create();

SignedUrl signedUrl =        
    cloudFrontUtilities.getSignedUrlWithCannedPolicy(cannedRequest);

String url = signedUrl.url();
產生已簽章的 Cookie （自訂） 
CookiesForCustomPolicy cookies =
    CloudFrontCookieSigner.getCookiesForCustomPolicy(
        resourceUrl, privateKey, keyPairId, expirationDate, 
        activeDate, ipRange);

CloudFrontUtilities cloudFrontUtilities =
    CloudFrontUtilities.create();

CookiesForCustomPolicy cookies =
     cloudFrontUtilities.getCookiesForCustomPolicy(customRequest);

v2 中的重構 Cookie 標頭

在 Java v1 中，Java SDK 會以 形式提供 Cookie 標頭Map.Entry<String, String>。

Map.Entry<String, String> signatureMap = cookies.getSignature();
String signatureKey = signatureMap.getKey(); // "CloudFront-Signature"
String signatureValue = signatureMap.getValue(); // "[SIGNATURE_VALUE]"

Java v2 SDK 以單一 形式交付整個標頭String。

String signatureHeaderValue = cookies.signatureHeaderValue(); // "CloudFront-Signature=[SIGNATURE_VALUE]"