在请求身份验证中指定签名版本

Amazon S3 在大多数 AWS 区域 中只支持 AWS Signature Version 4。不过，在某些较旧的 AWS 区域 中，Amazon S3 同时支持 Signature Version 4 和 Signature Version 2。但是，签名版本 2 将要被关闭（弃用）。有关结束对签名版本 2 支持的更多信息，请参阅 已为 Amazon S3 关闭（弃用）AWS 签名版本 2。

有关所有 Amazon S3 区域的列表以及这些区域支持的 Signature Version，请参阅《AWS 一般参考》中的区域和终端节点。

对于所有 AWS 区域，默认情况下，AWS 开发工具包使用 Signature Version 4 对请求进行身份验证。如果使用 2016 年 5 月之前发布的 AWS 开发工具包，您可能需要请求 Signature Version 4，如下表所示。

$ aws configure set default.s3.signature_version s3v4

$ aws configure set profile.your_profile_name.s3.signature_version s3v4

System.setProperty(SDKGlobalConfiguration.ENABLE_S3_SIGV4_SYSTEM_PROPERTY, "true");

-Dcom.amazonaws.services.s3.enableV4

var s3 = new AWS.S3({signatureVersion: 'v4'});

<?php 
$client = S3Client::factory([
    'region' => 'YOUR-REGION',
    'version' => 'latest',
    'signature' => 'v4'
]);

<?php 
$s3 = new Aws\S3\S3Client([
    'version' => '2006-03-01',
    'region' => 'YOUR-REGION',
    'signature_version' => 'v4'
]);

[s3] use-sigv4 = True

s3 = AWS::S3::Client.new(:s3_signature_version => :v4)

s3 = Aws::S3::Client.new(signature_version: 'v4')

AWSConfigsS3.UseSignatureVersion4 = true;

<appSettings>
   <add key="AWS.S3.UseSignatureVersion4" value="true" />
</appSettings>

已为 Amazon S3 关闭（弃用）AWS 签名版本 2

但是，Amazon S3 即将关闭（弃用）签名版本 2。之后，Amazon S3 仅接受使用签名版本 4 签名的 API 请求。

本部分提供有关结束签名版本 2 支持的常见问题解答。

什么是签名版本 2/4，以及这对于签名请求意味着什么？

签名版本 2 或签名版本 4 签名过程用于对 Amazon S3 API 请求进行身份验证。签名请求使得 Amazon S3 可以确定谁在发送请求并保护您的请求免遭恶意人士侵害。

有关签署 AWS 请求的更多信息，请参阅《AWS 一般参考》中的签署 AWS API 请求。

进行了哪些更新？

我们当前支持使用签名版本 2 和签名版本 4 过程签名的 Amazon S3 API 请求。在此之后，Amazon S3 将仅接受使用签名版本 4 签名的请求。

有关签署 AWS 请求的更多信息，请参阅《AWS 一般参考》中的签名版本 4 中的变化。

为什么进行这些更新？

签名版本 4 使用签名密钥而非您的秘密访问密钥，提供了更好的安全性。当前所有 AWS 区域中都支持 Signature Version 4，而只有在 2014 年 1 月之前推出的区域中支持 Signature Version 2。此更新使得我们可以在所有区域中提供更为一致的体验。

如何确保我使用的是签名版本 4，需要进行哪些更新？

对请求进行签名所用的签名版本通常由客户端上的工具或开发工具包设置。默认情况下，AWS 开发工具包的最新版本使用 Signature Version 4。对于第三方软件，请联系您软件的相应支持团队以确认所需的版本。如果您向 Amazon S3 发送直接 REST 调用，则必须修改应用程序以使用签名版本 4 签名过程。

有关在转向 Signature Version 4 时所用 AWS 开发工具包版本的信息，请参阅 从签名版本 2 转向签名版本 4。

有关将 Signature Version 4 与 Amazon S3 REST API 结合使用的信息，请参阅《Amazon Simple Storage Service API 参考》中的对请求进行身份验证 (AWS Signature Version 4)。

如果我不更新会怎样？

在此之后使用签名版本 2 签名的请求将无法通过 Amazon S3 的身份验证。请求者将看到错误，说明请求必须使用签名版本 4 签名。

如果我使用要求我签名 7 天以上的预签名 URL，是否应进行更改？

如果您使用了要求您签名 7 天以上的预签名 URL，目前无需任何操作。您可以继续使用 AWS Signature Version 2 对预签名 URL 进行签名并通过身份验证。我们将后续跟进并提供更多详情，说明如何为预签名 URL 场景迁移签名版本 4。

更多信息

从签名版本 2 转向签名版本 4

如果您为 Amazon S3 API 请求身份验证使用签名版本 2，则应改为使用签名版本 4。对签名版本 2 的支持将结束，如已为 Amazon S3 关闭（弃用）AWS 签名版本 2中所述。

有关将 Signature Version 4 与 Amazon S3 REST API 结合使用的信息，请参阅《Amazon Simple Storage Service API 参考》中的对请求进行身份验证 (AWS Signature Version 4)。

下表列出了使用签名版本 4 (SigV4) 所需的开发工具包最低版本列表。如果您使用通过 AWS Java、JavaScript (Node.js) 或 Python (Boto/CLI)开发工具包预签名 URL，则必须设置正确的 AWS 区域 并在客户端配置中设置 Signature Version 4。有关在客户端配置中设置 SigV4 的信息，请参阅在请求身份验证中指定签名版本。

AWS Tools for Windows PowerShell 或者 AWS Tools for PowerShell Core

如果您使用的模块版本早于 3.3.0.0，则必须升级到 3.3.0.0。

要获取版本信息，请使用 Get-Module cmdlet：

          Get-Module –Name AWSPowershell
          Get-Module –Name AWSPowershell.NetCore  
        

要更新 3.3.0.0 版本，请使用 Update-Module cmdlet：

          Update-Module –Name AWSPowershell
          Update-Module –Name AWSPowershell.NetCore  
        

您可以使用有效期超过 7 天的预签名 URL 以将签名版本 2 流量发送到其上。