使用STS临时授权

OSS可以通过阿里云STS (Security Token Service) 进行临时授权访问。阿里云STS是为云计算用户提供临时访问令牌的Web服务。通过STS，您可以为第三方应用或子用户（即用户身份由您自己管理的用户）颁发一个自定义时效和权限的访问凭证。STS更详细的解释请参见STS介绍。

STS的优势如下：

• 您无需透露您的长期密钥（AccessKey）给第三方应用，只需生成一个访问令牌并将令牌交给第三方应用。您可以自定义这个令牌的访问权限及有效期限。
• 您无需关心权限撤销问题，访问令牌过期后自动失效。

使用STS访问OSS的流程请参见开发指南中的STS临时授权访问OSS。

以下代码用于使用STS凭证构造签名请求：

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* 初始化OSS账号信息 */
    std::string AccessKeyId = "yourAccessKeyId";
    std::string AccessKeySecret = "yourAccessKeySecret";
    std::string Endpoint = "yourEndpoint";
    std::string SecurityToken  = "securityToken";

    /* 初始化网络等资源 */
    InitializeSdk();

    ClientConfiguration conf;
    OssClient client(Endpoint, AccessKeyId, AccessKeySecret, SecurityToken, conf);

    /* 释放网络等资源 */
    ShutdownSdk();
    return 0;
}

使用签名URL临时授权

您可以将生成的签名URL提供给访客进行临时访问。生成签名URL时，您可以通过指定URL的过期时间来限制访客的访问时长。

有关如何在URL中加入签名信息，以便将该URL转给第三方实现授权访问，详情请参见在URL中包含签名。

• 使用签名URL上传文件

  以下代码用于使用签名URL上传文件：

  #include <alibabacloud/oss/OssClient.h>
  using namespace AlibabaCloud::OSS;
  
  int main(void)
  {
       /* 初始化OSS账号信息 */
      std::string AccessKeyId = "yourAccessKeyId";
      std::string AccessKeySecret = "yourAccessKeySecret";
      std::string Endpoint = "yourEndpoint";
      std::string BucketName = "yourBucketName";
      std::string PutobjectUrlName = "yourPutobjectUrlName";
  
       /* 初始化网络等资源 */
      InitializeSdk();
  
      ClientConfiguration conf;
      OssClient client(Endpoint, AccessKeyId, AccessKeySecret, conf);
  
      /* 设置签名URL有效时长 */
      std::time_t t = std::time(nullptr) + 1200;
      /* 生成签名URL */
      auto genOutcome = client.GeneratePresignedUrl(BucketName, PutobjectUrlName, t, Http::Put);
      if (genOutcome.isSuccess()) {
          std::cout << "GeneratePresignedUrl success, Gen url:" << genOutcome.result().c_str() << std::endl;
      }
      else {
          /* 异常处理 */
          std::cout << "GeneratePresignedUrl fail" <<
          ",code:" << genOutcome.error().Code() <<
          ",message:" << genOutcome.error().Message() <<
          ",requestId:" << genOutcome.error().RequestId() << std::endl;
          ShutdownSdk();
          return -1;
      }
  
      std::shared_ptr<std::iostream> content = std::make_shared<std::stringstream>();
      *content << "test cpp sdk";
  
      /* 使用签名URL上传文件 */
      auto outcome = client.PutObjectByUrl(genOutcome.result(), content);
  
      if (!outcome.isSuccess()) {
          /* 异常处理 */
          std::cout << "PutObjectByUrl fail" <<
          ",code:" << outcome.error().Code() <<
          ",message:" << outcome.error().Message() <<
          ",requestId:" << outcome.error().RequestId() << std::endl;
          ShutdownSdk();
          return -1;
      }
  
      /* 释放网络等资源 */
      ShutdownSdk();
      return 0;
  }

• 使用签名URL下载文件

  以下代码用于使用签名URL下载文件：

  #include <alibabacloud/oss/OssClient.h>
  using namespace AlibabaCloud::OSS;
  
  int main(void)
  {
      /* 初始化OSS账号信息 */
      std::string AccessKeyId = "yourAccessKeyId";
      std::string AccessKeySecret = "yourAccessKeySecret";
      std::string Endpoint = "yourEndpoint";
      std::string BucketName = "yourBucketName";
      std::string GetobjectUrlName = "yourGetobjectUrlName";
  
      /* 初始化网络等资源 */
      InitializeSdk();
  
      ClientConfiguration conf;
      OssClient client(Endpoint, AccessKeyId, AccessKeySecret, conf);
  
      /* 设置签名URL有效时长*/
      std::time_t t = std::time(nullptr) + 1200;
      /* 生成签名URL */
      auto genOutcome = client.GeneratePresignedUrl(BucketName, GetobjectUrlName, t, Http::Get);
      if (genOutcome.isSuccess()) {
          std::cout << "GeneratePresignedUrl success, Gen url:" << genOutcome.result().c_str() << std::endl;
      }
      else {
          /* 异常处理 */
          std::cout << "GeneratePresignedUrl fail" <<
          ",code:" << genOutcome.error().Code() <<
          ",message:" << genOutcome.error().Message() <<
          ",requestId:" << genOutcome.error().RequestId() << std::endl;
          ShutdownSdk();
          return -1;
      }
  
      /* 使用签名URL下载文件 */
      auto outcome = client.GetObjectByUrl(genOutcome.result());
  
      if (!outcome.isSuccess()) {
          /* 异常处理 */
          std::cout << "GetObjectByUrl fail" <<
          ",code:" << outcome.error().Code() <<
          ",message:" << outcome.error().Message() <<
          ",requestId:" << outcome.error().RequestId() << std::endl;
          ShutdownSdk();
          return -1;
      }
  
      /* 释放网络等资源 */
      ShutdownSdk();
      return 0;
  }