share_sas_builder.hpp

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.
 
#pragma once
 
#include <azure/core/nullable.hpp>
#include <azure/storage/common/account_sas_builder.hpp>
#include <azure/storage/common/internal/constants.hpp>
 
#include <string>
#include <type_traits>
 
namespace Azure { namespace Storage { namespace Sas {
 
  enum class ShareSasResource
  {
    Share,
 
    File,
  };
 
  enum class ShareSasPermissions
  {
    Read = 1,
 
    Write = 2,
 
    Delete = 4,
 
    List = 8,
 
    Create = 16,
 
    All = ~0,
  };
 
  inline ShareSasPermissions operator|(ShareSasPermissions lhs, ShareSasPermissions rhs)
  {
    using type = std::underlying_type_t<ShareSasPermissions>;
    return static_cast<ShareSasPermissions>(static_cast<type>(lhs) | static_cast<type>(rhs));
  }
 
  inline ShareSasPermissions operator&(ShareSasPermissions lhs, ShareSasPermissions rhs)
  {
    using type = std::underlying_type_t<ShareSasPermissions>;
    return static_cast<ShareSasPermissions>(static_cast<type>(lhs) & static_cast<type>(rhs));
  }
 
  enum class ShareFileSasPermissions
  {
    Read = 1,
 
    Write = 2,
 
    Delete = 4,
 
    Create = 8,
 
    All = ~0,
  };
 
  inline ShareFileSasPermissions operator|(ShareFileSasPermissions lhs, ShareFileSasPermissions rhs)
  {
    using type = std::underlying_type_t<ShareFileSasPermissions>;
    return static_cast<ShareFileSasPermissions>(static_cast<type>(lhs) | static_cast<type>(rhs));
  }
 
  inline ShareFileSasPermissions operator&(ShareFileSasPermissions lhs, ShareFileSasPermissions rhs)
  {
    using type = std::underlying_type_t<ShareFileSasPermissions>;
    return static_cast<ShareFileSasPermissions>(static_cast<type>(lhs) & static_cast<type>(rhs));
  }
 
  struct ShareSasBuilder final
  {
    SasProtocol Protocol;
 
    Azure::Nullable<Azure::DateTime> StartsOn;
 
    Azure::DateTime ExpiresOn;
 
    Azure::Nullable<std::string> IPRange;
 
    std::string Identifier;
 
    std::string ShareName;
 
    std::string FilePath;
 
    ShareSasResource Resource;
 
    std::string CacheControl;
 
    std::string ContentDisposition;
 
    std::string ContentEncoding;
 
    std::string ContentLanguage;
 
    std::string ContentType;
 
    void SetPermissions(ShareSasPermissions permissions);
 
    void SetPermissions(ShareFileSasPermissions permissions);
 
    void SetPermissions(std::string rawPermissions) { Permissions = std::move(rawPermissions); }
 
    std::string GenerateSasToken(const StorageSharedKeyCredential& credential);
 
    std::string GenerateSasStringToSign(const StorageSharedKeyCredential& credential);
 
  private:
    std::string Permissions;
  };
 
}}} // namespace Azure::Storage::Sas